نام (NAME)

kitten-@-set-user-vars - تنظیم متغیرهای کاربری روی یک پنجره

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

kitten @ set-user-vars [NAME=VALUE ...]

توضیحات (DESCRIPTION)

تنظیم متغیرهای کاربری برای پنجره‌های مشخص‌شده. اگر از گزینه --match استفاده کنید، متغیرها برای تمام پنجره‌های منطبق تنظیم خواهند شد. به طور پیش‌فرض، تنها پنجره‌ای که دستور در آن اجرا می‌شود تحت تأثیر قرار می‌گیرد. اگر متغیری را مشخص نکنید، متغیرهای فعلی در خروجی چاپ می‌شوند، هر کدام در یک خط. برای حذف یک متغیر، تنها نام آن را مشخص کنید.

گزینه‌ها (OPTIONS)

--match, -m

پنجره مورد نظر برای تطبیق. مشخصات تطبیق به فرم field:query هستند؛ که در آن field می‌تواند یکی از موارد زیر باشد: id، title، pid، cwd، cmdline، num، env، var، state، neighbor، session و recent. بخش query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم (regular expression) باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.

مقدار ویژه all با تمام پنجره‌ها تطبیق می‌یابد.

برای فیلدهای عددی: id، pid، num و recent، عبارت به عنوان یک عدد تفسیر می‌شود، نه یک عبارت منظم. مقادیر منفی برای id از بالاترین شماره id به سمت پایین تطبیق داده می‌شوند؛ به‌ویژه، -1 جدیدترین پنجره ایجادشده است.

فیلد num به موقعیت پنجره در زبانه جاری اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (مشابه ترتیبی که پنجره‌ها توسط دستور kitten @ ls گزارش می‌شوند).

شناسه پنجره جاری از طریق متغیر محیطی KITTY_WINDOW_ID در دسترس است.

فیلد recent به پنجره‌های اخیراً فعال در زبانه فعال کنونی اشاره دارد، با صفر به عنوان پنجره در حال حاضر فعال، یک به عنوان پنجره قبلاً فعال و به همین ترتیب.

فیلد neighbor به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد: left، right، top یا bottom.

فیلد session با پنجره‌هایی که در نشست مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت ^$ برای تطبیق پنجره‌هایی که در یک نشست ایجاد نشده‌اند، از . برای تطبیق نشست فعال فعلی و از ~ برای تطبیق نشست فعال فعلی یا آخرین نشست فعال (هنگامی که هیچ نشستی فعال نیست) استفاده کنید.

هنگام استفاده از فیلد env برای تطبیق بر روی متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار را مشخص کنید؛ برای مثال env:MY_ENV_VAR=2.

به همین ترتیب، فیلد var بر اساس متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌یابد. می‌توانید همانند فیلد env نام یا نام و مقدار را مشخص کنید.

فیلد state بر اساس وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused، focused_os_window، self و overlay_parent. پنجره‌های فعال (active) پنجره‌هایی هستند که در زبانه والد خود فعال هستند. تنها یک پنجره فوکوس‌شده (focused) وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره فوکوس‌شده تطبیق داده می‌شود. مقدار focused_os_window با تمام پنجره‌های موجود در پنجره فوکوس‌شده سیستم‌عامل مطابقت دارد. مقدار self با پنجره‌ای که دستور کنترل از راه دور در آن اجرا شده مطابقت دارد. مقدار overlay_parent با پنجره زیرین پنجره self (هنگامی که پنجره self یک لایه رویی یا overlay است) مطابقت دارد.

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرستی از پنجره‌ها استفاده کنید.

--help, -h [=no]

نمایش راهنما برای این دستور.

گزینه‌های سراسری (GLOBAL OPTIONS)

--to: نشانی نمونه kitty مورد نظر برای کنترل. متناظر با نشانی داده‌شده به نمونه kitty از طریق گزینه --listen-on یا تنظیم listen_on در kitty.conf است. در صورت مشخص نشدن، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند، یعنی تنها در صورتی کار خواهند کرد که این فرآیند درون یک پنجره kitty اجرا شود.
--password: رمز عبوری برای استفاده هنگام برقراری ارتباط با kitty. این باعث می‌شود kitty از کاربر برای انجام عمل مشخص‌شده اجازه بخواهد، مگر اینکه رمز عبور قبلاً پذیرفته شده باشد یا در kitty.conf از پیش پیکربندی شده باشد. برای استفاده از رمز عبور خالی، گزینه --use-password را روی always قرار دهید.
--password-file [=rc-pass]: فایلی که رمز عبور از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی از دایرکتوری پیکربندی kitty سنجیده می‌شوند. از - برای خواندن از STDIN استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل num استفاده کنید. در صورتی استفاده می‌شود که هیچ --password ارائه نشده باشد. پیش‌فرض بررسی فایل rc-pass در دایرکتوری پیکربندی kitty است.
--password-env [=KITTY_RC_PASSWORD]: نام متغیر محیطی برای خواندن رمز عبور از آن. در صورتی استفاده می‌شود که گزینه --password-file ارائه نشده باشد. پیش‌فرض بررسی متغیر محیطی KITTY_RC_PASSWORD است.
--use-password [=if-available]: اگر هیچ رمز عبوری در دسترس نباشد، kitty معمولاً فقط دستور کنترل از راه دور را بدون رمز عبور ارسال می‌کند. از این گزینه می‌توان برای اجبار به استفاده همیشگی یا هرگز استفاده نکردن از رمز عبور ارائه‌شده استفاده کرد. اگر روی always تنظیم شود و رمز عبوری ارائه نشده باشد، از رمز عبور خالی استفاده می‌شود.
انتخاب‌ها: if-available, always, never