.TH XTRLOCK 1
.SH "نام (NAME)"
xtrlock \- قفل کردن نمایشگر X تا زمان وارد کردن گذرواژه، با قابل مشاهده ماندن پنجره‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B xtrlock [-b] [-f] [-F]
.SH "توضیحات (DESCRIPTION)"
دستور
.B xtrlock
سرور X را تا زمانی که کاربر گذرواژه خود را از صفحه‌کلید وارد کند قفل می‌کند.

هنگامی که
.B xtrlock
در حال اجرا است، کنترل موشواره و صفحه‌کلید در دست گرفته می‌شود و مکان‌نمای موشواره به شکل یک قفل درمی‌آید. خروجی نمایش داده‌شده توسط برنامه‌های X و پنجره‌هایی که توسط کلاینت‌های جدید X باز می‌شوند، همچنان قابل مشاهده باقی می‌مانند و هر خروجی جدید به‌طور عادی نمایش داده می‌شود.

پس از تایپ گذرواژه توسط کاربر و به دنبال آن فشردن کلید Enter یا Newline، کنترل موشواره و صفحه‌کلید بازگردانده می‌شود. اگر گذرواژه نادرستی وارد شود، زنگ سیستم (bell) به صدا درمی‌آید. فشردن کلید Backspace یا Delete یک نویسه از گذرواژه واردشده را پاک می‌کند؛ فشردن Escape یا Clear تمام آنچه را که وارد شده است پاک می‌سازد.

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

محافظ صفحه (screen saver) سرور X به عملکرد عادی خود ادامه می‌دهد؛ در صورت فعال شدن آن، نمایشگر را می‌توان با روش‌های معمول مانند فشردن یک کلید (برای نمونه Shift) یا حرکت دادن موشواره بازیابی کرد.
.SH "هشدار (WARNING)"
به دلیل محدودیت‌های پروتکل X11، در صورت اجرا در یک محیط رومیزی مبتنی بر Wayland، دستور xtrlock قادر نخواهد بود تمام رویدادهای صفحه‌کلید و موشواره را رهگیری کند. در این شرایط، برنامه‌هایی که از پروتکل «سنتی» X11 استفاده می‌کنند قفل خواهند شد، در حالی که برنامه‌های پشتیبانی‌کننده از Wayland همچنان قابل تعامل باقی می‌مانند، حتی زمانی که xtrlock در حال اجرا است. همچنین ممکن است برخی میان‌برهای صفحه‌کلید در زمان قفل بودن نمایشگر به کار خود ادامه دهند.

در صورت شناسایی چنین محیطی، هشداری نمایش داده می‌شود. برای راه‌حل جایگزین، لطفاً
.BR swaylock (1)
یا موارد مشابه را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fR
علاوه بر نمایش تصویر قفل، صفحه را نیز خالی (سیاه) می‌کند.
.TP
\fB\-f\fR
پس از تکمیل قفل‌گذاری، فرایند فرزند می‌سازد (انشعاب یا fork) و وضعیت موفقیت‌آمیز را از فرایند والد بازمی‌گرداند.
.TP
\fB\-F\fR
قفل کردن اجباری؛ برای نمونه در حالتی که هیچ گذرواژه‌ای تنظیم نشده است.
.SH "منابع و پیکربندی X (X RESOURCES, CONFIGURATION)"
هیچ‌کدام.
.SH "گزارش باگ‌ها (BUGS)"
دستگاه‌های ورودی دیگر به جز صفحه‌کلید و موشواره غیرفعال نمی‌شوند.

زمان‌های وقفه، نگاره‌های بیتی و رنگ نشانگر موشواره قابل تغییر نیستند.
.SH "همچنین ببینید (SEE ALSO)"
.BR X "(1)، مستندات Xlib."
.SH "نویسندگان (AUTHORS)"
Ian Jackson <ian@chiark.greenend.org.uk>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(C 1993, 1994 متعلق به Ian Jackson.

اجازه‌نامه استفاده، رونوشت‌برداری، تغییر و توزیع این نرم‌افزار و مستندات آن بر اساس شرایط پروانه عمومی همگانی گنو (GNU General Public License)، نسخه ۲ یا بالاتر، منتشرشده توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) اعطا می‌شود.

این برنامه به این امید توزیع شده است که مفید باشد، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای هدفی خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.