.TH "kitten-@-signal-child" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-signal-child \- ارسال سیگنال به فرآیند پیش‌زمینه در پنجره‌های مشخص‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.SY "kitten @ signal-child  [SIGNAL_NAME ...]"
.YS
.SH "توضیحات (DESCRIPTION)"
ارسال یک یا چند سیگنال به فرآیند پیش‌زمینه در پنجره‌های مشخص‌شده. اگر از گزینه 
.B \-\-match
استفاده کنید، سیگنال برای تمام پنجره‌های منطبق ارسال خواهد شد. به طور پیش‌فرض، تنها پنجره فعال تحت تأثیر قرار می‌گیرد. اگر هیچ سیگنالی مشخص نکنید، به طور پیش‌فرض SIGINT ارسال می‌شود. همچنین می‌توانید signal_child را به یک میانبر در 
.I kitty.conf
نگاشت کنید، برای مثال:
.PP
.nf
    map f1 signal_child SIGTERM
.fi
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--no-response" " [=no]"
عدم انتظار برای دریافت پاسخ مبنی بر موفقیت عملیات. توجه داشته باشید که استفاده از این گزینه به این معناست که از خطاهای احتمالی مطلع نخواهید شد.
.TP
.BI "--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 گزارش می‌شوند).

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

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

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

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

هنگام استفاده از فیلد 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 برای دریافت فهرستی از پنجره‌ها استفاده کنید.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنما برای این دستور.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.TP
.BI "--to" 
نشانی نمونه kitty مورد نظر برای کنترل. متناظر با نشانی داده‌شده به نمونه kitty از طریق گزینه 
.B \-\-listen\-on
یا تنظیم 
.B listen_on
در 
.I kitty.conf
است. در صورت مشخص نشدن، متغیر محیطی 
.B KITTY_LISTEN_ON
بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند، یعنی تنها در صورتی کار خواهند کرد که این فرآیند درون یک پنجره kitty اجرا شود.
.TP
.BI "--password" 
رمز عبوری برای استفاده هنگام برقراری ارتباط با kitty. این باعث می‌شود kitty از کاربر برای انجام عمل مشخص‌شده اجازه بخواهد، مگر اینکه رمز عبور قبلاً پذیرفته شده باشد یا در 
.I kitty.conf
از پیش پیکربندی شده باشد. برای استفاده از رمز عبور خالی، گزینه 
.B \-\-use\-password
را روی always قرار دهید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که رمز عبور از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی از دایرکتوری پیکربندی kitty سنجیده می‌شوند. از \- برای خواندن از STDIN استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل num استفاده کنید. در صورتی استفاده می‌شود که هیچ 
.B \-\-password
ارائه نشده باشد. پیش‌فرض بررسی فایل 
.I rc\-pass
در دایرکتوری پیکربندی kitty است.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام متغیر محیطی برای خواندن رمز عبور از آن. در صورتی استفاده می‌شود که گزینه 
.B \-\-password\-file
ارائه نشده باشد. پیش‌فرض بررسی متغیر محیطی 
.B KITTY_RC_PASSWORD
است.
.TP
.BI "--use-password" " [=if\-available]"
اگر هیچ رمز عبوری در دسترس نباشد، kitty معمولاً فقط دستور کنترل از راه دور را بدون رمز عبور ارسال می‌کند. از این گزینه می‌توان برای اجبار به استفاده همیشگی یا هرگز استفاده نکردن از رمز عبور ارائه‌شده استفاده کرد. اگر روی always تنظیم شود و رمز عبوری ارائه نشده باشد، از رمز عبور خالی استفاده می‌شود.

انتخاب‌ها: if-available, always, never