'\" t
.TH "SYSTEMD\-INHIBIT" "1" "" "systemd 261.2" "systemd-inhibit"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-inhibit \- اجرای یک برنامه با اعمال قفل بازدارنده (inhibition lock)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-inhibit\fR\ 'u
\fBsystemd\-inhibit\fR [OPTIONS...] [COMMAND] [ARGUMENTS...]
.HP \w'\fBsystemd\-inhibit\fR\ 'u
\fBsystemd\-inhibit\fR [OPTIONS...] [\-\-list]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-inhibit\fR
می‌تواند برای اجرای یک برنامه با در اختیار گرفتن یک قفل بازدارنده خاموش‌شدن (shutdown)، خواب (sleep) یا بی‌کاری (idle) استفاده شود\&. این قفل پیش از اجرای خط فرمان مشخص‌شده اخذ شده و پس از اتمام آن آزاد می‌گردد\&.
.PP
قفل‌های بازدارنده (Inhibitor locks) می‌توانند برای مسدود کردن یا به تاخیر انداختن درخواست‌های خواب و خاموش‌شدن سیستم از سوی کاربر و همچنین مدیریت خودکار بی‌کاری توسط سیستم‌عامل استفاده شوند\&. این ویژگی برای جلوگیری از تعلیق (suspend) سیستم هنگام رایت کردن یک دیسک نوری یا عملیات مشابهی که نباید متوقف شوند مفید است\&.
.PP
برای اطلاعات بیشتر
\m[blue]\fBقفل‌های بازدارنده (Inhibitor Locks)\fR\m[]\&\s-2\u[1]\d\s+2
را ببینید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-what=\fR
.RS 4
فهرستی از یک یا چند عملیات جداشده با دونقطه (:) را برای بازداری دریافت می‌کند:
"shutdown"،
"sleep"،
"idle"،
"handle\-power\-key"،
"handle\-reboot\-key"،
"handle\-suspend\-key"،
"handle\-hibernate\-key"،
"handle\-lid\-switch"، که به ترتیب برای بازداری از راه‌اندازی مجدد/خاموش کردن/توقف/kexec/راه‌اندازی مجدد نرم (soft\-reboot)، تعلیق/خواب زمستانی، تشخیص خودکار بی‌کاری، یا مدیریت سطح پایین کلیدهای پاور/راه‌اندازی مجدد/خواب و سوییچ درب لپ‌تاپ به کار می‌روند\&. در صورت حذف، مقدار پیش‌فرض آن
"idle:sleep:shutdown"
است\&.
.RE
.PP
\fB\-\-who=\fR
.RS 4
یک رشته توصیفی کوتاه و خوانا برای انسان برای برنامه‌ای که قفل را می‌گیرد دریافت می‌کند\&. اگر ارسال نشود، به طور پیش‌فرض روی رشته خط فرمان تنظیم می‌شود\&.
.RE
.PP
\fB\-\-why=\fR
.RS 4
یک رشته توصیفی کوتاه و خوانا برای انسان به عنوان دلیل گرفتن قفل دریافت می‌کند\&. مقدار پیش‌فرض آن "Unknown reason" (دلیل نامشخص) است\&.
.RE
.PP
\fB\-\-mode=\fR
.RS 4
یکی از مقادیر
"block"،
"delay"
یا
"block\-weak"
را می‌پذیرد و نحوه اعمال قفل را توصیف می‌کند\&. اگر از
"block"
استفاده شود (پیش‌فرض)، قفل از هر یک از عملیات درخواست‌شده بدون محدودیت زمانی جلوگیری می‌کند، و تنها کاربران دارای امتیاز می‌توانند آن را نادیده بگیرند (لغو کنند)\&. نوع قفل بازدارنده
"block\-weak"
مشابه
"block"
است اما در برابر عملیات آغازشده توسط کلاینت‌های دارای امتیاز یا عملیات متعلق به همان کاربری که مالک قفل بازدارنده است اعمال نمی‌شود\&. اگر از
"delay"
استفاده شود، قفل تنها می‌تواند عملیات درخواستی را برای مدت محدودی به تاخیر بیندازد\&. اگر زمان به پایان برسد، قفل نادیده گرفته شده و عملیات اجرا می‌شود\&. این محدودیت زمانی را می‌توان در
\fBlogind.conf\fR(5)
تعیین کرد\&. توجه داشته باشید که
"delay"
تنها برای
"sleep"
و
"shutdown"
در دسترس است\&.
.RE
.PP
\fB\-\-list\fR
.RS 4
به جای گرفتن قفل، تمام قفل‌های بازدارنده فعال را فهرست می‌کند\&. این فهرست می‌تواند با استفاده از
\fB\-\-what=\fR،
\fB\-\-who=\fR،
\fB\-\-why=\fR
یا
\fB\-\-mode=\fR
فیلتر شود\&.
.RE
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
از کاربر برای احراز هویت در عملیات دارای امتیاز سوال نمی‌پرسد\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) منتقل (پایپ) نمی‌کند\&.
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
راهنما (legend)، یعنی سرستون‌ها و پاورقی همراه با نکات را چاپ نمی‌کند\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
خروجی را با قالب‌بندی JSON نمایش می‌دهد\&. یکی از مقادیر
"short"
(برای کوتاه‌ترین خروجی ممکن بدون هیچ‌گونه فاصله خالی اضافی یا شکست خط)،
"pretty"
(برای نسخه زیبای همان خروجی، همراه با تورفتگی و شکست خط) یا
"off"
(برای خاموش کردن خروجی JSON، مقدار پیش‌فرض) را می‌پذیرد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.PP
کد خروج برنامه اجراشده را بازمی‌گرداند\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n \{\
.RS 4
.\}
.nf
# systemd\-inhibit wodim foobar\&.iso
.fi
.if n \{\
.RE
.\}
.PP
این دستور ایمیج ISO
foobar\&.iso
را با استفاده از
\fBwodim\fR(1)
روی یک CD رایت می‌کند، و در حین انجام این کار از به خواب رفتن سیستم، خاموش شدن و بی‌کاری جلوگیری می‌نماید\&.
.SH "محیط (ENVIRONMENT)"
.PP
\fI$SYSTEMD_LOG_LEVEL\fR
.RS 4
حداکثر سطح ثبت وقایع (لاگ) برای پیام‌های منتشرشده (پیام‌های با سطح لاگ بالاتر، یعنی با اهمیت کمتر، نادیده گرفته خواهند شد)\&. فهرستی از مقادیر جداشده با کاما را می‌پذیرد\&. یک مقدار می‌تواند یکی از موارد زیر باشد (به ترتیب کاهش اهمیت):
\fBemerg\fR،
\fBalert\fR،
\fBcrit\fR،
\fBerr\fR،
\fBwarning\fR،
\fBnotice\fR،
\fBinfo\fR،
\fBdebug\fR
یا یک عدد صحیح در محدوده 0\&...7\&. برای اطلاعات بیشتر به
\fBsyslog\fR(3)
مراجعه کنید\&. هر مقدار می‌تواند به صورت اختیاری با یکی از پیشوندهای
\fBconsole\fR،
\fBsyslog\fR،
\fBkmsg\fR
یا
\fBjournal\fR
همراه با یک دو نقطه (:) مشخص شود تا حداکثر سطح لاگ را برای آن مقصد لاگ خاص تعیین کند (برای مثال
\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR
مشخص می‌کند که لاگ در سطح debug باشد مگر هنگام ثبت در کنسول که باید در سطح info باشد)\&. توجه داشته باشید که حداکثر سطح لاگ سراسری بر حداکثر سطوح لاگِ هر مقصد اولویت دارد\&.
.RE
.PP
\fI$SYSTEMD_LOG_COLOR\fR
.RS 4
یک مقدار بولی\&. اگر درست باشد، پیام‌های نوشته‌شده در tty بر اساس اولویت رنگی خواهند شد\&.
.sp
این تنظیم تنها زمانی مفید است که پیام‌ها مستقیماً در ترمینال نوشته شوند، زیرا
\fBjournalctl\fR(1)
و سایر ابزارهایی که لاگ‌ها را نمایش می‌دهند، خودشان پیام‌ها را بر اساس سطح لاگ رنگی می‌کنند\&.
.RE
.PP
\fI$SYSTEMD_LOG_TIME\fR
.RS 4
یک مقدار بولی\&. اگر درست باشد، پیام‌های لاگ کنسول با یک برچسب زمانی پیشوند می‌شوند\&.
.sp
این تنظیم تنها زمانی مفید است که پیام‌ها مستقیماً در ترمینال یا یک فایل نوشته شوند، زیرا
\fBjournalctl\fR(1)
و سایر ابزارهایی که لاگ‌ها را نمایش می‌دهند، خودشان برچسب‌های زمانی را بر اساس متادیتای ورودی پیوست می‌کنند\&.
.RE
.PP
\fI$SYSTEMD_LOG_LOCATION\fR
.RS 4
یک مقدار بولی\&. اگر درست باشد، پیام‌ها با نام فایل و شماره خط در کد منبع که پیام از آنجا سرچشمه گرفته است پیشوند می‌شوند\&.
.sp
توجه داشته باشید که مکان لاگ اغلب به عنوان متادیتا به ورودی‌های ژورنال ضمیمه می‌شود\&. با این حال، درج مستقیم آن در متن پیام می‌تواند هنگام اشکال‌زدایی برنامه‌ها راحت باشد\&.
.RE
.PP
\fI$SYSTEMD_LOG_TID\fR
.RS 4
یک مقدار بولی\&. اگر درست باشد، پیام‌ها با شناسه عددی ریسه جاری (TID) پیشوند می‌شوند\&.
.sp
توجه داشته باشید که این اطلاعات به هر حال به عنوان متادیتا به ورودی‌های ژورنال پیوست می‌شود\&. با این حال، درج مستقیم آن در متن پیام می‌تواند هنگام اشکال‌زدایی برنامه‌ها راحت باشد\&.
.RE
.PP
\fI$SYSTEMD_LOG_TARGET\fR
.RS 4
مقصد پیام‌های لاگ\&. یکی از مقادیر
\fBconsole\fR
(ثبت در tty متصل‌شده)،
\fBconsole\-prefixed\fR
(ثبت در tty متصل‌شده اما با پیشوندهایی که سطح لاگ و "facility" را مشخص می‌کنند، به
\fBsyslog\fR(3)
مراجعه کنید)،
\fBkmsg\fR
(ثبت در بافر لاگ چرخشی هسته)،
\fBjournal\fR
(ثبت در ژورنال)،
\fBjournal\-or\-kmsg\fR
(ثبت در ژورنال در صورت در دسترس بودن، و در غیر این صورت در kmsg)،
\fBauto\fR
(تعیین خودکار مقصد لاگ مناسب، پیش‌فرض)،
\fBnull\fR
(غیرفعال کردن خروجی لاگ)\&.
.RE
.PP
\fI$SYSTEMD_LOG_RATELIMIT_KMSG\fR
.RS 4
آیا محدودیت نرخ (ratelimit) روی kmsg اعمال شود یا خیر\&. یک مقدار بولی می‌پذیرد\&. پیش‌فرض
"true"
است\&. در صورت غیرفعال شدن، systemd پیام‌های نوشته‌شده در kmsg را محدود نمی‌کند\&.
.RE
.PP
\fI$SYSTEMD_PAGER\fR, \fI$PAGER\fR
.RS 4
صفحه‌بندی که هنگام مشخص نشدن
\fB\-\-no\-pager\fR
استفاده می‌شود\&. در صورت تنظیم بودن
\fI$SYSTEMD_PAGER\fR
از آن استفاده می‌شود؛ در غیر این صورت از
\fI$PAGER\fR
استفاده خواهد شد\&. اگر نه
\fI$SYSTEMD_PAGER\fR
و نه
\fI$PAGER\fR
تنظیم نشده باشند، مجموعه‌ای از پیاده‌سازی‌های شناخته‌شده صفحه‌بند به نوبت امتحان می‌شوند، از جمله
\fBless\fR(1)
و
\fBmore\fR(1)،
تا زمانی که یکی پیدا شود\&. اگر هیچ پیاده‌سازی صفحه‌بندی پیدا نشود، هیچ صفحه‌بندی فراخوانی نمی‌شود\&. تنظیم این متغیرهای محیطی روی یک رشته خالی یا مقدار
"cat"
معادل ارسال
\fB\-\-no\-pager\fR
است\&.
.sp
نکته: اگر
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد،
\fI$SYSTEMD_PAGER\fR
و
\fI$PAGER\fR
فقط برای غیرفعال کردن صفحه‌بند (با
"cat"
یا
"")
می‌توانند استفاده شوند، و در غیر این صورت نادیده گرفته می‌شوند\&.
.RE
.PP
\fI$SYSTEMD_LESS\fR
.RS 4
لغو گزینه‌های ارسالی به
\fBless\fR
(به طور پیش‌فرض
"FRSXMK")\&.
.sp
کاربران ممکن است بخواهند دو گزینه را به ویژه تغییر دهند:
.PP
\fBK\fR
.RS 4
این گزینه به صفحه‌بند دستور می‌دهد هنگام فشرده شدن
Ctrl+C
فوراً خارج شود\&. برای اینکه به
\fBless\fR
اجازه دهید خودش
Ctrl+C
را برای بازگشت به خط فرمان صفحه‌بند مدیریت کند، این گزینه را لغو کنید\&.
.sp
اگر مقدار
\fI$SYSTEMD_LESS\fR
شامل
"K"
نباشد، و صفحه‌بند فراخوانی‌شده
\fBless\fR
باشد،
Ctrl+C
توسط فایل اجرایی نادیده گرفته شده و باید توسط صفحه‌بند مدیریت شود\&.
.RE
.PP
\fBX\fR
.RS 4
این گزینه به صفحه‌بند دستور می‌دهد که رشته‌های مقداردهی اولیه و پایان‌دهی termcap را به ترمینال ارسال نکند\&. این گزینه به طور پیش‌فرض تنظیم شده است تا خروجی دستور حتی پس از خروج صفحه‌بند در ترمینال قابل مشاهده باقی بماند\&. با این حال، این امر مانع از عملکرد برخی قابلیت‌های صفحه‌بند می‌شود، به ویژه خروجی صفحه‌بندی‌شده را نمی‌توان با ماوس پیمایش (اسکرول) کرد\&.
.RE
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESS\fR
هیچ تاثیری برای فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.sp
برای توضیحات بیشتر به
\fBless\fR(1)
مراجعه کنید\&.
.RE
.PP
\fI$SYSTEMD_LESSCHARSET\fR
.RS 4
لغو مجموعه نویسه (charset) ارسالی به
\fBless\fR
(به طور پیش‌فرض
"utf\-8"،
اگر ترمینال فراخواننده به عنوان سازگار با UTF-8 تشخیص داده شود)\&.
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESSCHARSET\fR
هیچ تاثیری برای فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.RE
.PP
\fI$SYSTEMD_PAGERSECURE\fR
.RS 4
دستورات رایج صفحه‌بند مانند
\fBless\fR(1)،
علاوه بر «صفحه‌بندی»، یعنی پیمایش در خروجی، از باز کردن یا نوشتن در فایل‌های دیگر و اجرای دستورات دلخواه شل پشتیبانی می‌کنند\&. هنگامی که دستورات با امتیازات بالا، به عنوان مثال تحت
\fBsudo\fR(8)
یا
\fBpkexec\fR(1)
فراخوانی می‌شوند، صفحه‌بند به یک مرز امنیتی تبدیل می‌شود\&. باید دقت شود که تنها برنامه‌هایی با قابلیت‌های کاملاً محدود به عنوان صفحه‌بند استفاده شوند، و ویژگی‌های تعاملی ناخواسته مانند باز کردن یا ایجاد فایل‌های جدید یا شروع زیرفرایندها مجاز نباشند\&. «حالت امن» برای صفحه‌بند ممکن است همان‌طور که در زیر توضیح داده شده فعال شود،
\fIاگر صفحه‌بند از آن پشتیبانی کند\fR
(بیشتر صفحه‌بندها به شیوه‌ای نوشته نشده‌اند که این موضوع را در نظر بگیرند)\&. توصیه می‌شود یا صراحتاً «حالت امن» را فعال کنید یا با استفاده از
\fB\-\-no\-pager\fR
یا
\fIPAGER=cat\fR
هنگام اجازه دادن به کاربران غیرقابل اعتماد برای اجرای دستورات با امتیازات بالا، صفحه‌بند را کاملاً غیرفعال نمایید\&.
.sp
این گزینه یک آرگومان بولی می‌پذیرد\&. هنگامی که روی درست تنظیم شود، «حالت امن» صفحه‌بند فعال می‌شود\&. در «حالت امن»، هنگام فراخوانی صفحه‌بند
\fBLESSSECURE=1\fR
تنظیم خواهد شد، که به صفحه‌بند دستور می‌دهد دستوراتی را که فایل‌های جدید باز می‌کنند یا ایجاد می‌کنند یا زیرفرایندهای جدید آغاز می‌کنند غیرفعال کند\&. در حال حاضر فقط
\fBless\fR(1)
شناخته شده است که این متغیر را درک می‌کند و «حالت امن» را پیاده‌سازی می‌نماید\&.
.sp
هنگامی که روی نادرست تنظیم شود، هیچ محدودیتی بر صفحه‌بند اعمال نمی‌شود\&. تنظیم
\fISYSTEMD_PAGERSECURE=0\fR
یا حذف نکردن آن از متغیرهای محیطی به ارث رسیده ممکن است به کاربر اجازه دهد دستورات دلخواه را اجرا کند\&.
.sp
هنگامی که
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد، ابزارهای systemd تلاش می‌کنند تا به طور خودکار تشخیص دهند که آیا «حالت امن» باید فعال شود و آیا صفحه‌بند از آن پشتیبانی می‌کند یا خیر\&. اگر UID مؤثر با مالک نشست ورود یکسان نباشد، به
\fBgeteuid\fR(2)
و
\fBsd_pid_get_owner_uid\fR(3)
مراجعه کنید، یا هنگام اجرا تحت
\fBsudo\fR(8)
یا ابزارهای مشابه (\fI$SUDO_UID\fR
تنظیم شده باشد
\&\s-2\u[2]\d\s+2)\&.
در این موارد،
\fISYSTEMD_PAGERSECURE=1\fR
تنظیم می‌شود و صفحه‌بندهایی که پیاده‌سازی «حالت امن» در آن‌ها شناخته‌شده نیست اصلاً استفاده نخواهند شد\&. توجه داشته باشید که این تشخیص خودکار فقط متداول‌ترین سازوکارهای ارتقای امتیازات را پوشش می‌دهد و برای راحتی کار در نظر گرفته شده است\&. توصیه می‌شود صراحتاً
\fI$SYSTEMD_PAGERSECURE\fR
را تنظیم کرده یا صفحه‌بند را غیرفعال کنید\&.
.sp
توجه داشته باشید که اگر متغیرهای
\fI$SYSTEMD_PAGER\fR
یا
\fI$PAGER\fR
قرار است رعایت شوند، به جز برای غیرفعال کردن صفحه‌بند،
\fI$SYSTEMD_PAGERSECURE\fR
نیز باید تنظیم شده باشد\&.
.RE
.PP
\fI$SYSTEMD_COLORS\fR
.RS 4
یک آرگومان بولی، یا یک مقدار ویژه می‌پذیرد\&. به طور پیش‌فرض (تنظیم‌نشده)،
\fBsystemd\fR
و ابزارهای مرتبط در صورت امکان از رنگ‌ها در خروجی خود استفاده خواهند کرد\&. اگر
\fI$COLORTERM\fR
روی
"truecolor"
یا
"24bit"
تنظیم شده باشد، رنگ‌های 24 بیتی فعال می‌شوند، در غیر این صورت 256 رنگ، مگر اینکه
\fI$NO_COLOR\fR
یا
\fI$TERM\fR
نشان دهد رنگ‌ها غیرفعال هستند\&.
.PP
\fBtrue\fR
.RS 4
مشابه تنظیم‌نشده، با این تفاوت که
\fI$NO_COLOR\fR
نادیده گرفته می‌شود\&.
.RE
.PP
\fBfalse\fR
.RS 4
خروجی تک‌رنگ خواهد بود\&.
.RE
.PP
"16", "256", "24bit"
.RS 4
همیشه به ترتیب از رنگ‌های پایه ۱۶ تایی ANSI، ۲۵۶ رنگ، یا رنگ ۲۴ بیتی استفاده می‌کند\&.
.RE
.PP
"auto\-16", "auto\-256", "auto\-24bit"
.RS 4
از تعداد رنگ‌های مشخص‌شده، بر اساس
\fI$TERM\fR
و اینکه کنسول به چه چیزی متصل است، استفاده می‌کند\&.
.RE
.RE
.PP
\fI$SYSTEMD_URLIFY\fR
.RS 4
مقدار باید یک بولی باشد\&. کنترل می‌کند که آیا پیوندهای قابل کلیک در خروجی برای شبیه‌سازهای ترمینالی که از این قابلیت پشتیبانی می‌کنند تولید شود یا خیر\&. این گزینه را می‌توان برای لغو تصمیمی که
\fBsystemd\fR
بر اساس
\fI$TERM\fR
و سایر شرایط می‌گیرد تعیین کرد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBlogind.conf\fR(5)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
قفل‌های بازدارنده (Inhibitor Locks)
.RS 4
\%https://systemd.io/INHIBITOR_LOCKS
.RE
.IP " 2." 4
توصیه می‌شود سایر ابزارها نیز
\fI$SUDO_UID\fR
را در صورت لزوم تنظیم و بررسی کنند و با آن به عنوان یک رابط مشترک رفتار نمایند\&.