.\" SPDX-License-Identifier: GPL-2.0-or-later
.\" Copyright (c) 2025 Red Hat GmbH
.\" Author: Stefano Brivio <sbrivio@redhat.com>
.TH passt-repair 1

.SH "نام (NAME)"
passt-repair \- ابزار کمکی برای تنظیم گزینه‌های سوکت TCP_REPAIR برای \fBpasst\fR(1)

.SH "خلاصه دستور (SYNOPSIS)"
.B passt-repair
\fIPATH\fR

.SH "توضیحات (DESCRIPTION)"

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

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

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

.SH "پروتکل (PROTOCOL)"

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

پیام‌ها شامل یک عدد صحیح ۸ بیتی علامت‌دار هستند که طبق تعریف API کاربری هسته لینوکس می‌تواند \fITCP_REPAIR_ON\fR (1)، \fITCP_REPAIR_OFF\fR (0) یا \fITCP_REPAIR_OFF_NO_WP\fR (-1) باشد، به همراه یک تا SCM_MAX_FD (253) سوکت به عنوان پیام کمکی SCM_RIGHTS (به \fBunix\fR(7) مراجعه کنید) که توسط کارساز، \fBpasst\fR(1)، ارسال می‌شود.

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

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

.SH "نکات (NOTES)"

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

.SH "نویسندگان (AUTHORS)"

Stefano Brivio <sbrivio@redhat.com>.

.SH "گزارش باگ‌ها (BUGS)"

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

.SH "کپی‌رایت و تکثیر (COPYRIGHT)"

Copyright (c) 2025 Red Hat GmbH.

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

.SH "همچنین ببینید (SEE ALSO)"

\fBpasst\fR(1), \fBqemu\fR(1), \fBcapabilities\fR(7), \fBunix\fR(7).