.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..

.TH i3lock 1 "JANUARY 2012" Linux "User Manuals"

.SH "نام (NAME)"
i3lock \- قفل‌کننده صفحه نمایش بهبودیافته

.SH "خلاصه دستور (SYNOPSIS)"
.B i3lock
.RB [\|\-v\|]
.RB [\|\-n\|]
.RB [\|\-b\|]
.RB [\|\-i
.IR image.png \|]
.RB [\|\-c
.IR color \|]
.RB [\|\-t\|]
.RB [\|\-p
.IR pointer\|]
.RB [\|\-u\|]
.RB [\|\-e\|]
.RB [\|\-f\|]

.SH "کاربرد پیشنهادی (RECOMMENDED USAGE)"
.RB xss-lock
.RB --transfer-sleep-lock
.RB --
.RB i3lock
.RB --nofork

استفاده از
.B xss-lock
تضمین می‌کند که صفحه نمایش شما پیش از رفتن رایانه به حالت تعلیق (suspend) قفل شود\&.

به ویژه، استفاده از فایل سرویس systemd کافی نیست، زیرا تعلیق را تا زمان قفل شدن صفحه به تعویق نمی‌اندازد\&.

.SH "توضیحات (DESCRIPTION)"
برنامه
.B i3lock
یک قفل‌کننده ساده صفحه نمایش مانند slock است\&. پس از شروع آن، یک صفحه سفید مشاهده خواهید کرد (می‌توانید رنگ یا یک تصویر را برای آن پیکربندی کنید)\&. با وارد کردن گذرواژه خود می‌توانید به صفحه دسکتاپ بازگردید\&.

.SH "بهبودها (IMPROVEMENTS)"

.IP \[bu] 2
برنامه i3lock فرآیند را فورک (انشعاب) می‌کند، بنابراین می‌توانید آن را با یک نام مستعار برای تعلیق در RAM ترکیب کنید (دستور "i3lock && echo mem > /sys/power/state" را اجرا کنید تا پس از بیدار شدن رایانه از تعلیق، صفحه قفل‌شده باشد)\&.
.IP \[bu]
می‌توانید یک رنگ پس‌زمینه یا یک تصویر PNG تعیین کنید که در زمان قفل بودن صفحه نمایش داده شود\&.
.IP \[bu]
می‌توانید تعیین کنید که آیا i3lock در صورت وارد کردن گذرواژه اشتباه بوق هشدار بزند یا خیر\&.
.IP \[bu]
برنامه i3lock از PAM استفاده می‌کند و بنابراین با LDAP و سایر سامانه‌ها سازگار است\&.


.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-v, \-\-version
نمایش نسخه برنامه
.B i3lock

.TP
.B \-n, \-\-nofork
پس از اجرا فرآیند را در پس‌زمینه فورک (انشعاب) نمی‌کند\&.

.TP
.B \-b, \-\-beep
فعال کردن بوق هشدار\&. مطمئن شوید زمانی که ممکن است دیگران را برنجانید (مانند باز کردن لپ‌تاپ در یک سخنرانی کسل‌کننده)، از این گزینه استفاده نکنید\&.

.TP
.B \-u, \-\-no-unlock-indicator
غیرفعال کردن نشانگر بازگشایی قفل\&. برنامه i3lock به طور پیش‌فرض پس از فشردن کلیدها یک نشانگر بازگشایی قفل را نشان می‌دهد\&. این بازخورد به ازای هر کلید فشرده‌شده نمایش داده می‌شود و وضعیت فعلی PAM را نشان می‌دهد (اینکه آیا گذرواژه شما در حال بررسی است یا اشتباه وارد شده است)\&.

.TP
.BI \-i\  path \fR,\ \fB\-\-image= path
نمایش تصویر PNG داده‌شده به جای یک صفحه خالی\&.

.TP
.BI \fB\-\-raw= format
تصویر داده‌شده توسط \-\-image را به جای PNG به صورت یک تصویر خام (raw) می‌خواند\&. آرگومان ورودی فرمت تصویر به صورت <width>x<height>:<pixfmt> است\&. فرمت‌های پیکسل پشتیبانی‌شده عبارتند از:
\(aqnative', \(aqrgb', \(aqxrgb', \(aqrgbx', \(aqbgr', \(aqxbgr' و \(aqbgrx'\&.
فرمت پیکسل "native" انتظار دارد پیکسل یک عدد صحیح ۳۲ بیتی (۴ بایتی) بر اساس ترتیب بایت محلی دستگاه باشد که ۸ بیت بالایی آن استفاده نمی‌شود\&. مقادیر قرمز، سبز و آبی در بیت‌های باقی‌مانده و به همان ترتیب ذخیره می‌شوند\&.

.BR مثال:
.Vb 6
\&	--raw=1920x1080:rgb
.Ve

.BR
می‌توانید از برنامه
.IR convert(1)
متعلق به ImageMagick برای ارسال تصاویر خام به i3lock استفاده کنید:

.BR
.Vb 6
\&	convert wallpaper.jpg RGB:- | i3lock --raw 3840x2160:rgb --image /dev/stdin
.Ve

این قابلیت به شما اجازه می‌دهد فرمت‌های گوناگون تصویر را بارگذاری کنید بدون آنکه لازم باشد i3lock صریحاً از هر یک پشتیبانی نماید\&.

.TP
.BI \-c\  rrggbb \fR,\ \fB\-\-color= rrggbb
تغییر رنگ صفحه به رنگ داده‌شده به جای سفید\&. رنگ باید در قالب ۳ بایتی rrggbb ارائه شود (مثلاً ff0000 قرمز است)\&.

.TP
.B \-t, \-\-tiling
اگر تصویری مشخص شده باشد (از طریق \-i)، تصویر را به صورت کاشی‌کاری در سراسر صفحه نمایش می‌دهد (در صورت پیکربندی چند مانیتور، تصویر در تمام نمایشگرها قابل مشاهده خواهد بود)\&.

.TP
.BI \-p\  win|default \fR,\ \fB\-\-pointer= win|default
اگر مقدار "default" را مشخص کنید،
.B i3lock
نشانگر ماوس را پنهان نمی‌کند\&. اگر "win" را تعیین کنید،
.B i3lock
یک نشانگر ویندوزی نمایش می‌دهد (که به شما امکان می‌دهد با قرار دادن تصویر دسکتاپ ویندوز به عنوان صفحه قفل، با دوستانتان شوخی کنید)\&.

.TP
.B \-e, \-\-ignore-empty-password
هنگامی که گذرواژه خالی وارد می‌شود، آن را اعتبارسنجی نمی‌کند\&. بدون این گزینه، گذرواژه خالی به PAM ارسال می‌شود و در صورت نامعتبر بودن، کاربر باید چند ثانیه پیش از تلاش مجدد صبر کند\&. این ویژگی زمانی مفید است که کلید XF86ScreenSaver برای به خواب رفتن لپ‌تاپ به کار رفته باشد یا سیستم با فشردن کلید Enter بیدار شود\&.

.TP
.B \-f, \-\-show-failed-attempts
نمایش تعداد تلاش‌های ناموفق، در صورت وجود\&.

.TP
.B \-k, \-\-show-keyboard-layout
نمایش چیدمان فعلی صفحه‌کلید\&.

.TP
.B \-\-debug
گزارش‌گیری اشکال‌زدایی (debug) را فعال می‌کند\&.
توجه داشته باشید که این گزینه گذرواژه واردشده برای احراز هویت را در خروجی استاندارد (stdout) ثبت می‌کند\&.

.SH "مدیریت مصرف انرژی (DPMS)"

گزینه \-d (\-\-dpms) در نسخه 2.8 از i3lock حذف شد\&. سناریوهای زیادی وجود داشت که به درستی پشتیبانی نمی‌شدند و باگ‌های فراوانی پیرامون این قابلیت وجود داشت\&. با این که قابلیت‌ها معمولاً از i3 و ابزارهای آن حذف نمی‌شوند، لازم دانستیم در این مورد استثنا قائل شویم\&.

کاربرانی که می‌خواهند DPMS تنها در زمان قفل بودن صفحه به صراحت فعال باشد، می‌توانند از یک اسکریپت واسط مانند زیر استفاده کنند:

.Vb 6
\&	#!/bin/sh
\&	revert() {
\&	  xset dpms 0 0 0
\&	}
\&	trap revert HUP INT TERM
\&	xset +dpms dpms 5 5 5
\&	i3lock -n
\&	revert
.Ve

گزینه \-I (\-\-inactivity-timeout=seconds) نیز حذف شد زیرا تنها در صورت وجود DPMS معنا داشت\&.

.SH "همچنین ببینید (SEE ALSO)"
.IR xss-lock(1)
\- اتصال i3lock به مدیر ورود systemd

.IR convert(1)
\- ارسال طیف وسیعی از فرمت‌های تصویر به i3lock

.SH "نویسندگان (AUTHORS)"
Michael Stapelberg <michael+i3lock at stapelberg dot de>