نام (NAME)

swayidle - مدیر وضعیت بیکاری برای Wayland

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

swayidle [options] [events...]

گزینه‌ها (OPTIONS)

-C <path>

فایل پیکربندی مورد استفاده. به‌طور پیش‌فرض، مسیرهای زیر با ترتیب مشخص‌شده بررسی می‌شوند: $XDG_CONFIG_HOME/swayidle/config و $HOME/.swayidle/config. مدخل‌های فایل پیکربندی رویدادهایی هستند که در بخش «رویدادها (EVENTS)» توضیح داده شده‌اند. مشخص کردن رویدادها در پیکربندی و به عنوان آرگومان با یکدیگر مانعة‌الجمع نیستند.

-h

نمایش پیام راهنما و خروج.

-d

فعال‌سازی خروجی اشکال‌زدایی (debug).

-w

انتظار برای اتمام اجرای دستور پیش از ادامه دادن؛ برای اطمینان از این‌که دستور before-sleep پیش از به خواب رفتن سیستم به پایان رسیده باشد مفید است.

نکته: استفاده از این گزینه باعث می‌شود swayidle تا زمان پایان یافتن دستور متوقف (مسدود) بماند.

-S <seat-name>

مشخص کردن seat مورد استفاده. به‌طور پیش‌فرض، اگر نامی تعیین نشده باشد، یک seat دلخواه انتخاب خواهد شد.

توضیحات (DESCRIPTION)

برنامهٔ swayidle به فعالیت‌های بیکاری در کامپوزیتور Wayland شما گوش فرا می‌دهد و با وقوع رویدادهای گوناگونِ مرتبط با بیکاری، وظایفی را اجرا می‌کند. شما می‌توانید هر تعداد رویداد را در خط فرمان و در فایل پیکربندی مشخص کنید.

رویدادها (EVENTS)

timeout <timeout> <timeout command> [resume <resume command>]

اگر برای مدت <timeout> ثانیه فعالیتی نباشد، دستور timeout command را اجرا می‌کند.

اگر عبارت "resume <resume command>" را مشخص کنید، هنگام شروع مجدد فعالیت، دستور resume command اجرا خواهد شد.

before-sleep <command>

اگر همراه با پشتیبانی از systemd ساخته شده باشد، دستور command را پیش از آنکه systemd رایانه را به حالت خواب ببرد اجرا می‌کند.

نکته: این ویژگی به خواب رفتن رایانه را تنها تا سقف تعیین‌شده توسط گزینهٔ InhibitDelayMaxSec در logind.conf(5) به تعویق می‌اندازد. دستوری که تا آن هنگام تمام نشده باشد، پس از بازگشت از حالت خواب به اجرای خود ادامه خواهد داد.

after-resume <command>

اگر همراه با پشتیبانی از systemd ساخته شده باشد، دستور command را پس از آنکه logind سیگنال بازگشت رایانه از خواب را ارسال کرد اجرا می‌کند.

lock <command>

اگر همراه با پشتیبانی از systemd ساخته شده باشد، هنگامی که logind سیگنال قفل شدن نشست (session) را ارسال کند، دستور command را اجرا می‌کند.

unlock <command>

اگر همراه با پشتیبانی از systemd ساخته شده باشد، هنگامی که logind سیگنال باز شدن قفل نشست (session) را ارسال کند، دستور command را اجرا می‌کند.

idlehint <timeout>

اگر همراه با پشتیبانی از systemd ساخته شده باشد، مقدار IdleHint را پس از <timeout> ثانیه به گونه‌ای تنظیم می‌کند که نشان‌دهندهٔ یک نشست بیکار در logind/elogind باشد. افزودن یک رویداد idlehint همچنین باعث می‌شود swayidle در هنگام اجرا، بازگشت به کار، باز شدن قفل و غیره SetIdleHint(false) را فراخوانی کند.

تمامی دستورها در یک پوسته (shell) اجرا می‌شوند.

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

برنامهٔ swayidle به سیگنال‌های زیر پاسخ می‌دهد:

SIGTERM, SIGINT

تمام دستورهای معوقهٔ resume را اجرا می‌کند. پس از پایان، swayidle خاتمه می‌یابد.

SIGUSR1

بلافاصله وارد وضعیت بیکاری (idle) می‌شود.

مثال‌ها (EXAMPLES)

swayidle -w 	timeout 300 ´swaylock -f -c 000000´ 	timeout 600 ´swaymsg "output * power off"´ 		resume ´swaymsg "output * power on"´ 	before-sleep ´swaylock -f -c 000000´

این دستور پس از ۳۰۰ ثانیه عدم فعالیت، صفحهٔ شما را قفل می‌کند، سپس با گذشت ۳۰۰ ثانیه دیگر نمایشگرها را خاموش می‌کند، و در صورت بازگشت فعالیت، صفحه‌نمایش‌ها را دوباره روشن می‌سازد. همچنین پیش از رفتن رایانه به حالت خواب، صفحهٔ شما را قفل خواهد کرد.

برای اطمینان از این‌که swayidle پیش از آزادسازی قفل مهار (inhibition lock) منتظر می‌ماند تا swaylock صفحه را قفل کند، از گزینهٔ -w در swayidle و گزینهٔ -f در swaylock استفاده شده است.

نویسندگان (AUTHORS)

نگه‌داری‌شده توسط Drew DeVault <sir@cmpwn.com> با همراهی سایر مشارکت‌کنندگان متن‌باز. برای اطلاعات بیشتر دربارهٔ توسعهٔ swayidle، به https://github.com/swaywm/swayidle مراجعه کنید.

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

sway(5) swaymsg(1) sway-input(5) sway-output(5) sway-bar(5) loginctl(1)