passt-repair(1) General Commands Manual passt-repair(1)

passt-repair - ابزار کمکی برای تنظیم گزینه‌های سوکت TCP_REPAIR برای passt(1)

passt-repair PATH

passt-repair یک ابزار کمکی با دسترسی ویژه است که به نمایندگی از passt(1) حالت تعمیر (repair mode) را روی سوکت‌های TCP فعال یا غیرفعال می‌کند؛ این کار بر اساس دستورهای تک‌بایتی ارسالی از طریق یک UNIX domain socket انجام می‌گیرد.

این ابزار می‌تواند برای انتقال اتصالات TCP میان مهمان‌ها، بدون اعطای قابلیت‌های (capabilities) اضافی به خود passt(1) به کار رود: برای انتقال اتصالات TCP، passt(1) از حالت تعمیر استفاده می‌کند، که فعال یا غیرفعال کردن آن نیازمند قابلیت CAP_NET_ADMIN است (به capabilities(7) مراجعه کنید).

اگر PATH نشان‌دهنده یک UNIX domain socket باشد، passt-repair(1) برای اتصال به آن تلاش می‌کند. اگر یک دایرکتوری باشد، passt-repair(1) تا زمانی که فایلی با پسوند .repair در آن ظاهر شود منتظر می‌ماند، و سپس برای اتصال به آن تلاش می‌کند.

passt-repair(1) با استفاده از سوکت مشخص‌شده از طریق گزینه --repair-path در خود passt(1) به آن متصل می‌شود. به‌طور پیش‌فرض، نام آن همانند UNIX domain socket مورد استفاده برای ارتباط با مهمان است که پسوند .repair به آن اضافه شده است.

پیام‌ها شامل یک عدد صحیح ۸ بیتی علامت‌دار هستند که طبق تعریف API کاربری هسته لینوکس می‌تواند TCP_REPAIR_ON (1)، TCP_REPAIR_OFF (0) یا TCP_REPAIR_OFF_NO_WP (-1) باشد، به همراه یک تا SCM_MAX_FD (253) سوکت به عنوان پیام کمکی SCM_RIGHTS (به unix(7) مراجعه کنید) که توسط کارساز، passt(1)، ارسال می‌شود.

کلاینت، یعنی passt-repair(1)، برای نشان دادن موفقیت با همان بایت (و بدون پیام کمکی) پاسخ می‌دهد، و در صورت شکست اتصال را می‌بندد.

کارساز در صورت بروز خطا یا تکمیل کار، اتصال را می‌بندد.

می‌توان به passt-repair(1) قابلیت CAP_NET_ADMIN را اعطا کرد (روش ارجح، زیرا اختیارات را منحصراً به موارد کاملاً ضروری محدود می‌کند)، یا می‌توان آن را با کاربر ریشه (root) اجرا کرد.

Stefano Brivio <sbrivio@redhat.com>.

لطفاً مشکلات را در سامانه ردیابی باگ به نشانی https://bugs.passt.top گزارش دهید، یا پیامی به فهرست رایانامه‌ای passt-user@passt.top ارسال کنید؛ ببینید: https://lists.passt.top

Copyright (c) 2025 Red Hat GmbH.

passt-repair یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید.

passt(1), qemu(1), capabilities(7), unix(7).