.\" Man page generated from reStructuredText .\" by the Docutils 0.22.3 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "xss-lock" "1" "November 2018" "" .SH "نام (NAME)" xss\-lock \- استفاده از یک قفل‌کننده بیرونی به‌عنوان محافظ صفحه در X .SH "خلاصه دستور (SYNOPSIS)" .nf xss\-lock [\-n \fInotify_cmd\fP] [\-s \fIsession ID\fP] [\-\-ignore\-sleep] [\-l] [\-v|\-q] [\-\-] \fIlocker\fP [\fIarg\fP] ... xss\-lock \-\-help|\-\-version .fi .sp .SH "توضیحات (DESCRIPTION)" .sp دستور \fBxss\-lock\fP برنامه قفل‌کننده دلخواه شما را به افزونه محافظ صفحه MIT برای سامانه X و همچنین مدیر ورود systemd متصل می‌کند. .sp دستور \fBxss\-lock\fP باید در نشست گرافیکی (xsession) شما اجرا شود، خواه با راه‌اندازی آن در \fI\&.xsessionrc\fP یا با روش‌های خاص دیگر نشست (مانند پیکربندی مدیر پنجره). توجه داشته باشید که \fBxss\-lock\fP در پیش‌زمینه اجرا می‌شود (یعنی فورک نمی‌کند) و بنابراین ممکن است نیاز باشد آن را در پس‌زمینه اجرا کنید (برای مثال با اجرای آن به همراه \fI&\fP). .sp برنامه قفل‌کننده در پاسخ به رویدادهای ناشی از این دو منبع اجرا می‌شود: .INDENT 0.0 .IP \(bu 2 سیگنال‌های سامانه X هنگامی که فعال‌سازی محافظ صفحه اجبار شود یا پس از دوره‌ای از عدم فعالیت کاربر (همان‌طور که با \fBxset s TIMEOUT\fP تنظیم شده است). در حالت دوم، در صورت مشخص بودن دستور اطلاع‌رسان (notifier)، ابتدا آن دستور اجرا می‌شود. .IP \(bu 2 مدیر ورود نیز می‌تواند درخواست قفل شدن نشست را بدهد؛ برای مثال در نتیجه اجرای \fBloginctl lock\-sessions\fP. علاوه بر این، \fBxss\-lock\fP از منطق بازدارندگی (inhibition) برای قفل کردن صفحه پیش از به خواب رفتن سیستم استفاده می‌کند. .UNINDENT .sp دستور \fBxss\-lock\fP منتظر خروج برنامه قفل‌کننده می‌ماند \-\- یا هنگامی که غیرفعال‌سازی محافظ صفحه یا باز کردن قفل نشست اجباری شود، آن را متوقف می‌کند (kill) \-\- بنابراین دستور نباید فورک کند. .sp همچنین، \fBxss\-lock\fP نشانه بیکاری (idle hint) را در نشست ورود مدیریت می‌کند. وضعیت بیکاری نشست مستقیماً به فعالیت کاربر گزارش‌شده توسط سامانه X متصل است (به‌جز زمانی که اطلاع‌رسان پیش از قفل کردن صفحه اجرا می‌شود). هنگامی که همه نشست‌ها بیکار باشند، مدیر ورود می‌تواند پس از یک تاخیر از پیش پیکربندی‌شده اقدام لازم (مانند معلق‌سازی یا ساسپند کردن سیستم) را انجام دهد. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .BI \-n \ cmd\fR,\fB \ \-\-notifier\fB= cmd اجرای \fIcmd\fP هنگام فعال شدن محافظ صفحه به دلیل عدم فعالیت کاربر. نقل‌قول به سبک شل (Shell\-style quoting) پشتیبانی می‌شود. هنگامی که سامانه X فعالیت کاربر را گزارش کند اطلاع‌رسان با سیگنال SIGHUP و هنگامی که قفل‌کننده شروع به کار کند با سیگنال SIGTERM متوقف می‌شود. قفل‌کننده پس از اولین چرخه محافظ صفحه، همان‌طور که با \fBxset s TIMEOUT CYCLE\fP تنظیم شده است، اجرا می‌شود. اگر زمان چرخه محافظ صفحه 0 باشد، اطلاع‌رسان اجرا نشده و قفل‌کننده بلافاصله پس از اتمام مهلت (timeout) شروع می‌شود. .sp از این گزینه می‌توان برای اجرای شمارش معکوس یا (در لپ‌تاپ‌ها) تاریک کردن (dim) صفحه پیش از قفل کردن استفاده کرد. برای مشاهده یک مثال، اسکریپت \fI/usr/share/doc/xss\-lock/dim\-screen.sh\fP را ببینید. .sp برای مثالی از نحوه استفاده از دو سیگنال مختلف دریافت شده توسط دستور اطلاع‌رسان، اسکریپت \fI/usr/share/doc/xss\-lock/dim\-screen2.sh\fP را ببینید. .TP .B \-l\fP,\fB \-\-transfer\-sleep\-lock اجازه به فرآیند قفل‌کننده برای به ارث بردن توصیف‌گر فایل (file descriptor) که نمایانگر قفل تاخیر دریافت شده از مدیر ورود است. اندیس مربوطه در متغیر محیطی \fB$XSS_SLEEP_LOCK_FD\fP در دسترس قرار خواهد گرفت؛ این متغیر تنها در صورتی تنظیم می‌شود که دلیل قفل کردن، آماده شدن سیستم برای رفتن به حالت خواب (sleep) باشد. قفل‌کننده باید این توصیف‌گر فایل را ببندد تا نشان دهد آماده است. .sp اسکریپت‌های نمونه‌ای که قفل‌کننده‌های موجود را کپسوله‌سازی می‌کنند در مسیر \fI/usr/share/doc/xss\-lock/transfer\-sleep\-lock\-*.sh\fP در دسترس هستند. .TP .BI \-s \ ID\fR,\fB \ \-\-session\fB= ID استفاده از شناسه نشست \fBID\fP به‌جای نشست جاری. .sp مثال: \fI/usr/share/doc/xss\-lock/xss\-lock.service\fP\&. .TP .B \-\-ignore\-sleep عدم قفل کردن هنگام تعلیق/خواب زمستانی (suspend/hibernate). .TP .B \-q\fP,\fB \-\-quiet نمایش فقط خطاهای مرگبار (fatal). .TP .B \-v\fP,\fB \-\-verbose نمایش پیام‌های بیشتر. .TP .B \-h\fP,\fB \-\-help چاپ پیام راهنما و خروج. .TP .B \-\-version چاپ شماره نسخه و خروج. .UNINDENT .SH "سیگنال‌ها (SIGNALS)" .INDENT 0.0 .TP .B SIGHUP با دریافت این سیگنال، \fBxss\-lock\fP محافظ صفحه را بازنشانی می‌کند، اما فقط در صورتی که صفحه در آن لحظه قفل نباشد (برخلاف \fBxset s reset\fP). .sp این موضوع می‌تواند در پیکربندی MPlayer به‌عنوان راهکاری برای رفع ناتوانی MPlayer در راه‌اندازی مجدد زمان‌سنج محافظ صفحه هنگام توقف موقت (pause) پخش استفاده شود: .INDENT 7.0 .INDENT 3.5 .sp .EX heartbeat\-cmd=\(dqkillall \-HUP xss\-lock\(dq stop\-xscreensaver=false .EE .UNINDENT .UNINDENT .sp \fBتوجه:\fP .INDENT 7.0 .INDENT 3.5 این کار در mplayer2 (و mpv) بی‌تاثیر است، زیرا تپش قلب (heartbeat) آن هنگام توقف موقت پخش همچنان ادامه دارد. .UNINDENT .UNINDENT .TP .B SIGINT/SIGTERM با دریافت این سیگنال، \fBxss\-lock\fP پس از متوقف کردن (kill) هرگونه اطلاع‌رسان یا قفل‌کننده در حال اجرا خارج می‌شود. .UNINDENT .SH "نکات (NOTES)" .INDENT 0.0 .IP \(bu 2 برخی از برنامه‌ها به اسکریپت \fBxdg\-screensaver\fP از بسته xdg\-utils وابسته هستند، که از \fBxset s off\fP و \fBxset s default\fP به ترتیب برای تعلیق و ازسرگیری محافظ صفحه استفاده می‌کند. دستور دوم، مهلت زمانی و چرخه را به پیش‌فرض‌های کارساز (سرور) بازنشانی می‌کند (دستور \fBxset s on\fP در عوض از یک پیش‌فرض هاردکد شده استفاده می‌کند)، بنابراین این عملکرد تنها در صورتی مطلوب است که از تنظیمات کارساز راضی باشید (یا بتوانید آن را کنترل کنید). .sp برای اصلاح عملیات ازسرگیری در این اسکریپت (یا یک نسخه در \fI~/bin\fP با اولویت بالاتر از نسخه اصلی در \fB$PATH\fP)، یا \fBon\fP را با مهلت زمانی و چرخه دلخواه خود جایگزین کنید، یا با وصله کردن (patch) اسکریپت برای اجرای حلقه تعلیق همانند سایر محافظ‌های صفحه با استفاده از \fI/usr/share/doc/xss\-lock/xdg\-screensaver.patch\fP از مقادیر زمانی هاردکد شده اجتناب نمایید. .UNINDENT .SH "مثال‌ها (EXAMPLES)" .INDENT 0.0 .IP \(bu 2 استفاده به همراه \fBxscreensaver\fP از طریق \fI\&.xsessionrc\fP (بنابراین در پس‌زمینه): .INDENT 2.0 .INDENT 3.5 .sp .EX xscreensaver & xss\-lock \-\- xscreensaver\-command \-\-lock & .EE .UNINDENT .UNINDENT .IP \(bu 2 اجرای \fBxlock\fP پس از ده دقیقه عدم فعالیت کاربر: .INDENT 2.0 .INDENT 3.5 .sp .EX xset s 600 xss\-lock xlock +resetsaver .EE .UNINDENT .UNINDENT .sp بدون \fB+resetsaver\fP، برنامه \fBxlock\fP هنگام راه‌اندازی بازنشانی محافظ صفحه را تحمیل می‌کند، و در نتیجه به \fBxss\-lock\fP اعلام می‌کند که فوراً \fBxlock\fP را مجدداً متوقف کند. .IP \(bu 2 تاریک کردن صفحه پس از سه دقیقه عدم فعالیت، و قفل کردن صفحه دو دقیقه پس از آن با استفاده از \fBi3lock\fP: .INDENT 2.0 .INDENT 3.5 .sp .EX xset s 180 120 xss\-lock \-n dim\-screen.sh \-\- i3lock \-n .EE .UNINDENT .UNINDENT .sp \fBتوجه:\fP .INDENT 2.0 .INDENT 3.5 اسکریپتی برای استفاده از حالت فورک \fBi3lock\fP به همراه گزینه \fB\-\-transfer\-sleep\-lock\fP ارائه شده است (به بخش‌های بالا مراجعه کنید). .UNINDENT .UNINDENT .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fBloginctl\fP(1), \fBxset\fP(1), \fBsystemd\-logind.service\fP(8) .SH "نویسندگان (AUTHORS)" Raymond Wagenmaker .\" End of generated man page.