WAYLOCK(1)                  General Commands Manual                 WAYLOCK(1)

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

خلاصه دستور (SYNOPSIS)
       waylock [گزینه‌ها]

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

گزینه‌ها (OPTIONS)
       -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)

نحوه استفاده (USAGE)
       برای قفل کردن نشست، برنامه اجرایی 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) مراجعه کنید.

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

همچنین ببینید (SEE ALSO)
       pam(8), swayidle(1)

https://codeberg.org/ifreund/waylock
                                  2026-05-09                        WAYLOCK(1)