'\" t
.TH "STORAGECTL" "1" "" "systemd 261.2" "storagectl"
.\" -----------------------------------------------------------------
.\" * 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)"
storagectl \- بررسی و کنترل سرویسهای ذخیرهسازی سیستمدی (systemd-storaged)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBstoragectl\fR\ 'u
\fBstoragectl\fR [OPTIONS...] {COMMAND} [NAME...]
.HP \w'\fBmount\fR\ 'u
\fBmount\fR \-t storage \fIPROVIDER\fR:\fIVOLUME\fR \fIDIRECTORY\fR
.HP \w'\fBmount\fR\ 'u
\fBmount\fR \-t storage\&.\fIFSTYPE\fR \fIPROVIDER\fR:\fIVOLUME\fR \fIDIRECTORY\fR
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBstoragectl\fR
ممکن است برای بررسی ارائه‌دهندگان ذخیره‌سازی و حجم‌های ذخیره‌سازی که ارائه می‌دهند استفاده شود\&. یک ارائه‌دهنده ذخیره‌سازی، سرویسی است که رابط
\m[blue]\fBVarlink\fR\m[]\&\s-2\u[1]\d\s+2
\fBio\&.systemd\&.StorageProvider\fR
را پیاده‌سازی می‌کند، و به عنوان یک سوکت AF_UNIX در زیر دایرکتوری شناخته‌شده سوکت
/run/systemd/io\&.systemd\&.StorageProvider/
(در حالت سیستمی) یا
\fI$XDG_RUNTIME_DIR\fR/systemd/io\&.systemd\&.StorageProvider/
(در حالت کاربری) ثبت شده است\&. دو ارائه‌دهنده ذخیره‌سازی که همراه با systemd ارائه می‌شوند عبارتند از
\fBsystemd-storage-block@.service\fR(8)،
که دستگاه‌های بلوکی سیستم را در دسترس قرار می‌دهد، و
\fBsystemd-storage-fs@.service\fR(8)،
که فایل‌ها و دایرکتوری‌های معمولی را از یک سیستم‌فایل پشتیبان در دسترس قرار می‌دهد\&.
.PP
این ابزار همچنین یک کمکی
\fBmount\fR(8)
را برای نوع سیستم‌فایل
"storage"
فراهم می‌کند، که امکان سوار کردن حجم‌های ذخیره‌سازی را در مکان‌های دلخواه ممکن می‌سازد\&. برای جزئیات به بخش «استفاده به عنوان کمکی سوار کردن» در زیر مراجعه کنید\&.
.SH "دستورات (COMMANDS)"
.PP
دستورات زیر پشتیبانی می‌شوند:
.PP
\fBvolumes\fR [\fIGLOB\fR]
.RS 4
فهرست کردن حجم‌های ذخیره‌سازی ارائه‌شده توسط تمام ارائه‌دهندگان ذخیره‌سازی در حال اجرا در سیستم (یا با
\fB\-\-user\fR،
در محیط زمان اجرای کاربر)\&. آرگومان اختیاری
\fIGLOB\fR
یک الگوی سبک پوسته است (به
\fBfnmatch\fR(3)
مراجعه کنید) که نتایج را بر اساس نام حجم فیلتر می‌کند\&. خروجی جدولی شامل سرویس ارائه‌دهنده، نام حجم، نوع آن ("blk"،
"reg"
یا
"dir")، وضعیت فقط‌خواندنی بودن، و \(em در صورت مشخص بودن \(em اندازه آن و تعداد بایت‌های استفاده‌شده است\&.
.sp
در صورتی که دستوری مشخص نشود، این دستور پیش‌فرض است\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fBtemplates\fR [\fIGLOB\fR]
.RS 4
فهرست کردن الگوهای حجم پشتیبانی‌شده توسط ارائه‌دهندگان ذخیره‌سازی در حال اجرا\&. الگوها پیکربندی مورد استفاده هنگام ایجاد بی‌درنگ حجم‌ها در زمان به‌دست آوردن آن‌ها را در بر می‌گیرند\&. پشتیبانی از الگو یک ویژگی اختیاری برای ارائه‌دهندگان است و تنها برای ارائه‌دهندگانی اعمال می‌شود که امکان ایجاد بی‌درنگ حجم‌ها را فراهم می‌کنند\&. برای جزئیات به مستندات ارائه‌دهنده مربوطه مراجعه کنید، به عنوان مثال
\fBsystemd-storage-fs@.service\fR(8)\&.
آرگومان اختیاری
\fIGLOB\fR
نتایج را بر اساس نام الگو فیلتر می‌کند\&. ارائه‌دهندگان ذخیره‌سازی که ایجاد حجم مبتنی بر الگو را پیاده‌سازی نکرده‌اند (مانند ارائه‌دهنده دستگاه بلوکی) در این خروجی نقشی ندارند\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fBproviders\fR
.RS 4
فهرست کردن ارائه‌دهندگان ذخیره‌سازی شناخته‌شده برای سیستم\&. این کار با پویش دایرکتوری شناخته‌شده سوکت برای یافتن سوکت‌های
\fBAF_UNIX\fR
که شبیه به نقاط پایانی
\fBio\&.systemd\&.StorageProvider\fR
هستند تعیین می‌شود\&. برای هر ارائه‌دهنده همچنین گزارش داده می‌شود که آیا در حال حاضر می‌توان به سوکت متصل شد یا خیر\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.SH "گزینهها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-system\fR
.RS 4
عملیات روی ارائه‌دهندگان ذخیره‌سازی سراسری سیستم\&. سوکت‌ها در
/run/systemd/io\&.systemd\&.StorageProvider/
جستجو می‌شوند\&. این حالت پیش‌فرض است\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fB\-\-user\fR
.RS 4
عملیات روی ارائه‌دهندگان ذخیره‌سازی مختص هر کاربر\&. سوکت‌ها در
$XDG_RUNTIME_DIR/systemd/io\&.systemd\&.StorageProvider/
جستجو می‌شوند\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
نمایش خروجی با فرمت JSON\&. یکی از مقادیر زیر را می‌پذیرد:
"short"
(برای کوتاه‌ترین خروجی ممکن بدون هیچ فاصله خالی اضافی یا شکست خط)،
"pretty"
(برای نسخه زیباسازی‌شده همان خروجی، همراه با فاصله‌گذاری و شکست خط) یا
"off"
(برای خاموش کردن خروجی JSON، که حالت پیش‌فرض است)\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند هدایت نمی‌کند\&.
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
راهنما (عنوان ستون‌ها و پانوشت شامل نکات راهنما) را چاپ نمی‌کند\&.
.RE
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
برای عملیات دارای دسترسی بالا، برای احراز هویت از کاربر سؤالی نمی‌پرسد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته نسخه کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "استفاده به عنوان کمکی سوار کردن (USE AS A MOUNT HELPER)"
.PP
این ابزار نام مستعار
\fB/sbin/mount\&.storage\fR
را فراهم می‌کند که رابط "کمکی خارجی"
\fBmount\fR(8)
را پیاده‌سازی می‌نماید و اجازه می‌دهد حجم‌های ذخیره‌سازی با دستور معمول
\fBmount\fR
سوار شوند\&. حجم مورد نظر برای سوار شدن به عنوان منبع mount به فرم
"\fIPROVIDER\fR:\fIVOLUME\fR"
کدگذاری می‌شود، که در آن
\fIPROVIDER\fR
نام یک ارائه‌دهنده ذخیره‌سازی (همان‌طور که توسط
\fBstoragectl providers\fR
فهرست شده است) و
\fIVOLUME\fR
نام حجم است\&. دو شیوه نگارش نوع سیستم‌فایل شناخته می‌شود:
.PP
"storage"
.RS 4
یک حجم دایرکتوری را به‌دست آورده و درخت دایرکتوری آن را به صورت bind\-mount بر روی مقصد سوار می‌کند\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
"storage\&.\fIFSTYPE\fR"
.RS 4
یک فایل معمولی یا حجم دستگاه بلوکی را به‌دست آورده و آن را به عنوان یک سیستم‌فایل از نوع
\fIFSTYPE\fR
سوار می‌کند (برای مثال
"storage\&.ext4"،
"storage\&.btrfs"،
\&...)\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
گزینه‌های استاندارد
\fB\-o\fR
برای mount به
\fBmount\fR
هدایت می‌شوند\&. علاوه بر این، گزینه‌های زیر با پیشوند "storage\." توسط خود
\fBmount\&.storage\fR
تفسیر شده و از فهرست هدایت‌شده حذف می‌شوند:
.PP
\fBstorage\&.create=\fR\fIMODE\fR
.RS 4
یکی از مقادیر زیر را می‌پذیرد:
"any"
(در صورت وجود باز شود، در غیر این صورت ایجاد شود \(em حالت پیش‌فرض)،
"open"
(در صورتی که حجم هنوز وجود نداشته باشد ناموفق شود) یا
"new"
(در صورتی که حجم از قبل وجود داشته باشد ناموفق شود)\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fBstorage\&.template=\fR\fINAME\fR
.RS 4
الگویی که باید هنگام ایجاد یک حجم جدید استفاده شود، در صورتی که وجود نداشته باشد و ارائه‌دهنده از ایجاد بی‌درنگ حجم‌ها پشتیبانی کند\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.PP
\fBstorage\&.create\-size=\fR\fIBYTES\fR
.RS 4
هنگام ایجاد یک حجم جدید به صورت بی‌درنگ، اندازه به بایت برای تخصیص دادن\&. پسوندهای معمول
"K"/"M"/"G"/"T"
(بر مبنای ۱۰۲۴) را می‌پذیرد\&. هنگام ایجاد یک حجم فایل معمولی الزامی است\&.
.sp
اضافه‌شده در نگارش 261\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&1.\ \&شمارش ارائه‌دهندگان ذخیره‌سازی، حجم‌ها و الگوهای موجود\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ storagectl providers
$ storagectl volumes
$ storagectl volumes \*(Aq*foo*\*(Aq
$ storagectl templates
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&2.\ \&سوار کردن یک حجم دایرکتوری از ارائه‌دهنده سیستم‌فایل\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# mount \-t storage fs:myvol /mnt/myvol
.fi
.if n \{\
.RE
.\}
.PP
اگر حجم
"myvol"
هنوز وجود نداشته باشد، با استفاده از الگوی پیش‌فرض
"subvolume"
ایجاد خواهد شد\&.
.PP
\fBمثال\ \&3.\ \&ایجاد و سوار کردن یک سیستم‌فایل ext4 از یک فایل معمولی\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# mount \-t storage\&.ext4 fs:scratch /mnt/scratch \-o loop
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&4.\ \&سوار کردن یک حجم دستگاه بلوکی به صورت فقط‌خواندنی\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# mount \-t storage\&.ext4 \-o ro block:/dev/disk/by\-id/usb\-foo /mnt/foo
.fi
.if n \{\
.RE
.\}
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت 0 بازگردانده می‌شود، و در غیر این صورت یک کد شکست غیرصفر بازگردانده خواهد شد\&.
.SH "محیط (ENVIRONMENT)"
.PP
\fI$SYSTEMD_LOG_LEVEL\fR
.RS 4
حداکثر سطح ثبت وقایع (لاگ) برای پیام‌های ارسالی (پیام‌هایی با سطح لاگ بالاتر، یعنی کم‌اهمیت‌تر، فرونشانده خواهند شد)\&. فهرستی از مقادیر جداشده با کاما را می‌پذیرد\&. یک مقدار می‌تواند یکی از موارد زیر (به ترتیب کاهش اهمیت) باشد:
\fBemerg\fR،
\fBalert\fR،
\fBcrit\fR،
\fBerr\fR،
\fBwarning\fR،
\fBnotice\fR،
\fBinfo\fR،
\fBdebug\fR،
یا یک عدد صحیح در محدوده 0\&...7\&. برای اطلاعات بیشتر به
\fBsyslog\fR(3)
مراجعه کنید\&. هر مقدار می‌تواند به صورت اختیاری با یکی از پیشوندهای
\fBconsole\fR،
\fBsyslog\fR،
\fBkmsg\fR
یا
\fBjournal\fR
به همراه یک علامت دونقطه برای تنظیم حداکثر سطح ثبت وقایع برای آن مقصد لاگ خاص همراه شود (به عنوان مثال
\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR
مشخص می‌کند که ثبت وقایع در سطح debug انجام شود، به جز هنگام ثبت در کنسول که باید در سطح info باشد)\&. توجه داشته باشید که حداکثر سطح لاگ سراسری نسبت به سطوح لاگ تعیین‌شده برای هر مقصد اولویت دارد\&.
.RE
.PP
\fI$SYSTEMD_LOG_COLOR\fR
.RS 4
یک مقدار بولی\&. اگر درست (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_TID\fR
.RS 4
یک مقدار بولی\&. اگر درست باشد، پیام‌ها با شناسه عددی نخ (TID) فعلی پیشوندگذاری می‌شوند\&.
.sp
توجه داشته باشید که این اطلاعات به هر حال به عنوان فراداده به مدخل‌های ژورنال پیوست می‌شود\&. با این حال گنجاندن مستقیم آن در متن پیام می‌تواند هنگام اشکال‌زدایی برنامه‌ها سودمند باشد\&.
.RE
.PP
\fI$SYSTEMD_LOG_TARGET\fR
.RS 4
مقصد پیام‌های لاگ\&. یکی از موارد:
\fBconsole\fR
(ثبت در tty متصل)،
\fBconsole\-prefixed\fR
(ثبت در tty متصل اما با پیشوندهای کدگذاری‌کننده سطح لاگ و "facility"، به
\fBsyslog\fR(3)
مراجعه کنید)،
\fBkmsg\fR
(ثبت در بافر لاگ حلقوی هسته)،
\fBjournal\fR
(ثبت در ژورنال)،
\fBjournal\-or\-kmsg\fR
(ثبت در ژورنال در صورت در دسترس بودن، و در غیر این صورت در kmsg)،
\fBauto\fR
(تعیین خودکار مقصد مناسب برای لاگ، که حالت پیش‌فرض است)،
\fBnull\fR
(غیرفعال کردن خروجی لاگ)\&.
.RE
.PP
\fI$SYSTEMD_LOG_RATELIMIT_KMSG\fR
.RS 4
مشخص می‌کند که آیا محدودیت نرخ برای kmsg اعمال شود یا خیر\&. یک مقدار بولی می‌پذیرد\&. مقدار پیش‌فرض
"true"
است\&. در صورت غیرفعال بودن، systemd پیام‌های نوشته‌شده در kmsg را محدود نخواهد کرد\&.
.RE
.PP
\fI$SYSTEMD_PAGER\fR, \fI$PAGER\fR
.RS 4
صفحه‌بندی که هنگام عدم ارائه
\fB\-\-no\-pager\fR
استفاده می‌شود\&. در صورت تنظیم بودن،
\fI$SYSTEMD_PAGER\fR
استفاده می‌شود؛ در غیر این صورت
\fI$PAGER\fR
به کار می‌رود\&. اگر هیچ‌یک از
\fI$SYSTEMD_PAGER\fR
یا
\fI$PAGER\fR
تنظیم نشده باشند، مجموعه‌ای از پیاده‌سازی‌های شناخته‌شده صفحه‌بند به نوبت امتحان می‌شوند، از جمله
\fBless\fR(1)
و
\fBmore\fR(1)،
تا زمانی که یکی پیدا شود\&. اگر هیچ پیاده‌سازی صفحه‌بندی کشف نشود، صفحه‌بندی فراخوانی نخواهد شد\&. تنظیم این متغیرهای محیطی به یک رشته خالی یا مقدار
"cat"
معادل ارسال
\fB\-\-no\-pager\fR
است\&.
.sp
نکته: اگر
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد،
\fI$SYSTEMD_PAGER\fR
و
\fI$PAGER\fR
تنها می‌توانند برای غیرفعال کردن صفحه‌بند (با
"cat"
یا
"")
استفاده شوند و در غیر این صورت نادیده گرفته می‌شوند\&.
.RE
.PP
\fI$SYSTEMD_LESS\fR
.RS 4
گزینه‌های ارسالی به
\fBless\fR
را بازنویسی می‌کند (به‌طور پیش‌فرض
"FRSXMK")\&.
.sp
کاربران ممکن است به ویژه مایل به تغییر دو گزینه باشند:
.PP
\fBK\fR
.RS 4
این گزینه به صفحه‌بند دستور می‌دهد هنگام فشردن
Ctrl+C
بلافاصله خارج شود\&. برای اینکه به
\fBless\fR
اجازه دهید خودش
Ctrl+C
را برای بازگشت به اعلان فرمان صفحه‌بند مدیریت کند، این گزینه را لغو کنید\&.
.sp
اگر مقدار
\fI$SYSTEMD_LESS\fR
شامل
"K"
نباشد، و صفحه‌بند فراخوانی‌شده
\fBless\fR
باشد،
Ctrl+C
توسط برنامه اجرایی نادیده گرفته شده و باید توسط صفحه‌بند مدیریت شود\&.
.RE
.PP
\fBX\fR
.RS 4
این گزینه به صفحه‌بند دستور می‌دهد رشته‌های مقداردهی اولیه و بازنشانی termcap را به ترمینال ارسال نکند\&. این گزینه به‌طور پیش‌فرض تنظیم شده است تا خروجی دستور حتی پس از خروج از صفحه‌بند در ترمینال قابل مشاهده باقی بماند\&. با این وجود، این امر مانع از کارکرد برخی قابلیت‌های صفحه‌بند می‌شود؛ به‌ویژه خروجی صفحه‌بندی‌شده را نمی‌توان با ماوس پیمایش کرد\&.
.RE
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESS\fR
هیچ اثری بر فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.sp
برای بررسی بیشتر به
\fBless\fR(1)
مراجعه کنید\&.
.RE
.PP
\fI$SYSTEMD_LESSCHARSET\fR
.RS 4
مجموعه نویسه‌های ارسالی به
\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[2]\d\s+2)،
«حالت امن» فعال می‌شود\&. در این حالت‌ها،
\fISYSTEMD_PAGERSECURE=1\fR
تنظیم خواهد شد و صفحه‌بندهایی که اجرای «حالت امن» توسط آن‌ها شناخته نشده است اصلاً استفاده نخواهند شد\&. توجه داشته باشید که این تشخیص خودکار تنها متداول‌ترین سازوکارهای ارتقای اختیارات را پوشش می‌دهد و برای راحتی کار در نظر گرفته شده است\&. توصیه می‌شود صراحتاً
\fI$SYSTEMD_PAGERSECURE\fR
را تنظیم کنید یا صفحه‌بند را غیرفعال نمایید\&.
.sp
توجه داشته باشید که اگر قرار باشد متغیرهای
\fI$SYSTEMD_PAGER\fR
یا
\fI$PAGER\fR
رعایت شوند، به جز برای غیرفعال کردن صفحه‌بند، باید
\fI$SYSTEMD_PAGERSECURE\fR
نیز تنظیم شده باشد\&.
.RE
.PP
\fI$SYSTEMD_COLORS\fR
.RS 4
یک آرگومان بولی یا یک مقدار ویژه می‌پذیرد\&. به طور پیش‌فرض (تنظیم‌نشده)،
\fBsystemd\fR
و ابزارهای مرتبط در صورت امکان از رنگ‌ها در خروجی خود استفاده خواهند کرد\&. اگر
\fI$COLORTERM\fR
بر روی
"truecolor"
یا
"24bit"
تنظیم شده باشد، رنگ‌های ۲۴ بیتی فعال می‌شوند، در غیر این صورت رنگ‌های ۲۵۶ رنگ فعال خواهند بود، مگر اینکه
\fI$NO_COLOR\fR
یا
\fI$TERM\fR
نشان دهد که رنگ‌ها غیرفعال هستند\&.
.PP
\fBtrue\fR
.RS 4
مشابه حالت تنظیم‌نشده است، با این تفاوت که
\fI$NO_COLOR\fR
نادیده گرفته می‌شود\&.
.RE
.PP
\fBfalse\fR
.RS 4
خروجی تک‌رنگ خواهد بود\&.
.RE
.PP
"16", "256", "24bit"
.RS 4
همواره به ترتیب از ۱۶ رنگ پایه ANSI، ۲۵۶ رنگ، یا رنگ‌های ۲۴ بیتی استفاده می‌کند\&.
.RE
.PP
"auto\-16", "auto\-256", "auto\-24bit"
.RS 4
با توجه به
\fI$TERM\fR
و آنچه کنسول به آن متصل است، از تعداد رنگ‌های مشخص‌شده استفاده می‌کند\&.
.RE
.RE
.PP
\fI$SYSTEMD_URLIFY\fR
.RS 4
مقدار باید یک بولی باشد\&. مشخص می‌کند آیا برای شبیه‌سازهای ترمینال پشتیبانی‌کننده، پیوندهای قابل کلیک در خروجی تولید شوند یا خیر\&. این مقدار می‌تواند برای لغو تصمیمی که
\fBsystemd\fR
بر اساس
\fI$TERM\fR
و شرایط دیگر می‌گیرد، تعیین شود\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-storage-block@.service\fR(8), \fBsystemd-storage-fs@.service\fR(8), \fBvarlinkctl\fR(1), \fBmount\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
Varlink
.RS 4
\%https://varlink.org
.RE
.IP " 2." 4
به سایر ابزارها توصیه می‌شود متناسب با نیاز،
\fI$SUDO_UID\fR
را تنظیم و بررسی کنند و با آن به عنوان یک رابط مشترک رفتار نمایند\&.