.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "WAYLOCK" "1" "2026-05-09" "https://codeberg.org/ifreund/waylock" "General Commands Manual"
.PP
.SH "نام (NAME)"
.PP
waylock \- یک قفل‌کننده صفحه نمایش کوچک برای Wayland
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBwaylock\fR [\fIگزینه‌ها\fR]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه \fBwaylock\fR یک قفل‌کننده صفحه نمایش کوچک برای کامپوزیتورهای Wayland است که پروتکل \fBext-session-lock-v1\fR را پیاده‌سازی کرده‌اند.\& پروتکل \fBext-session-lock-v1\fR به طور چشمگیری نسبت به رویکردهای پیشین قفل صفحه در سمت کلاینت در Wayland پایدارتر و مستحکم‌تر است.\& نکته مهم این است که از کار افتادن (crash) قفل‌کننده صفحه باعث باز شدن قفل نشست نمی‌شود.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h\fR
.RS 4
چاپ پیام راهنما و خروج.\&
.PP
.RE
\fB-version\fR
.RS 4
چاپ شماره نسخه و خروج.\&
.PP
.RE
\fB-log-level\fR [\fBerror\fR|\fBwarning\fR|\fBinfo\fR|\fBdebug\fR]
.RS 4
تنظیم سطح گزارش‌گیری waylock.\& در سطح \fBerror\fR، تنها خطاها ثبت می‌شوند.\& در سطح \fBdebug\fR، همه‌چیز از جمله پیام‌های اشکال‌زدایی پرجزئیات ثبت می‌شود.\&
.PP
.RE
\fB-fork-on-lock\fR
.RS 4
رفتن به پس‌زمینه (fork) پس از قفل کردن نشست.\& این گزینه برای یکپارچه‌سازی با دیمن‌های مدیریت وضعیت بیکاری (idle) بدون ایجاد شرایط رقابتی (race condition) برای قفل کردن نشست پیش از تعلیق (suspend) مفید است.\& با این گزینه، waylock پس از قفل شدن نشست و زمانی که رفتن به تعلیق ایمن باشد خارج می‌شود.\&
.PP
.RE
\fB-ready-fd\fR \fIfd\fR
.RS 4
نوشتن یک نویسه خط جدید (newline) در توصیف‌کننده فایل \fIfd\fR (یک عدد) پس از قفل کردن و سپس بستن \fIfd\fR.\& این قابلیت زمانی کاربرد دارد که نیاز به اعلان قفل شدن بدون ایجاد فرآیند پس‌زمینه (fork-less) باشد؛ برای مثال، جهت ادغام با یک مدیر سرویس (service manager).\&
.PP
.RE
\fB-ignore-empty-password\fR
.RS 4
عدم ارسال گذرواژه‌های خالی به PAM برای اعتبارسنجی هنگام فشرده شدن کلید Enter.\& در عوض، هیچ کاری انجام نمی‌شود.\& این قابلیت برای نمونه هنگامی مفید است که از کلید Enter برای بیدار کردن رایانه از حالت خواب (sleep) استفاده می‌شود.\&
.PP
.RE
\fB-init-color\fR \fI0xRRGGBB\fR
.RS 4
تنظیم رنگ اولیه.\& (پیش‌فرض: 0x002b36)
.PP
.RE
\fB-input-color\fR \fI0xRRGGBB\fR
.RS 4
تنظیم رنگ مورد استفاده پس از ورودی.\& (پیش‌فرض: 0x6c71c4)
.PP
.RE
\fB-input-alt-color\fR \fI0xRRGGBB\fR
.RS 4
تنظیم رنگ متناوب مورد استفاده پس از ورودی.\& (پیش‌فرض همان مقداری است که برای \fB-input-color\fR تنظیم شده است)
.PP
.RE
\fB-fail-color\fR \fI0xRRGGBB\fR
.RS 4
تنظیم رنگ مورد استفاده هنگام شکست در احراز هویت.\& (پیش‌فرض: 0xdc322f)
.PP
.RE
.SH "نحوه استفاده (USAGE)"
.PP
برای قفل کردن نشست، برنامه اجرایی waylock را اجرا کنید.\& تمام نمایشگرها با رنگ \fB-init-color\fR پوشانده می‌شوند.\& تایپ کردن باعث تغییر رنگ به \fB-input-color\fR می‌گردد.\& در صورت تعیین \fB-input-alt-color\fR، رنگ تایپ بین این دو رنگ متناوب خواهد شد.\& فشردن کلید Esc یا Ctrl-U تمام ورودی فعلی را پاک می‌کند، در حالی که کلید Backspace آخرین کدپوینت (codepoint) یونیکد UTF-8 را حذف می‌کند.\&
.PP
برای باز کردن قفل نشست، گذرواژه خود را تایپ کرده و Enter را فشار دهید.\& اگر گذرواژه درست باشد، waylock قفل نشست را باز کرده و خارج می‌شود.\& در غیر این صورت، رنگ به \fB-fail-color\fR تغییر می‌کند و می‌توانید مجدداً تلاش کنید.\&
.PP
به منظور اجرای خودکار waylock پس از مدت معینی عدم فعالیت یا پیش از به خواب رفتن سیستم (sleep)، می‌توان از ابزار \fBswayidle\fR(1) یا برنامه‌ای مشابه استفاده کرد.\& برای جزئیات به صفحه راهنمای \fBswayidle\fR(1) مراجعه کنید.\&
.PP
.SH "نویسندگان (AUTHORS)"
.PP
نگه‌داری توسط Isaac Freund <mail@isaacfreund.com> با همکاری مشارکت‌کنندگان متن‌باز انجام می‌شود.\& برای اطلاعات بیشتر درباره توسعه waylock، نشانی https://codeberg.org/ifreund/waylock را ببینید.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpam\fR(8), \fBswayidle\fR(1)