نام (NAME)

kitten-@-run - اجرای برنامه در کامپیوتری که kitty روی آن در حال اجراست و دریافت خروجی آن

نحوه استفاده (USAGE)

kitten @ run CMD ...

توضیحات (DESCRIPTION)

اجرای برنامه مشخص‌شده در کامپیوتری که kitty روی آن در حال اجراست. هنگامی که STDIN یک TTY نباشد، به عنوان STDIN برنامه به آن ارسال می‌شود. خروجی‌های STDOUT و STDERR از برنامه به اینجا هدایت می‌شوند. وضعیت خروج این فراخوانی، همان وضعیت خروج برنامه اجراشده خواهد بود. اگر می‌خواهید صرفاً برنامه‌ای را بدون انتظار برای پاسخ اجرا کنید، به جای آن از @ launch --type=background استفاده کنید.

گزینه‌ها (OPTIONS)

--env

متغیرهای محیطی برای تنظیم در فرآیند فرزند. می‌توان این گزینه را چندین بار برای تنظیم متغیرهای محیطی مختلف مشخص کرد. ساختار: name=value. استفاده از name= مقدار را به رشته خالی تنظیم می‌کند و صرفاً name متغیر محیطی را حذف خواهد کرد.

--allow-remote-control [=no]

برنامه اجراشده دارای دسترسی برای اجرای دستورات کنترل از راه دور در kitty خواهد بود.

--remote-control-password

محدود کردن عملیاتی که کنترل از راه دور مجاز به انجام آن‌ها است. این گزینه مانند remote_control_password عمل می‌کند. می‌توانید یک گذرواژه و فهرستی از عملیات‌ها را دقیقاً مانند remote_control_password مشخص کنید. برای مثال:

--remote-control-password '"my passphrase" get-* set-colors'

این گذرواژه تنها برای این پنجره معتبر خواهد بود. توجه داشته باشید که هر گذرواژه‌ای که برای remote_control_password در kitty.conf تعریف کرده‌اید نیز همچنان معتبر است. می‌توانید با استفاده از همان گذرواژه در اینجا، آن‌ها را بازنویسی کنید. همچنین می‌توانید تمام گذرواژه‌های سراسری remote_control_password را برای این پنجره با دستور زیر غیرفعال کنید:

--remote-control-password '!'

این گزینه تنها در صورتی اثرگذار است که --allow-remote-control نیز مشخص شده باشد. می‌توان این گزینه را چندین بار برای ایجاد چندین گذرواژه مشخص کرد. این گزینه در نسخه 0.26.0 به kitty اضافه شد.

--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