'\" t
.TH "SYSTEMCTL" "1" "" "systemd 257.13" "systemctl"
.\" -----------------------------------------------------------------
.\" * 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)"
systemctl \- کنترل و مدیریت سرویس\(hyها و سیستم در systemd
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemctl\fR\ 'u
\fBsystemctl\fR [\fIگزینه‌ها\fR...] \fIدستور\fR [\fIواحد\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
از
\fBsystemctl\fR
می\(hyتوان برای بررسی و کنترل وضعیت مدیر سیستم و سرویس\(hyهای
"systemd"
استفاده کرد\&. لطفاً برای آشنایی با مفاهیم پایه و عملکردهایی که این ابزار مدیریت می\(hyکند، به
\fBsystemd\fR(1)
مراجعه فرمایید\&.
.SH "دستورات (COMMANDS)"
.PP
دستورات زیر پشتیبانی می\(hyشوند:
.SS "دستورات واحدها (بررسی و تغییر)"
.PP
\fBlist\-units\fR [\fIPATTERN\fR\&...]
.RS 4
واحدهایی را که
\fBsystemd\fR
در حال حاضر در حافظه دارد فهرست می\(hyکند\&. این شامل واحدهایی است که مستقیماً یا از طریق وابستگی ارجاع داده شده\(hyاند، واحدهایی که توسط برنامه\(hyها به صورت نرم\(hyافزاری سنجاق (pin) شده\(hyاند، یا واحدهایی که در گذشته فعال بوده و با شکست مواجه شده\(hyاند\&. به طور پیش\(hyفرض، فقط واحدهایی که فعال هستند، کارهای معلق دارند یا ناموفق بوده\(hyاند نشان داده می\(hyشوند؛ این رفتار با گزینه
\fB\-\-all\fR
قابل تغییر است\&. در صورت مشخص شدن یک یا چند
\fIPATTERN\fR،
تنها واحدهای منطبق با یکی از آن\(hyها نمایش داده می\(hyشوند\&. واحدهای نمایش\(hyداده\(hyشده در صورت تعیین گزینه\(hyهای
\fB\-\-type=\fR
و
\fB\-\-state=\fR
به صورت اضافی فیلتر می\(hyشوند\&.
.sp
توجه داشته باشید که این دستور الگوهای واحد (unit templates) را نمایش نمی\(hyدهد، بلکه فقط نمونه\(hyهای الگوهای واحد را نشان می\(hyدهد\&. الگوهای واحدی که نمونه\(hyسازی نشده\(hyاند قابل اجرا نیستند و بنابراین هرگز در خروجی این دستور ظاهر نخواهند شد\&. به طور خاص این بدان معناست که
foo@\&.service
هرگز در این فهرست نمایش داده نخواهد شد \(em مگر اینکه نمونه\(hyسازی شده باشد، مثلاً به عنوان
foo@bar\&.service\&.
برای فهرست کردن فایل\(hyهای الگوی واحد نصب\(hyشده از
\fBlist\-unit\-files\fR
(در ادامه) استفاده کنید\&.
.sp
خروجی مشابه زیر تولید می\(hyکند:
.sp
.if n \{\
.RS 4
.\}
.nf
  UNIT                         LOAD   ACTIVE SUB     DESCRIPTION
  sys\-module\-fuse\&.device       loaded active plugged /sys/module/fuse
  \-\&.mount                      loaded active mounted Root Mount
  boot\-efi\&.mount               loaded active mounted /boot/efi
  systemd\-journald\&.service     loaded active running Journal Service
  systemd\-logind\&.service       loaded active running Login Service
● user@1000\&.service            loaded failed failed  User Manager for UID 1000
  \&...
  systemd\-tmpfiles\-clean\&.timer loaded active waiting Daily Cleanup of Temporary Directories

LOAD   = Reflects whether the unit definition was properly loaded\&.
ACTIVE = The high\-level unit activation state, i\&.e\&. generalization of SUB\&.
SUB    = The low\-level unit activation state, values depend on unit type\&.

123 loaded units listed\&. Pass \-\-all to see loaded but inactive units, too\&.
To show all installed unit files use \*(Aqsystemctl list\-unit\-files\*(Aq\&.
.fi
.if n \{\
.RE
.\}
.sp
در صورتی که ترمینال پشتیبانی کند، سربرگ و آخرین واحد از یک نوع مشخص خط\(hyزیرین (underline) می\(hyشوند\&. یک نقطه رنگی در کنار سرویس\(hyهایی که ماسک شده\(hyاند، پیدا نشده\(hyاند یا به نحوی با شکست مواجه شده\(hyاند نمایش داده می\(hyشود\&.
.sp
ستون LOAD وضعیت بارگذاری را نشان می\(hyدهد که یکی از مقادیر
\fBloaded\fR،
\fBnot\-found\fR،
\fBbad\-setting\fR،
\fBerror\fR،
\fBmasked\fR
است\&. ستون ACTIVE وضعیت کلی واحد را نشان می\(hyدهد که یکی از موارد زیر است:
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&1.\ \&وضعیت‌های ACTIVE واحد
.TS
allbox tab(:);
lB lB.
T{
وضعیت
T}:T{
توضیحات
T}
.T&
l l
l l
l l
l l
l l
l l
l l
l l.
T{
\fIactive\fR
T}:T{
شروع\(hyشده، مقید\(hyشده (bound)، متصل\(hyشده (plugged in) و غیره، بسته به نوع واحد\&.
T}
T{
\fIinactive\fR
T}:T{
متوقف\(hyشده، رها\(hyشده، جدا\(hyشده و غیره، بسته به نوع واحد\&.
T}
T{
\fIfailed\fR
T}:T{
مشابه \fBinactive\fR، اما واحد به نحوی با شکست مواجه شده است (پردازش هنگام خروج کد خطا بازگردانده، کرش کرده، زمان یک عملیات به پایان رسیده یا پس از راه‌اندازی‌های مجدد بیش از حد)\&.
T}
T{
\fIactivating\fR
T}:T{
در حال تغییر از \fBinactive\fR به \fBactive\fR\&.
T}
T{
\fIdeactivating\fR
T}:T{
در حال تغییر از \fBactive\fR به \fBinactive\fR\&.
T}
T{
\fImaintenance\fR
T}:T{
واحد در وضعیت \fBinactive\fR است و یک عملیات نگهداری در جریان است\&.
T}
T{
\fIreloading\fR
T}:T{
واحد در وضعیت \fBactive\fR است و در حال بارگذاری مجدد پیکربندی خود می\(hyباشد\&.
T}
T{
\fIrefreshing\fR
T}:T{
واحد در وضعیت \fBactive\fR است و یک مانت (mount) جدید در فضای نام آن در حال فعال‌سازی است\&.
T}
.TE
.sp 1
ستون SUB وضعیت دقیق وابسته به نوع واحد را نشان می\(hyدهد، مقادیر ممکن بسته به نوع واحد متفاوت است\&. فهرست وضعیت\(hyهای ممکن LOAD، ACTIVE و SUB ثابت نیست و نسخه\(hyهای جدید systemd ممکن است مقادیری را اضافه یا حذف کنند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
systemctl \-\-state=help
.fi
.if n \{\
.RE
.\}
.sp
می\(hyتوان از این دستور برای نمایش مجموعه فعلی مقادیر مجاز استفاده کرد\&.
.sp
این دستور پیش\(hyفرض است\&.
.RE
.PP
\fBlist\-automounts\fR [\fIPATTERN\fR\&...]
.RS 4
واحدهای نصب خودکار (automount) موجود در حافظه را به ترتیب مسیر مانت فهرست می\(hyکند\&. اگر یک یا چند
\fIPATTERN\fR
مشخص شود، فقط واحدهای اتومانتی که با یکی از آن\(hyها تطابق دارند نمایش داده می\(hyشوند\&. خروجی مشابه زیر تولید می\(hyکند:
.sp
.if n \{\
.RS 4
.\}
.nf
WHAT        WHERE                    MOUNTED IDLE TIMEOUT UNIT
/dev/sdb1   /mnt/test                no      120s         mnt\-test\&.automount
binfmt_misc /proc/sys/fs/binfmt_misc yes     0            proc\-sys\-fs\-binfmt_misc\&.automount

2 automounts listed\&.
.fi
.if n \{\
.RE
.\}
.sp
همچنین ببینید:
\fB\-\-show\-types\fR،
\fB\-\-all\fR
و
\fB\-\-state=\fR\&.
.sp
اضافه شده در نسخه 252\&.
.RE
.PP
\fBlist\-paths\fR [\fIPATTERN\fR\&...]
.RS 4
واحدهای مسیر (path) موجود در حافظه را به ترتیب مسیر فهرست می\(hyکند\&. اگر یک یا چند
\fIPATTERN\fR
مشخص شود، فقط واحدهای مسیری که با یکی از آن\(hyها منطبق هستند نشان داده می\(hyشوند\&. خروجی مشابه زیر تولید می\(hyکند:
.sp
.if n \{\
.RS 4
.\}
.nf
PATH                           CONDITION         UNIT                               ACTIVATES
/run/systemd/ask\-password      DirectoryNotEmpty systemd\-ask\-password\-plymouth\&.path systemd\-ask\-password\-plymouth\&.service
/run/systemd/ask\-password      DirectoryNotEmpty systemd\-ask\-password\-wall\&.path     systemd\-ask\-password\-wall\&.service
/var/cache/cups/org\&.cups\&.cupsd PathExists        cups\&.path                          cups\&.service

3 paths listed\&.
.fi
.if n \{\
.RE
.\}
.sp
همچنین ببینید:
\fB\-\-show\-types\fR،
\fB\-\-all\fR
و
\fB\-\-state=\fR\&.
.sp
اضافه شده در نسخه 254\&.
.RE
.PP
\fBlist\-sockets\fR [\fIPATTERN\fR\&...]
.RS 4
واحدهای سوکت موجود در حافظه را به ترتیب آدرس شنود فهرست می\(hyکند\&. اگر یک یا چند
\fIPATTERN\fR
مشخص شود، فقط واحدهای سوکتی که با یکی از آن\(hyها مطابقت دارند نمایش داده می\(hyشوند\&. خروجی مشابه زیر تولید می\(hyکند:
.sp
.if n \{\
.RS 4
.\}
.nf
LISTEN           UNIT                        ACTIVATES
kobject\-uevent 1 systemd\-udevd\-kernel\&.socket systemd\-udevd\&.service
/dev/rfkill      systemd\-rfkill\&.socket       systemd\-rfkill\&.service
\&...

5 sockets listed\&.
.fi
.if n \{\
.RE
.\}
.sp
توجه: به دلیل اینکه آدرس\(hyها ممکن است شامل فاصله باشند، این خروجی برای پردازش برنامه‌نویسی مناسب نیست\&.
.sp
همچنین ببینید:
\fB\-\-show\-types\fR،
\fB\-\-all\fR
و
\fB\-\-state=\fR\&.
.sp
اضافه شده در نسخه 202\&.
.RE
.PP
\fBlist\-timers\fR [\fIPATTERN\fR\&...]
.RS 4
واحدهای تایمر موجود در حافظه را بر اساس زمان انقضای بعدی فهرست می\(hyکند\&. اگر یک یا چند
\fIPATTERN\fR
تعیین شده باشد، فقط واحدهای منطبق با یکی از آن\(hyها نمایش داده می\(hyشوند\&. خروجی مشابه زیر تولید می\(hyکند:
.sp
.if n \{\
.RS 4
.\}
.nf
NEXT                         LEFT          LAST                         PASSED     UNIT                         ACTIVATES
\-                            \-             Thu 2017\-02\-23 13:40:29 EST  3 days ago ureadahead\-stop\&.timer        ureadahead\-stop\&.service
Sun 2017\-02\-26 18:55:42 EST  1min 14s left Thu 2017\-02\-23 13:54:44 EST  3 days ago systemd\-tmpfiles\-clean\&.timer systemd\-tmpfiles\-clean\&.service
Sun 2017\-02\-26 20:37:16 EST  1h 42min left Sun 2017\-02\-26 11:56:36 EST  6h ago     apt\-daily\&.timer              apt\-daily\&.service
Sun 2017\-02\-26 20:57:49 EST  2h 3min left  Sun 2017\-02\-26 11:56:36 EST  6h ago     snapd\&.refresh\&.timer          snapd\&.refresh\&.service
.fi
.if n \{\
.RE
.\}
.sp
\fINEXT\fR
زمان اجرای بعدی تایمر را نشان می\(hyدهد\&.
.sp
\fILEFT\fR
مدت زمان باقی\(hyمانده تا اجرای بعدی تایمر را نشان می\(hyدهد\&.
.sp
\fILAST\fR
آخرین باری را که تایمر اجرا شده است نشان می\(hyدهد\&.
.sp
\fIPASSED\fR
مدت زمان سپری\(hyشده از آخرین اجرای تایمر را نشان می\(hyدهد\&.
.sp
\fIUNIT\fR
نام تایمر را نشان می\(hyدهد\&.
.sp
\fIACTIVATES\fR
نام سرویسی را که تایمر هنگام اجرا فعال می\(hyکند نشان می\(hyدهد\&.
.sp
همچنین ببینید:
\fB\-\-all\fR
و
\fB\-\-state=\fR\&.
.sp
اضافه شده در نسخه 209\&.
.RE
.PP
\fBis\-active \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
بررسی می\(hyکند که آیا هر یک از واحدهای مشخص\(hyشده فعال (یعنی در حال اجرا) هستند یا خیر\&. اگر حداقل یک واحد فعال باشد کد خروج
\fB0\fR
و در غیر این صورت مقداری غیرصفر بازمی\(hyگرداند\&. مگر اینکه گزینه
\fB\-\-quiet\fR
تعیین شده باشد، وضعیت فعلی واحد را در خروجی استاندارد نیز چاپ می\(hyکند\&.
.RE
.PP
\fBis\-failed \fR\fB[\fIPATTERN\fR\&...]\fR
.RS 4
بررسی می\(hyکند که آیا هر یک از واحدهای مشخص\(hyشده در وضعیت "failed" قرار دارد یا خیر\&. اگر هیچ واحدی تعیین نشود، بررسی می\(hyکند که آیا واحد ناموفقی وجود دارد یا خیر، که این متناظر با وضعیت
"degraded"
بازگردانده\(hyشده توسط
\fBis\-system\-running\fR
است\&. اگر حداقل یک واحد با شکست مواجه شده باشد کد خروج
\fB0\fR
و در غیر این صورت مقدار غیرصفر بازمی\(hyگرداند\&. مگر اینکه گزینه
\fB\-\-quiet\fR
تعیین شده باشد، وضعیت فعلی واحد یا سیستم را در خروجی استاندارد نیز چاپ می\(hyکند\&.
.sp
اضافه شده در نسخه 197\&.
.RE
.PP
\fBstatus\fR [\fIPATTERN\fR\&...|\fIPID\fR\&...]]
.RS 4
اطلاعات وضعیت زمان اجرای کل سیستم یا یک یا چند واحد را به همراه جدیدترین داده\(hyهای گزارش (log) از ژورنال نمایش می\(hyدهد\&. اگر هیچ آرگومان موضعی مشخص نشود و فیلتر واحدی با
\fB\-\-type=\fR،
\fB\-\-state=\fR
یا
\fB\-\-failed\fR
داده نشود، وضعیت کل سیستم را نشان می\(hyدهد\&. اگر با
\fB\-\-all\fR
ترکیب شود، به دنبال آن وضعیت تمام واحدها نمایش داده می\(hyشود\&. اگر آرگومان\(hyهای موضعی مشخص شوند، با هر آرگومان موضعی به عنوان نام واحد برای نمایش، یا الگوی تطبیق (glob) برای نمایش واحدهایی که نامشان با آن الگو منطبق است، یا یک شناسه پردازش (PID) برای نمایش واحد حاوی آن PID رفتار می\(hyشود\&. هنگامی که از
\fB\-\-type=\fR،
\fB\-\-state=\fR
یا
\fB\-\-failed\fR
استفاده شود، واحدها علاوه بر این بر اساس TYPE و وضعیت ACTIVE فیلتر می\(hyشوند\&.
.sp
این دستور برای تولید خروجی خوانا برای انسان در نظر گرفته شده است\&. اگر به دنبال خروجی قابل تجزیه توسط رایانه هستید، به جای آن از
\fBshow\fR
استفاده کنید\&. به طور پیش\(hyفرض، این تابع تنها 10 خط خروجی را نشان می\(hyدهد و خطوط را کوتاه می\(hyکند تا در پنجره ترمینال جا شوند\&. این رفتار با گزینه\(hyهای
\fB\-\-lines\fR
و
\fB\-\-full\fR
قابل تغییر است\&. علاوه بر این، دستورات
\fBjournalctl \-\-unit=\fR\fB\fINAME\fR\fR
یا
\fBjournalctl \-\-user\-unit=\fR\fB\fINAME\fR\fR
از فیلتر مشابهی برای پیام\(hyها استفاده می\(hyکنند و ممکن است راحت\(hyتر باشند\&.
.sp
توجه داشته باشید که این عملیات تنها وضعیت
\fIزمان اجرا (runtime)\fR
را نشان می\(hyدهد، یعنی اطلاعات مربوط به اجرای فعلی واحد (اگر در حال اجرا باشد) یا جدیدترین اجرای آن (اگر دیگر اجرا نمی\(hyشود و از حافظه آزاد نشده باشد)\&. اطلاعات مربوط به اجراهای قبلی، اجراهای بوت\(hyهای قبلی سیستم، یا اجراهای پیشینی که از حافظه پاک شده\(hyاند را می\(hyتوان از طریق
\fBjournalctl \-\-unit=\fR
به دست آورد\&.
.sp
سامانه systemd واحدها را بر حسب نیاز به صورت ضمنی بارگذاری می\(hyکند، بنابراین اجرای صرف دستور
\fBstatus\fR
تلاش خواهد کرد فایلی را بارگذاری کند\&. بنابراین این دستور برای تعیین اینکه آیا چیزی از قبل بارگذاری شده بوده یا خیر مفید نیست\&. همچنین در صورتی که دلیلی برای نگه داشتن واحد در حافظه وجود نداشته باشد، واحدها ممکن است بلافاصله پس از اتمام عملیات از حافظه خارج شوند\&.
.PP
\fBمثال\ \&1.\ \&خروجی نمونه از systemctl status\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemctl status bluetooth
● bluetooth\&.service \- Bluetooth service
   Loaded: loaded (/usr/lib/systemd/system/bluetooth\&.service; enabled; preset: enabled)
   Active: active (running) since Wed 2017\-01\-04 13:54:04 EST; 1 weeks 0 days ago
     Docs: man:bluetoothd(8)
 Main PID: 930 (bluetoothd)
   Status: "Running"
    Tasks: 1
   Memory: 648\&.0K
      CPU: 435ms
   CGroup: /system\&.slice/bluetooth\&.service
           └─930 /usr/lib/bluetooth/bluetoothd

Jan 12 10:46:45 example\&.com bluetoothd[8900]: Not enough free handles to register service
Jan 12 10:46:45 example\&.com bluetoothd[8900]: Current Time Service could not be registered
Jan 12 10:46:45 example\&.com bluetoothd[8900]: gatt\-time\-server: Input/output error (5)
.fi
.if n \{\
.RE
.\}
.sp
نقطه ("●") در ترمینال\(hyهای پشتیبانی\(hyشده با رنگ\(hyآمیزی، خلاصه وضعیت واحد را در یک نگاه نشان می\(hyدهد\&. همراه با رنگ، شکل آن نیز بر اساس وضعیت تغییر می\(hyکند:
"inactive"
یا
"maintenance"
یک دایره توخالی سفید ("○") است،
"active"
یک نقطه سبز ("●") است،
"deactivating"
یک نقطه سفید است،
"failed"
یا
"error"
یک علامت ضربدر قرمز ("\(mu") است، و
"reloading"
یا
"refreshing"
یک فلش دایره\(hyای ساعت\(hyگرد سبز ("↻") است\&.
.sp
سطر "Loaded:" در خروجی، در صورتی که واحد در حافظه بارگذاری شده باشد مقدار
"loaded"
را نشان خواهد داد\&. سایر مقادیر ممکن برای "Loaded:" عبارتند از:
"error"
اگر در بارگذاری آن مشکلی پیش آمده باشد،
"not\-found"
اگر هیچ فایل واحدی برای این واحد یافت نشود،
"bad\-setting"
اگر یک تنظیم ضروری در فایل واحد قابل تجزیه نباشد، و
"masked"
اگر فایل واحد ماسک شده باشد\&. این سطر همراه با نمایش مسیر فایل واحد، وضعیت فعال\(hyسازی (enablement) را نیز نشان می\(hyدهد\&. واحدهای فعال\(hyشده در شبکه وابستگی بین واحدها گنجانده می\(hyشوند و بدین ترتیب در هنگام بوت یا از طریق فرم دیگری از فعال\(hyسازی شروع به کار می\(hyکنند\&. جدول کامل وضعیت\(hyهای فعال\(hyسازی ممکن \(em از جمله تعریف
"masked"
\(em را در مستندات دستور
\fBis\-enabled\fR
مشاهده فرمایید\&.
.sp
سطر "Active:" وضعیت فعالیت را نشان می\(hyدهد\&. مقدار آن معمولاً
"active"
یا
"inactive"
است\&. فعال بودن بسته به نوع واحد می\(hyتواند به معنای شروع\(hyشده، مقید\(hyشده، متصل\(hyشده و غیره باشد\&. واحد همچنین ممکن است در حال تغییر وضعیت باشد و وضعیت
"activating"
یا
"deactivating"
را گزارش کند\&. وضعیت خاص
"failed"
زمانی وارد می\(hyشود که سرویس به نحوی با شکست مواجه شده باشد، مانند کرش کردن، خروج با کد خطا یا به پایان رسیدن مهلت زمانی (timeout)\&. در صورت ورود به وضعیت failed، علت آن برای ارجاع بعدی در لاگ ثبت خواهد شد\&.
.RE
.PP
\fBshow\fR [\fIPATTERN\fR\&...|\fIJOB\fR\&...]
.RS 4
ویژگی\(hyهای یک یا چند واحد، کار (job) یا خود مدیر سیستم را نمایش می\(hyدهد\&. اگر هیچ آرگومانی مشخص نشود، ویژگی\(hyهای مدیر سیستم نشان داده می\(hyشود\&. اگر نام یک واحد تعیین شود، ویژگی\(hyهای آن واحد و اگر شناسه یک کار تعیین شود، ویژگی\(hyهای آن کار نمایش داده می\(hyشود\&. به طور پیش\(hyفرض، ویژگی\(hyهای خالی نمایش داده نمی\(hyشوند\&. از
\fB\-\-all\fR
برای نمایش آن\(hyها نیز استفاده کنید\&. برای انتخاب ویژگی\(hyهای خاص، از
\fB\-\-property=\fR
استفاده فرمایید\&. این دستور برای مواردی که خروجی قابل تجزیه توسط کامپیوتر مورد نیاز است در نظر گرفته شده است\&. در صورتی که به دنبال خروجی قالب\(hyبندی\(hyشده و خوانا برای انسان هستید، از
\fBstatus\fR
استفاده کنید\&.
.sp
بسیاری از ویژگی\(hyهای نمایش داده شده توسط
\fBsystemctl show\fR
مستقیماً با تنظیمات پیکربندی مدیر سیستم و سرویس و فایل\(hyهای واحد آن مطابقت دارند\&. توجه داشته باشید که ویژگی\(hyهای نشان داده شده توسط این دستور به طور کلی نسخه\(hyهای سطح پایین\(hyتر و نرمال\(hyشده تنظیمات پیکربندی اصلی هستند و علاوه بر پیکربندی، وضعیت زمان اجرا را نیز نشان می\(hyدهند\&. به عنوان مثال، ویژگی\(hyهای نمایش\(hyداده\(hyشده برای واحدهای سرویس شامل شناسه پردازش اصلی فعلی سرویس به عنوان
"MainPID"
(که وضعیت زمان اجرا است) می\(hyباشد، و تنظیمات زمانی همیشه به عنوان ویژگی\(hyهایی با پسوند
"\&...USec"
نمایش داده می\(hyشوند حتی اگر گزینه پیکربندی منطبق به
"\&...Sec"
ختم شود، زیرا میکروثانیه واحد زمانی نرمال\(hyشده است که در داخل توسط مدیر سیستم و سرویس استفاده می\(hyشود\&.
.sp
برای جزئیات بیشتر درباره بسیاری از این ویژگی\(hyها، به مستندات رابط D\-Bus پشتیبان این ویژگی\(hyها در
\fBorg.freedesktop.systemd1\fR(5)
مراجعه کنید\&.
.RE
.PP
\fBcat \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
فایل\(hyهای پشتیبان (منبع) یک یا چند واحد را نمایش می\(hyدهد\&. "قطعه" (fragment) و "تکمیل\(hyکننده\(hyها" (drop\-ins یا فایل\(hyهای منبع) واحدها را چاپ می\(hyکند\&. قبل از هر فایل یک کامنت قرار می\(hyگیرد که شامل نام فایل است\&. توجه داشته باشید که این دستور محتویات فایل\(hyهای پشتیبان روی دیسک را نشان می\(hyدهد، که ممکن است با برداشت مدیر سیستم از این واحدها مطابقت نداشته باشد، اگر هر یک از فایل\(hyهای واحد روی دیسک به\(hyروز شده باشند و دستور
\fBdaemon\-reload\fR
پس از آن صادر نشده باشد\&.
.sp
اضافه شده در نسخه 209\&.
.RE
.PP
\fBhelp \fR\fB\fIPATTERN\fR\fR\fB\&...|\fR\fB\fIPID\fR\fR\fB\&...\fR
.RS 4
صفحات راهنما (manual pages) را برای یک یا چند واحد در صورت وجود نمایش می\(hyدهد\&. اگر یک PID داده شود، صفحات راهنما برای واحدی که پردازش به آن تعلق دارد نمایش داده می\(hyشود\&.
.sp
اضافه شده در نسخه 185\&.
.RE
.PP
\fBlist\-dependencies\fR [\fIUNIT\fR\&.\&.\&.]
.RS 4
واحدهای مورد نیاز (required) و خواسته‌شده (wanted) توسط واحدهای مشخص‌شده را نشان می‌دهد\&. این دستور به صورت بازگشتی واحدهای پس از وابستگی‌های
\fIRequires=\fR،
\fIRequisite=\fR،
\fIWants=\fR،
\fIConsistsOf=\fR،
\fIBindsTo=\fR
و
\fIUpholds=\fR
را فهرست می‌کند\&. اگر واحدی مشخص نشود،
default\&.target
در نظر گرفته می‌شود\&.
.sp
واحدهای نمایش‌داده‌شده در صورت تعیین گزینه‌های
\fB\-\-type=\fR
و
\fB\-\-state=\fR
به طور اضافی فیلتر می‌شوند\&. توجه داشته باشید که در این صورت امکان استفاده از ساختار درختی وجود نخواهد داشت، بنابراین
\fB\-\-plain\fR
به طور ضمنی اعمال می‌شود\&.
.sp
به طور پیش‌فرض، فقط واحدهای هدف (target) به صورت بازگشتی بسط داده می‌شوند\&. هنگامی که
\fB\-\-all\fR
ارسال شود، تمام واحدهای دیگر نیز به صورت بازگشتی بسط می‌یابند\&.
.sp
از گزینه‌های
\fB\-\-reverse\fR،
\fB\-\-after\fR
و
\fB\-\-before\fR
می‌توان برای تغییر انواع وابستگی‌های نمایش‌داده‌شده استفاده کرد\&.
.sp
توجه داشته باشید که این دستور فقط واحدهایی را فهرست می‌کند که در حال حاضر توسط مدیر سرویس در حافظه بارگذاری شده‌اند\&. به ویژه، این دستور برای دریافت یک فهرست جامع از تمام وابستگی‌های معکوس روی یک واحد خاص مناسب نیست، زیرا وابستگی‌های تعریف‌شده توسط واحدهایی را که در حال حاضر بارگذاری نشده‌اند فهرست نمی‌کند\&.
.sp
اضافه شده در نسخه 198\&.
.RE
.PP
\fBstart \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
شروع (فعال‌سازی) یک یا چند واحد مشخص‌شده در خط فرمان\&.
.sp
توجه داشته باشید که الگوهای تطبیق واحد (glob) به نام واحدهایی که در حال حاضر در حافظه هستند بسط می‌یابند\&. واحدهایی که فعال نیستند و در وضعیت شکست‌خورده قرار ندارند، معمولاً در حافظه نیستند و با هیچ الگویی مطابقت نخواهند داشت\&. علاوه بر این، در مورد واحدهای نمونه‌سازی‌شده، systemd اغلب تا زمانی که نمونه راه‌اندازی نشده باشد از نام نمونه آگاه نیست\&. بنابراین، استفاده از الگوهای تطبیق با
\fBstart\fR
کاربرد محدودی دارد\&. همچنین نام‌های مستعار ثانویه واحدها در نظر گرفته نمی‌شوند\&.
.sp
گزینه
\fB\-\-all\fR
ممکن است برای اعمال عملیات بر روی واحدهای غیرفعالی که توسط سایر واحدهای بارگذاری‌شده ارجاع داده شده‌اند نیز استفاده شود\&. توجه داشته باشید که این با کار بر روی "همه" واحدهای ممکن یکسان نیست، زیرا همانطور که در پاراگراف قبلی توضیح داده شد، چنین فهرستی نامشخص است\&. با این وجود،
\fBsystemctl start \-\-all \fR\fB\fIGLOB\fR\fR
ممکن است در صورتی که تمام واحدهای منطبق بر الگو توسط هدفی کشیده شده باشند که مشخص است بارگذاری شده، مفید باشد\&.
.RE
.PP
\fBstop \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
متوقف کردن (غیرفعال‌سازی) یک یا چند واحد مشخص‌شده در خط فرمان\&.
.sp
در صورتی که واحد وجود نداشته باشد یا توقف واحد ممنوع باشد (به
\fIRefuseManualStop=\fR
در
\fBsystemd.unit\fR(5)
مراجعه کنید)، این دستور با شکست مواجه می‌شود\&. اما اگر هر یک از دستورات پیکربندی‌شده برای متوقف کردن واحد (مانند \fIExecStop=\fR و غیره) با شکست مواجه شوند، این دستور با شکست مواجه
\fIنخواهد شد\fR،
زیرا مدیر سیستم همچنان واحد را به اجبار خاتمه می‌دهد\&.
.sp
اگر واحدی که متوقف می‌شود همچنان بتواند توسط واحدهای دیگر راه‌اندازی (trigger) شود، هشداری حاوی نام واحدهای راه‌انداز نمایش داده می‌شود\&.
\fB\-\-no\-warn\fR
می‌تواند برای خاموش کردن این هشدار استفاده شود\&.
.RE
.PP
\fBreload \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
از تمام واحدهای فهرست‌شده در خط فرمان درخواست می‌کند تا پیکربندی خود را دوباره بارگذاری کنند\&. توجه داشته باشید که این کار پیکربندی خاص سرویس را بارگذاری مجدد می‌کند، نه فایل پیکربندی واحد systemd را\&. اگر می‌خواهید systemd فایل پیکربندی یک واحد را مجدداً بارگذاری کند، از دستور
\fBdaemon\-reload\fR
استفاده کنید\&. به عبارت دیگر: برای مورد مثال آپاچی، این کار فایل
httpd\&.conf
آپاچی را در وب‌سرور مجدداً بارگذاری می‌کند، نه فایل واحد
apache\&.service
را در systemd\&.
.sp
این دستور نباید با دستور
\fBdaemon\-reload\fR
اشتباه گرفته شود\&.
.RE
.PP
\fBrestart \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
یک یا چند واحد مشخص‌شده در خط فرمان را متوقف کرده و سپس راه‌اندازی می‌کند\&. اگر واحدها هنوز در حال اجرا نباشند، شروع به کار خواهند کرد\&.
.sp
توجه داشته باشید که راه‌اندازی مجدد یک واحد با این دستور لزوماً تمام منابع واحد را قبل از شروع مجدد آن پاک نمی‌کند\&. به عنوان مثال، قابلیت ذخیره توصیف‌کننده فایل به ازای هر سرویس (به
\fIFileDescriptorStoreMax=\fR
در
\fBsystemd.service\fR(5)
مراجعه کنید) تا زمانی که واحد یک کار در انتظار داشته باشد دست‌نخورده باقی می‌ماند، و تنها زمانی پاک می‌شود که واحد کاملاً متوقف شده و هیچ کاری در انتظار نباشد\&. اگر هدف این است که مخزن توصیف‌کننده فایل نیز در طول عملیات راه‌اندازی مجدد پاک شود، باید یک دستور صریح
\fBsystemctl stop\fR
و به دنبال آن
\fBsystemctl start\fR
صادر شود\&.
.RE
.PP
\fBtry\-restart \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
در صورتی که واحدها در حال اجرا باشند، یک یا چند واحد مشخص‌شده در خط فرمان را متوقف کرده و دوباره راه‌اندازی می‌کند\&. اگر واحدها در حال اجرا نباشند، این دستور هیچ کاری انجام نمی‌دهد\&.
.RE
.PP
\fBreload\-or\-restart \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
یک یا چند واحد را در صورت پشتیبانی مجدداً بارگذاری می‌کند\&. در غیر این صورت، به جای آن آن‌ها را متوقف کرده و دوباره راه‌اندازی می‌کند\&. اگر واحدها هنوز اجرا نشده باشند، راه‌اندازی خواهند شد\&.
.sp
این دستور در صورت استفاده همراه با
\fB\-\-marked\fR
عملکرد کمی متفاوت دارد، به توضیحات آن مراجعه کنید\&.
.RE
.PP
\fBtry\-reload\-or\-restart \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
یک یا چند واحد را در صورت پشتیبانی مجدداً بارگذاری می‌کند\&. در غیر این صورت، در صورت در حال اجرا بودن، آن‌ها را متوقف کرده و سپس راه‌اندازی مجدد می‌کند\&. اگر واحدها اجرا نشده باشند، هیچ کاری انجام نمی‌دهد\&.
.sp
اضافه شده در نسخه 229\&.
.RE
.PP
\fBisolate \fR\fB\fIUNIT\fR\fR
.RS 4
واحد مشخص‌شده در خط فرمان و وابستگی‌های آن را راه‌اندازی کرده و تمام واحدهای دیگر را متوقف می‌کند، مگر اینکه تنظیم
\fBIgnoreOnIsolate=yes\fR
را داشته باشند (به
\fBsystemd.unit\fR(5)
مراجعه فرمایید)\&. اگر نام واحدی بدون پسوند داده شود، پسوند
"\&.target"
در نظر گرفته می‌شود\&.
.sp
این دستور خطرناک است، زیرا فوراً فرآیندهایی را که در هدف جدید فعال نشده‌اند متوقف می‌کند، که احتمالاً شامل محیط گرافیکی یا ترمینالی است که در حال حاضر استفاده می‌کنید\&.
.sp
توجه داشته باشید که این عملیات فقط روی واحدهایی مجاز است که
\fBAllowIsolate=\fR
در آن‌ها فعال باشد\&. برای جزئیات به
\fBsystemd.unit\fR(5)
مراجعه کنید\&.
.RE
.PP
\fBkill \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
ارسال یک سیگنال پردازش یونیکس به یک یا چند فرآیند واحد\&. از
\fB\-\-kill\-whom=\fR
برای انتخاب فرآیندی که سیگنال به آن ارسال شود استفاده کنید\&. از
\fB\-\-signal=\fR
برای انتخاب سیگنال ارسالی استفاده فرمایید\&. با
\fB\-\-kill\-value=\fR
ترکیب کنید تا یک سیگنال بلادرنگ (Realtime) پازیکس با مقدار مربوطه در صف قرار گیرد\&.
.RE
.PP
\fBclean \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
حذف پیکربندی، وضعیت، حافظه پنهان (کَش)، گزارش‌ها (logs)، داده‌های زمان اجرا یا انبار توصیف‌کننده فایل واحدهای مشخص‌شده\&. از
\fB\-\-what=\fR
برای انتخاب نوع منبع جهت حذف استفاده کنید\&. برای واحدهای سرویس این ممکن است برای حذف دایرکتوری‌های پیکربندی‌شده با
\fIConfigurationDirectory=\fR،
\fIStateDirectory=\fR،
\fICacheDirectory=\fR،
\fILogsDirectory=\fR
و
\fIRuntimeDirectory=\fR
استفاده شود؛ برای جزئیات به
\fBsystemd.exec\fR(5)
مراجعه فرمایید\&. همچنین ممکن است برای پاک‌سازی انبار توصیف‌کننده فایل که از طریق
\fIFileDescriptorStoreMax=\fR
فعال شده استفاده شود، برای جزئیات به
\fBsystemd.service\fR(5)
مراجعه فرمایید\&. برای واحدهای تایمر در صورتی که از
\fIPersistent=\fR
استفاده شده باشد و
\fB\-\-what=state\fR
انتخاب شود، این ممکن است برای پاک‌سازی داده‌های برچسب زمانی پایدار استفاده شود؛ به
\fBsystemd.timer\fR(5)
مراجعه فرمایید\&. این دستور فقط برای واحدهایی اعمال می‌شود که از هر یک از این تنظیمات استفاده می‌کنند\&. اگر
\fB\-\-what=\fR
مشخص نشده باشد، داده‌های کَش و زمان اجرا و همچنین انبار توصیف‌کننده فایل حذف می‌شوند (زیرا این سه نوع منبع معمولاً افزونه بوده و در فراخوانی بعدی واحد قابل بازتولید هستند)\&. مقادیر متعدد را می‌توان با ویرگول جدا کرد\&. توجه داشته باشید که برای اجرای این عملیات، واحدهای مشخص‌شده باید متوقف شده باشند\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&2.\ \& مقادیر ممکن برای \-\-what=
.TS
allbox tab(:);
lB lB.
T{
مقدار
T}:T{
تنظیمات واحد
T}
.T&
l l
l l
l l
l l
l l
l l
l l
l l.
T{
"runtime"
T}:T{
\fIRuntimeDirectory=\fR
T}
T{
"state"
T}:T{
\fIStateDirectory=\fR
T}
T{
"cache"
T}:T{
\fICacheDirectory=\fR
T}
T{
"logs"
T}:T{
\fILogsDirectory=\fR
T}
T{
"configuration"
T}:T{
\fIConfigurationDirectory=\fR
T}
T{
"fdstore"
T}:T{
\fIFileDescriptorStorePreserve=\fR
T}
T{
"all"
T}:T{
تمام موارد فوق
T}
T{
"help"
T}:T{
نمایش مقادیر پشتیبانی‌شده و خروج
T}
.TE
.sp 1
اضافه شده در نسخه 243\&.
.RE
.PP
\fBfreeze \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
انجماد (تعلیق) یک یا چند واحد مشخص‌شده در خط فرمان با استفاده از فریزِر cgroup\&.
.sp
منجمد کردن واحد باعث می‌شود تمام فرآیندهای موجود در cgroup متناظر با واحد به حالت تعلیق درآیند\&. تعلیق به این معنی است که فرآیندهای واحد تا زمان رفع انجماد برای اجرا روی پردازنده زمان‌بندی نخواهند شد\&. توجه داشته باشید که این دستور تنها در سیستم‌هایی که از سلسله‌مراتب یکپارچه cgroup استفاده می‌کنند پشتیبانی می‌شود\&. واحد درست قبل از اجرای کاری علیه آن، به عنوان مثال قبل از توقف واحد، به طور خودکار از انجماد خارج می‌شود\&.
.sp
اضافه شده در نسخه 246\&.
.RE
.PP
\fBthaw \fR\fB\fIPATTERN\fR\fR\fB\&...\fR
.RS 4
رفع انجماد (خروج از حالت فریز) یک یا چند واحد مشخص‌شده در خط فرمان\&.
.sp
این عملیات معکوس دستور
\fBfreeze\fR
است و اجرای فرآیندها را در cgroup واحد از سر می‌گیرد\&.
.sp
اضافه شده در نسخه 246\&.
.RE
.PP
\fBset\-property \fR\fB\fIUNIT\fR\fR\fB \fR\fB\fIPROPERTY\fR\fR\fB=\fR\fB\fIVALUE\fR\fR\fB\&...\fR
.RS 4
تنظیم ویژگی‌های واحد مشخص‌شده در زمان اجرا در مواردی که پشتیبانی می‌شود\&. این اجازه می‌دهد تا ویژگی‌های پارامتر پیکربندی مانند تنظیمات کنترل منابع در زمان اجرا تغییر کنند\&. همه ویژگی‌ها ممکن است در زمان اجرا تغییر نکنند، اما بسیاری از تنظیمات کنترل منابع (عمدتاً موارد موجود در
\fBsystemd.resource-control\fR(5))
می‌توانند تغییر کنند\&. تغییرات فوراً اعمال می‌شوند و برای بوت‌های آینده روی دیسک ذخیره می‌شوند، مگر اینکه
\fB\-\-runtime\fR
ارسال شود که در این صورت تنظیمات فقط تا راه‌اندازی مجدد بعدی اعمال می‌شوند\&. نحو انتساب ویژگی از نحو انتساب در فایل‌های واحد به دقت پیروی می‌کند\&.
.sp
مثال:
\fBsystemctl set\-property foobar\&.service CPUWeight=200\fR
.sp
اگر به نظر برسد که واحد مشخص‌شده غیرفعال است، تغییرات تنها همان‌طور که پیش‌تر توضیح داده شد روی دیسک ذخیره می‌شوند، بنابراین هنگام راه‌اندازی واحد مؤثر خواهند بود\&.
.sp
توجه داشته باشید که این دستور امکان تغییر چندین ویژگی را به طور همزمان فراهم می‌کند که نسبت به تنظیم جداگانه آن‌ها ارجح است\&.
.sp
مثال:
\fBsystemctl set\-property foobar\&.service CPUWeight=200 MemoryMax=2G IPAccounting=yes\fR
.sp
مانند تنظیمات پیکربندی فایل واحد، انتساب یک مقدار خالی معمولاً ویژگی را به مقادیر پیش‌فرض آن بازنشانی می‌کند\&.
.sp
مثال:
\fBsystemctl set\-property avahi\-daemon\&.service IPAddressDeny=\fR
.sp
اضافه شده در نسخه 206\&.
.RE
.PP
\fBbind\fR \fIUNIT\fR \fIPATH\fR [\fIPATH\fR]
.RS 4
اتصال یک فایل یا دایرکتوری (bind\-mount) از میزبان به فضای نام نصب (mount namespace) واحد مشخص‌شده\&. آرگومان مسیر اول، فایل یا دایرکتوری مبدا در میزبان است و آرگومان مسیر دوم، فایل یا دایرکتوری مقصد در فضای نام نصب واحد است\&. هنگامی که مورد دوم حذف شود، مسیر مقصد در فضای نام نصب واحد همانند مسیر مبدا در میزبان خواهد بود\&. در صورت ترکیب با سوییچ
\fB\-\-read\-only\fR،
یک مانت اتصالی فقط‌خواندنی ایجاد می‌شود\&. در صورت ترکیب با سوییچ
\fB\-\-mkdir\fR،
مسیر مقصد ابتدا قبل از اعمال مانت ایجاد می‌شود\&.
.sp
توجه داشته باشید که این گزینه در حال حاضر فقط برای واحدهایی پشتیبانی می‌شود که در یک فضای نام نصب اجرا می‌شوند (مثلاً با
\fBRootImage=\fR،
\fBPrivateMounts=\fR
و غیره)\&. این دستور از اتصال دایرکتوری‌ها، فایل‌های معمولی، گره‌های دستگاه، گره‌های سوکت
\fBAF_UNIX\fR
و همچنین FIFOها پشتیبانی می‌کند\&. این اتصال گذرا (ephemeral) است و به محض خروج فرآیند فعلی واحد، لغو می‌شود\&. توجه داشته باشید که فضای نام ذکر شده در اینجا که اتصال مانت به آن اضافه خواهد شد، فضایی است که فرآیند سرویس اصلی در آن اجرا می‌شود\&. فرآیندهای دیگر (آن‌هایی که توسط
\fBExecReload=\fR،
\fBExecStartPre=\fR
و غیره اجرا می‌شوند) در فضاهای نام متمایزی اجرا می‌شوند\&.
.sp
در صورت پشتیبانی هسته، هرگونه مانت قبلی روی هدف انتخاب‌شده با مانت جدید جایگزین خواهد شد\&. در صورت عدم پشتیبانی، هرگونه مانت قبلی روی آن پوشانده می‌شود، اما سنجاق‌شده و غیرقابل دسترس باقی می‌ماند\&.
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fBmount\-image\fR \fIUNIT\fR \fIIMAGE\fR [\fIPATH\fR [\fIPARTITION_NAME\fR:\fIMOUNT_OPTIONS\fR]]
.RS 4
یک ایمیج را از میزبان در فضای نام نصب واحد مشخص‌شده مانت می‌کند\&. آرگومان مسیر اول، ایمیج مبدا در میزبان است؛ آرگومان مسیر دوم، دایرکتوری مقصد در فضای نام نصب واحد است (یعنی داخل
\fBRootImage=\fR/\fBRootDirectory=\fR)\&.
آرگومان بعدی، در صورت وجود، به صورت یک چندتایی جداشده با دونقطه از نام پارتیشن و فهرست جداشده با کاما از گزینه‌های مانت برای آن پارتیشن تفسیر می‌شود\&. قالب آن مشابه تنظیم
\fBMountImages=\fR
سرویس است\&. در صورت ترکیب با سوییچ
\fB\-\-read\-only\fR،
یک مانت فقط‌خواندنی ایجاد می‌شود\&. در صورت ترکیب با سوییچ
\fB\-\-mkdir\fR،
مسیر مقصد قبل از اعمال مانت ابتدا ایجاد می‌شود\&.
.sp
توجه داشته باشید که این گزینه در حال حاضر فقط برای واحدهایی پشتیبانی می‌شود که در یک فضای نام نصب اجرا می‌شوند (یعنی با
\fBRootImage=\fR،
\fBPrivateMounts=\fR
و غیره)\&. توجه داشته باشید که فضای نام ذکر شده در اینجا که مانت ایمیج به آن اضافه خواهد شد، فضایی است که فرآیند سرویس اصلی در آن اجرا می‌شود\&. فرآیندهای دیگر (آن‌هایی که توسط
\fBExecReload=\fR،
\fBExecStartPre=\fR
و غیره اجرا می‌شوند) در فضاهای نام متمایزی اجرا می‌شوند\&.
.sp
در صورت پشتیبانی هسته، هرگونه مانت قبلی روی هدف انتخاب‌شده با مانت جدید جایگزین خواهد شد\&. در صورت عدم پشتیبانی، هر مانت قبلی روی آن پوشانده می‌شود، اما سنجاق‌شده و غیرقابل دسترسی باقی خواهد ماند\&.
.sp
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
systemctl mount\-image foo\&.service /tmp/img\&.raw /var/lib/image root:ro,nosuid
.fi
.if n \{\
.RE
.\}
.sp

.sp
.if n \{\
.RS 4
.\}
.nf
systemctl mount\-image \-\-mkdir bar\&.service /tmp/img\&.raw /var/lib/baz/img
.fi
.if n \{\
.RE
.\}
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fBservice\-log\-level\fR \fISERVICE\fR [\fILEVEL\fR]
.RS 4
اگر آرگومان
\fILEVEL\fR
داده نشود، سطح لاگ فعلی را همان‌طور که توسط سرویس
\fISERVICE\fR
گزارش شده چاپ می‌کند\&.
.sp
اگر آرگومان اختیاری
\fILEVEL\fR
ارائه شود، سطح لاگ فعلی سرویس را به
\fILEVEL\fR
تغییر می‌دهد\&. سطح لاگ باید یک سطح لاگ معمول syslog باشد، یعنی مقداری در محدوده 0\&...7 یا یکی از رشته‌های
\fBemerg\fR،
\fBalert\fR،
\fBcrit\fR،
\fBerr\fR،
\fBwarning\fR،
\fBnotice\fR،
\fBinfo\fR،
\fBdebug\fR؛
برای جزئیات به
\fBsyslog\fR(3)
مراجعه فرمایید\&.
.sp
سرویس باید ویژگی مناسب
\fIBusName=\fR\fI\fIdestination\fR\fR
را داشته باشد و همچنین رابط عمومی
\fBorg.freedesktop.LogControl1\fR(5)
را پیاده‌سازی کرده باشد\&. (ابزار systemctl
از پروتکل عمومی D\-Bus برای دسترسی به رابط
org\&.freedesktop\&.LogControl1\&.LogLevel
برای نام D\-Bus
\fIdestination\fR
استفاده خواهد کرد\&.)
.sp
اضافه شده در نسخه 247\&.
.RE
.PP
\fBservice\-log\-target\fR \fISERVICE\fR [\fITARGET\fR]
.RS 4
اگر آرگومان
\fITARGET\fR
داده نشود، مقصد لاگ فعلی را همان‌طور که توسط سرویس
\fISERVICE\fR
گزارش شده است چاپ می‌کند\&.
.sp
اگر آرگومان اختیاری
\fITARGET\fR
ارائه شود، مقصد لاگ فعلی سرویس را به
\fITARGET\fR
تغییر می‌دهد\&. مقصد لاگ باید یکی از رشته‌های زیر باشد:
\fBconsole\fR
(برای خروجی لاگ به جریان خطای استاندارد سرویس)،
\fBkmsg\fR
(برای خروجی لاگ به بافر لاگ هسته)،
\fBjournal\fR
(برای خروجی لاگ به
\fBsystemd-journald.service\fR(8)
با استفاده از پروتکل بومی ژورنال)،
\fBsyslog\fR
(برای خروجی لاگ به سوکت کلاسیک syslog در
/dev/log)،
\fBnull\fR
(برای عدم خروجی هیچ‌گونه لاگ) یا
\fBauto\fR
(برای یک انتخاب تعیین‌شده به صورت خودکار، که در صورت فراخوانی تعاملی سرویس معمولاً معادل
\fBconsole\fR
و در غیر این صورت معادل
\fBjournal\fR
یا
\fBsyslog\fR
است)\&.
.sp
برای اکثر سرویس‌ها، فقط زیرمجموعه کوچکی از مقاصد لاگ منطقی است\&. به ویژه، اکثر سرویس‌های "معمولی" فقط باید
\fBconsole\fR،
\fBjournal\fR
و
\fBnull\fR
را پیاده‌سازی کنند\&. هر چیز دیگری فقط برای سرویس‌های سطح پایینی مناسب است که در مراحل اولیه بوت، قبل از استقرار ثبت گزارش مناسب، فعال هستند\&.
.sp
سرویس باید ویژگی مناسب
\fIBusName=\fR\fI\fIdestination\fR\fR
را داشته باشد و همچنین رابط عمومی
\fBorg.freedesktop.LogControl1\fR(5)
را پیاده‌سازی کند\&. (ابزار systemctl
از پروتکل عمومی D\-Bus برای دسترسی به رابط
org\&.freedesktop\&.LogControl1\&.LogLevel
برای نام D\-Bus
\fIdestination\fR
استفاده خواهد کرد\&.)
.sp
اضافه شده در نسخه 247\&.
.RE
.PP
\fBreset\-failed [\fR\fB\fIPATTERN\fR\fR\fB\&...]\fR
.RS 4
بازنشانی وضعیت
"failed"
واحدهای مشخص‌شده، یا در صورت عدم ارسال نام واحد، بازنشانی وضعیت تمام واحدها\&. هنگامی که یک واحد به نحوی با شکست مواجه می‌شود (یعنی خروج فرآیند با کد خطای غیرصفر، خاتمه غیرعادی یا پایان مهلت زمانی)، به طور خودکار وارد وضعیت
"failed"
می‌شود و کد خروج و وضعیت آن برای بررسی توسط مدیر سیستم ثبت می‌شود تا زمانی که سرویس متوقف/راه‌اندازی مجدد شود یا با این دستور بازنشانی گردد\&.
.sp
علاوه بر بازنشانی وضعیت
"failed"
یک واحد، این دستور ویژگی‌های متعدد دیگری را نیز به ازای هر واحد بازنشانی می‌کند: شمارنده محدودیت نرخ شروع (start rate limit) تمام انواع واحدها به صفر بازنشانی می‌شود، همان‌طور که شمارنده راه‌اندازی مجدد واحدهای سرویس نیز به صفر برمی‌گردد\&. بنابراین، اگر محدودیت شروع یک واحد (همان‌طور که با
\fIStartLimitIntervalSec=\fR/\fIStartLimitBurst=\fR
پیکربندی شده است) فعال شده باشد و واحد از راه‌اندازی مجدد امتناع ورزد، از این دستور استفاده کنید تا دوباره قابل راه‌اندازی شود\&.
.RE
.PP
\fBwhoami [\fR\fB\fIPID\fR\fR\fB\&...]\fR
.RS 4
واحدهایی را که فرآیندهای ارجاع‌شده توسط PIDهای داده‌شده به آن‌ها تعلق دارند بازمی‌گرداند (در هر خط یک واحد)\&. اگر PID مشخص نشود، واحدی را بازمی‌گرداند که دستور
\fBsystemctl\fR
در آن فراخوانی شده است\&.
.sp
اضافه شده در نسخه 254\&.
.RE
.SS "دستورات فایل‌های واحد"
.PP
\fBlist\-unit\-files\fR [\fIPATTERN\&...\fR]
.RS 4
فایل‌های واحد نصب‌شده روی سیستم را همراه با وضعیت فعال‌سازی آن‌ها (همان‌طور که توسط
\fBis\-enabled\fR
گزارش می‌شود) فهرست می‌کند\&. اگر یک یا چند
\fIPATTERN\fR
مشخص شود، فقط فایل‌های واحدی که نام آن‌ها با یکی از الگوها مطابقت دارد نشان داده می‌شوند (الگوهای منطبق با مسیرهای سیستم فایل فایل‌های واحد پشتیبانی نمی‌شوند)\&.
.sp
برخلاف
\fBlist\-units\fR،
این دستور علاوه بر واحدهای صریحاً نمونه‌سازی‌شده، واحدهای الگو را نیز فهرست می‌کند\&.
.sp
اضافه شده در نسخه 233\&.
.RE
.PP
\fBenable \fR\fB\fIUNIT\fR\fR\fB\&...\fR, \fBenable \fR\fB\fIPATH\fR\fR\fB\&...\fR
.RS 4
یک یا چند واحد یا نمونه واحد را فعال می‌کند\&. این کار مجموعه‌ای از پیوندهای نمادین (symlinks) را طبق آنچه در بخش‌های [Install] فایل‌های واحد مشخص شده ایجاد می‌کند\&. پس از ایجاد پیوندها، پیکربندی مدیر سیستم مجدداً بارگذاری می‌شود (مشابه
\fBdaemon\-reload\fR)
تا اطمینان حاصل شود که تغییرات فوراً اعمال می‌شوند\&. توجه داشته باشید که این دستور اثر شروع واحدهای فعال‌شده را
\fIندارد\fR\&.
در صورت تمایل به راه‌اندازی هم‌زمان، این دستور را با سوییچ
\fB\-\-now\fR
ترکیب کنید، یا بعداً دستور
\fBstart\fR
را با آرگومان‌های مناسب اجرا فرمایید\&. توجه داشته باشید که در مورد فعال‌سازی نمونه واحد (یعنی فعال‌سازی واحدهایی به شکل
foo@bar\&.service)،
پیوندهای نمادینی هم‌نام با نمونه‌ها در پوشه پیکربندی واحد ایجاد می‌شوند، اما آن‌ها به همان فایل الگوی واحد اصلی که از آن نمونه‌سازی شده‌اند اشاره می‌کنند\&.
.sp
این دستور یا نام‌های معتبر واحد را انتظار دارد (که در این صورت دایرکتوری‌های مختلف فایل واحد به طور خودکار برای یافتن نام‌های مناسب جستجو می‌شوند)، یا مسیرهای مطلق به فایل‌های واحد را می‌پذیرد (که در این حالت این فایل‌ها مستقیماً خوانده می‌شوند)\&. اگر فایل واحد مشخص‌شده در خارج از پوشه‌های معمولی فایل واحد قرار داشته باشد، یک پیوند نمادین اضافی ایجاد می‌شود که آن را به مسیر پیکربندی واحد پیوند می‌دهد و بدین ترتیب اطمینان حاصل می‌شود که در صورت درخواست توسط دستوراتی مانند
\fBstart\fR
پیدا خواهد شد\&. سیستم فایلی که فایل‌های واحد پیوندشده در آن قرار دارند باید هنگام شروع systemd در دسترس باشد (برای مثال هر چیزی زیر
/home/
یا
/var/
مجاز نیست، مگر اینکه آن پوشه‌ها روی سیستم فایل ریشه قرار داشته باشند)\&.
.sp
این دستور عملیات انجام‌شده روی سیستم فایل را چاپ می‌کند\&. این خروجی با ارسال
\fB\-\-quiet\fR
می‌تواند خاموش شود\&.
.sp
توجه داشته باشید که این عملیات تنها پیوندهای نمادین پیشنهادی در بخش [Install] فایل‌های واحد را ایجاد می‌کند\&. اگرچه این دستور روش توصیه‌شده برای دستکاری دایرکتوری پیکربندی واحد است، اما مدیر سیستم آزاد است با قرار دادن یا حذف پیوندهای نمادین در زیر این دایرکتوری، تغییرات اضافی را به صورت دستی اعمال کند\&. این به ویژه برای ایجاد پیکربندی‌هایی که با نصب پیش‌فرض پیشنهادی تفاوت دارند مفید است\&. در این حالت، مدیر سیستم باید مطمئن شود که در صورت لزوم دستور
\fBdaemon\-reload\fR
را به صورت دستی فراخوانی کند تا تغییرات اعمال شوند\&.
.sp
هنگام استفاده از این عملیات روی واحدهای بدون اطلاعات نصب، هشداری در این باره نشان داده می‌شود\&.
\fB\-\-no\-warn\fR
می‌تواند برای سرکوب این هشدار استفاده شود\&.
.sp
فعال‌سازی واحدها نباید با شروع (فعال‌کردن در زمان اجرا) واحدها که توسط دستور
\fBstart\fR
انجام می‌شود اشتباه گرفته شود\&. فعال‌سازی و راه‌اندازی واحدها مستقل از یکدیگرند: واحدها ممکن است بدون راه‌اندازی فعال شوند و بدون فعال‌سازی راه‌اندازی گردند\&. فعال‌سازی صرفاً واحد را به مکان‌های مختلف پیشنهادی قلاب می‌کند (مثلاً تا واحد به طور خودکار هنگام بوت یا هنگام اتصال نوع خاصی از سخت‌افزار شروع شود)\&. راه‌اندازی در واقع فرآیند دیمن را اجرا می‌کند (در مورد واحدهای سرویس)، یا سوکت را متصل می‌کند (در مورد واحدهای سوکت) و غیره\&.
.sp
بسته به اینکه
\fB\-\-system\fR،
\fB\-\-user\fR،
\fB\-\-runtime\fR
یا
\fB\-\-global\fR
مشخص شده باشد، این دستور واحد را برای سیستم، فقط برای کاربر فراخوان، فقط برای این بوت سیستم، یا برای تمام ورودهای آینده همه کاربران فعال می‌کند\&. توجه داشته باشید که در حالت آخر، هیچ پیکربندی دیمن systemd مجدداً بارگذاری نمی‌شود\&.
.sp
استفاده از
\fBenable\fR
روی واحدهای ماسک‌شده پشتیبانی نمی‌شود و منجر به خطا خواهد شد\&.
.RE
.PP
\fBdisable \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
یک یا چند واحد را غیرفعال می‌کند\&. این دستور تمام پیوندهای نمادین به فایل‌های واحد پشتیبان را از دایرکتوری پیکربندی واحد حذف می‌کند و بنابراین هرگونه تغییر ایجادشده توسط
\fBenable\fR
یا
\fBlink\fR
را بازمی‌گرداند\&. توجه داشته باشید که این کار
\fIتمام\fR
پیوندهای نمادین به فایل‌های واحد منطبق را حذف می‌کند، از جمله پیوندهایی که به صورت دستی ایجاد شده‌اند، و نه فقط مواردی که واقعاً توسط
\fBenable\fR
یا
\fBlink\fR
ساخته شده‌اند\&. توجه داشته باشید در حالی که
\fBdisable\fR
اثر
\fBenable\fR
را خنثی می‌کند، این دو دستور کاملاً متقارن نیستند، زیرا
\fBdisable\fR
ممکن است پیوندهای نمادین بیشتری نسبت به آنچه فراخوانی قبلی
\fBenable\fR
ایجاد کرده بود حذف کند\&.
.sp
این دستور فقط نام‌های معتبر واحد را انتظار دارد و مسیرهای فایل‌های واحد را نمی‌پذیرد\&.
.sp
علاوه بر واحدهای مشخص‌شده به عنوان آرگومان، تمام واحدهایی که در تنظیم
\fIAlso=\fR
موجود در بخش [Install] هر یک از فایل‌های واحد مورد عمل فهرست شده‌اند نیز غیرفعال می‌شوند\&.
.sp
این دستور پس از اتمام عملیات، پیکربندی مدیر سیستم را به صورت ضمنی مجدداً بارگذاری می‌کند\&. توجه داشته باشید که این دستور به صورت خودکار واحدهایی را که غیرفعال می‌شوند متوقف نمی‌کند\&. در صورت تمایل، این دستور را با سوییچ
\fB\-\-now\fR
ترکیب کنید، یا بعداً دستور
\fBstop\fR
را با آرگومان‌های مناسب فراخوانی فرمایید\&.
.sp
این دستور اطلاعات مربوط به عملیات انجام‌شده روی سیستم فایل (حذف پیوندهای نمادین) را چاپ می‌کند\&. این خروجی با ارسال
\fB\-\-quiet\fR
قابل خاموش کردن است\&.
.sp
اگر واحدی غیرفعال شود اما واحدهای راه‌انداز (triggering) آن هنوز فعال باشند، هشداری حاوی نام واحدهای راه‌انداز نمایش داده می‌شود\&.
\fB\-\-no\-warn\fR
می‌تواند برای خاموش کردن هشدار استفاده شود\&.
.sp
هنگامی که این دستور با
\fB\-\-user\fR
استفاده می‌شود، واحدهای در حال ویرایش ممکن است هنوز در محدوده سراسری (global) فعال باشند، و بنابراین حتی پس از غیرفعال‌سازی موفقیت‌آمیز در محدوده کاربر، به طور خودکار شروع شوند\&. در این حالت، هشداری درباره آن نشان داده می‌شود که با استفاده از
\fB\-\-no\-warn\fR
می‌توان آن را نادیده گرفت\&.
.sp
این دستور گزینه‌های
\fB\-\-system\fR،
\fB\-\-user\fR،
\fB\-\-runtime\fR،
\fB\-\-global\fR
و
\fB\-\-no\-warn\fR
را به روشی مشابه
\fBenable\fR
رعایت می‌کند\&.
.sp
اضافه شده در نسخه 238\&.
.RE
.PP
\fBreenable \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
فعال‌سازی مجدد یک یا چند واحد مشخص‌شده در خط فرمان\&. این ترکیبی از
\fBdisable\fR
و
\fBenable\fR
است و برای بازنشانی پیوندهای نمادینی که یک فایل واحد با آن‌ها فعال شده است به مقادیر پیش‌فرض پیکربندی‌شده در بخش [Install] آن مفید است\&. این دستور فقط نام واحد را انتظار دارد و مسیر فایل‌های واحد را نمی‌پذیرد\&.
.sp
این دستور پس از اتمام عملیات، پیکربندی مدیر سیستم را به طور ضمنی مجدداً بارگذاری می‌کند\&. توجه داشته باشید که این دستور به صورت خودکار واحدهای غیرفعال‌شده را مجدداً راه‌اندازی نمی‌کند\&. در صورت تمایل، یا این دستور را با سوییچ
\fB\-\-now\fR
ترکیب کنید، یا بعداً دستور
\fBtry\-restart\fR
را با آرگومان‌های مناسب فراخوانی کنید\&.
.sp
اضافه شده در نسخه 238\&.
.RE
.PP
\fBpreset \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
بازنشانی وضعیت فعال/غیرفعال یک یا چند فایل واحد مشخص‌شده در خط فرمان، به مقادیر پیش‌فرض پیکربندی‌شده در فایل‌های خط‌مشی پیش‌تنظیم (preset policy)\&. این دستور بسته به نحوه فهرست شدن واحد در فایل‌های پیش‌تنظیم، اثری مشابه
\fBdisable\fR
یا
\fBenable\fR
دارد\&.
.sp
از
\fB\-\-preset\-mode=\fR
برای کنترل اینکه آیا واحدها باید فعال و غیرفعال شوند، یا فقط فعال شوند، یا فقط غیرفعال شوند استفاده کنید\&.
.sp
اگر واحد فاقد اطلاعات نصب باشد، توسط این دستور نادیده گرفته می‌شود\&.
\fIUNIT\fR
باید نام واقعی واحد باشد، هرگونه نام مستعار نادیده گرفته می‌شود\&.
.sp
برای اطلاعات بیشتر در مورد قالب خط‌مشی پیش‌تنظیم، به
\fBsystemd.preset\fR(5)
مراجعه فرمایید\&.
.sp
اضافه شده در نسخه 238\&.
.RE
.PP
\fBpreset\-all\fR
.RS 4
تمام فایل‌های واحد نصب‌شده را به مقادیر پیش‌فرض پیکربندی‌شده در فایل‌های خط‌مشی پیش‌تنظیم بازنشانی می‌کند (به بالا مراجعه کنید)\&.
.sp
از
\fB\-\-preset\-mode=\fR
برای کنترل اینکه آیا واحدها باید فعال و غیرفعال شوند، یا فقط فعال، یا فقط غیرفعال شوند استفاده کنید\&.
.sp
اضافه شده در نسخه 215\&.
.RE
.PP
\fBis\-enabled \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
بررسی می‌کند که آیا هر یک از فایل‌های واحد مشخص‌شده فعال هستند یا خیر (همانند با
\fBenable\fR)\&. در صورتی که حداقل یک واحد فعال باشد کد خروج 0 و در غیر این صورت مقدار غیرصفر بازمی‌گرداند\&. وضعیت فعال‌سازی فعلی را چاپ می‌کند (به جدول مراجعه کنید)\&. برای خاموش کردن این خروجی، از
\fB\-\-quiet\fR
استفاده کنید\&. برای نمایش اهداف نصب، از
\fB\-\-full\fR
استفاده فرمایید\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&3.\ \& خروجی is\-enabled
.TS
allbox tab(:);
lB lB lB.
T{
نام
T}:T{
توضیحات
T}:T{
کد خروج
T}
.T&
l l l
l ^ ^
l l l
l ^ ^
l l l
l l l
l ^ ^
l l l
l l l
l l l
l l l
l l l
l l l
l l l.
T{
"enabled"
T}:T{
از طریق پیوندهای نمادین \&.wants/، \&.requires/ یا \fIAlias=\fR فعال شده است (به طور دائم در /etc/systemd/system/ یا به طور موقت در /run/systemd/system/)\&.
T}:T{
0
T}
T{
"enabled\-runtime"
T}::
T{
"linked"
T}:T{
از طریق یک یا چند پیوند نمادین به فایل واحد در دسترس قرار گرفته است (به طور دائم در /etc/systemd/system/ یا موقتی در /run/systemd/system/)، اگرچه ممکن است فایل واحد خارج از مسیر جستجوی فایل‌های واحد قرار داشته باشد\&.
T}:T{
> 0
T}
T{
"linked\-runtime"
T}::
T{
"alias"
T}:T{
نام یک نام مستعار است (پیوند نمادین به فایل واحد دیگر)\&.
T}:T{
0
T}
T{
"masked"
T}:T{
به طور کامل غیرفعال شده است، به طوری که هرگونه عملیات شروع بر روی آن با شکست مواجه می‌شود (به طور دائم در /etc/systemd/system/ یا موقت در /run/systemd/system/)\&.
T}:T{
> 0
T}
T{
"masked\-runtime"
T}::
T{
"static"
T}:T{
فایل واحد فعال نشده است و هیچ پیش‌بینی برای فعال‌سازی در بخش [Install] فایل واحد ندارد\&.
T}:T{
0
T}
T{
"indirect"
T}:T{
خود فایل واحد فعال نشده است، اما دارای تنظیم غیرخالی \fIAlso=\fR در بخش [Install] است که فایل‌های واحد دیگری را که ممکن است فعال باشند فهرست می‌کند، یا دارای نام مستعار تحت نام دیگری از طریق پیوند نمادین است که در \fIAlso=\fR مشخص نشده است\&. برای فایل‌های الگوی واحد، نمونه‌ای غیر از نمونه مشخص‌شده در \fIDefaultInstance=\fR فعال است\&.
T}:T{
0
T}
T{
"disabled"
T}:T{
فایل واحد فعال نشده است، اما شامل بخش [Install] همراه با دستورالعمل‌های نصب است\&.
T}:T{
> 0
T}
T{
"generated"
T}:T{
فایل واحد به طور پویا از طریق یک ابزار مولد (generator) تولید شده است\&. به \fBsystemd.generator\fR(7) مراجعه کنید\&. فایل‌های واحد تولیدشده ممکن است فعال نشوند، آن‌ها به طور ضمنی توسط مولد خود فعال می‌شوند\&.
T}:T{
0
T}
T{
"transient"
T}:T{
فایل واحد به صورت پویا با API زمان اجرا ایجاد شده است\&. واحدهای گذرا ممکن است فعال نشوند\&.
T}:T{
0
T}
T{
"bad"
T}:T{
فایل واحد نامعتبر است یا خطای دیگری روی داده است\&. توجه داشته باشید که \fBis\-enabled\fR در عمل این وضعیت را بازنمی‌گرداند، بلکه یک پیام خطا چاپ می‌کند\&. با این حال، فهرست فایل واحد ارائه‌شده توسط \fBlist\-unit\-files\fR ممکن است آن را نشان دهد\&.
T}:T{
> 0
T}
T{
"not\-found"
T}:T{
فایل واحد وجود ندارد\&.
T}:T{
4
T}
.TE
.sp 1
اضافه شده در نسخه 238\&.
.RE
.PP
\fBmask \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
ماسک کردن یک یا چند واحد، همان‌طور که در خط فرمان مشخص شده است\&. این کار فایل‌های واحد را به
/dev/null
پیوند می‌دهد و راه‌اندازی آن‌ها را غیرممکن می‌سازد\&. این یک نسخه قوی‌تر از
\fBdisable\fR
است، زیرا از هر نوع فعال‌سازی واحد، از جمله فعال‌سازی خودکار و دستی جلوگیری می‌کند\&. از این گزینه با احتیاط استفاده کنید\&. این دستور گزینه
\fB\-\-runtime\fR
را رعایت می‌کند تا فقط تا راه‌اندازی مجدد بعدی سیستم به طور موقت ماسک شود\&. گزینه
\fB\-\-now\fR
می‌تواند برای اطمینان از متوقف شدن واحدها نیز استفاده شود\&. این دستور فقط نام‌های معتبر واحد را می‌پذیرد و مسیر فایل‌های واحد را قبول نمی‌کند\&.
.sp
توجه داشته باشید که این کار یک پیوند نمادین به نام واحد در
/etc/systemd/system/
(در صورتی که
\fB\-\-runtime\fR
مشخص نشده باشد) یا در
/run/systemd/system/
(در صورت تعیین
\fB\-\-runtime\fR)
ایجاد می‌کند\&. اگر یک فایل واحد منطبق از قبل زیر این دایرکتوری‌ها وجود داشته باشد، این عملیات با شکست مواجه خواهد شد\&. این بدان معناست که این عملیات اساساً برای ماسک کردن واحدهای ارائه‌شده توسط توزیع مناسب است (زیرا آن‌ها در
/usr/lib/systemd/system/
عرضه می‌شوند و نه در دو پوشه ذکرشده)، اما معمولاً برای واحدهایی که به صورت محلی ایجاد شده‌اند کار نمی‌کند (زیرا آن‌ها دقیقاً در همان دو پوشه فوق قرار دارند)\&. محدودیت‌های مشابهی برای حالت
\fB\-\-user\fR
اعمال می‌شود، که در این حالت دایرکتوری‌ها زیر پوشه خانگی کاربر قرار دارند\&.
.sp
اگر واحدی ماسک شود اما واحدهای راه‌انداز آن همچنان فعال باشند، هشداری شامل نام واحدهای راه‌انداز نمایش داده می‌شود\&.
\fB\-\-no\-warn\fR
می‌تواند برای سرکوب این هشدار استفاده شود\&.
.sp
اضافه شده در نسخه 238\&.
.RE
.PP
\fBunmask \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
خروج یک یا چند فایل واحد از حالت ماسک، همان‌طور که در خط فرمان تعیین شده است\&. این کار اثر
\fBmask\fR
را خنثی می‌کند\&. این دستور فقط نام‌های معتبر واحد را می‌پذیرد و مسیر فایل‌های واحد را قبول نمی‌کند\&.
.sp
اضافه شده در نسخه 238\&.
.RE
.PP
\fBlink \fR\fB\fIPATH\fR\fR\fB\&...\fR
.RS 4
پیوند دادن یک فایل واحد که در مسیر جستجوی فایل‌های واحد نیست به مسیر جستجو\&. این دستور مسیر مطلق به فایل واحد را انتظار دارد\&. اثر این دستور با
\fBdisable\fR
قابل بازگشت است\&. اثر این دستور این است که فایل واحد برای دستوراتی مانند
\fBstart\fR
در دسترس قرار می‌گیرد، حتی اگر مستقیماً در مسیر جستجوی واحدها نصب نشده باشد\&. سیستم فایلی که فایل‌های واحد پیوندشده در آن قرار دارند باید هنگام شروع systemd در دسترس باشد (برای مثال هر چیزی در زیر
/home/
یا
/var/
مجاز نیست، مگر اینکه آن دایرکتوری‌ها روی سیستم فایل ریشه قرار داشته باشند)\&.
.sp
اضافه شده در نسخه 233\&.
.RE
.PP
\fBrevert \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
بازگردانی یک یا چند فایل واحد به نسخه ارائه‌شده توسط توزیع‌کننده (vendor)\&. این دستور فایل‌های پیکربندی افزایشی (drop\-in) که واحدهای مشخص‌شده را تغییر می‌دهند، و همچنین هر فایل واحد پیکربندی‌شده توسط کاربر که جایگزین فایل واحد توزیع می‌شود را حذف می‌کند\&. به طور مشخص، برای یک واحد
"foo\&.service"،
پوشه‌های منطبق
"foo\&.service\&.d/"
همراه با تمام فایل‌های داخل آن‌ها، هم در پوشه‌های پیکربندی پایدار و هم زمان اجرا (یعنی زیر
/etc/systemd/system
و
/run/systemd/system)
حذف می‌شوند؛ اگر فایل واحد دارای نسخه‌ای ارائه‌شده توسط توزیع باشد (یعنی فایل واحدی زیر
/usr/)
هر فایل واحد پایدار یا زمان اجرای منطبق که آن را بازنویسی (override) کرده باشد نیز حذف می‌شود\&. توجه داشته باشید اگر یک فایل واحد فاقد نسخه توزیع‌کننده باشد (یعنی فقط زیر
/etc/systemd/system
یا
/run/systemd/system
تعریف شده باشد، نه در فایلی زیر
/usr/)،
آن‌گاه حذف نمی‌شود\&. همچنین، اگر واحدی ماسک شده باشد، از حالت ماسک خارج می‌گردد\&.
.sp
در عمل، از این دستور می‌توان برای بازگردانی تمام تغییرات ایجادشده با
\fBsystemctl edit\fR،
\fBsystemctl set\-property\fR
و
\fBsystemctl mask\fR
استفاده کرد و فایل واحد اصلی با تنظیمات اولیه‌اش دوباره اثرگذار خواهد شد\&.
.sp
اضافه شده در نسخه 230\&.
.RE
.PP
\fBadd\-wants \fR\fB\fITARGET\fR\fR\fB \fR\fB\fIUNIT\fR\fR\fB\&...\fR, \fBadd\-requires \fR\fB\fITARGET\fR\fR\fB \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
به ترتیب وابستگی‌های
"Wants="
یا
"Requires="
را به
\fITARGET\fR
مشخص‌شده برای یک یا چند واحد اضافه می‌کند\&.
.sp
این دستور گزینه‌های
\fB\-\-system\fR،
\fB\-\-user\fR،
\fB\-\-runtime\fR
و
\fB\-\-global\fR
را به روشی مشابه
\fBenable\fR
رعایت می‌کند\&.
.sp
اضافه شده در نسخه 217\&.
.RE
.PP
\fBedit \fR\fB\fIUNIT\fR\fR\fB\&...\fR
.RS 4
ویرایش یا جایگزینی یک قطعه drop\-in یا فایل اصلی واحد، برای گسترش یا بازنویسی تعریف واحد مشخص‌شده\&.
.sp
بسته به اینکه
\fB\-\-system\fR
(پیش‌فرض)،
\fB\-\-user\fR،
یا
\fB\-\-global\fR
مشخص شده باشد، این دستور بر روی فایل‌های واحد سیستم، فایل‌های واحد برای کاربر فراخوان، یا فایل‌های واحد مشترک بین تمام کاربران عمل می‌کند\&.
.sp
ویرایشگر متن (به بخش "محیط" در ادامه مراجعه کنید) بر روی فایل‌های موقتی باز می‌شود که در صورت خروج موفقیت‌آمیز ویرایشگر در محل واقعی نوشته خواهند شد\&. پس از اتمام ویرایش، پیکربندی مجدداً بارگذاری می‌شود که معادل
\fBsystemctl daemon\-reload \-\-system\fR
یا
\fBsystemctl daemon\-reload \-\-user\fR
است\&. برای
\fBedit \-\-global\fR،
بارگذاری مجدد انجام نمی‌شود و ویرایش‌ها فقط برای ورودهای بعدی (یا پس از درخواست بارگذاری مجدد به روشی دیگر) اعمال خواهند شد\&.
.sp
اگر
\fB\-\-full\fR
مشخص شود، یک جایگزین کامل برای فایل واحد اصلی ایجاد یا ویرایش می‌شود\&. در غیر این صورت، یک فایل drop\-in ایجاد یا ویرایش خواهد شد\&.
.sp
اگر
\fB\-\-drop\-in=\fR
مشخص شود، نام فایل drop\-in داده‌شده به جای نام پیش‌فرض
override\&.conf
استفاده خواهد شد\&.
.sp
واحد باید از قبل وجود داشته باشد، یعنی فایل اصلی واحد آن باید موجود باشد\&. اگر
\fB\-\-force\fR
مشخص شده باشد، این الزام نادیده گرفته می‌شود و یک واحد جدید ممکن است ایجاد شود (با
\fB\-\-full\fR)،
یا یک drop\-in برای یک واحد ناموجود ساخته شود\&.
.sp
اگر
\fB\-\-runtime\fR
مشخص شود، تغییرات به طور موقت در
/run/
اعمال می‌شوند و در راه‌اندازی مجدد بعدی از بین خواهند رفت\&.
.sp
اگر
\fB\-\-stdin\fR
مشخص شود، محتویات جدید از ورودی استاندارد خوانده می‌شوند\&. در این حالت، محتویات قبلی فایل دور ریخته می‌شوند\&.
.sp
اگر فایل موقت پس از خروج از ویرایشگر خالی باشد، تغییرات واحد لغو می‌شوند\&.
.sp
توجه داشته باشید که این دستور نمی‌تواند برای ویرایش از راه دور واحدها استفاده شود و نمی‌توانید واحدهایی را که در
/etc/
هستند به طور موقت در
/run/
ویرایش کنید، زیرا اولویت با
/etc/
است\&.
.sp
اضافه شده در نسخه 218\&.
.RE
.PP
\fBget\-default\fR
.RS 4
بازگرداندن هدف پیش‌فرضی که سیستم به آن بوت می‌شود\&. این نام واحد هدفی را که
default\&.target
به آن پیوند (نام مستعار) داده شده برمی‌گرداند\&.
.sp
اضافه شده در نسخه 205\&.
.RE
.PP
\fBset\-default \fR\fB\fITARGET\fR\fR
.RS 4
تنظیم هدف پیش‌فرض برای بوت سیستم\&. این دستور نام مستعار (پیوند نمادین)
default\&.target
را به واحد هدف داده‌شده متصل می‌کند\&.
.sp
اضافه شده در نسخه 205\&.
.RE
.SS "دستورات ماشین‌ها"
.PP
\fBlist\-machines\fR [\fIPATTERN\fR\&...]
.RS 4
فهرست کردن میزبان و تمام کانتینرهای محلی در حال اجرا همراه با وضعیت آن‌ها\&. اگر یک یا چند
\fIPATTERN\fR
مشخص شود، فقط کانتینرهایی که با یکی از آن‌ها منطبق هستند نمایش داده می‌شوند\&.
.sp
اضافه شده در نسخه 212\&.
.RE
.SS "دستورات کارها (Jobs)"
.PP
\fBlist\-jobs \fR\fB[\fIPATTERN\&...]\fR
.RS 4
فهرست کردن کارهایی که در حال انجام هستند\&. اگر یک یا چند
\fIPATTERN\fR
مشخص شود، فقط کارهای واحدهایی که با یکی از آن‌ها مطابقت دارند نمایش داده می‌شوند\&.
.sp
هنگامی که با
\fB\-\-after\fR
یا
\fB\-\-before\fR
ترکیب شود، فهرست با اطلاعاتی درباره اینکه هر کار منتظر چه کار دیگری است و چه کارهای دیگری منتظر آن هستند تکمیل می‌شود، به توضیحات بالا مراجعه کنید\&.
.sp
اضافه شده در نسخه 233\&.
.RE
.PP
\fBcancel \fR\fB[\fIJOB\fR\&...]\fR
.RS 4
لغو یک یا چند کار مشخص‌شده در خط فرمان بر اساس شناسه‌های عددی کار آن‌ها\&. اگر هیچ شناسه کاری مشخص نشود، تمام کارهای معلق لغو می‌شوند\&.
.sp
اضافه شده در نسخه 233\&.
.RE
.SS "دستورات متغیرهای محیطی"
.PP
\fBsystemd\fR
از یک بلوک محیطی پشتیبانی می‌کند که به فرآیندهایی که مدیر سیستم اجرا می‌کند ارسال می‌شود\&. نام متغیرها می‌تواند شامل حروف ASCII، ارقام و کاراکتر زیرخط (underscore) باشد\&. نام متغیرها نمی‌تواند خالی باشد یا با یک رقم شروع شود\&. در مقادیر متغیرها، اکثر کاراکترها مجاز هستند، اما کل دنباله باید UTF\-8 معتبر باشد\&. (توجه داشته باشید که کاراکترهای کنترلی مانند خط جدید (\fBNL\fR)، تب (\fBTAB\fR) یا کاراکتر اسکیپ (\fBESC\fR)،
\fIهمگی\fR
اسکی معتبر و در نتیجه UTF\-8 معتبر هستند)\&. طول کل بلوک محیطی به مقدار
\fB_SC_ARG_MAX\fR
تعریف‌شده توسط
\fBsysconf\fR(3)
محدود است\&.
.PP
\fBshow\-environment\fR
.RS 4
تخلیه (چاپ) بلوک محیطی مدیر systemd\&. این بلوک محیطی است که به تمام فرآیندهای تولیدشده توسط مدیر سیستم منتقل می‌شود\&. بلوک محیطی در قالبی سرراست و مناسب برای وارد کردن (source) در اکثر شل‌ها چاپ می‌شود\&. اگر هیچ کاراکتر خاص یا فاصله‌ای در مقادیر متغیرها وجود نداشته باشد، هیچ اسکیپی انجام نمی‌شود و انتساب‌ها به شکل
"VARIABLE=value"
هستند\&. اگر فاصله یا کاراکترهایی با معنای خاص در شل وجود داشته باشند، از اسکیپ دلار\-تک‌کوتیشن استفاده می‌شود و انتساب‌ها به شکل
"VARIABLE=$\*(Aqvalue\*(Aq"
خواهند بود\&. این نحو توسط
\fBbash\fR(1)،
\fBzsh\fR(1)،
\fBksh\fR(1)
و
\fBash\fR(1)
در
\fBbusybox\fR(1)
پشتیبانی می‌شود، اما در
\fBdash\fR(1)
یا
\fBfish\fR(1)
پشتیبانی نمی‌شود\&.
.sp
توجه داشته باشید که این دستور بلوک
\fIمؤثر\fR
را نشان می‌دهد، یعنی ترکیب متغیرهای محیطی پیکربندی‌شده از طریق فایل‌های پیکربندی، مولدهای محیطی و از طریق IPC (یعنی از طریق
\fBset\-environment\fR
که در زیر توضیح داده شده است)\&. در لحظه‌ای که یک فرآیند واحد منشعب می‌شود، این بلوک محیطی ترکیبی با متغیرهای محیطی به ازای هر واحد ترکیب می‌شود که در این دستور قابل مشاهده نیستند\&.
.RE
.PP
\fBset\-environment \fR\fB\fIVARIABLE=VALUE\fR\fR\fB\&...\fR
.RS 4
تنظیم یک یا چند متغیر محیطی مدیر سرویس، همان‌طور که در خط فرمان مشخص شده است\&. اگر نام‌ها و مقادیر متغیرها با قوانین ذکرشده در بالا مطابقت نداشته باشند، این دستور با شکست مواجه می‌شود\&.
.sp
توجه داشته باشید که این دستور روی یک بلوک محیطی مجزا از بلوک محیطی پیکربندی‌شده از پیکربندی مدیر سرویس و مولدهای محیطی عمل می‌کند\&. هر زمان که فرآیندی فراخوانی می‌شود، این دو بلوک با هم ترکیب شده (همچنین متغیرهای محیطی اختصاصی هر سرویس را در خود ادغام می‌کنند) و به آن منتقل می‌شوند\&. دستور
\fBshow\-environment\fR
ترکیب این بلوک‌ها را نشان می‌دهد، به توضیحات بالا مراجعه کنید\&.
.sp
اضافه شده در نسخه 233\&.
.RE
.PP
\fBunset\-environment \fR\fB\fIVARIABLE\fR\fR\fB\&...\fR
.RS 4
حذف یک یا چند متغیر محیطی مدیر systemd\&. اگر فقط یک نام متغیر مشخص شود، بدون توجه به مقدار آن حذف خواهد شد\&. اگر یک متغیر و یک مقدار مشخص شوند، متغیر تنها در صورتی حذف می‌شود که دارای همان مقدار مشخص‌شده باشد\&.
.sp
توجه داشته باشید که این دستور روی بلوک محیطی جداگانه از بلوک محیطی پیکربندی‌شده از تنظیمات مدیر سرویس و مولدهای محیطی عمل می‌کند\&. هر زمان فرآیندی اجرا شود، دو بلوک ترکیب شده و به آن منتقل می‌شوند\&. دستور
\fBshow\-environment\fR
ترکیب بلوک‌ها را نشان می‌دهد\&. توجه داشته باشید که این بدان معناست که این دستور نمی‌تواند برای حذف متغیرهای محیطی تعریف‌شده در فایل‌های پیکربندی مدیر سرویس یا از طریق مولدها استفاده شود\&.
.sp
اضافه شده در نسخه 233\&.
.RE
.PP
\fBimport\-environment\fR \fIVARIABLE\&...\fR
.RS 4
وارد کردن تمام، یک یا چند متغیر محیطی تنظیم‌شده در سمت کلاینت به بلوک محیطی مدیر systemd\&. اگر فهرستی از نام‌های متغیرهای محیطی ارسال شود، مقادیر سمت کلاینت به بلوک محیطی مدیر وارد می‌شوند\&. اگر هر نامی یک نام متغیر معتبر نباشد یا طبق قوانین توصیف‌شده مقادیر نامعتبر داشته باشد، خطا ایجاد می‌شود\&. اگر هیچ آرگومانی ارسال نشود، کل بلوک محیطی به ارث رسیده توسط فرآیند
\fBsystemctl\fR
وارد می‌شود\&. در این حالت، هر متغیر محیطی نامعتبر به ارث رسیده بدون اعلام نادیده گرفته می‌شود\&.
.sp
وارد کردن کل بلوک محیطی به ارث رسیده (فراخوانی این دستور بدون آرگومان) منسوخ شده است\&. یک پوسته ده‌ها متغیر را تنظیم می‌کند که فقط به صورت محلی منطقی هستند و فقط برای فرآیندهایی که فرزند آن پوسته هستند در نظر گرفته شده‌اند\&. چنین متغیرهایی در بلوک محیطی سراسری برای فرآیندهای دیگر گیج‌کننده خواهند بود\&.
.sp
اضافه شده در نسخه 209\&.
.RE
.SS "دستورات وضعیت مدیر سیستم"
.PP
\fBdaemon\-reload\fR
.RS 4
بارگذاری مجدد پیکربندی مدیر systemd\&. این کار تمام مولدها را مجدداً اجرا می‌کند (به
\fBsystemd.generator\fR(7)
مراجعه فرمایید)، تمام فایل‌های واحد را دوباره بارگذاری کرده و کل درخت وابستگی را بازسازی می‌کند\&. در حین بارگذاری مجدد دیمن، تمام سوکت‌هایی که systemd از طرف پیکربندی کاربر روی آن‌ها شنود می‌کند، در دسترس باقی خواهند ماند\&.
.sp
این دستور نباید با دستور
\fBreload\fR
اشتباه گرفته شود\&.
.RE
.PP
\fBdaemon\-reexec\fR
.RS 4
اجرای مجدد مدیر systemd\&. این دستور وضعیت مدیر را سریال‌سازی کرده، فرآیند را مجدداً اجرا می‌کند و وضعیت را دوباره بازیابی می‌نماید\&. این دستور به جز برای اشکال‌زدایی و ارتقای بسته‌ها کاربرد کمی دارد\&. گاهی اوقات ممکن است به عنوان یک
\fBdaemon\-reload\fR
سنگین‌تر مفید باشد\&. در حین اجرای مجدد دیمن، تمام سوکت‌هایی که systemd به نمایندگی از کاربر شنود می‌کند در دسترس خواهند ماند\&.
.RE
.PP
\fBlog\-level\fR [\fILEVEL\fR]
.RS 4
اگر هیچ آرگومانی داده نشود، سطح لاگ فعلی مدیر را چاپ می‌کند\&. اگر آرگومان اختیاری
\fILEVEL\fR
ارائه شود، دستور سطح لاگ فعلی مدیر را به
\fILEVEL\fR
تغییر می‌دهد (همان مقادیری را می‌پذیرد که برای
\fB\-\-log\-level=\fR
در
\fBsystemd\fR(1)
توضیح داده شده است)\&.
.sp
اضافه شده در نسخه 244\&.
.RE
.PP
\fBlog\-target\fR [\fITARGET\fR]
.RS 4
اگر هیچ آرگومانی داده نشود، مقصد لاگ فعلی مدیر را چاپ می‌کند\&. اگر یک آرگومان اختیاری
\fITARGET\fR
ارائه شود، دستور مقصد لاگ فعلی مدیر را به
\fITARGET\fR
تغییر می‌دهد (همان مقادیری را می‌پذیرد که برای
\fB\-\-log\-target=\fR
در
\fBsystemd\fR(1)
توضیح داده شده است)\&.
.sp
اضافه شده در نسخه 244\&.
.RE
.PP
\fBservice\-watchdogs\fR [yes|no]
.RS 4
اگر هیچ آرگومانی داده نشود، وضعیت فعلی واچ‌داگ‌های زمان اجرای سرویس مدیر را چاپ می‌کند\&. اگر یک آرگومان بولی اختیاری ارائه شود، واچ‌داگ‌های زمان اجرای سرویس (\fBWatchdogSec=\fR) و اقدامات اضطراری (مانند
\fBOnFailure=\fR
یا
\fBStartLimitAction=\fR)
را به صورت سراسری فعال یا غیرفعال می‌کند؛ به
\fBsystemd.service\fR(5)
مراجعه کنید\&. واچ‌داگ سخت‌افزاری تحت تأثیر این تنظیم قرار نمی‌گیرد\&.
.sp
اضافه شده در نسخه 244\&.
.RE
.SS "دستورات سیستمی"
.PP
\fBis\-system\-running\fR
.RS 4
بررسی می‌کند که آیا سیستم عملیاتی است یا خیر\&. در صورتی که سیستم کاملاً بالا آمده و در حال اجرا باشد، به ویژه در حالت‌های راه‌اندازی (startup)، خاموش شدن (shutdown) یا نگهداری (maintenance) نباشد و هیچ سرویس ناموفقی نداشته باشد، موفقیت (کد خروج 0) بازگردانده می‌شود\&. در غیر این صورت عدم موفقیت (کد خروج غیرصفر) بازگردانده می‌شود\&. علاوه بر این، وضعیت فعلی در یک رشته کوتاه در خروجی استاندارد چاپ می‌شود، به جدول زیر مراجعه کنید\&. از
\fB\-\-quiet\fR
برای خاموش کردن این خروجی استفاده کنید\&.
.sp
از
\fB\-\-wait\fR
برای صبر کردن تا زمان تکمیل فرآیند بوت قبل از چاپ وضعیت فعلی و بازگرداندن وضعیت خطای مناسب استفاده کنید\&. اگر
\fB\-\-wait\fR
استفاده شود، وضعیت‌های
\fIinitializing\fR
یا
\fIstarting\fR
گزارش نمی‌شوند، بلکه دستور تا زمان رسیدن به وضعیت بعدی (مانند
\fIrunning\fR
یا
\fIdegraded\fR)
مسدود (block) خواهد ماند\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&4.\ \& خروجی is\-system\-running
.TS
allbox tab(:);
lB lB lB.
T{
نام
T}:T{
توضیحات
T}:T{
کد خروج
T}
.T&
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l.
T{
\fIinitializing\fR
T}:T{
مراحل اولیه بوت، قبل از رسیدن به basic\&.target یا ورود به وضعیت \fImaintenance\fR\&.
T}:T{
> 0
T}
T{
\fIstarting\fR
T}:T{
مراحل پایانی بوت، قبل از اینکه صف کارها برای اولین بار بیکار شود، یا رسیدن به یکی از اهداف امداد (rescue)\&.
T}:T{
> 0
T}
T{
\fIrunning\fR
T}:T{
سیستم کاملاً عملیاتی و فعال است\&.
T}:T{
0
T}
T{
\fIdegraded\fR
T}:T{
سیستم عملیاتی است اما یک یا چند واحد با شکست مواجه شده‌اند\&.
T}:T{
> 0
T}
T{
\fImaintenance\fR
T}:T{
هدف امداد (rescue) یا اضطراری (emergency) فعال است\&.
T}:T{
> 0
T}
T{
\fIstopping\fR
T}:T{
مدیر سیستم در حال خاموش شدن است\&.
T}:T{
> 0
T}
T{
\fIoffline\fR
T}:T{
مدیر سیستم در حال اجرا نیست\&. به طور خاص، اگر برنامه‌ای ناسازگار به عنوان مدیر سیستم (PID 1) اجرا شود، این وضعیت عملیاتی گزارش می‌شود\&.
T}:T{
> 0
T}
T{
\fIunknown\fR
T}:T{
به دلیل کمبود منابع یا علت خطای دیگر، وضعیت عملیاتی قابل تعیین نیست\&.
T}:T{
> 0
T}
.TE
.sp 1
اضافه شده در نسخه 215\&.
.RE
.PP
\fBdefault\fR
.RS 4
ورود به حالت پیش‌فرض\&. این معادل با
\fBsystemctl isolate default\&.target\fR
است\&. این عملیات به طور پیش‌فرض مسدودکننده (blocking) است؛ برای درخواست رفتار ناهمگام (asynchronous) از
\fB\-\-no\-block\fR
استفاده کنید\&.
.RE
.PP
\fBrescue\fR
.RS 4
ورود به حالت امداد (rescue mode)\&. این معادل با
\fBsystemctl isolate rescue\&.target\fR
است\&. این عملیات به طور پیش‌فرض همگام و مسدودکننده است؛ برای رفتار ناهمگام از
\fB\-\-no\-block\fR
استفاده فرمایید\&.
.RE
.PP
\fBemergency\fR
.RS 4
ورود به حالت اضطراری (emergency mode)\&. این معادل با
\fBsystemctl isolate emergency\&.target\fR
است\&. این عملیات به طور پیش‌فرض همگام و مسدودکننده است؛ برای رفتار ناهمگام از
\fB\-\-no\-block\fR
استفاده کنید\&.
.RE
.PP
\fBhalt\fR
.RS 4
خاموش کردن و متوقف ساختن سیستم (halt)\&. این دستور عمدتاً معادل با
\fBsystemctl start halt\&.target \-\-job\-mode=replace\-irreversibly \-\-no\-block\fR
است، اما همچنین یک پیام همگانی (wall message) برای تمام کاربران ارسال می‌کند\&. این دستور ناهمگام است؛ پس از قرار گرفتن عملیات توقف در صف بازمی‌گردد، بدون اینکه منتظر اتمام آن بماند\&. توجه داشته باشید که این عملیات پس از خاموش کردن سیستم‌عامل صرفاً هسته را متوقف می‌کند و سخت‌افزار را روشن رها می‌سازد\&. برای قطع کامل برق سیستم از
\fBsystemctl poweroff\fR
استفاده کنید (به ادامه مراجعه فرمایید)\&.
.sp
اگر با
\fB\-\-force\fR
ترکیب شود، خاموش شدن تمام سرویس‌های در حال اجرا نادیده گرفته می‌شود، اما تمام فرآیندها کشته شده و تمام سیستم‌های فایل پیاده‌سازی (unmount) یا به صورت فقط‌خواندنی سوار می‌شوند و بلافاصله سیستم متوقف می‌گردد\&. اگر
\fB\-\-force\fR
دو بار مشخص شود، عملیات فوراً بدون پایان دادن به هیچ فرآیندی یا پیاده کردن هیچ سیستم فایلی اجرا می‌شود\&. این کار ممکن است منجر به از دست رفتن داده‌ها شود\&. توجه داشته باشید هنگامی که
\fB\-\-force\fR
دو بار مشخص شود، عملیات halt توسط خود
\fBsystemctl\fR
اجرا می‌شود و با مدیر سیستم ارتباطی برقرار نمی‌گردد\&. این بدان معنی است که دستور حتی در صورت کرش کردن مدیر سیستم باید با موفقیت اجرا شود\&.
.sp
اگر با
\fB\-\-when=\fR
ترکیب شود، خاموش شدن برای پس از برچسب زمانی داده‌شده زمان‌بندی می‌شود\&. و
\fB\-\-when=cancel\fR
خاموش‌سازی زمان‌بندی‌شده را لغو می‌کند\&.
.RE
.PP
\fBpoweroff\fR
.RS 4
خاموش کردن و قطع برق سیستم\&. این عمدتاً معادل با
\fBsystemctl start poweroff\&.target \-\-job\-mode=replace\-irreversibly \-\-no\-block\fR
است، اما همچنین یک پیام همگانی به همه کاربران ارسال می‌کند\&. این دستور ناهمگام است؛ پس از اینکه عملیات قطع برق در صف قرار گرفت بازمی‌گردد، بدون آنکه منتظر تکمیل آن بماند\&.
.sp
این دستور گزینه‌های
\fB\-\-force\fR
و
\fB\-\-when=\fR
را به روشی مشابه
\fBhalt\fR
رعایت می‌کند\&.
.RE
.PP
\fBreboot\fR
.RS 4
خاموش کردن و راه‌اندازی مجدد (reboot) سیستم\&.
.sp
این دستور عمدتاً معادل با
\fBsystemctl start reboot\&.target \-\-job\-mode=replace\-irreversibly \-\-no\-block\fR
است، اما همچنین یک پیام همگانی به تمام کاربران می‌فرستد\&. این دستور ناهمگام است؛ پس از صف‌بندی عملیات ریبوت بازمی‌گردد، بدون آنکه منتظر تکمیل آن بماند\&.
.sp
اگر سوییچ
\fB\-\-reboot\-argument=\fR
داده شود، به عنوان آرگومان اختیاری به فراخوانی سیستمی
\fBreboot\fR(2)
منتقل می‌شود\&.
.sp
گزینه‌های
\fB\-\-boot\-loader\-entry=\fR،
\fB\-\-boot\-loader\-menu=\fR
و
\fB\-\-firmware\-setup\fR
می‌توانند برای انتخاب اقداماتی که
\fIپس از\fR
ریبوت باید انجام شوند استفاده گردند\&. برای جزئیات به توضیحات آن گزینه‌ها مراجعه فرمایید\&.
.sp
این دستور گزینه‌های
\fB\-\-force\fR
و
\fB\-\-when=\fR
را به روشی مشابه
\fBhalt\fR
رعایت می‌کند\&.
.sp
اگر یک هسته جدید از طریق
\fBkexec \-\-load\fR
بارگذاری شده باشد، به جای ریبوت یک
\fBkexec\fR
انجام می‌شود، مگر اینکه
"SYSTEMCTL_SKIP_AUTO_KEXEC=1"
تنظیم شده باشد\&. اگر یک سیستم فایل ریشه جدید روی
"/run/nextroot/"
راه‌اندازی شده باشد، به جای ریبوت یک
\fBsoft\-reboot\fR
انجام می‌شود، مگر اینکه
"SYSTEMCTL_SKIP_AUTO_SOFT_REBOOT=1"
تنظیم شده باشد\&.
.sp
اضافه شده در نسخه 246\&.
.RE
.PP
\fBkexec\fR
.RS 4
خاموش کردن و راه‌اندازی مجدد سیستم از طریق
\fBkexec\fR\&.
این دستور در صورت عدم بارگذاری هسته kexec، یک هسته را بارگذاری می‌کند وگرنه با شکست مواجه می‌شود\&. یک هسته می‌تواند قبلاً در یک مرحله جداگانه بارگذاری شده باشد، که به ویژه در صورت نیاز به initrd سفارشی یا گزینه‌های خط فرمان اضافی هسته مفید است\&. از
\fB\-\-force\fR
می‌توان برای ادامه کار بدون هسته kexec، یعنی انجام یک ریبوت معمولی استفاده کرد\&. مرحله نهایی ریبوت معادل است با
\fBsystemctl start kexec\&.target \-\-job\-mode=replace\-irreversibly \-\-no\-block\fR\&.
.sp
برای بارگذاری یک هسته، یک شمارش بر اساس
\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2
انجام می‌شود و مدخل بوت پیش‌فرض بارگذاری می‌گردد\&. برای موفقیت این مرحله، سیستم باید از UEFI استفاده کند و مدخل‌های بوت‌لودر به درستی پیکربندی شده باشند\&. از
\fBbootctl list\fR
می‌توان برای فهرست کردن مدخل‌های بوت استفاده کرد، به
\fBbootctl\fR(1)
مراجعه کنید\&.
.sp
این دستور ناهمگام است؛ پس از قرار گرفتن عملیات ریبوت در صف بازمی‌گردد، بدون آنکه منتظر تکمیل آن بماند\&.
.sp
این دستور گزینه‌های
\fB\-\-force\fR
و
\fB\-\-when=\fR
را مشابه
\fBhalt\fR
رعایت می‌کند\&.
.sp
اگر یک هسته جدید از طریق
\fBkexec \-\-load\fR
بارگذاری شده باشد، هنگامی که
\fBreboot\fR
فراخوانی شود یک
\fBkexec\fR
انجام خواهد شد، مگر اینکه
"SYSTEMCTL_SKIP_AUTO_KEXEC=1"
تنظیم شده باشد\&.
.RE
.PP
\fBsoft\-reboot\fR
.RS 4
خاموش کردن و راه‌اندازی مجدد فضای کاربری (userspace)\&. این معادل است با
\fBsystemctl start soft\-reboot\&.target \-\-job\-mode=replace\-irreversibly \-\-no\-block\fR\&.
این دستور ناهمگام است؛ پس از در صف قرار گرفتن عملیات ریبوت بازمی‌گردد، بدون آنکه منتظر بماند تا کامل شود\&.
.sp
این دستور گزینه‌های
\fB\-\-force\fR
و
\fB\-\-when=\fR
را به روشی مشابه
\fBhalt\fR
رعایت می‌کند\&.
.sp
این عملیات فقط فضای کاربری را مجدداً راه‌اندازی می‌کند و هسته را در حال اجرا باقی می‌گذارد\&. برای جزئیات به
\fBsystemd-soft-reboot.service\fR(8)
مراجعه فرمایید\&.
.sp
اگر یک سیستم فایل ریشه جدید روی
"/run/nextroot/"
راه‌اندازی شده باشد، هنگامی که
\fBreboot\fR
فراخوانی شود یک
\fBsoft\-reboot\fR
انجام خواهد شد، مگر اینکه
"SYSTEMCTL_SKIP_AUTO_SOFT_REBOOT=1"
تنظیم شده باشد\&.
.sp
اضافه شده در نسخه 254\&.
.RE
.PP
\fBexit\fR [\fIEXIT_CODE\fR]
.RS 4
درخواست خروج از مدیر سرویس\&. این کار فقط برای مدیران سرویس کاربری (یعنی همراه با گزینه
\fB\-\-user\fR)
یا در کانتینرها پشتیبانی می‌شود و در غیر این صورت معادل
\fBpoweroff\fR
است\&. این دستور ناهمگام است؛ پس از قرار گرفتن عملیات خروج در صف بازمی‌گردد، بدون اینکه منتظر تکمیل آن بماند\&.
.sp
در صورت ارائه
\fIEXIT_CODE\fR،
مدیر سرویس با کد خروج مشخص‌شده خارج خواهد شد\&.
.sp
اضافه شده در نسخه 227\&.
.RE
.PP
\fBswitch\-root\fR [\fIROOT\fR [\fIINIT\fR]]
.RS 4
تعویض به یک دایرکتوری ریشه متفاوت و اجرای یک فرآیند مدیر سیستم جدید زیر آن\&. این برای استفاده در initrd در نظر گرفته شده است، و از فرآیند مدیر سیستم initrd (معروف به فرآیند "init"، PID 1) به فرآیند اصلی مدیر سیستم که از سیستم فایل ریشه واقعی میزبان بارگذاری می‌شود انتقال می‌یابد\&. این فراخوانی دو آرگومان می‌گیرد: دایرکتوری که قرار است ریشه جدید شود، و مسیر باینری جدید مدیر سیستم زیر آن برای اجرا به عنوان PID 1\&. اگر هر دو حذف شوند یا اولی یک رشته خالی باشد، مقدار پیش‌فرض
/sysroot/
است\&. اگر دومی حذف شود یا یک رشته خالی باشد، یک باینری systemd به طور خودکار جستجو شده و به عنوان مدیر سرویس استفاده می‌شود\&. اگر مسیر مدیر سیستم حذف شود، برابر با رشته خالی یا یکسان با مسیر باینری systemd باشد، وضعیت فرآیند مدیر سیستم initrd به مدیر سیستم اصلی منتقل می‌شود که امکان بررسی وضعیت سرویس‌های درگیر در مرحله بوت initrd را در آینده فراهم می‌کند\&.
.sp
اضافه شده در نسخه 209\&.
.RE
.PP
\fBsleep\fR
.RS 4
بردن سیستم به حالت خواب از طریق
\fBsuspend\fR،
\fBhibernate\fR،
\fBhybrid\-sleep\fR
یا
\fBsuspend\-then\-hibernate\fR\&.
عملیات خواب برای استفاده به طور خودکار توسط
\fBsystemd-logind.service\fR(8)
انتخاب می‌شود\&. به طور پیش‌فرض،
\fBsuspend\-then\-hibernate\fR
استفاده می‌شود و در صورت عدم پشتیبانی به
\fBsuspend\fR
و سپس
\fBhibernate\fR
پس‌روی می‌کند\&. برای جزئیات بیشتر به تنظیم
\fISleepOperation=\fR
در
\fBlogind.conf\fR(5)
مراجعه کنید\&. این دستور ناهمگام است و پس از قرار گرفتن موفقیت‌آمیز عملیات خواب در صف بازمی‌گردد\&. منتظر تکمیل چرخه خواب/بیداری نخواهد ماند\&.
.sp
اضافه شده در نسخه 256\&.
.RE
.PP
\fBsuspend\fR
.RS 4
تعلیق (suspend) سیستم\&. این کار فعال‌سازی واحد هدف ویژه
suspend\&.target
را تحریک می‌کند\&. این دستور ناهمگام است و پس از قرار گرفتن موفقیت‌آمیز عملیات تعلیق در صف بازمی‌گردد\&. منتظر اتمام چرخه تعلیق/ازسرگیری نخواهد ماند\&.
.sp
اگر
\fB\-\-force\fR
مشخص شده باشد و
\fBsystemd\-logind\fR
خطایی برای عملیات برگرداند، خطا نادیده گرفته شده و عملیات مجدداً مستقیماً از طریق راه‌اندازی واحد هدف امتحان خواهد شد\&.
.RE
.PP
\fBhibernate\fR
.RS 4
خواب زمستانی (hibernate) سیستم\&. این کار فعال‌سازی واحد هدف ویژه
hibernate\&.target
را تحریک می‌کند\&. این دستور ناهمگام است و پس از قرار گرفتن موفقیت‌آمیز عملیات هایبرنیت در صف بازمی‌گردد\&. منتظر اتمام چرخه هایبرنیت/بیداری نخواهد ماند\&.
.sp
این دستور
\fB\-\-force\fR
را به همان روش
\fBsuspend\fR
رعایت می‌کند\&.
.RE
.PP
\fBhybrid\-sleep\fR
.RS 4
خواب زمستانی و تعلیق ترکیبی سیستم (hybrid sleep)\&. این کار فعال‌سازی واحد هدف ویژه
hybrid\-sleep\&.target
را تحریک می‌کند\&. این دستور ناهمگام است و پس از قرار گرفتن در صف بازمی‌گردد، بدون آنکه منتظر پایان چرخه خواب/بیداری بماند\&.
.sp
این دستور
\fB\-\-force\fR
را به همان روش
\fBsuspend\fR
رعایت می‌کند\&.
.sp
اضافه شده در نسخه 196\&.
.RE
.PP
\fBsuspend\-then\-hibernate\fR
.RS 4
تعلیق سیستم و بردن آن به خواب زمستانی هنگامی که باتری کم است، یا زمانی که تاخیر مشخص‌شده در
systemd\-sleep\&.conf
سپری شود\&. این کار فعال‌سازی واحد هدف ویژه
suspend\-then\-hibernate\&.target
را تحریک می‌کند\&. این دستور ناهمگام است و پس از صف‌بندی عملیات بازمی‌گردد و منتظر تکمیل چرخه خواب/بیداری نمی‌ماند\&.
.sp
این دستور
\fB\-\-force\fR
را به همان روش
\fBsuspend\fR
رعایت می‌کند\&.
.sp
اضافه شده در نسخه 240\&.
.RE
.SS "ساختار پارامترها (Parameter Syntax)"
.PP
دستورات واحد که در بالا فهرست شده‌اند یا یک نام واحد منفرد (مشخص‌شده به عنوان
\fIUNIT\fR)
یا چندین مشخصه واحد (تعیین‌شده به عنوان
\fIPATTERN\fR\&...)
را دریافت می‌کنند\&. در حالت اول، نام واحد با یا بدون پسوند باید ارائه شود\&. اگر پسوند مشخص نشود (نام واحد "کوتاه‌شده" باشد)، systemctl یک پسوند مناسب اضافه خواهد کرد: به طور پیش‌فرض
"\&.service"
و در مورد دستوراتی که فقط روی انواع خاصی از واحدها عمل می‌کنند، پسوند خاص آن نوع\&. به عنوان مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl start sshd
.fi
.if n \{\
.RE
.\}
.sp
و
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl start sshd\&.service
.fi
.if n \{\
.RE
.\}
.sp
معادل یکدیگر هستند، همان‌طور که دستورات
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl isolate default
.fi
.if n \{\
.RE
.\}
.sp
و
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl isolate default\&.target
.fi
.if n \{\
.RE
.\}
.sp
معادلند\&. توجه داشته باشید که مسیرهای (مطلق) به گره‌های دستگاه به طور خودکار به نام واحدهای دستگاه، و سایر مسیرهای (مطلق) به نام واحدهای مانت تبدیل می‌شوند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl status /dev/sda
# systemctl status /home
.fi
.if n \{\
.RE
.\}
.sp
معادل هستند با:
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl status dev\-sda\&.device
# systemctl status home\&.mount
.fi
.if n \{\
.RE
.\}
.sp
در حالت دوم، الگوهای فراگیر به سبک شل (glob) با نام‌های اصلی تمام واحدهایی که در حال حاضر در حافظه هستند مطابقت داده می‌شوند؛ نام‌های تحت‌اللفظی واحدها، با یا بدون پسوند، همانند حالت اول رفتار خواهند شد\&. این بدان معناست که نام‌های لفظی واحدها همیشه دقیقاً به یک واحد اشاره می‌کنند، اما الگوهای گلوب ممکن است با صفر واحد مطابقت داشته باشند و این یک خطا محسوب نمی‌شود\&.
.PP
الگوهای تطبیق از
\fBfnmatch\fR(3)
استفاده می‌کنند، بنابراین قوانین معمول تطبیق پوسته اعمال شده و کاراکترهای
"*",
"?",
"[]"
می‌توانند استفاده شوند\&. برای جزئیات بیشتر به
\fBglob\fR(7)
مراجعه کنید\&. الگوها با نام‌های اصلی واحدهای موجود در حافظه مطابقت داده می‌شوند و الگوهایی که با هیچ چیزی مطابقت ندارند نادیده گرفته می‌شوند\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl stop "sshd@*\&.service"
.fi
.if n \{\
.RE
.\}
.sp
تمام نمونه‌های
sshd@\&.service
را متوقف خواهد کرد\&. توجه داشته باشید که نام‌های مستعار واحدها و واحدهایی که در حافظه نیستند برای بسط الگو در نظر گرفته نمی‌شوند\&.
.PP
برای دستورات فایل واحد،
\fIUNIT\fR
مشخص‌شده باید نام فایل واحد (احتمالاً مخفف‌شده، به بالا مراجعه کنید) یا مسیر مطلق به فایل واحد باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl enable foo\&.service
.fi
.if n \{\
.RE
.\}
.sp
یا
.sp
.if n \{\
.RS 4
.\}
.nf
# systemctl link /path/to/foo\&.service
.fi
.if n \{\
.RE
.\}
.sp
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-t\fR, \fB\-\-type=\fR
.RS 4
آرگومان فهرستی جداشده با کاما از انواع واحدها مانند
\fBservice\fR
و
\fBsocket\fR
است\&. هنگامی که واحدها با
\fBlist\-units\fR،
\fBlist\-dependencies\fR،
\fBshow\fR
یا
\fBstatus\fR
فهرست می‌شوند، فقط واحدهایی از انواع مشخص‌شده نمایش داده می‌شوند\&. به طور پیش‌فرض، واحدهای تمام انواع نشان داده می‌شوند\&.
.sp
به عنوان یک مورد خاص، اگر یکی از آرگومان‌ها
\fBhelp\fR
باشد، فهرستی از مقادیر مجاز چاپ شده و برنامه خارج می‌شود\&.
.RE
.PP
\fB\-\-state=\fR
.RS 4
آرگومان فهرستی جداشده با کاما از وضعیت‌های LOAD، SUB یا ACTIVE واحد است\&. هنگام فهرست کردن واحدها با
\fBlist\-units\fR،
\fBlist\-dependencies\fR،
\fBshow\fR
یا
\fBstatus\fR،
تنها واحدهایی که در وضعیت‌های مشخص‌شده قرار دارند نمایش داده می‌شوند\&. از
\fB\-\-state=failed\fR
یا
\fB\-\-failed\fR
برای نمایش فقط واحدهای با وضعیت شکست‌خورده استفاده کنید\&.
.sp
به عنوان یک مورد خاص، اگر یکی از آرگومان‌ها
\fBhelp\fR
باشد، فهرستی از مقادیر مجاز چاپ شده و برنامه خارج می‌شود\&.
.sp
اضافه شده در نسخه 206\&.
.RE
.PP
\fB\-p\fR, \fB\-\-property=\fR
.RS 4
هنگام نمایش ویژگی‌های واحد/کار/مدیر سیستم با دستور
\fBshow\fR،
نمایش را به ویژگی‌های مشخص‌شده در آرگومان محدود می‌کند\&. آرگومان باید یک فهرست جداشده با کاما از نام ویژگی‌ها مانند
"MainPID"
باشد\&. مگر اینکه مشخص شده باشد، تمام ویژگی‌های شناخته‌شده نمایش داده می‌شوند\&. در صورت تعیین چندباره، تمام ویژگی‌های با نام‌های مشخص‌شده نمایش داده خواهند شد\&. تکمیل خودکار پوسته (Shell completion) برای نام‌های ویژگی پیاده‌سازی شده است\&.
.sp
برای خود مدیر سیستم،
\fBsystemctl\ show\fR
تمام ویژگی‌های موجود را نشان می‌دهد که بیشتر آن‌ها مشتق شده یا دقیقاً منطبق بر گزینه‌های توصیف‌شده در
\fBsystemd-system.conf\fR(5)
هستند\&.
.sp
ویژگی‌های واحدها بر اساس نوع واحد متفاوت است، بنابراین نمایش هر واحد (حتی یک واحد ناموجود) راهی برای فهرست کردن ویژگی‌های مربوط به آن نوع است\&. به طور مشابه، نمایش هر کاری ویژگی‌های مربوط به همه کارها را فهرست می‌کند\&. ویژگی‌های واحدها در
\fBsystemd.unit\fR(5)
و صفحات راهنمای انواع واحدهای منفرد مانند
\fBsystemd.service\fR(5)،
\fBsystemd.socket\fR(5)
و غیره مستند شده‌اند\&.
.RE
.PP
\fB\-P\fR
.RS 4
معادل با
\fB\-\-value\fR
\fB\-\-property=\fR
است، یعنی مقدار ویژگی را بدون نام ویژگی یا
"="
نمایش می‌دهد\&. توجه داشته باشید که استفاده یک‌باره از
\fB\-P\fR
بر تمام ویژگی‌های فهرست‌شده با
\fB\-p\fR/\fB\-\-property=\fR
نیز تأثیر می‌گذارد\&.
.sp
اضافه شده در نسخه 246\&.
.RE
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
هنگام فهرست کردن واحدها با
\fBlist\-units\fR،
واحدهای غیرفعال و واحدهایی را که واحدهای دیگر را دنبال می‌کنند نیز نمایش می‌دهد\&. هنگام نمایش ویژگی‌های واحد/کار/مدیر، تمام ویژگی‌ها را صرف‌نظر از تنظیم بودن یا نبودن آن‌ها نشان می‌دهد\&.
.sp
برای فهرست کردن تمام واحدهای نصب‌شده در سیستم فایل، به جای آن از دستور
\fBlist\-unit\-files\fR
استفاده فرمایید\&.
.sp
هنگام فهرست کردن واحدها با
\fBlist\-dependencies\fR،
وابستگی‌های تمام واحدهای وابسته را به صورت بازگشتی نمایش می‌دهد (به طور پیش‌فرض فقط وابستگی‌های واحدهای هدف نشان داده می‌شوند)\&.
.sp
هنگام استفاده با
\fBstatus\fR،
پیام‌های ژورنال را به طور کامل نشان می‌دهد، حتی اگر شامل کاراکترهای غیرقابل چاپ باشند یا بسیار طولانی باشند\&. به طور پیش‌فرض، فیلدهای دارای کاراکترهای غیرقابل چاپ به صورت "blob data" خلاصه می‌شوند\&. (توجه داشته باشید که صفحه‌بند ممکن است کاراکترهای غیرقابل چاپ را دوباره اسکیپ کند)\&.
.RE
.PP
\fB\-r\fR, \fB\-\-recursive\fR
.RS 4
هنگام فهرست کردن واحدها، واحدهای کانتینرهای محلی را نیز نشان می‌دهد\&. واحدهای کانتینرهای محلی با نام کانتینر پیشوند می‌خورند که با یک کاراکتر دو‌نقطه (":") جدا می‌شود\&.
.sp
اضافه شده در نسخه 212\&.
.RE
.PP
\fB\-\-reverse\fR
.RS 4
نمایش وابستگی‌های معکوس بین واحدها با
\fBlist\-dependencies\fR،
یعنی دنبال کردن وابستگی‌هایی از نوع
\fIWantedBy=\fR،
\fIRequiredBy=\fR،
\fIUpheldBy=\fR،
\fIPartOf=\fR،
\fIBoundBy=\fR
به جای
\fIWants=\fR
و مانند آن\&.
.sp
اضافه شده در نسخه 203\&.
.RE
.PP
\fB\-\-after\fR
.RS 4
همراه با
\fBlist\-dependencies\fR،
واحدهایی را نشان می‌دهد که قبل از واحد مشخص‌شده مرتب شده‌اند\&. به عبارت دیگر، واحدهای پس از وابستگی
\fIAfter=\fR
را به صورت بازگشتی فهرست می‌کند\&.
.sp
توجه داشته باشید که هر وابستگی
\fIAfter=\fR
به طور خودکار برای ایجاد یک وابستگی
\fIBefore=\fR
منعکس می‌شود\&. وابستگی‌های زمانی ممکن است به صراحت مشخص شوند، اما به طور ضمنی نیز برای واحدهایی که اهداف
\fIWantedBy=\fR
هستند ایجاد می‌شوند (به
\fBsystemd.target\fR(5)
مراجعه کنید)، و در نتیجه سایر دستورالعمل‌ها (برای مثال
\fIRequiresMountsFor=\fR)
نیز به وجود می‌آیند\&. هر دو نوع وابستگی صریح و ضمنی با
\fBlist\-dependencies\fR
نمایش داده می‌شوند\&.
.sp
هنگامی که به دستور
\fBlist\-jobs\fR
منتقل شود، برای هر کار چاپ‌شده نشان می‌دهد که چه کارهای دیگری منتظر آن هستند\&. ممکن است با
\fB\-\-before\fR
ترکیب شود تا هم کارهایی که منتظر هر کار هستند و هم تمام کارهایی که هر کار منتظر آن‌ها است نشان داده شوند\&.
.sp
اضافه شده در نسخه 203\&.
.RE
.PP
\fB\-\-before\fR
.RS 4
همراه با
\fBlist\-dependencies\fR،
واحدهایی را نشان می‌دهد که بعد از واحد مشخص‌شده مرتب شده‌اند\&. به عبارت دیگر، واحدهای پیرو وابستگی
\fIBefore=\fR
را به صورت بازگشتی فهرست می‌کند\&.
.sp
هنگامی که به دستور
\fBlist\-jobs\fR
ارسال شود، برای هر کار چاپ‌شده نشان می‌دهد که منتظر چه کارهای دیگری است\&. ممکن است با
\fB\-\-after\fR
ترکیب شود تا هم کارهای در انتظار و هم کارهای مورد انتظار را نمایش دهد\&.
.sp
اضافه شده در نسخه 212\&.
.RE
.PP
\fB\-\-with\-dependencies\fR
.RS 4
هنگامی که با
\fBstatus\fR،
\fBcat\fR،
\fBlist\-units\fR
و
\fBlist\-unit\-files\fR
استفاده شود، آن دستورات تمام واحدهای مشخص‌شده و وابستگی‌های آن واحدها را چاپ می‌کنند\&.
.sp
گزینه‌های
\fB\-\-reverse\fR،
\fB\-\-after\fR،
\fB\-\-before\fR
ممکن است برای تغییر انواع وابستگی‌های نمایش‌داده‌شده استفاده شوند\&.
.sp
اضافه شده در نسخه 245\&.
.RE
.PP
\fB\-l\fR, \fB\-\-full\fR
.RS 4
نام واحدها، ورودی‌های درخت فرآیند، خروجی ژورنال یا توصیف‌های واحد را در خروجی
\fBstatus\fR،
\fBlist\-units\fR،
\fBlist\-jobs\fR
و
\fBlist\-timers\fR
خلاصه و کوتاه (ellipsize) نمی‌کند\&.
.sp
همچنین اهداف نصب را در خروجی
\fBis\-enabled\fR
نشان می‌دهد\&.
.RE
.PP
\fB\-\-value\fR
.RS 4
هنگام چاپ ویژگی‌ها با
\fBshow\fR،
فقط مقدار را چاپ کرده و نام ویژگی و
"="
را رد می‌کند\&. همچنین گزینه
\fB\-P\fR
در بالا را ببینید\&.
.sp
اضافه شده در نسخه 230\&.
.RE
.PP
\fB\-\-show\-types\fR
.RS 4
هنگام نمایش سوکت‌ها، نوع سوکت را نشان می‌دهد\&.
.sp
اضافه شده در نسخه 202\&.
.RE
.PP
\fB\-\-job\-mode=\fR
.RS 4
هنگام قرار دادن یک کار جدید در صف، این گزینه نحوه برخورد با کارهای قبلاً در صف قرار گرفته را کنترل می‌کند\&. یکی از مقادیر
"fail"،
"replace"،
"replace\-irreversibly"،
"isolate"،
"ignore\-dependencies"،
"ignore\-requirements"،
"flush"،
"triggering"
یا
"restart\-dependencies"
را می‌پذیرد\&. به طور پیش‌فرض روی
"replace"
قرار دارد، به جز زمانی که از دستور
\fBisolate\fR
استفاده شود که به طور ضمنی حالت کار
"isolate"
را اعمال می‌کند\&.
.sp
اگر
"fail"
مشخص شود و عملیات درخواستی با یک کار معلق تداخل داشته باشد (به طور خاص: باعث شود یک کار شروع معلق به یک کار توقف یا بالعکس تبدیل شود)، باعث شکست عملیات می‌شود\&.
.sp
اگر
"replace"
(پیش‌فرض) مشخص شود، هر کار در حال تعلیق متداخل در صورت لزوم جایگزین خواهد شد\&.
.sp
اگر
"replace\-irreversibly"
مشخص شود، مانند
"replace"
عمل می‌کند، اما همچنین کارهای جدید را غیرقابل برگشت علامت‌گذاری می‌کند\&. این امر از جایگزینی این کارها توسط تراکنش‌های متداخل آینده (یا حتی قرار گرفتن در صف در حالی که کارهای غیرقابل برگشت هنوز معلق هستند) جلوگیری می‌کند\&. کارهای برگشت‌ناپذیر همچنان می‌توانند با استفاده از دستور
\fBcancel\fR
لغو شوند\&. این حالت کار باید در هر تراکنشی که
shutdown\&.target
را فراخوانی می‌کند استفاده شود\&.
.sp
مقدار
"isolate"
فقط برای عملیات شروع معتبر است و باعث می‌شود هنگامی که واحد مشخص‌شده شروع می‌شود، تمام واحدهای دیگر متوقف شوند\&. این حالت همیشه زمانی که دستور
\fBisolate\fR
استفاده می‌شود به کار می‌رود\&.
.sp
مقدار
"flush"
باعث می‌شود هنگامی که کار جدید در صف قرار می‌گیرد، تمام کارهای در صف لغو شوند\&.
.sp
اگر
"ignore\-dependencies"
مشخص شود، تمام وابستگی‌های واحد برای این کار جدید نادیده گرفته شده و عملیات فوراً اجرا می‌شود\&. در این صورت، هیچ واحد الزامی برای واحد ارسالی به جریان نخواهد افتاد و هیچ وابستگی ترتیبی رعایت نخواهد شد\&. این بیشتر یک ابزار اشکال‌زدایی و امداد برای مدیر سیستم است و نباید توسط برنامه‌ها استفاده شود\&.
.sp
مقدار
"ignore\-requirements"
مشابه
"ignore\-dependencies"
است، اما تنها باعث نادیده گرفته شدن وابستگی‌های الزامی می‌شود، وابستگی‌های ترتیبی همچنان رعایت خواهند شد\&.
.sp
مقدار
"triggering"
فقط با
\fBsystemctl stop\fR
می‌تواند استفاده شود\&. در این حالت، واحد مشخص‌شده و تمام واحدهای فعالی که آن را راه‌اندازی می‌کنند متوقف می‌شوند\&. برای اطلاعات بیشتر در مورد واحدهای راه‌انداز، به بحث
\fITriggers=\fR
در
\fBsystemd.unit\fR(5)
مراجعه کنید\&.
.sp
مقدار
"restart\-dependencies"
فقط با
\fBsystemctl start\fR
می‌تواند استفاده شود\&. در این حالت، وابستگی‌های واحد مشخص‌شده انتشار راه‌اندازی مجدد دریافت می‌کنند، گویی یک کار راه‌اندازی مجدد برای آن واحد در صف قرار گرفته است\&.
.sp
اضافه شده در نسخه 209\&.
.RE
.PP
\fB\-T\fR, \fB\-\-show\-transaction\fR
.RS 4
هنگام قرار دادن یک کار واحد در صف (مثلاً در اثر اجرای
\fBsystemctl start\fR
یا مشابه آن)، اطلاعات مختصری در مورد تمام کارهای در صف قرار گرفته، شامل کار درخواستی و هر کاری که به دلیل وابستگی‌های واحد اضافه شده است را نشان می‌دهد\&. توجه داشته باشید که خروجی فقط شامل کارهایی می‌شود که بلافاصله بخشی از تراکنش درخواستی هستند\&. ممکن است کد برنامه راه‌اندازی سرویس که در اثر کارهای در صف اجرا می‌شود، درخواست اضافه شدن کارهای بیشتری را بدهد\&. این بدان معناست که تکمیل کارهای فهرست‌شده ممکن است در نهایت کارهای بیشتری را نسبت به موارد فهرست‌شده در بر داشته باشد\&.
.sp
اضافه شده در نسخه 242\&.
.RE
.PP
\fB\-\-fail\fR
.RS 4
مختصرشده برای
\fB\-\-job\-mode=\fRfail\&.
.sp
هنگام استفاده با دستور
\fBkill\fR،
اگر هیچ واحدی کشته نشود، عملیات منجر به خطا می‌شود\&.
.sp
اضافه شده در نسخه 227\&.
.RE
.PP
\fB\-\-check\-inhibitors=\fR
.RS 4
هنگامی که خاموش شدن سیستم یا وضعیت خواب درخواست می‌شود، این گزینه بررسی قفل‌های بازدارنده (inhibitor locks) را کنترل می‌کند\&. یکی از مقادیر
"auto"،
"yes"
و
"no"
را می‌پذیرد\&. پیش‌فرض
"auto"
است، به این معنی که logind بررسی را انجام داده و به قفل‌های بازدارنده فعال احترام می‌گذارد، اما
\fBsystemctl\fR
تنها برای فراخوانی‌های تعاملی (یعنی از یک TTY) یک بررسی سمت کلاینت انجام می‌دهد تا خطای دوستانه‌تر و آگاه‌کننده‌تری به کاربران برگردانده شود\&. مقدار
"no"
بررسی‌ها را هم در
\fBsystemctl\fR
و هم در
\fBsystemd-logind\fR(8)
غیرفعال می‌کند\&.
.sp
برنامه‌ها می‌توانند قفل‌های بازدارنده ایجاد کنند تا از قطع شدن برخی عملیات مهم (مانند سوزاندن CD) توسط خاموش شدن سیستم یا خواب جلوگیری نمایند\&. هر کاربری می‌تواند این قفل‌ها را بگیرد و کاربران دارای امتیاز می‌توانند این قفل‌ها را نادیده بگیرند\&. اگر قفلی گرفته شده باشد، درخواست‌های خاموش شدن و وضعیت خواب به طور معمول با شکست مواجه می‌شوند (مگر اینکه صراحتاً با
"no"
بازنویسی شوند)\&.
.sp
گزینه
\fB\-\-force\fR
راه دیگری برای نادیده گرفتن بازدارنده‌ها فراهم می‌کند\&.
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fB\-i\fR
.RS 4
میانبری برای
\fB\-\-check\-inhibitors=no\fR\&.
.sp
اضافه شده در نسخه 198\&.
.RE
.PP
\fB\-\-dry\-run\fR
.RS 4
تنها چاپ می‌کند که چه کاری انجام خواهد شد\&. در حال حاضر توسط دستورات زیر پشتیبانی می‌شود:
\fBhalt\fR،
\fBpoweroff\fR،
\fBreboot\fR،
\fBkexec\fR،
\fBsuspend\fR،
\fBhibernate\fR،
\fBhybrid\-sleep\fR،
\fBsuspend\-then\-hibernate\fR،
\fBdefault\fR،
\fBrescue\fR،
\fBemergency\fR
و
\fBexit\fR\&.
.sp
اضافه شده در نسخه 236\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
خاموش کردن چاپ نتایج دستورات مختلف و همچنین راهنمایی‌های مربوط به خطوط لاگ کوتاه شده\&. این گزینه خروجی دستوراتی را که خروجی چاپ‌شده تنها نتیجه آن‌هاست (مانند
\fBshow\fR)
سرکوب نمی‌کند\&. خطاها همیشه چاپ می‌شوند\&.
.RE
.PP
\fB\-\-no\-warn\fR
.RS 4
هشدارهایی را که به طور پیش‌فرض در موارد زیر نشان داده می‌شوند تولید نمی‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی که
\fBsystemctl\fR
بدون مانت بودن procfs روی
/proc/
فراخوانی شود،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگام استفاده از
\fBenable\fR
یا
\fBdisable\fR
روی واحدهای بدون اطلاعات نصب (یعنی بخش [Install] ندارند یا بخش خالی دارند)،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگام استفاده از
\fBdisable\fR
همراه با
\fB\-\-user\fR
روی واحدهایی که در محدوده سراسری فعال هستند،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی که یک واحد متوقف‌شده (\fBstop\fR)، غیرفعال‌شده (\fBdisable\fR) یا ماسک‌شده (\fBmask\fR) هنوز واحدهای راه‌انداز فعال دارد،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی که یک فایل واحد تغییر کرده و به
\fBdaemon\-reload\fR
نیاز دارد\&.
.RE
.sp
اضافه شده در نسخه 253\&.
.RE
.PP
\fB\-\-no\-block\fR
.RS 4
به صورت همگام منتظر اتمام عملیات درخواستی نمی‌ماند\&. اگر این مشخص نشود، کار تأیید شده، در صف قرار می‌گیرد و
\fBsystemctl\fR
صبر می‌کند تا راه‌اندازی واحد کامل شود\&. با ارسال این آرگومان، فقط تأیید شده و در صف قرار می‌گیرد\&. این گزینه ممکن است با
\fB\-\-wait\fR
ترکیب نشود\&.
.RE
.PP
\fB\-\-wait\fR
.RS 4
هنگامی که با
\fBstart\fR
یا
\fBrestart\fR
استفاده شود، به طور همگام منتظر می‌ماند تا واحدهای راه‌اندازی‌شده دوباره خاتمه یابند\&. این گزینه نباید با
\fB\-\-no\-block\fR
ترکیب شود\&. توجه داشته باشید اگر واحد معین هرگز خاتمه نیابد (به خودی خود یا با متوقف شدن صریح)، این گزینه برای همیشه منتظر خواهد ماند؛ به ویژه سرویس‌هایی که از
"RemainAfterExit=yes"
استفاده می‌کنند\&.
.sp
هنگامی که با
\fBis\-system\-running\fR
استفاده شود، قبل از بازگشت منتظر می‌ماند تا فرآیند بوت تکمیل شود\&.
.sp
هنگامی که با
\fBkill\fR
استفاده شود، منتظر می‌ماند تا واحدهای سیگنال‌داده‌شده خاتمه یابند\&. توجه داشته باشید در صورتی که هر واحد معین هرگز خاتمه نیابد، این گزینه برای همیشه منتظر خواهد ماند\&.
.sp
اضافه شده در نسخه 232\&.
.RE
.PP
\fB\-\-user\fR
.RS 4
با مدیر سرویس کاربر فراخوان به جای مدیر سرویس سیستم ارتباط برقرار می‌کند\&.
.RE
.PP
\fB\-\-system\fR
.RS 4
با مدیر سرویس سیستم ارتباط برقرار می‌کند\&. این پیش‌فرض ضمنی است\&.
.RE
.PP
\fB\-\-failed\fR
.RS 4
فهرست کردن واحدهای در وضعیت ناموفق (failed)\&. این معادل است با
\fB\-\-state=failed\fR\&.
.sp
اضافه شده در نسخه 233\&.
.RE
.PP
\fB\-\-no\-wall\fR
.RS 4
قبل از توقف کامل (halt)، قطع برق (power\-off) و راه‌اندازی مجدد (reboot) پیام همگانی (wall message) ارسال نمی‌کند\&.
.RE
.PP
\fB\-\-global\fR
.RS 4
هنگام استفاده با
\fBenable\fR
و
\fBdisable\fR،
بر روی دایرکتوری پیکربندی سراسری کاربر عمل می‌کند، بنابراین یک فایل واحد را به صورت سراسری برای تمام ورودهای آینده همه کاربران فعال یا غیرفعال می‌نماید\&.
.RE
.PP
\fB\-\-no\-reload\fR
.RS 4
هنگام استفاده با
\fBenable\fR،
\fBdisable\fR،
\fBpreset\fR،
\fBmask\fR
یا
\fBunmask\fR،
پس از اجرای تغییرات به طور ضمنی پیکربندی دیمن را بازخوانی نمی‌کند\&.
.RE
.PP
\fB\-\-kill\-whom=\fR
.RS 4
هنگام استفاده با
\fBkill\fR،
فرآیندهایی را برای ارسال سیگنال پردازش یونیکس انتخاب می‌کند\&. باید یکی از گزینه‌های
\fBmain\fR،
\fBcontrol\fR
یا
\fBall\fR
باشد تا مشخص کند که فقط فرآیند اصلی، فرآیند کنترلی یا تمام فرآیندهای واحد کشته شوند\&. فرآیند اصلی واحد فرآیندی است که طول عمر آن را تعریف می‌کند\&. یک فرآیند کنترلی فرآیندی است که توسط مدیر برای القای تغییرات وضعیت در آن فراخوانی می‌شود\&. به عنوان مثال، تمام فرآیندهایی که به دلیل تنظیمات
\fIExecStartPre=\fR،
\fIExecStop=\fR
یا
\fIExecReload=\fR
واحدهای سرویس شروع می‌شوند، فرآیندهای کنترلی هستند\&. توجه داشته باشید که در هر زمان تنها یک فرآیند کنترلی به ازای هر واحد وجود دارد، زیرا در هر زمان تنها یک تغییر وضعیت اجرا می‌شود\&. برای سرویس‌هایی از نوع
\fIType=forking\fR،
فرآیند اولیه شروع‌شده توسط مدیر برای
\fIExecStart=\fR
یک فرآیند کنترلی است، در حالی که فرآیندی که در نهایت توسط آن منشعب می‌شود به عنوان فرآیند اصلی واحد در نظر گرفته می‌شود (اگر قابل تعیین باشد)\&. این برای واحدهای سرویس سایر انواع متفاوت است، جایی که فرآیند منشعب‌شده توسط مدیر برای
\fIExecStart=\fR
همیشه خود فرآیند اصلی است\&. یک واحد سرویس شامل صفر یا یک فرآیند اصلی، صفر یا یک فرآیند کنترلی به علاوه هر تعداد فرآیند اضافی است\&. با این حال، همه انواع واحدها فرآیندهایی از این انواع را مدیریت نمی‌کنند\&. به عنوان مثال، برای واحدهای مانت، فرآیندهای کنترلی تعریف شده‌اند (که فراخوانی‌های
/usr/bin/mount
و
/usr/bin/umount
هستند)، اما فرآیند اصلی تعریف نشده است\&. در صورت حذف، پیش‌فرض روی
\fBall\fR
است\&.
.sp
اضافه شده در نسخه 252\&.
.RE
.PP
\fB\-\-kill\-value=\fR\fB\fIINT\fR\fR
.RS 4
در صورت استفاده با دستور
\fBkill\fR،
یک سیگنال را همراه با پارامتر مقدار عدد صحیح مشخص‌شده برای فرآیند(های) معین در صف قرار می‌دهد\&. این عملیات فقط برای سیگنال‌های بلادرنگ (Realtime) پازیکس در دسترس است (یعنی
\fB\-\-signal=SIGRTMIN+\&...\fR
یا
\fB\-\-signal=SIGRTMAX\-\&...\fR)،
و تضمین می‌کند که سیگنال‌ها از طریق فراخوانی سیستمی
\fBsigqueue\fR(3)
به جای
\fBkill\fR(3)
تولید می‌شوند\&. مقدار مشخص‌شده باید یک عدد صحیح علامت‌دار 32 بیتی باشد و می‌تواند به صورت ده‌دهی، شانزده‌شانزدهی (با پیشوند
"0x")،
هشت‌هشتی (با پیشوند
"0o")
یا دودویی (با پیشوند
"0b")
مشخص شود\&.
.sp
در صورت استفاده از این گزینه، سیگنال تنها برای فرآیند کنترلی یا اصلی واحد در صف قرار می‌گیرد و هرگز برای سایر فرآیندهای متعلق به واحد ارسال نخواهد شد؛ یعنی
\fB\-\-kill\-whom=all\fR
تنها بر فرآیندهای اصلی و کنترلی تأثیر می‌گذارد و نه بر هیچ فرآیند دیگری\&.
.sp
اضافه شده در نسخه 254\&.
.RE
.PP
\fB\-s\fR, \fB\-\-signal=\fR
.RS 4
هنگام استفاده با
\fBkill\fR،
انتخاب می‌کند که کدام سیگنال به فرآیندهای انتخاب‌شده ارسال شود\&. باید یکی از مشخص‌کننده‌های سیگنال شناخته‌شده مانند
\fBSIGTERM\fR،
\fBSIGINT\fR
یا
\fBSIGSTOP\fR
باشد\&. در صورت حذف، پیش‌فرض روی
\fBSIGTERM\fR
است\&.
.sp
مقدار ویژه
"help"
فهرست مقادیر شناخته‌شده را چاپ کرده و برنامه بلافاصله خارج می‌شود، و مقدار ویژه
"list"
فهرست مقادیر شناخته‌شده را به همراه شماره عددی سیگنال‌ها نمایش داده و برنامه بلافاصله خارج خواهد شد\&.
.RE
.PP
\fB\-\-what=\fR
.RS 4
نوع منابع اختصاصی واحد را برای حذف در هنگام اجرای دستور
\fBclean\fR
انتخاب می‌کند، به توضیحات بالا مراجعه فرمایید\&. یکی از مقادیر
\fBconfiguration\fR،
\fBstate\fR،
\fBcache\fR،
\fBlogs\fR،
\fBruntime\fR،
\fBfdstore\fR
را برای انتخاب نوع منبع می‌پذیرد\&. این گزینه ممکن است بیش از یک بار مشخص شود که در این صورت تمام انواع منابع مشخص‌شده حذف می‌شوند\&. همچنین مقدار ویژه
\fBall\fR
را به عنوان میانبری برای تعیین هر شش نوع منبع می‌پذیرد\&. اگر این گزینه مشخص نشود، پیش‌فرض روی ترکیبی از
\fBcache\fR،
\fBruntime\fR
و
\fBfdstore\fR
قرار می‌گیرد، یعنی سه نوع منبعی که عموماً اضافی تلقی می‌شوند و می‌توان در فراخوانی بعدی دوباره آن‌ها را بازسازی کرد\&. توجه داشته باشید که حذف صریح منبع نوع
\fBfdstore\fR
تنها در صورتی مفید است که گزینه
\fIFileDescriptorStorePreserve=\fR
فعال باشد، زیرا در غیر این صورت مخزن توصیف‌کننده فایل هنگام توقف واحد به طور خودکار پاک می‌شود\&.
.sp
اضافه شده در نسخه 243\&.
.RE
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
هنگام استفاده با
\fBenable\fR،
هرگونه پیوند نمادین متداخل موجود را بازنویسی می‌کند\&.
.sp
هنگام استفاده با
\fBedit\fR،
تمام واحدهای مشخص‌شده‌ای را که از قبل وجود ندارند ایجاد می‌کند\&.
.sp
هنگام استفاده با
\fBsuspend\fR،
\fBhibernate\fR،
\fBhybrid\-sleep\fR
یا
\fBsuspend\-then\-hibernate\fR،
خطای بازگردانده‌شده توسط
\fBsystemd\-logind\fR
نادیده گرفته شده و عملیات مستقیماً از طریق راه‌اندازی واحدهای مربوطه انجام خواهد شد\&.
.sp
هنگام استفاده با
\fBhalt\fR،
\fBpoweroff\fR،
\fBreboot\fR
یا
\fBkexec\fR،
عملیات انتخاب‌شده را بدون خاموش کردن همه واحدها اجرا می‌کند\&. با این حال، تمام فرآیندها به اجبار کشته می‌شوند و تمام سیستم‌های فایل پیاده (unmount) یا دوباره به صورت فقط‌خواندنی متصل می‌شوند\&. بنابراین این یک گزینه شدید اما نسبتاً ایمن برای درخواست راه‌اندازی مجدد فوری است\&. اگر
\fB\-\-force\fR
دو بار برای این عملیات (به استثنای
\fBkexec\fR)
مشخص شود، آن‌ها بلافاصله بدون خاتمه دادن به هیچ فرآیندی یا پیاده‌سازی هیچ سیستم فایلی اجرا خواهند شد\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBهشدار\fR
.ps -1
.br
مشخص کردن دوبار
\fB\-\-force\fR
در هر یک از این عملیات ممکن است منجر به از دست رفتن داده‌ها شود\&. توجه داشته باشید هنگامی که
\fB\-\-force\fR
دو بار مشخص شود، عملیات انتخاب‌شده توسط خود
\fBsystemctl\fR
اجرا می‌شود و با مدیر سیستم ارتباطی برقرار نمی‌شود\&. این بدان معناست که دستور حتی در صورت کرش کردن مدیر سیستم نیز باید با موفقیت کار کند\&.
.sp .5v
.RE
.RE
.PP
\fB\-\-message=\fR
.RS 4
هنگام استفاده با
\fBhalt\fR،
\fBpoweroff\fR
یا
\fBreboot\fR،
یک پیام کوتاه برای توضیح دلیل عملیات تنظیم می‌کند\&. این پیام همراه با پیام پیش‌فرض خاموش شدن در لاگ ثبت خواهد شد\&.
.sp
اضافه شده در نسخه 225\&.
.RE
.PP
\fB\-\-now\fR
.RS 4
هنگام استفاده با
\fBenable\fR،
\fBdisable\fR،
\fBmask\fR
یا
\fBreenable\fR،
پس از موفقیت در عملیات فایل واحد، واحدها را نیز بلافاصله شروع/متوقف/راه‌اندازی مجدد می‌کند\&.
.sp
اضافه شده در نسخه 220\&.
.RE
.PP
\fB\-\-root=\fR
.RS 4
هنگام استفاده با
\fBenable\fR/\fBdisable\fR/\fBis\-enabled\fR
(و دستورات مرتبط)، از مسیر ریشه مشخص‌شده هنگام جستجوی فایل‌های واحد استفاده می‌کند\&. اگر این گزینه ارائه شود،
\fBsystemctl\fR
به جای برقراری ارتباط با دیمن
\fBsystemd\fR
برای اعمال تغییرات، مستقیماً روی سیستم فایل عمل خواهد کرد\&.
.RE
.PP
\fB\-\-image=\fR\fB\fIimage\fR\fR
.RS 4
مسیری به یک فایل ایمیج دیسک یا گره دستگاه بلوکی دریافت می‌کند\&. در صورت تعیین، تمام عملیات روی سیستم فایل درون ایمیج دیسک مشخص‌شده اعمال می‌شوند\&. این گزینه مشابه
\fB\-\-root=\fR
است، اما روی سیستم‌های فایل ذخیره‌شده در ایمیج‌های دیسک یا دستگاه‌های بلوکی عمل می‌کند\&. ایمیج دیسک باید یا تنها حاوی یک سیستم فایل باشد یا مجموعه‌ای از سیستم‌های فایل در یک جدول پارتیشن GPT بر اساس
\m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&.
برای اطلاعات بیشتر در مورد ایمیج‌های دیسک پشتیبانی‌شده، به سوییچ همنام در
\fBsystemd-nspawn\fR(1)
مراجعه کنید\&.
.sp
اضافه شده در نسخه 252\&.
.RE
.PP
\fB\-\-image\-policy=\fR\fB\fIpolicy\fR\fR
.RS 4
یک رشته خط‌مشی ایمیج را به عنوان آرگومان طبق
\fBsystemd.image-policy\fR(7)
می‌پذیرد\&. این خط‌مشی هنگام کار بر روی ایمیج دیسک مشخص‌شده از طریق
\fB\-\-image=\fR
اعمال می‌شود، به توضیحات بالا مراجعه فرمایید\&. در صورت عدم تعیین، مقدار پیش‌فرض روی خط‌مشی
"*"
قرار می‌گیرد، یعنی تمام سیستم‌های فایل شناخته‌شده در ایمیج استفاده می‌شوند\&.
.RE
.PP
\fB\-\-runtime\fR
.RS 4
هنگام استفاده با
\fBenable\fR،
\fBdisable\fR،
\fBedit\fR
(و دستورات مرتبط)، تغییرات را تنها به صورت موقتی اعمال می‌کند، به طوری که در راه‌اندازی مجدد بعدی از بین بروند\&. اثر این کار این است که تغییرات در زیرشاخه‌های
/etc/
اعمال نمی‌شوند، بلکه در
/run/
اعمال می‌گردند، با اثرات فوری یکسان؛ اما از آن‌جا که دومی با ریبوت پاک می‌شود، تغییرات نیز از دست می‌روند\&.
.sp
به طور مشابه، هنگام استفاده با
\fBset\-property\fR،
تغییرات را به طور موقت اعمال می‌کند تا در ریبوت بعدی از دست بروند\&.
.RE
.PP
\fB\-\-preset\-mode=\fR
.RS 4
یکی از مقادیر
"full"
(پیش‌فرض)،
"enable\-only"،
"disable\-only"
را می‌پذیرد\&. هنگامی که با دستورات
\fBpreset\fR
یا
\fBpreset\-all\fR
استفاده شود، کنترل می‌کند که آیا واحدها باید بر اساس قوانین پیش‌تنظیم فعال و غیرفعال شوند، یا فقط فعال شوند، یا فقط غیرفعال شوند\&.
.sp
اضافه شده در نسخه 215\&.
.RE
.PP
\fB\-n\fR, \fB\-\-lines=\fR
.RS 4
هنگام استفاده با
\fBstatus\fR،
تعداد خطوط ژورنال را برای نمایش کنترل می‌کند و از جدیدترین خطوط شمارش می‌نماید\&. یک آرگومان عدد صحیح مثبت، یا 0 را برای غیرفعال کردن خروجی ژورنال می‌پذیرد\&. پیش‌فرض 10 است\&.
.RE
.PP
\fB\-o\fR, \fB\-\-output=\fR
.RS 4
هنگام استفاده با
\fBstatus\fR،
قالب‌بندی ورودی‌های ژورنال نمایش‌داده‌شده را کنترل می‌کند\&. برای گزینه‌های موجود به
\fBjournalctl\fR(1)
مراجعه فرمایید\&. پیش‌فرض روی
"short"
است\&.
.RE
.PP
\fB\-\-firmware\-setup\fR
.RS 4
هنگام استفاده با دستورات
\fBreboot\fR،
\fBpoweroff\fR
یا
\fBhalt\fR،
به سفت‌افزار سیستم اعلام می‌کند که برای بوت بعدی وارد رابط تنظیمات سفت‌افزار (BIOS/UEFI setup) شود\&. توجه داشته باشید که این قابلیت در تمام سیستم‌ها در دسترس نیست\&.
.sp
اضافه شده در نسخه 220\&.
.RE
.PP
\fB\-\-boot\-loader\-menu=\fR\fB\fItimeout\fR\fR
.RS 4
هنگام استفاده با دستورات
\fBreboot\fR،
\fBpoweroff\fR
یا
\fBhalt\fR،
به لودر بوت سیستم اعلام می‌کند که منوی بوت‌لودر را در بوت بعدی نشان دهد\&. یک مقدار زمانی به عنوان پارامتر می‌گیرد \(em که مهلت زمانی منو را مشخص می‌کند\&. برای غیرفعال کردن مهلت زمانی منو عدد صفر را وارد کنید\&. توجه داشته باشید که همه بوت‌لودرها از این قابلیت پشتیبانی نمی‌کنند\&.
.sp
اضافه شده در نسخه 242\&.
.RE
.PP
\fB\-\-boot\-loader\-entry=\fR\fB\fIID\fR\fR
.RS 4
هنگام استفاده با دستورات
\fBreboot\fR،
\fBpoweroff\fR
یا
\fBhalt\fR،
به بوت‌لودر سیستم اعلام می‌کند که در بوت بعدی با یک ورودی بوت‌لودر مشخص بوت شود\&. یک شناسه ورودی بوت‌لودر را به عنوان آرگومان، یا
"help"
را برای فهرست کردن ورودی‌های موجود دریافت می‌کند\&. توجه داشته باشید که تمام بوت‌لودرها از این عملکرد پشتیبانی نمی‌کنند\&.
.sp
اضافه شده در نسخه 242\&.
.RE
.PP
\fB\-\-reboot\-argument=\fR
.RS 4
این سوییچ با
\fBreboot\fR
استفاده می‌شود\&. مقدار آن وابسته به معماری و سفت‌افزار است\&. برای مثال،
"recovery"
ممکن است برای فعال کردن بازیابی سیستم، و
"fota"
برای به‌روزرسانی سفت‌افزار از راه دور (firmware over the air) استفاده شود\&.
.sp
اضافه شده در نسخه 246\&.
.RE
.PP
\fB\-\-plain\fR
.RS 4
هنگام استفاده با
\fBlist\-dependencies\fR،
\fBlist\-units\fR
یا
\fBlist\-machines\fR،
خروجی به جای درخت به صورت یک فهرست چاپ می‌شود و دایره‌های گلوله‌ای حذف می‌شوند\&.
.sp
اضافه شده در نسخه 203\&.
.RE
.PP
\fB\-\-timestamp=\fR
.RS 4
قالب برچسب‌های زمانی چاپ‌شده را تغییر می‌دهد\&. مقادیر زیر می‌توانند استفاده شوند:
.PP
\fBpretty\fR (پیش‌فرض است)
.RS 4
"Day YYYY\-MM\-DD HH:MM:SS TZ"
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fBunix\fR
.RS 4
"@seconds\-since\-the\-epoch"
.sp
اضافه شده در نسخه 251\&.
.RE
.PP
\fBus\fR, \fBμs\fR
.RS 4
"Day YYYY\-MM\-DD HH:MM:SS\&.UUUUUU TZ"
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fButc\fR
.RS 4
"Day YYYY\-MM\-DD HH:MM:SS UTC"
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fBus+utc\fR, \fBμs+utc\fR
.RS 4
"Day YYYY\-MM\-DD HH:MM:SS\&.UUUUUU UTC"
.sp
اضافه شده در نسخه 248\&.
.RE
.sp
اضافه شده در نسخه 247\&.
.RE
.PP
\fB\-\-mkdir\fR
.RS 4
هنگام استفاده با
\fBbind\fR،
فایل یا دایرکتوری مقصد را قبل از اعمال مانت اتصالی ایجاد می‌کند\&. توجه داشته باشید هرچند نام این گزینه بیانگر مناسب بودن آن فقط برای دایرکتوری‌ها است، اما اگر شیء مورد نظر برای مانت یک دایرکتوری نباشد بلکه یک فایل معمولی، گره دستگاه، سوکت یا FIFO باشد، گره فایل مقصد را نیز ایجاد خواهد کرد\&.
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fB\-\-marked\fR
.RS 4
فقط همراه با
\fBreload\-or\-restart\fR
مجاز است\&. کارهای راه‌اندازی مجدد را برای تمام واحدهایی که دارای علامت
"needs\-restart"
هستند و کارهای بارگذاری مجدد را برای واحدهایی که علامت
"needs\-reload"
دارند در صف قرار می‌دهد\&. هنگامی که یک واحد علامت‌گذاری‌شده برای بارگذاری مجدد از بارگذاری پشتیبانی نکند، راه‌اندازی مجدد در صف قرار می‌گیرد\&. این ویژگی‌ها را می‌توان با استفاده از
\fBset\-property Markers=\&...\fR
تنظیم کرد\&.
.sp
مگر اینکه از
\fB\-\-no\-block\fR
استفاده شود،
\fBsystemctl\fR
منتظر می‌ماند تا کارهای در صف به پایان برسند\&.
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fB\-\-read\-only\fR
.RS 4
هنگام استفاده با
\fBbind\fR،
یک مانت اتصالی فقط‌خواندنی ایجاد می‌کند\&.
.sp
اضافه شده در نسخه 248\&.
.RE
.PP
\fB\-\-drop\-in=\fR\fB\fINAME\fR\fR
.RS 4
هنگام استفاده با
\fBedit\fR،
از
\fINAME\fR
به عنوان نام فایل drop\-in به جای
override\&.conf
استفاده می‌کند\&.
.sp
اضافه شده در نسخه 253\&.
.RE
.PP
\fB\-\-when=\fR
.RS 4
هنگام استفاده با
\fBhalt\fR،
\fBpoweroff\fR،
\fBreboot\fR
یا
\fBkexec\fR،
اجرای اقدام را برای برچسب زمانی داده‌شده زمان‌بندی می‌کند، که باید از نحوی که در
\fBsystemd.time\fR(7)
بخش "PARSING TIMESTAMPS" مستند شده پیروی کند\&. به طور ویژه، اگر
"show"
داده شود، اقدام زمان‌بندی‌شده فعلی نمایش داده می‌شود که می‌توان با ارسال رشته خالی یا
"cancel"
آن را لغو کرد\&.
"auto"
اقدام را طبق بازه نگهداری یا یک دقیقه در آینده زمان‌بندی خواهد کرد\&.
.sp
اضافه شده در نسخه 254\&.
.RE
.PP
\fB\-\-stdin\fR
.RS 4
هنگام استفاده با
\fBedit\fR،
محتویات فایل از ورودی استاندارد خوانده شده و ویرایشگر باز نخواهد شد\&. در این حالت، محتویات قبلی فایل به طور کامل جایگزین می‌شوند\&. این برای "ویرایش" فایل‌های واحد از طریق اسکریپت‌ها مفید است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemctl edit \-\-drop\-in=limits\&.conf \-\-stdin some\-service\&.service <<EOF
[Unit]
AllowedCPUs=7,11
EOF
.fi
.if n \{\
.RE
.\}
.sp
چندین drop\-in می‌توانند در این حالت "ویرایش" شوند؛ محتوای یکسان در همه آن‌ها نوشته خواهد شد\&.
.sp
اضافه شده در نسخه 256\&.
.RE
.PP
\fB\-H\fR, \fB\-\-host=\fR
.RS 4
عملیات را از راه دور اجرا می‌کند\&. یک نام میزبان (hostname) یا یک نام کاربری و نام میزبان را که با
"@"
جدا شده‌اند مشخص کنید\&. نام میزبان ممکن است اختیاری با پورتی که ssh روی آن شنود می‌کند با پسوند
":"
و سپس نام کانتینر جداشده با
"/"
دنبال شود که مستقیماً به یک کانتینر خاص روی میزبان مشخص‌شده متصل می‌گردد\&. این کار از SSH برای گفتگو با نمونه مدیر ماشین راه دور استفاده می‌کند\&. نام کانتینرها را می‌توان با
\fBmachinectl \-H \fR\fB\fIHOST\fR\fR
شمارش کرد\&. آدرس‌های IPv6 را داخل براکت قرار دهید\&.
.RE
.PP
\fB\-M\fR, \fB\-\-machine=\fR
.RS 4
عملیات را روی یک کانتینر محلی اجرا می‌کند\&. یک نام کانتینر را برای اتصال مشخص کنید، که اختیاری می‌تواند با یک نام کاربری برای اتصال و کاراکتر جداکننده
"@"
پیشوند بخورد\&. اگر رشته خاص
"\&.host"
به جای نام کانتینر استفاده شود، اتصالی به سیستم محلی برقرار می‌شود (که برای اتصال به گذرگاه کاربری یک کاربر خاص مفید است:
"\-\-user \-\-machine=lennart@\&.host")\&.
اگر نحو
"@"
استفاده نشود، اتصال به عنوان کاربر root برقرار می‌شود\&. اگر از نحو
"@"
استفاده شود، هر یک از سمت چپ یا سمت راست ممکن است حذف شوند (اما نه هر دو) که در این حالت نام کاربر محلی و
"\&.host"
ضمنی هستند\&.
.RE
.PP
\fB\-C\fR, \fB\-\-capsule=\fR
.RS 4
عملیات را روی یک کپسول (capsule) اجرا می‌کند\&. یک نام کپسول را برای اتصال مشخص کنید\&. برای جزئیات در مورد کپسول‌ها به
\fBcapsule@.service\fR(5)
مراجعه کنید\&.
.sp
اضافه شده در نسخه 256\&.
.RE
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
از کاربر برای احراز هویت جهت انجام عملیات دارای امتیاز سؤال نمی‌پرسد\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) هدایت نمی‌کند\&.
.RE
.PP
\fB\-\-legend=\fR\fB\fIBOOL\fR\fR
.RS 4
چاپ راهنما (legend)، یعنی سربرگ‌های ستون و پاورقی همراه با نکات راهنما را فعال یا غیرفعال می‌کند\&. راهنما به طور پیش‌فرض چاپ می‌شود، مگر اینکه با
\fB\-\-quiet\fR
یا مشابه آن غیرفعال شده باشد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته نسخه کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت 0، و در غیر این صورت یک کد شکست غیرصفر بازگردانده می‌شود\&.
.PP
\fBsystemctl\fR
از کدهای بازگشتی تعریف‌شده توسط LSB استفاده می‌کند، همان‌طور که در
\m[blue]\fBLSB 3\&.0\&.0\fR\m[]\&\s-2\u[3]\d\s+2
تعریف شده است\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&5.\ \& کدهای بازگشتی LSB
.TS
allbox tab(:);
lB lB lB.
T{
مقدار
T}:T{
توضیحات در LSB
T}:T{
کاربرد در systemd
T}
.T&
l l l
l l l
l l l
l l l
l l l.
T{
\fB0\fR
T}:T{
"برنامه در حال اجراست یا سرویس سالم است"
T}:T{
واحد فعال است (unit is active)
T}
T{
\fB1\fR
T}:T{
"برنامه مرده است و فایل pid در /var/run وجود دارد"
T}:T{
واحد ناموفق \fIنیست\fR (استفاده‌شده توسط \fBis\-failed\fR)
T}
T{
\fB2\fR
T}:T{
"برنامه مرده است و فایل قفل در /var/lock وجود دارد"
T}:T{
استفاده‌نشده
T}
T{
\fB3\fR
T}:T{
"برنامه در حال اجرا نیست"
T}:T{
واحد فعال نیست (unit is not active)
T}
T{
\fB4\fR
T}:T{
"وضعیت برنامه یا سرویس نامشخص است"
T}:T{
چنین واحدی وجود ندارد (no such unit)
T}
.TE
.sp 1
.PP
تطبیق وضعیت‌های سرویس LSB با وضعیت‌های واحد systemd ناقص است، بنابراین بهتر است به این مقادیر بازگشتی اتکا نکنید و در عوض وضعیت‌ها و وضعیت‌های فرعی خاص واحد را بررسی فرمایید\&.
.SH "محیط (ENVIRONMENT)"
.PP
\fI$SYSTEMD_EDITOR\fR
.RS 4
ویرایشگری که هنگام ویرایش واحدها استفاده می‌شود؛ بر
\fI$EDITOR\fR
و
\fI$VISUAL\fR
ارجحیت دارد\&. اگر هیچ‌یک از
\fI$SYSTEMD_EDITOR\fR،
\fI$EDITOR\fR
یا
\fI$VISUAL\fR
وجود نداشته باشند یا اگر روی یک رشته خالی تنظیم شده باشند یا اجرای آن‌ها ناموفق باشد، systemctl ویرایشگرهای شناخته‌شده را به این ترتیب امتحان می‌کند:
\fBeditor\fR(1)،
\fBnano\fR(1)،
\fBvim\fR(1)،
\fBvi\fR(1)\&.
.sp
اضافه شده در نسخه 218\&.
.RE
.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
یک مقدار بولی\&. در صورت درست (true) بودن، پیام‌های نوشته‌شده در 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_TARGET\fR
.RS 4
مقصد پیام‌های گزارش (log)\&. یکی از مقادیر زیر است:
\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_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
مجموعه کاراکترهای ارسالی به
\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
این گزینه یک آرگومان بولی می‌پذیرد\&. در صورت تنظیم روی درست (true)، "حالت امن" صفحه‌بند فعال می‌شود\&. در "حالت امن"،
\fBLESSSECURE=1\fR
هنگام فراخوانی صفحه‌بند تنظیم می‌شود، که به صفحه‌بند دستور می‌دهد دستوراتی را که فایل‌های جدید باز می‌کنند یا می‌سازند، یا فرآیندهای فرعی جدید شروع می‌کنند غیرفعال کند\&. در حال حاضر فقط
\fBless\fR(1)
شناخته شده است که این متغیر را درک کرده و "حالت امن" را پیاده‌سازی می‌کند\&.
.sp
هنگامی که روی نادرست (false) تنظیم شود، هیچ محدودیتی برای صفحه‌بند اعمال نمی‌شود\&. تنظیم
\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[4]\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
و ابزارهای مربوطه از رنگ‌ها در خروجی خود استفاده خواهند کرد، در غیر این صورت خروجی تک‌رنگ (سیاه و سفید) خواهد بود\&. علاوه بر این، متغیر می‌تواند یکی از مقادیر ویژه زیر را بگیرد:
"16"،
"256"
تا استفاده از رنگ‌ها را به ترتیب به 16 یا 256 رنگ پایه ANSI محدود کند\&. این می‌تواند برای بازنویسی تصمیم‌گیری خودکار بر اساس
\fI$TERM\fR
و آنچه کنسول به آن متصل است مشخص شود\&.
.RE
.PP
\fI$SYSTEMD_URLIFY\fR
.RS 4
مقدار باید بولی باشد\&. کنترل می‌کند که آیا پیوندهای قابل کلیک در خروجی برای شبیه‌سازهای ترمینالی که از این قابلیت پشتیبانی می‌کنند ایجاد شود یا خیر\&. این می‌تواند برای بازنویسی تصمیمی که
\fBsystemd\fR
بر اساس
\fI$TERM\fR
و شرایط دیگر می‌گیرد مشخص شود\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBloginctl\fR(1), \fBmachinectl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.special\fR(7), \fBwall\fR(1), \fBsystemd.preset\fR(5), \fBsystemd.generator\fR(7), \fBglob\fR(7)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
مشخصات لودر بوت (Boot Loader Specification)
.RS 4
\%https://uapi-group.org/specifications/specs/boot_loader_specification
.RE
.IP " 2." 4
مشخصات پارتیشن‌های قابل کشف (Discoverable Partitions Specification)
.RS 4
\%https://uapi-group.org/specifications/specs/discoverable_partitions_specification
.RE
.IP " 3." 4
استاندارد LSB 3.0.0
.RS 4
\%http://refspecs.linuxbase.org/LSB_3.0.0/LSB-PDA/LSB-PDA/iniscrptact.html
.RE
.IP " 4." 4
توصیه می‌شود سایر ابزارها نیز
\fI$SUDO_UID\fR
را در صورت لزوم تنظیم و بررسی کنند و با آن به عنوان یک رابط مشترک رفتار نمایند\&.