.\" 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 "footclient" "1" "2026\-09\-03"
.PP
.SH "نام (NAME)"
footclient \- راه‌اندازی ترمینال‌های جدید در کارگزار foot
.PP
.SH "خلاصه دستور (SYNOPSIS)"
\fBfootclient\fR [\fIOPTIONS\fR]
.br
\fBfootclient\fR [\fIOPTIONS\fR] <\fIcommand\fR> [\fICOMMAND OPTIONS\fR]
.PP
تمامی آرگومان‌های انتهایی (غیر از گزینه‌ها) به عنوان دستوری برای اجرا (به جای شل پیش‌فرض) و آرگومان‌های آن در نظر گرفته می‌شوند.\&
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار \fBfootclient\fR همراه با دستور \fBfoot\fR(1) در حالت \fB\-\-server\fR استفاده می‌شود.\&
.PP
اجرای آن بدون هیچ آرگومانی یک پنجره ترمینال جدید (به میزبانی کارگزار foot) با شل پیش‌فرض شما باز می‌کند.\& کد خروج آن برابر با کد خروج ترمینال خواهد بود؛ یعنی \fBfootclient\fR تا زمان پایان یافتن ترمینال خارج نمی‌شود.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-t\fR,\fB\-\-term\fR=\fITERM\fR
.RS 4
مقداری که متغیر محیطی \fBTERM\fR روی آن تنظیم می‌شود (بخش‌های \fBTERMINFO\fR و \fBمحیط (ENVIRONMENT)\fR را ببینید).\& پیش‌فرض: \fIfoot\fR.\&
.PP
.RE
\fB\-T\fR,\fB\-\-title\fR=\fITITLE\fR
.RS 4
عنوان اولیه پنجره.\& پیش‌فرض: \fIfoot\fR.\&
.PP
.RE
\fB\-a\fR,\fB\-\-app\-id\fR=\fIID\fR
.RS 4
مقداری که ویژگی \fBapp\-id\fR پنجره وی‌لند روی آن تنظیم می‌شود.\& پیش‌فرض: \fIfoot\fR (حالت عادی) یا \fIfootclient\fR (حالت کارگزار).\&
.PP
.RE
\fB\-\-class\fR=\fIID\fR
.RS 4
نام مستعار برای \fB\-\-app\-id\fR.\&
.PP
.RE
\fBtoplevel\-tag\fR=\fITAG\fR
.RS 4
مقداری که ویژگی \fBtoplevel\-tag\fR پنجره وی‌لند روی آن تنظیم می‌شود.\& کامپوزیتور می‌تواند از این مقدار برای مدیریت نشست، قوانین پنجره و غیره استفاده کند.\& پیش‌فرض: \fIتنظیم‌نشده\fR
.PP
.RE
\fB\-w\fR,\fB\-\-window\-size\-pixels\fR=\fIWIDTHxHEIGHT\fR
.RS 4
تنظیم عرض و ارتفاع اولیه پنجره بر حسب پیکسل.\& پیش‌فرض: \fI700x500\fR.\&
.PP
.RE
\fB\-W\fR,\fB\-\-window\-size\-chars\fR=\fIWIDTHxHEIGHT\fR
.RS 4
تنظیم عرض و ارتفاع اولیه پنجره بر حسب نویسه‌ها.\& پیش‌فرض: \fIتنظیم‌نشده\fR.\&
.PP
.RE
\fB\-m\fR,\fB\-\-maximized\fR
.RS 4
شروع در حالت بیشینه (maximized).\& اگر هر دو گزینه \fB\-\-maximized\fR و \fB\-\-fullscreen\fR مشخص شوند، گزینه \fIآخر\fR اولویت خواهد داشت.\&
.PP
.RE
\fB\-F\fR,\fB\-\-fullscreen\fR
.RS 4
شروع در حالت تمام‌صفحه (fullscreen).\& اگر هر دو گزینه \fB\-\-maximized\fR و \fB\-\-fullscreen\fR مشخص شوند، گزینه \fIآخر\fR اولویت خواهد داشت.\&
.PP
.RE
\fB\-L\fR,\fB\-\-login\-shell\fR
.RS 4
شروع یک شل ورود (login shell) با افزودن نویسه '\&\-'\& به ابتدای argv[0].\&
.PP
.RE
\fB\-D\fR,\fB\-\-working\-directory\fR=\fIDIR\fR
.RS 4
دایرکتوری کاری اولیه برای برنامه کلاینت.\& پیش‌فرض:
\fIدایرکتوری کاری جاری footclient\fR.\&
.PP
.RE
\fB\-s\fR,\fB\-\-server\-socket\fR=\fIPATH\fR
.RS 4
اتصال به مسیر \fIPATH\fR به جای
\fB$XDG_RUNTIME_DIR/foot\-$WAYLAND_DISPLAY.\&sock\fR.\&
.PP
.RE
\fB\-H\fR,\fB\-\-hold\fR
.RS 4
باز ماندن پنجره پس از خروج فرایند فرزند.\&
.PP
.RE
\fB\-N\fR,\fB\-\-no\-wait\fR
.RS 4
جدا کردن فرایند کلاینت از ترمینال در حال اجرا و خروج فوری.\&
.PP
.RE
\fB\-o\fR,\fB\-\-override\fR=[\fISECTION\fR.\&]\fIKEY\fR=\fIVALUE\fR
.RS 4
بازنویسی گزینه‌ای که در فایل پیکربندی تنظیم شده است.\& اگر \fISECTION\fR مشخص نشود، پیش‌فرض \fImain\fR خواهد بود.\&
.PP
.RE
\fB\-E\fR,\fB\-\-client\-environment\fR
.RS 4
فرایند فرزند در نمونه جدید ترمینال به جای محیط کارگزار، از محیط footclient استفاده خواهد کرد.\&
.PP
متغیرهای محیطی فهرست‌شده در بخش \fBمتغیرهای تنظیم‌شده در فرایند فرزند\fR توسط کارگزار foot بازنویسی خواهند شد.\& برای نمونه، ترمینال جدید از \fBTERM\fR پیکربندی استفاده خواهد کرد، نه از محیط footclient.\&
.PP
.RE
\fB\-d\fR,\fB\-\-log\-level\fR={\fBinfo\fR,\fBwarning\fR,\fBerror\fR,\fBnone\fR}
.RS 4
سطح ثبت گزارش (log)، که هم برای خروجی گزارش روی stderr و هم برای syslog استفاده می‌شود.\& پیش‌فرض: \fIwarning\fR.\&
.PP
.RE
\fB\-l\fR,\fB\-\-log\-colorize\fR=[{\fBnever\fR,\fBalways\fR,\fBauto\fR}]
.RS 4
فعال‌سازی یا غیرفعال‌سازی رنگ‌آمیزی خروجی گزارش روی stderr.\&
.PP
.RE
\fB\-v\fR,\fB\-\-version\fR
.RS 4
نمایش شماره نسخه و خروج
.PP
.RE
\fB\-e\fR
.RS 4
نادیده گرفته می‌شود؛ جهت سازگاری با \fBxterm \-e\fR.\& برای جزئیات بیشتر \fBfoot\fR(1) را ببینید.\&
.PP
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
اگر در خود footclient خطایی رخ دهد (برای نمونه، سوکت سرور وجود نداشته باشد)، با کد 220 خارج می‌شود.\&
.PP
در صورت استفاده از \fB\-N\fR,\fB\-\-no\-wait\fR، به محض اینکه به کارگزار foot دستور باز کردن یک پنجره جدید داده شود، footclient با کد 0 خارج می‌شود.\&
.PP
در غیر این صورت، footclient ممکن است با کد 230 نیز خارج شود.\& این مقدار نشان‌دهنده بروز خطا در کارگزار foot است.\&
.PP
در تمام موارد دیگر کد خروج برابر با کد خروج برنامه کلاینت (یعنی همان شل) خواهد بود.\&
.PP
.SH "پایگاه داده ترمینال (TERMINFO)"
.PP
برنامه‌های کلاینت از شناسه terminfo که توسط متغیر محیطی \fBTERM\fR (تنظیم‌شده توسط foot) مشخص می‌شود، برای تعیین قابلیت‌های ترمینال استفاده می‌کنند.\&
.PP
ترمینال Foot دارای دو تعریف terminfo است: \fBfoot\fR و \fBfoot\-direct\fR، که \fBfoot\fR پیش‌فرض است.\&
.PP
تفاوت این دو در تعداد رنگ‌هایی است که توصیف می‌کنند؛ \fBfoot\fR تعداد ۲۵۶ رنگ و \fBfoot\-direct\fR تعداد ۱۶.۷ میلیون رنگ (رنگ واقعی ۲۴ بیتی) را توصیف می‌کند.\&
.PP
توجه داشته باشید که استفاده از terminfo مربوط به \fBfoot\fR تعداد رنگ‌های قابل استفاده را به ۲۵۶ محدود نمی‌کند؛ برنامه‌ها همچنان می‌توانند از رنگ‌های ۲۴ بیتی RGB استفاده کنند.\& در واقع، بیشتر برنامه‌ها با \fBfoot\fR به بهترین شکل کار می‌کنند (از جمله رنگ‌های ۲۴ بیتی).\& استفاده از مدخل‌های terminfo با فرمت \fB*\-direct\fR حتی ممکن است باعث کرش کردن برخی برنامه‌های ncurses شود.\&
.PP
با این حال، برنامه‌هایی وجود دارند که برای پشتیبانی از ۲۴ بیتی به مدخل terminfo از نوع \fB*\-direct\fR نیاز دارند؛ Emacs یک نمونه از آن‌ها است.\&
.PP
اگرچه استفاده از \fBfoot\fR یا \fBfoot\-direct\fR قویاً توصیه می‌شود، اما امکان استفاده از مواردی مانند \fBxterm\-256color\fR نیز وجود دارد.\& این مورد می‌تواند هنگام اتصال از راه دور به سیستمی که مدخل‌های terminfo مربوط به foot به راحتی روی آن قابل نصب نیستند، سودمند باشد.\&
.PP
توجه داشته باشید که مدخل‌های terminfo می‌توانند در دایرکتوری خانگی کاربر نصب شوند.\& بدین معنا که اگر دسترسی ریشه ندارید، یا اگر در توزیع شما بسته‌ای برای مدخل‌های terminfo مربوط به foot وجود ندارد، می‌توانید مدخل‌های terminfo مربوط به foot را با رونوشت گرفتن از \fBfoot\fR و \fBfoot\-direct\fR در مسیر \fB\(ti/.\&terminfo/f/\fR به صورت دستی نصب کنید.\&
.PP
.SH "محیط (ENVIRONMENT)"
.PP
.SS "متغیرهای مورد استفاده footclient"
.PP
\fBXDG_RUNTIME_DIR\fR
.RS 4
برای ساخت مسیر پیش‌فرض \fIPATH\fR برای گزینه \fB\-\-server\-socket\fR، در صورتی که آرگومان صریحی ارائه نشده باشد استفاده می‌شود (بالا را ببینید).\&
.PP
.RE
\fBWAYLAND_DISPLAY\fR
.RS 4
برای ساخت مسیر پیش‌فرض \fIPATH\fR برای گزینه \fB\-\-server\-socket\fR، در صورتی که آرگومان صریحی ارائه نشده باشد استفاده می‌شود (بالا را ببینید).\&
.PP
.RE
اگر سوکت در مسیر پیش‌فرض \fIPATH\fR وجود نداشته باشد، \fBfootclient\fR با اولویت زیر به مسیرهای با اختصاصیت کمتر رجوع می‌کند:
\fB$XDG_RUNTIME_DIR/foot\-$WAYLAND_DISPLAY.\&sock\fR،
\fB$XDG_RUNTIME_DIR/foot.\&sock\fR، \fB/tmp/foot.\&sock\fR.\&
.PP
.SS "متغیرهای تنظیم‌شده در فرایند فرزند"
.PP
\fBTERM\fR
.RS 4
شناسه terminfo/termcap.\& این متغیر توسط برنامه‌های کلاینت استفاده می‌شود تا مشخص گردد ترمینال از چه قابلیت‌هایی پشتیبانی می‌کند.\& مقدار آن بر اساس گزینه خط فرمان \fB\-\-term\fR یا گزینه پیکربندی \fBterm\fR در فایل \fBfoot.\&ini\fR(5) تنظیم می‌شود.\&
.PP
.RE
\fBCOLORTERM\fR
.RS 4
این متغیر روی \fBtruecolor\fR تنظیم می‌شود تا به برنامه‌های کلاینت نشان دهد که رنگ‌های ۲۴ بیتی RGB پشتیبانی می‌شوند.\&
.PP
.RE
\fBPWD\fR
.RS 4
دایرکتوری کاری جاری (در زمان راه‌اندازی foot).\&
.PP
.RE
\fBSHELL\fR
.RS 4
روی شل راه‌اندازی‌شده تنظیم می‌شود، به شرطی که آن شل معتبر باشد (در فایل \fB/etc/shells\fR فهرست شده باشد).\&
.PP
.RE
علاوه بر متغیرهای ذکرشده در بالا، متغیرهای محیطی سفارشی را نیز می‌توان در \fBfoot.\&ini\fR(5) تعریف کرد.\&
.PP
.SS "متغیرهای حذف‌شده در فرایند فرزند"
.PP
\fBTERM_PROGRAM\fR
\fBTERM_PROGRAM_VERSION\fR
.RS 4
این متغیرهای محیطی توسط برخی شبیه‌سازهای ترمینال دیگر تنظیم می‌شوند.\& ما آن‌ها را حذف (unset) می‌کنیم تا از تشخیص نادرست foot توسط برنامه‌ها جلوگیری شود.\&
.PP
.RE
علاوه بر متغیرهای ذکرشده در بالا، متغیرهای محیطی سفارشی جهت حذف شدن را می‌توان در \fBfoot.\&ini\fR(5) تعریف کرد.\&
.PP
.SH "سیگنال‌ها (SIGNALS)"
.PP
سیگنال‌های زیر در footclient دارای معانی ویژه‌ای هستند:
.PP
.PD 0
.IP \(bu 4
SIGUSR1: تغییر به تم رنگی تیره (\fB[colors\-dark]\fR).\&
.IP \(bu 4
SIGUSR2: تغییر به تم رنگی روشن (\fB[colors\-light]\fR).\&
.PD
.PP
هنگام ارسال SIGUSR1/SIGUSR2 به یک نمونه از footclient، تم تنها در آن نمونه تغییر می‌کند.\& این رفتار با حالتی که SIGUSR1/SIGUSR2 را به فرایند سرور ارسال می‌کنید و تم تمام نمونه‌ها تغییر می‌کند، متفاوت است.\&
.PP
نکته: به دلایل مشخص، این مورد زمانی که footclient با \fB\-\-no\-wait\fR راه‌اندازی شده باشد پشتیبانی نمی‌شود.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBfoot\fR(1)