نام (NAME)

footclient - راه‌اندازی ترمینال‌های جدید در کارگزار foot

خلاصه دستور (SYNOPSIS)

footclient [OPTIONS]
footclient [OPTIONS] <command> [COMMAND OPTIONS]

تمامی آرگومان‌های انتهایی (غیر از گزینه‌ها) به عنوان دستوری برای اجرا (به جای شل پیش‌فرض) و آرگومان‌های آن در نظر گرفته می‌شوند.

توضیحات (DESCRIPTION)

ابزار footclient همراه با دستور foot(1) در حالت --server استفاده می‌شود.

اجرای آن بدون هیچ آرگومانی یک پنجره ترمینال جدید (به میزبانی کارگزار foot) با شل پیش‌فرض شما باز می‌کند. کد خروج آن برابر با کد خروج ترمینال خواهد بود؛ یعنی footclient تا زمان پایان یافتن ترمینال خارج نمی‌شود.

گزینه‌ها (OPTIONS)

-t,--term=TERM

-T,--title=TITLE

-a,--app-id=ID

--class=ID

toplevel-tag=TAG

-w,--window-size-pixels=WIDTHxHEIGHT

-W,--window-size-chars=WIDTHxHEIGHT

-m,--maximized

-F,--fullscreen

-L,--login-shell

-D,--working-directory=DIR

-s,--server-socket=PATH

-H,--hold

-N,--no-wait

-o,--override=[SECTION.]KEY=VALUE

-E,--client-environment

-d,--log-level={info,warning,error,none}

-l,--log-colorize=[{never,always,auto}]

-v,--version

-e

وضعیت خروج (EXIT STATUS)

اگر در خود footclient خطایی رخ دهد (برای نمونه، سوکت سرور وجود نداشته باشد)، با کد 220 خارج می‌شود.

در صورت استفاده از -N,--no-wait، به محض اینکه به کارگزار foot دستور باز کردن یک پنجره جدید داده شود، footclient با کد 0 خارج می‌شود.

در غیر این صورت، footclient ممکن است با کد 230 نیز خارج شود. این مقدار نشان‌دهنده بروز خطا در کارگزار foot است.

در تمام موارد دیگر کد خروج برابر با کد خروج برنامه کلاینت (یعنی همان شل) خواهد بود.

پایگاه داده ترمینال (TERMINFO)

برنامه‌های کلاینت از شناسه terminfo که توسط متغیر محیطی TERM (تنظیم‌شده توسط foot) مشخص می‌شود، برای تعیین قابلیت‌های ترمینال استفاده می‌کنند.

ترمینال Foot دارای دو تعریف terminfo است: foot و foot-direct، که foot پیش‌فرض است.

تفاوت این دو در تعداد رنگ‌هایی است که توصیف می‌کنند؛ foot تعداد ۲۵۶ رنگ و foot-direct تعداد ۱۶.۷ میلیون رنگ (رنگ واقعی ۲۴ بیتی) را توصیف می‌کند.

توجه داشته باشید که استفاده از terminfo مربوط به foot تعداد رنگ‌های قابل استفاده را به ۲۵۶ محدود نمی‌کند؛ برنامه‌ها همچنان می‌توانند از رنگ‌های ۲۴ بیتی RGB استفاده کنند. در واقع، بیشتر برنامه‌ها با foot به بهترین شکل کار می‌کنند (از جمله رنگ‌های ۲۴ بیتی). استفاده از مدخل‌های terminfo با فرمت *-direct حتی ممکن است باعث کرش کردن برخی برنامه‌های ncurses شود.

با این حال، برنامه‌هایی وجود دارند که برای پشتیبانی از ۲۴ بیتی به مدخل terminfo از نوع *-direct نیاز دارند؛ Emacs یک نمونه از آن‌ها است.

اگرچه استفاده از foot یا foot-direct قویاً توصیه می‌شود، اما امکان استفاده از مواردی مانند xterm-256color نیز وجود دارد. این مورد می‌تواند هنگام اتصال از راه دور به سیستمی که مدخل‌های terminfo مربوط به foot به راحتی روی آن قابل نصب نیستند، سودمند باشد.

توجه داشته باشید که مدخل‌های terminfo می‌توانند در دایرکتوری خانگی کاربر نصب شوند. بدین معنا که اگر دسترسی ریشه ندارید، یا اگر در توزیع شما بسته‌ای برای مدخل‌های terminfo مربوط به foot وجود ندارد، می‌توانید مدخل‌های terminfo مربوط به foot را با رونوشت گرفتن از foot و foot-direct در مسیر ~/.terminfo/f/ به صورت دستی نصب کنید.

محیط (ENVIRONMENT)

سیگنال‌ها (SIGNALS)

سیگنال‌های زیر در footclient دارای معانی ویژه‌ای هستند:

• SIGUSR1: تغییر به تم رنگی تیره ([colors-dark]).
• SIGUSR2: تغییر به تم رنگی روشن ([colors-light]).

هنگام ارسال SIGUSR1/SIGUSR2 به یک نمونه از footclient، تم تنها در آن نمونه تغییر می‌کند. این رفتار با حالتی که SIGUSR1/SIGUSR2 را به فرایند سرور ارسال می‌کنید و تم تمام نمونه‌ها تغییر می‌کند، متفاوت است.

نکته: به دلایل مشخص، این مورد زمانی که footclient با --no-wait راه‌اندازی شده باشد پشتیبانی نمی‌شود.

همچنین ببینید (SEE ALSO)

foot(1)