WAYLOCK(1) General Commands Manual WAYLOCK(1)

waylock - یک قفل‌کننده صفحه نمایش کوچک برای Wayland

waylock [گزینه‌ها]

برنامه waylock یک قفل‌کننده صفحه نمایش کوچک برای کامپوزیتورهای Wayland است که پروتکل ext-session-lock-v1 را پیاده‌سازی کرده‌اند. پروتکل ext-session-lock-v1 به طور چشمگیری نسبت به رویکردهای پیشین قفل صفحه در سمت کلاینت در Wayland پایدارتر و مستحکم‌تر است. نکته مهم این است که از کار افتادن (crash) قفل‌کننده صفحه باعث باز شدن قفل نشست نمی‌شود.

-h

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

-version

چاپ شماره نسخه و خروج.

-log-level [error|warning|info|debug]

تنظیم سطح گزارش‌گیری waylock. در سطح error، تنها خطاها ثبت می‌شوند. در سطح debug، همه‌چیز از جمله پیام‌های اشکال‌زدایی پرجزئیات ثبت می‌شود.

-fork-on-lock

رفتن به پس‌زمینه (fork) پس از قفل کردن نشست. این گزینه برای یکپارچه‌سازی با دیمن‌های مدیریت وضعیت بیکاری (idle) بدون ایجاد شرایط رقابتی (race condition) برای قفل کردن نشست پیش از تعلیق (suspend) مفید است. با این گزینه، waylock پس از قفل شدن نشست و زمانی که رفتن به تعلیق ایمن باشد خارج می‌شود.

-ready-fd fd

نوشتن یک نویسه خط جدید (newline) در توصیف‌کننده فایل fd (یک عدد) پس از قفل کردن و سپس بستن fd. این قابلیت زمانی کاربرد دارد که نیاز به اعلان قفل شدن بدون ایجاد فرآیند پس‌زمینه (fork-less) باشد؛ برای مثال، جهت ادغام با یک مدیر سرویس (service manager).

-ignore-empty-password

عدم ارسال گذرواژه‌های خالی به PAM برای اعتبارسنجی هنگام فشرده شدن کلید Enter. در عوض، هیچ کاری انجام نمی‌شود. این قابلیت برای نمونه هنگامی مفید است که از کلید Enter برای بیدار کردن رایانه از حالت خواب (sleep) استفاده می‌شود.

-init-color 0xRRGGBB

تنظیم رنگ اولیه. (پیش‌فرض: 0x002b36)

-input-color 0xRRGGBB

تنظیم رنگ مورد استفاده پس از ورودی. (پیش‌فرض: 0x6c71c4)

-input-alt-color 0xRRGGBB

تنظیم رنگ متناوب مورد استفاده پس از ورودی. (پیش‌فرض همان مقداری است که برای -input-color تنظیم شده است)

-fail-color 0xRRGGBB

تنظیم رنگ مورد استفاده هنگام شکست در احراز هویت. (پیش‌فرض: 0xdc322f)

برای قفل کردن نشست، برنامه اجرایی waylock را اجرا کنید. تمام نمایشگرها با رنگ -init-color پوشانده می‌شوند. تایپ کردن باعث تغییر رنگ به -input-color می‌گردد. در صورت تعیین -input-alt-color، رنگ تایپ بین این دو رنگ متناوب خواهد شد. فشردن کلید Esc یا Ctrl-U تمام ورودی فعلی را پاک می‌کند، در حالی که کلید Backspace آخرین کدپوینت (codepoint) یونیکد UTF-8 را حذف می‌کند.

برای باز کردن قفل نشست، گذرواژه خود را تایپ کرده و Enter را فشار دهید. اگر گذرواژه درست باشد، waylock قفل نشست را باز کرده و خارج می‌شود. در غیر این صورت، رنگ به -fail-color تغییر می‌کند و می‌توانید مجدداً تلاش کنید.

به منظور اجرای خودکار waylock پس از مدت معینی عدم فعالیت یا پیش از به خواب رفتن سیستم (sleep)، می‌توان از ابزار swayidle(1) یا برنامه‌ای مشابه استفاده کرد. برای جزئیات به صفحه راهنمای swayidle(1) مراجعه کنید.

نگه‌داری توسط Isaac Freund <mail@isaacfreund.com> با همکاری مشارکت‌کنندگان متن‌باز انجام می‌شود. برای اطلاعات بیشتر درباره توسعه waylock، نشانی https://codeberg.org/ifreund/waylock را ببینید.

pam(8), swayidle(1)

2026-05-09 https://codeberg.org/ifreund/waylock