.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "SYD\-FD" "1" "2026\-09\-01"
.PP
.SH "نام (NAME)"
syd-fd \- مدیریت توصیف‌کننده‌های فایل در جعبه‌شنی syd
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBsyd\-fd\fR \fI[\-h]\fR \fI[\-p pid]\fR \fI[\-f remote_fd[:local_fd]]\fR.\&.\&.\& \fI{command [args.\&.\&.\&]}\fR
.br
\fBsyd\-fd\fR \fI[\-hw]\fR \-u \fIsocket\fR \fI[\-m msg]\fR \fI[\-f fd[,fd.\&.\&.\&]]\fR.\&.\&.\&
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fBsyd\-fd\fR
می‌تواند برای تعامل با توصیف‌کننده‌های فایل در سیستم‌های لینوکس مورد استفاده قرار گیرد.\& این ابزار در یکی از دو حالت زیر کار می‌کند: انتقال توصیف‌کننده‌های فایل راه دور با استفاده از
\fIpidfd_getfd\fR(2)،
یا ارسال توصیف‌کننده‌های فایل از طریق یک سوکت دامین یونیکس با
\fBSCM_RIGHTS\fR.\&
.PP
در حالت نخست، در صورت تعیین تنها یک آرگومان PID با گزینه
\fI\-p\fR،
فایل‌های باز فرایند با PID داده‌شده را در قالب JSON فشرده و خط‌محور فهرست می‌کند.\& اگر هیچ آرگومان PID مشخص نشود، فایل‌های باز فرایند جاری را فهرست می‌کند.\& می‌توان از آرگومان
\fI\-f\fR
برای انتقال توصیف‌کننده‌های فایل راه دور با استفاده از
\fIpidfd_getfd\fR(2)
استفاده کرد که نیازمند لینوکس 5.6 یا بالاتر (Linux>=5.6) است.\& به عنوان یک امکان اختیاری، می‌توان یک توصیف‌کننده فایل محلی را پس از دونقطه به عنوان مقصد اضافه کرد.\& برای تکثیر توصیف‌کننده فایل در یک خانه تصادفی آزاد از توصیف‌کننده‌های فایل، عبارت "rand" را به عنوان مقصد مشخص کنید.\& اگر دستوری مشخص شده باشد، اجرا می‌شود و توصیف‌کننده‌های فایل به فرایند منتقل می‌شوند.\& در صورت عدم تعیین دستور،
"/bin/sh"
اجرا می‌شود.\&
.PP
در حالت دوم که با گزینه
\fI\-u\fR
انتخاب می‌شود، به سوکت دامین یونیکس مشخص‌شده متصل شده و یک پیام تکی حاوی توصیف‌کننده‌های فایل ارائه‌شده با
\fI\-f\fR
را به عنوان داده‌های کمکی
\fBSCM_RIGHTS\fR
از
\fIunix\fR(7)
ارسال می‌کند.\& وجود علامت
\fB@\fR
در ابتدای آدرس سوکت نشان‌دهنده یک سوکت یونیکس انتزاعی (abstract) است.\& آرگومان‌های
\fI\-f\fR
شماره‌های توصیف‌کننده فایل محلی هستند: فراخواننده باید آن‌ها را باز کند، برای نمونه با تغییر مسیرهای پوسته.\& خط پیام را می‌توان با
\fI\-m\fR
مشخص کرد که به طور پیش‌فرض خالی است.\& هر دو گزینه
\fI\-m\fR
و
\fI\-f\fR
اختیاری هستند، بنابراین این حالت می‌تواند برای ارسال پیام‌های ساده بدون توصیف‌کننده فایل نیز استفاده شود.\& هرگونه محدودیت روی تعداد توصیف‌کننده‌ها در هر پیام تابع خط‌مشی دریافت‌کننده است: سوکت IPC در
\fIsyd\fR(2)
دقیقاً یک توصیف‌کننده فایل پیکربندی را در هر پیام می‌پذیرد.\& به طور پیش‌فرض syd\-fd بلافاصله پس از ارسال بدون انتظار برای پاسخ خارج می‌شود؛ با تعیین گزینه
\fI\-w\fR
صرف‌نظر از آنچه ارسال شده منتظر دریافت پاسخ می‌ماند و آن را تا زمانی که طرف مقابل اتصال را ببندد در خروجی استاندارد چاپ می‌کند.\& بالاتر از همه، این حالت برای بارگذاری پیکربندی جعبه‌شنی از طریق سوکت IPC در
\fIsyd\fR(2)
کاربرد دارد.\& یک توصیف‌کننده فایلِ دریافت‌شده، درخواست بارگذاری را تشکیل می‌دهد و پیام حامل آن باید تنها شامل دستور "load" باشد.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
.TS
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fB\-h\fR
T}	T{
نمایش راهنما.\&
T}
T{
\fB\-p\fR \fIpid\fR
T}	T{
مشخص کردن شناسه فرایند (PID).\& در صورت عدم تعیین، توصیف‌کننده‌های فایل فرایند جاری را فهرست می‌کند.\&
T}
T{
\fB\-f\fR \fIremote_fd[:local_fd]\fR
T}	T{
مشخص کردن fd راه دور برای انتقال.\& می‌توان یک fd محلی مقصد را پس از دونقطه اضافه کرد، یا "rand" را برای مقصدی تصادفی به کار برد.\&
T}
T{
\fB\-u\fR \fIsocket\fR
T}	T{
اتصال به سوکت دامین یونیکس و ارسال fdهای داده‌شده با \fBSCM_RIGHTS\fR.\& وجود \fB@\fR در ابتدا نشان‌دهنده یک سوکت انتزاعی است.\& توصیف‌کننده‌های فایل برای ارسال با \fI\-f\fR مشخص می‌شوند که می‌تواند تکرار شده یا با کاما جدا شود.\&
T}
T{
\fB\-m\fR \fIline\fR
T}	T{
مشخص کردن خط پیام برای ارسال با گزینه \fI\-u\fR.\& اختیاری است و به طور پیش‌فرض خالی می‌باشد.\&
T}
T{
\fB\-w\fR
T}	T{
انتظار برای دریافت پاسخ هنگام استفاده از \fI\-u\fR، صرف‌نظر از آنچه ارسال شده، و چاپ آن در خروجی استاندارد.\& به طور پیش‌فرض syd\-fd بلافاصله پس از ارسال خارج می‌شود.\&
T}
.TE
.sp 1
.SH "وضعیت خروج (EXIT STATUS)"
.PP
ابزار
\fBsyd\-fd\fR
با همان کد خروج دستور مشخص‌شده خارج می‌شود.\& با گزینه
\fI\-u\fR،
در صورت موفقیت با کد 0 و در صورت شکست با شماره
\fIerrno\fR(3)
مربوط به فراخوانی سیستمی شکست‌خورده خارج می‌شود.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
بارگذاری پیکربندی جعبه‌شنی از طریق سوکت IPC در
\fIsyd\fR(2):
.PP
.nf
.RS 4
$ syd\-fd \-w \-u @sandbox\&.sock \-m load \-f 3 3<paludis\&.syd\-3
{"err":0,"msg":"ACK"}
.fi
.RE
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fIsyd\fR(1), \fIsyd\fR(2), \fIsyd\fR(5), \fIsyd\-lock\fR(1), \fIsyd\-pds\fR(1),
\fIpidfd_getfd\fR(1), \fIunix\fR(7)
.PP
وبگاه اصلی \fBsyd\fR:
https://sydbox.\&exherbo.\&org
.PP
.SH "نویسندگان (AUTHORS)"
.PP
توسعه و نگهداری توسط Ali Polatel.\& کدهای منبع به‌روز را می‌توانید در
https://gitlab.\&exherbo.\&org/sydbox/sydbox.\&git
و در Radicle در
rad:z38HCnbmcDegA2BMxuPaPRPMdp6wF
بیابید.\& گزارش‌های اشکال و وصله‌ها را می‌توان به
https://gitlab.\&exherbo.\&org/groups/sydbox/\-/issues
ارسال کرد.\& گفتگو و تبادل نظر در کانال #sydbox در Libera Chat یا در #sydbox:mailstation.\&de در Matrix.\&