'\" t
.TH "SYSTEMD\-TMPFILES" "8" "" "systemd 261.2" "systemd-tmpfiles"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-tmpfiles, systemd-tmpfiles-setup.service, systemd-tmpfiles-setup-dev-early.service, systemd-tmpfiles-setup-dev.service, systemd-tmpfiles-clean.service, systemd-tmpfiles-clean.timer \- ایجاد، حذف و پاک‌سازی خودکار فایل‌ها و دایرکتوری‌های موقت
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-tmpfiles\fR\ 'u
\fBsystemd\-tmpfiles\fR [OPTIONS...] [\fICONFIGFILE\fR...]
.PP
واحدهای سیستمی:
.RS 4
systemd\-tmpfiles\-setup\&.service
.RE
.RS 4
systemd\-tmpfiles\-setup\-dev\-early\&.service
.RE
.RS 4
systemd\-tmpfiles\-setup\-dev\&.service
.RE
.RS 4
systemd\-tmpfiles\-clean\&.service
.RE
.RS 4
systemd\-tmpfiles\-clean\&.timer
.RE
.PP
واحدهای کاربری:
.RS 4
systemd\-tmpfiles\-setup\&.service
.RE
.RS 4
systemd\-tmpfiles\-clean\&.service
.RE
.RS 4
systemd\-tmpfiles\-clean\&.timer
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-tmpfiles\fR
فایل‌ها و دایرکتوری‌ها را با استفاده از قالب و مکان فایل‌های پیکربندی مشخص‌شده در
\fBtmpfiles.d\fR(5)
ایجاد، حذف و پاک‌سازی می‌کند\&. از نظر تاریخی، همان‌طور که از نام آن پیداست، برای مدیریت فایل‌های موقت و فرار (volatile) طراحی شده بود، اما قابلیت‌های عمومی مدیریت فایل را ارائه می‌دهد و می‌تواند برای مدیریت هر نوع فایلی استفاده شود\&. این ابزار باید با یک یا چند دستور از میان
\fB\-\-create\fR،
\fB\-\-remove\fR
و
\fB\-\-clean\fR
فراخوانی شود تا زیرمجموعه عملیات مربوطه انتخاب گردد\&.
.PP
اگر بدون آرگومان فراخوانی شود، دستورالعمل‌های موجود در فایل‌های پیکربندی ارائه‌شده در دایرکتوری‌های مشخص‌شده توسط
\fBtmpfiles.d\fR(5)
اجرا می‌شوند\&. هنگامی که با آرگومان‌های موضعی فراخوانی شود، اگر گزینه
\fB\-\-replace=\fR\fB\fIPATH\fR\fR
مشخص شده باشد، آرگومان‌های مشخص‌شده در خط فرمان به جای فایل پیکربندی
\fIPATH\fR
استفاده می‌شوند\&. در غیر این صورت، تنها پیکربندی مشخص‌شده توسط آرگومان‌های خط فرمان اجرا می‌شود\&. اگر به جای نام فایل رشته‌ی
"\-"
مشخص شود، پیکربندی از ورودی استاندارد خوانده می‌شود\&. اگر آرگومان نام یک فایل باشد (بدون هیچ اسلشی)، تمام دایرکتوری‌های پیکربندی برای یافتن یک فایل مطابق جستجو می‌شوند و فایلی که دارای بالاترین اولویت است اجرا می‌شود\&. اگر آرگومان یک مسیر باشد، آن فایل مستقیماً و بدون جستجو در دایرکتوری‌های پیکربندی برای هرگونه فایل منطبق دیگر استفاده می‌شود\&.
.PP
سرویس‌های سیستمی (systemd\-tmpfiles\-setup\&.service،
systemd\-tmpfiles\-setup\-dev\-early\&.service،
systemd\-tmpfiles\-setup\-dev\&.service،
systemd\-tmpfiles\-clean\&.service)
\fBsystemd\-tmpfiles\fR
را برای ایجاد فایل‌های سیستمی و انجام پاک‌سازی سراسری سیستم فراخوانی می‌کنند\&. این سرویس‌ها فایل‌های پیکربندی تحت کنترل مدیر سیستم را در دایرکتوری‌های
tmpfiles\&.d/
می‌خوانند\&. سرویس‌های کاربری (systemd\-tmpfiles\-setup\&.service،
systemd\-tmpfiles\-clean\&.service) نیز
\fBsystemd\-tmpfiles\fR
را فراخوانی می‌کنند، اما این نمونه مجموعه جداگانه‌ای از فایل‌ها را می‌خواند که شامل فایل‌های تحت کنترل کاربر در
~/\&.config/user\-tmpfiles\&.d/
و
~/\&.local/share/user\-tmpfiles\&.d/
و فایل‌های تحت کنترل مدیر سیستم در
/usr/share/user\-tmpfiles\&.d/
می‌شود\&. کاربران می‌توانند از این قابلیت برای ایجاد و پاک‌سازی فایل‌های تحت کنترل خود استفاده کنند، اما نمونه سیستمی پاک‌سازی سراسری را انجام می‌دهد و تحت تأثیر پیکربندی کاربر قرار نمی‌گیرد\&. توجه داشته باشید که این بدان معناست که یک پاک‌سازی مبتنی بر زمانِ پیکربندی‌شده در نمونه سیستمی، مانند آنچه معمولاً برای
/tmp/
پیکربندی می‌شود، روی فایل‌های ایجادشده توسط نمونه کاربری نیز در صورتی که در
/tmp/
قرار داده شده باشند تأثیر خواهد گذاشت، حتی اگر پاک‌سازی مبتنی بر زمان نمونه کاربری خاموش باشد\&.
.PP
برای اعمال مجدد تنظیمات پس از تغییر پیکربندی، کافی است
systemd\-tmpfiles\-clean\&.service
را راه‌اندازی مجدد (restart) کنید، که هر تنظیمی را که بتوان در زمان اجرا با اطمینان اعمال کرد اجرا خواهد نمود\&. برای اشکال‌زدایی
\fBsystemd\-tmpfiles\fR،
ممکن است فراخوانی مستقیم آن از خط فرمان با افزایش سطح لاگ مفید باشد (به
\fI$SYSTEMD_LOG_LEVEL\fR
در زیر مراجعه کنید)\&.
.SH "دستورات و گزینه‌ها (COMMANDS AND OPTIONS)"
.PP
دستورات زیر پشتیبانی می‌شوند:
.PP
\fB\-\-create\fR
.RS 4
اگر این دستور ارسال شود، تمام فایل‌ها و دایرکتوری‌هایی که در فایل‌های پیکربندی با
\fIf\fR،
\fIF\fR،
\fIw\fR،
\fId\fR،
\fID\fR،
\fIv\fR،
\fIp\fR،
\fIL\fR،
\fIc\fR،
\fIb\fR،
\fIm\fR
علامت‌گذاری شده‌اند ایجاد می‌شوند یا در آن‌ها نوشته می‌شود\&. مالکیت، حالت دسترسی و برچسب‌های امنیتی فایل‌ها و دایرکتوری‌های علامت‌گذاری‌شده با
\fIz\fR،
\fIZ\fR،
\fIt\fR،
\fIT\fR،
\fIa\fR
و
\fIA\fR
تنظیم می‌گردد\&.
.RE
.PP
\fB\-\-clean\fR
.RS 4
اگر این دستور ارسال شود، تمام فایل‌ها و دایرکتوری‌هایی که پارامتر سن (age) برای آن‌ها پیکربندی شده است، پاک‌سازی خواهند شد\&.
.RE
.PP
\fB\-\-remove\fR
.RS 4
اگر این دستور ارسال شود، محتوای دایرکتوری‌های علامت‌گذاری‌شده با
\fID\fR
یا
\fIR\fR،
و خود فایل‌ها یا دایرکتوری‌های علامت‌گذاری‌شده با
\fIr\fR
یا
\fIR\fR
حذف می‌شوند، مگر اینکه یک قفل BSD انحصاری یا مشترک روی آن‌ها گرفته شده باشد (به
\fBflock\fR(2)
مراجعه کنید)\&.
.RE
.PP
\fB\-\-purge\fR
.RS 4
اگر این گزینه ارسال شود، تمام فایل‌ها و دایرکتوری‌هایی که برای
\fIایجاد\fR
اعلام شده و با نویسه
"$"
توسط فایل‌های
tmpfiles\&.d/
مشخص‌شده در خط فرمان علامت‌گذاری شده‌اند،
\fIحذف خواهند شد\fR\&. به‌طور مشخص، این دستور روی تمام فایل‌ها و دایرکتوری‌های علامت‌گذاری‌شده با
\fIf\fR،
\fIF\fR،
\fId\fR،
\fID\fR،
\fIv\fR،
\fIq\fR،
\fIQ\fR،
\fIp\fR،
\fIL\fR،
\fIc\fR،
\fIb\fR،
\fIC\fR،
\fIw\fR،
\fIe\fR
عمل می‌کند\&. در صورت استفاده از این سوئیچ، به دلایل ایمنی باید حداقل یک فایل
tmpfiles\&.d/
(یا
\-
برای ورودی استاندارد) در خط فرمان مشخص شود وگرنه فراخوانی رد خواهد شد (زیرا در غیر این صورت بخش زیادی از فایل‌های نصب‌شده سیستم ممکن است حذف شوند)\&.
.sp
مورد استفاده اصلی این گزینه، حذف خودکار فایل‌ها و دایرکتوری‌هایی است که در اصل به نمایندگی از یک بسته نصب‌شده ایجاد شده بودند، در زمان حذف آن بسته\&.
.sp
توصیه می‌شود ابتدا این دستور را در ترکیب با
\fB\-\-dry\-run\fR
(زیر را ببینید) اجرا کنید تا بررسی شود چه فایل‌ها و دایرکتوری‌هایی حذف خواهند شد\&.
.sp
\fIهشدار!\fR
این معمولاً دستوری نیست که شما می‌خواهید! در بیشتر موارد
\fB\-\-remove\fR
همان چیزی است که به دنبال آن هستید\&.
.sp
اضافه‌شده در نسخه ۲۵۶\&.
.RE
.PP
\fB\-\-user\fR
.RS 4
اجرای پیکربندی "کاربر"، یعنی فایل‌های
tmpfiles\&.d/
در دایرکتوری‌های پیکربندی کاربر\&.
.sp
اضافه‌شده در نسخه ۲۳۶\&.
.RE
.PP
\fB\-\-boot\fR
.RS 4
همچنین خطوط دارای علامت تعجب را اجرا می‌کند\&. خطوطی که اجرای آن‌ها روی یک سیستم در حال اجرا ایمن نیست ممکن است به این روش علامت‌گذاری شوند\&.
\fBsystemd\-tmpfiles\fR
در زمان بوت اولیه با تعیین
\fB\-\-boot\fR
اجرا می‌شود و آن خطوط را اجرا خواهد کرد\&. هنگامی که بعداً دوباره فراخوانی شود، باید بدون
\fB\-\-boot\fR
فراخوانده شود\&.
.sp
اضافه‌شده در نسخه ۲۰۹\&.
.RE
.PP
\fB\-\-graceful\fR
.RS 4
نادیده گرفتن خطوط پیکربندی مربوط به کاربران یا گروه‌های ناشناخته\&. این گزینه برای استفاده در مراحل اولیه بوت پیش از ایجاد همه کاربران یا گروه‌ها در نظر گرفته شده است\&.
.sp
اضافه‌شده در نسخه ۲۵۴\&.
.RE
.PP
\fB\-\-dry\-run\fR
.RS 4
پردازش پیکربندی و چاپ اینکه چه عملیاتی انجام خواهد شد، اما عملاً چیزی در فایل‌سیستم تغییر نمی‌دهد\&.
.sp
اضافه‌شده در نسخه ۲۵۶\&.
.RE
.PP
\fB\-\-inline\fR
.RS 4
رفتار با هر آرگومان موضعی به عنوان یک خط پیکربندی مجزا به جای نام فایل\&.
.sp
اضافه‌شده در نسخه ۲۶۱\&.
.RE
.PP
\fB\-\-prefix=\fR\fB\fIpath\fR\fR
.RS 4
فقط قوانینی با مسیرهایی که با پیشوند مشخص‌شده شروع می‌شوند را اعمال می‌کند\&. این گزینه را می‌توان چندین بار مشخص کرد\&.
.sp
اضافه‌شده در نسخه ۲۱۲\&.
.RE
.PP
\fB\-\-exclude\-prefix=\fR\fB\fIpath\fR\fR
.RS 4
نادیده گرفتن قوانینی با مسیرهایی که با پیشوند مشخص‌شده شروع می‌شوند\&. این گزینه را می‌توان چندین بار مشخص کرد\&.
.sp
اضافه‌شده در نسخه ۲۰۷\&.
.RE
.PP
\fB\-E\fR
.RS 4
یک میانبر برای
"\-\-exclude\-prefix=/dev \-\-exclude\-prefix=/proc \-\-exclude\-prefix=/run \-\-exclude\-prefix=/sys"،
یعنی مستثنی کردن سلسله‌مراتب‌هایی که معمولاً مبتنی بر سیستم‌های فایل مجازی یا حافظه‌ای هستند\&. این گزینه در ترکیب با
\fB\-\-root=\fR
مفید است، در صورتی که درخت دایرکتوری مشخص‌شده شامل یک درخت سیستم‌عامل بدون مانت شدن این سیستم‌های فایل مجازی/حافظه‌ای باشد، زیرا معمولاً ایجاد هرگونه فایل و دایرکتوری زیر این زیردایرکتوری‌ها در صورتی که قرار باشد در زمان اجرا روی آن‌ها مانت شود (overmount)، مطلوب نیست\&.
.sp
اضافه‌شده در نسخه ۲۴۷\&.
.RE
.PP
\fB\-\-root=\fR\fB\fIroot\fR\fR
.RS 4
یک مسیر دایرکتوری را به عنوان آرگومان می‌گیرد\&. تمام مسیرها با مسیر جایگزین داده‌شده
\fIroot\fR
پیشوندگذاری می‌شوند، از جمله مسیرهای جستجوی پیکربندی\&.
.sp
هنگامی که از این گزینه استفاده می‌شود، سرویس سوئیچ نام لایب‌سی (libc NSS) برای برطرف‌سازی کاربران و گروه‌ها دور زده می‌شود\&. در عوض فایل‌های
/etc/passwd
و
/etc/group
درون ریشه جایگزین مستقیماً خوانده می‌شوند\&. این بدان معناست که کاربران/گروه‌هایی که در این فایل‌ها فهرست نشده‌اند شناسایی نخواهند شد، یعنی LDAP، NIS و سایر پایگاه‌های داده پیچیده در نظر گرفته نمی‌شوند\&.
.sp
ترکیب این گزینه با
\fB\-E\fR
را در نظر داشته باشید تا اطمینان حاصل شود که فراخوانی، فایل‌ها یا دایرکتوری‌هایی را زیر نقاط اتصال در ایمیج سیستم‌عامل تحت عملیات ایجاد نمی‌کند که معمولاً در طول زمان اجرا روی آن‌ها مانت می‌شود\&.
.sp
توجه داشته باشید که این یک ویژگی ایزوله‌سازی (sandboxing) یا امنیتی نیست\&. تعاریف
\fBtmpfiles.d\fR(5)
ممکن است به صورت کاملاً ایزوله (hermetic) نسبت به ریشه مشخص‌شده پردازش نشوند\&.
.sp
اضافه‌شده در نسخه ۲۱۲\&.
.RE
.PP
\fB\-\-image=\fR\fB\fIimage\fR\fR
.RS 4
مسیری به یک فایل ایمیج دیسک یا گره دستگاه بلوکی می‌گیرد\&. در صورت مشخص شدن، تمام عملیات بر روی سیستم فایل در ایمیج دیسک مشخص‌شده اعمال می‌شود\&. این مشابه
\fB\-\-root=\fR
است اما روی سیستم‌های فایل ذخیره‌شده در ایمیج‌های دیسک یا دستگاه‌های بلوکی عمل می‌کند\&. ایمیج دیسک باید شامل یک سیستم فایل یا مجموعه‌ای از سیستم‌های فایل درون یک جدول پارتیشن GPT باشد، پیرو
\m[blue]\fBUAPI\&.2 Discoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. برای اطلاعات بیشتر درباره ایمیج‌های دیسک پشتیبانی‌شده، سوئیچ هم‌نام در
\fBsystemd-nspawn\fR(1)\*(Aq
را ببینید\&.
.sp
به صورت ضمنی شامل
\fB\-E\fR
می‌شود\&.
.sp
اضافه‌شده در نسخه ۲۴۷\&.
.RE
.PP
\fB\-\-image\-policy=\fR\fB\fIpolicy\fR\fR
.RS 4
یک رشته سیاست ایمیج را به عنوان آرگومان می‌گیرد، مطابق با
\fBsystemd.image-policy\fR(7)\&.
این سیاست هنگام کار بر روی ایمیج دیسک مشخص‌شده از طریق
\fB\-\-image=\fR
اعمال می‌شود، بالا را ببینید\&. اگر مشخص نشود، به صورت پیش‌فرض به سیاست
"*"
تنظیم می‌شود، یعنی تمام سیستم‌های فایل شناسایی‌شده در ایمیج استفاده می‌شوند\&.
.RE
.PP
\fB\-\-replace=\fR\fB\fIPATH\fR\fR
.RS 4
هنگامی که این گزینه داده می‌شود، باید یک یا چند آرگومان موضعی مشخص شود\&. تمام فایل‌های پیکربندی یافت‌شده در دایرکتوری‌های فهرست‌شده در
\fBtmpfiles.d\fR(5)
خوانده می‌شوند، و پیکربندی ارائه‌شده در خط فرمان به جای فایل پیکربندی
\fIPATH\fR
و با همان اولویت آن پردازش خواهد شد\&.
.sp
این گزینه برای استفاده در زمانی در نظر گرفته شده است که اسکریپت‌های نصب بسته در حال اجرا هستند و فایل‌های متعلق به آن بسته هنوز روی دیسک در دسترس نیستند، بنابراین محتوای آن‌ها باید در خط فرمان ارائه شود، اما ممکن است پیکربندی مدیر سیستم از قبل وجود داشته باشد و باید اولویت بالاتری به آن داده شود\&.
.sp
اضافه‌شده در نسخه ۲۳۸\&.
.RE
.PP
\fB\-\-cat\-config\fR
.RS 4
کپی محتوای فایل‌های پیکربندی در خروجی استاندارد\&. قبل از هر فایل، نام فایل به صورت یک کامنت چاپ می‌شود\&.
.RE
.PP
\fB\-\-tldr\fR
.RS 4
کپی محتوای فایل‌های پیکربندی در خروجی استاندارد\&. فقط بخش‌های «جالب‌توجه» فایل‌های پیکربندی چاپ می‌شوند و کامنت‌ها و خطوط خالی نادیده گرفته می‌شوند\&. قبل از هر فایل، نام فایل به صورت یک کامنت چاپ می‌شود\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) هدایت نمی‌کند\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
چاپ یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
چاپ یک رشته نسخه کوتاه و خروج\&.
.RE
.PP
امکان ترکیب
\fB\-\-create\fR،
\fB\-\-clean\fR
و
\fB\-\-remove\fR
در یک فراخوانی وجود دارد (که در این صورت حذف و پاک‌سازی قبل از ایجاد فایل‌های جدید اجرا می‌شوند)\&. برای مثال، در حین بوت خط فرمان زیر اجرا می‌شود تا اطمینان حاصل گردد که تمام دایرکتوری‌های موقت و فرار بر اساس فایل پیکربندی حذف و ایجاد می‌شوند:
.sp
.if n \{\
.RS 4
.\}
.nf
systemd\-tmpfiles \-\-remove \-\-create
.fi
.if n \{\
.RE
.\}
.SH "اعتبارنامه‌ها (CREDENTIALS)"
.PP
\fBsystemd\-tmpfiles\fR
از منطق اعتبارنامه‌های سرویس همان‌طور که توسط
\fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR
پیاده‌سازی شده است پشتیبانی می‌کند (برای جزئیات به
\fBsystemd.exec\fR(5)
مراجعه کنید)\&. در صورت ارسال، اعتبارنامه‌های زیر استفاده می‌شوند:
.PP
\fItmpfiles\&.extra\fR
.RS 4
محتوای این اعتبارنامه می‌تواند شامل خطوط اضافی برای پردازش باشد\&. محتوای اعتبارنامه باید از همان قالبی پیروی کند که هر فایل drop\-in دیگری در
tmpfiles\&.d/
استفاده می‌کند\&. اگر این اعتبارنامه ارسال شود، پس از خوانده شدن تمام فایل‌های drop\-in از سیستم فایل پردازش می‌شود\&. بنابراین خطوط موجود در اعتبارنامه می‌توانند خطوط موجود در سیستم‌عامل را تکمیل کنند، اما نمی‌توانند آن‌ها را بازنویسی (override) نمایند\&.
.sp
اضافه‌شده در نسخه ۲۵۲\&.
.RE
.PP
توجه داشته باشید که به طور پیش‌فرض فایل واحد
systemd\-tmpfiles\-setup\&.service
(و فایل‌های واحد مرتبط) به گونه‌ای تنظیم شده است که اعتبارنامه
"tmpfiles\&.extra"
را از مدیر سرویس به ارث ببرد\&.
.SH "محیط (ENVIRONMENT)"
.PP
\fI$SYSTEMD_LOG_LEVEL\fR
.RS 4
حداکثر سطح ثبت وقایع (لاگ) برای پیام‌های منتشرشده (پیام‌های با سطح لاگ بالاتر، یعنی با اهمیت کمتر، نادیده گرفته خواهند شد)\&. فهرستی از مقادیر جداشده با کاما را می‌پذیرد\&. یک مقدار می‌تواند یکی از موارد زیر باشد (به ترتیب کاهش اهمیت):
\fBemerg\fR،
\fBalert\fR،
\fBcrit\fR،
\fBerr\fR،
\fBwarning\fR،
\fBnotice\fR،
\fBinfo\fR،
\fBdebug\fR
یا یک عدد صحیح در محدوده 0\&...7\&. برای اطلاعات بیشتر به
\fBsyslog\fR(3)
مراجعه کنید\&. هر مقدار می‌تواند به صورت اختیاری با یکی از پیشوندهای
\fBconsole\fR،
\fBsyslog\fR،
\fBkmsg\fR
یا
\fBjournal\fR
همراه با یک دو نقطه (:) مشخص شود تا حداکثر سطح لاگ را برای آن مقصد لاگ خاص تعیین کند (برای مثال
\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR
مشخص می‌کند که لاگ در سطح debug باشد مگر هنگام ثبت در کنسول که باید در سطح info باشد)\&. توجه داشته باشید که حداکثر سطح لاگ سراسری بر حداکثر سطوح لاگِ هر مقصد اولویت دارد\&.
.RE
.PP
\fI$SYSTEMD_LOG_COLOR\fR
.RS 4
یک مقدار بولی\&. اگر درست باشد، پیام‌های نوشته‌شده در tty بر اساس اولویت رنگی خواهند شد\&.
.sp
این تنظیم تنها زمانی مفید است که پیام‌ها مستقیماً در ترمینال نوشته شوند، زیرا
\fBjournalctl\fR(1)
و سایر ابزارهایی که لاگ‌ها را نمایش می‌دهند، خودشان پیام‌ها را بر اساس سطح لاگ رنگی می‌کنند\&.
.RE
.PP
\fI$SYSTEMD_LOG_TIME\fR
.RS 4
یک مقدار بولی\&. اگر درست باشد، پیام‌های لاگ کنسول با یک برچسب زمانی پیشوند می‌شوند\&.
.sp
این تنظیم تنها زمانی مفید است که پیام‌ها مستقیماً در ترمینال یا یک فایل نوشته شوند، زیرا
\fBjournalctl\fR(1)
و سایر ابزارهایی که لاگ‌ها را نمایش می‌دهند، خودشان برچسب‌های زمانی را بر اساس متادیتای ورودی پیوست می‌کنند\&.
.RE
.PP
\fI$SYSTEMD_LOG_LOCATION\fR
.RS 4
یک مقدار بولی\&. اگر درست باشد، پیام‌ها با نام فایل و شماره خط در کد منبع که پیام از آنجا سرچشمه گرفته است پیشوند می‌شوند\&.
.sp
توجه داشته باشید که مکان لاگ اغلب به عنوان متادیتا به ورودی‌های ژورنال ضمیمه می‌شود\&. با این حال، درج مستقیم آن در متن پیام می‌تواند هنگام اشکال‌زدایی برنامه‌ها راحت باشد\&.
.RE
.PP
\fI$SYSTEMD_LOG_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_PAGER\fR, \fI$PAGER\fR
.RS 4
صفحه‌بندی که هنگام مشخص نشدن
\fB\-\-no\-pager\fR
استفاده می‌شود\&. در صورت تنظیم بودن
\fI$SYSTEMD_PAGER\fR
از آن استفاده می‌شود؛ در غیر این صورت از
\fI$PAGER\fR
استفاده خواهد شد\&. اگر نه
\fI$SYSTEMD_PAGER\fR
و نه
\fI$PAGER\fR
تنظیم نشده باشند، مجموعه‌ای از پیاده‌سازی‌های شناخته‌شده صفحه‌بند به نوبت امتحان می‌شوند، از جمله
\fBless\fR(1)
و
\fBmore\fR(1)،
تا زمانی که یکی پیدا شود\&. اگر هیچ پیاده‌سازی صفحه‌بندی پیدا نشود، هیچ صفحه‌بندی فراخوانی نمی‌شود\&. تنظیم این متغیرهای محیطی روی یک رشته خالی یا مقدار
"cat"
معادل ارسال
\fB\-\-no\-pager\fR
است\&.
.sp
نکته: اگر
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد،
\fI$SYSTEMD_PAGER\fR
و
\fI$PAGER\fR
فقط برای غیرفعال کردن صفحه‌بند (با
"cat"
یا
"")
می‌توانند استفاده شوند، و در غیر این صورت نادیده گرفته می‌شوند\&.
.RE
.PP
\fI$SYSTEMD_LESS\fR
.RS 4
لغو گزینه‌های ارسالی به
\fBless\fR
(به طور پیش‌فرض
"FRSXMK")\&.
.sp
کاربران ممکن است بخواهند دو گزینه را به ویژه تغییر دهند:
.PP
\fBK\fR
.RS 4
این گزینه به صفحه‌بند دستور می‌دهد هنگام فشرده شدن
Ctrl+C
فوراً خارج شود\&. برای اینکه به
\fBless\fR
اجازه دهید خودش
Ctrl+C
را برای بازگشت به خط فرمان صفحه‌بند مدیریت کند، این گزینه را لغو کنید\&.
.sp
اگر مقدار
\fI$SYSTEMD_LESS\fR
شامل
"K"
نباشد، و صفحه‌بند فراخوانی‌شده
\fBless\fR
باشد،
Ctrl+C
توسط فایل اجرایی نادیده گرفته شده و باید توسط صفحه‌بند مدیریت شود\&.
.RE
.PP
\fBX\fR
.RS 4
این گزینه به صفحه‌بند دستور می‌دهد که رشته‌های مقداردهی اولیه و پایان‌دهی termcap را به ترمینال ارسال نکند\&. این گزینه به طور پیش‌فرض تنظیم شده است تا خروجی دستور حتی پس از خروج صفحه‌بند در ترمینال قابل مشاهده باقی بماند\&. با این حال، این امر مانع از عملکرد برخی قابلیت‌های صفحه‌بند می‌شود، به ویژه خروجی صفحه‌بندی‌شده را نمی‌توان با ماوس پیمایش (اسکرول) کرد\&.
.RE
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESS\fR
هیچ تاثیری برای فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.sp
برای توضیحات بیشتر به
\fBless\fR(1)
مراجعه کنید\&.
.RE
.PP
\fI$SYSTEMD_LESSCHARSET\fR
.RS 4
لغو مجموعه نویسه (charset) ارسالی به
\fBless\fR
(به طور پیش‌فرض
"utf\-8"،
اگر ترمینال فراخواننده به عنوان سازگار با UTF-8 تشخیص داده شود)\&.
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESSCHARSET\fR
هیچ تاثیری برای فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.RE
.PP
\fI$SYSTEMD_PAGERSECURE\fR
.RS 4
دستورات رایج صفحه‌بند مانند
\fBless\fR(1)،
علاوه بر «صفحه‌بندی»، یعنی پیمایش در خروجی، از باز کردن یا نوشتن در فایل‌های دیگر و اجرای دستورات دلخواه شل پشتیبانی می‌کنند\&. هنگامی که دستورات با امتیازات بالا، به عنوان مثال تحت
\fBsudo\fR(8)
یا
\fBpkexec\fR(1)
فراخوانی می‌شوند، صفحه‌بند به یک مرز امنیتی تبدیل می‌شود\&. باید دقت شود که تنها برنامه‌هایی با قابلیت‌های کاملاً محدود به عنوان صفحه‌بند استفاده شوند، و ویژگی‌های تعاملی ناخواسته مانند باز کردن یا ایجاد فایل‌های جدید یا شروع زیرفرایندها مجاز نباشند\&. «حالت امن» برای صفحه‌بند ممکن است همان‌طور که در زیر توضیح داده شده فعال شود،
\fIاگر صفحه‌بند از آن پشتیبانی کند\fR
(بیشتر صفحه‌بندها به شیوه‌ای نوشته نشده‌اند که این موضوع را در نظر بگیرند)\&. توصیه می‌شود یا صراحتاً «حالت امن» را فعال کنید یا با استفاده از
\fB\-\-no\-pager\fR
یا
\fIPAGER=cat\fR
هنگام اجازه دادن به کاربران غیرقابل اعتماد برای اجرای دستورات با امتیازات بالا، صفحه‌بند را کاملاً غیرفعال نمایید\&.
.sp
این گزینه یک آرگومان بولی می‌پذیرد\&. هنگامی که روی درست تنظیم شود، «حالت امن» صفحه‌بند فعال می‌شود\&. در «حالت امن»، هنگام فراخوانی صفحه‌بند
\fBLESSSECURE=1\fR
تنظیم خواهد شد، که به صفحه‌بند دستور می‌دهد دستوراتی را که فایل‌های جدید باز می‌کنند یا ایجاد می‌کنند یا زیرفرایندهای جدید آغاز می‌کنند غیرفعال کند\&. در حال حاضر فقط
\fBless\fR(1)
شناخته شده است که این متغیر را درک می‌کند و «حالت امن» را پیاده‌سازی می‌نماید\&.
.sp
هنگامی که روی نادرست تنظیم شود، هیچ محدودیتی بر صفحه‌بند اعمال نمی‌شود\&. تنظیم
\fISYSTEMD_PAGERSECURE=0\fR
یا حذف نکردن آن از متغیرهای محیطی به ارث رسیده ممکن است به کاربر اجازه دهد دستورات دلخواه را اجرا کند\&.
.sp
هنگامی که
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد، ابزارهای systemd تلاش می‌کنند تا به طور خودکار تشخیص دهند که آیا «حالت امن» باید فعال شود و آیا صفحه‌بند از آن پشتیبانی می‌کند یا خیر\&. اگر UID مؤثر با مالک نشست ورود یکسان نباشد، به
\fBgeteuid\fR(2)
و
\fBsd_pid_get_owner_uid\fR(3)
مراجعه کنید، یا هنگام اجرا تحت
\fBsudo\fR(8)
یا ابزارهای مشابه (\fI$SUDO_UID\fR
تنظیم شده باشد
\&\s-2\u[2]\d\s+2)\&.
در این موارد،
\fISYSTEMD_PAGERSECURE=1\fR
تنظیم می‌شود و صفحه‌بندهایی که پیاده‌سازی «حالت امن» در آن‌ها شناخته‌شده نیست اصلاً استفاده نخواهند شد\&. توجه داشته باشید که این تشخیص خودکار فقط متداول‌ترین سازوکارهای ارتقای امتیازات را پوشش می‌دهد و برای راحتی کار در نظر گرفته شده است\&. توصیه می‌شود صراحتاً
\fI$SYSTEMD_PAGERSECURE\fR
را تنظیم کرده یا صفحه‌بند را غیرفعال کنید\&.
.sp
توجه داشته باشید که اگر متغیرهای
\fI$SYSTEMD_PAGER\fR
یا
\fI$PAGER\fR
قرار است رعایت شوند، به جز برای غیرفعال کردن صفحه‌بند،
\fI$SYSTEMD_PAGERSECURE\fR
نیز باید تنظیم شده باشد\&.
.RE
.PP
\fI$SYSTEMD_COLORS\fR
.RS 4
یک آرگومان بولی، یا یک مقدار ویژه می‌پذیرد\&. به طور پیش‌فرض (تنظیم‌نشده)،
\fBsystemd\fR
و ابزارهای مرتبط در صورت امکان از رنگ‌ها در خروجی خود استفاده خواهند کرد\&. اگر
\fI$COLORTERM\fR
روی
"truecolor"
یا
"24bit"
تنظیم شده باشد، رنگ‌های 24 بیتی فعال می‌شوند، در غیر این صورت 256 رنگ، مگر اینکه
\fI$NO_COLOR\fR
یا
\fI$TERM\fR
نشان دهد رنگ‌ها غیرفعال هستند\&.
.PP
\fBtrue\fR
.RS 4
مشابه تنظیم‌نشده، با این تفاوت که
\fI$NO_COLOR\fR
نادیده گرفته می‌شود\&.
.RE
.PP
\fBfalse\fR
.RS 4
خروجی تک‌رنگ خواهد بود\&.
.RE
.PP
"16", "256", "24bit"
.RS 4
همیشه به ترتیب از رنگ‌های پایه ۱۶ تایی ANSI، ۲۵۶ رنگ، یا رنگ ۲۴ بیتی استفاده می‌کند\&.
.RE
.PP
"auto\-16", "auto\-256", "auto\-24bit"
.RS 4
از تعداد رنگ‌های مشخص‌شده، بر اساس
\fI$TERM\fR
و اینکه کنسول به چه چیزی متصل است، استفاده می‌کند\&.
.RE
.RE
.PP
\fI$SYSTEMD_URLIFY\fR
.RS 4
مقدار باید یک بولی باشد\&. کنترل می‌کند که آیا پیوندهای قابل کلیک در خروجی برای شبیه‌سازهای ترمینالی که از این قابلیت پشتیبانی می‌کنند تولید شود یا خیر\&. این گزینه را می‌توان برای لغو تصمیمی که
\fBsystemd\fR
بر اساس
\fI$TERM\fR
و سایر شرایط می‌گیرد تعیین کرد\&.
.RE
.SH "عملیات \-\-CLEANUP بدون امتیاز (UNPRIVILEGED \-\-CLEANUP OPERATION)"
.PP
\fBsystemd\-tmpfiles\fR
تلاش می‌کند از تغییر زمان‌های دسترسی و اصلاح در دایرکتوری‌هایی که به آن‌ها دسترسی پیدا می‌کند اجتناب نماید، که این امر نیازمند امتیازات
\fBCAP_FOWNER\fR
است\&. هنگام اجرا به عنوان کاربر غیر ریشه (non\-root)، زمان دسترسی دایرکتوری‌هایی که برای یافتن فایل‌های قابل پاک‌سازی بررسی می‌شوند افزایش می‌یابد، که ممکن است مانع از پاک‌سازی آن‌ها شود\&.
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورت موفقیت، 0 برگردانده می‌شود\&. اگر پیکربندی از نظر نحوی نامعتبر باشد (خطاهای نحوی، آرگومان‌های مفقود و غیره)، به طوری که برخی خطوط نادیده گرفته شوند اما خطای دیگری رخ ندهد،
\fB65\fR
برگردانده می‌شود (\fBEX_DATAERR\fR
از
/usr/include/sysexits\&.h)\&. اگر پیکربندی از نظر نحوی معتبر باشد، اما نتوان آن را اجرا کرد (عدم وجود مجوزها، ایجاد فایل‌ها در دایرکتوری‌های ناموجود، محتوای نامعتبر هنگام نوشتن در مقادیر
/sys/
و غیره)،
\fB73\fR
برگردانده می‌شود (\fBEX_CANTCREAT\fR
از
/usr/include/sysexits\&.h)\&. در غیر این صورت،
\fB1\fR
برگردانده می‌شود (\fBEXIT_FAILURE\fR
از
/usr/include/stdlib\&.h)\&.
.PP
نکته: هنگام ایجاد موارد، اگر هدف از قبل وجود داشته باشد اما از نوع نادرست باشد یا با وضعیت درخواست‌شده مطابقت نداشته باشد، و عملیات اجباری با
"+"
درخواست نشده باشد، پیامی ارسال می‌شود اما شکست نادیده گرفته خواهد شد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBtmpfiles.d\fR(5)
.SH "نکات (NOTES)"
.IP " 1." 4
مشخصات UAPI.2 Discoverable Partitions Specification
.RS 4
\%https://uapi-group.org/specifications/specs/discoverable_partitions_specification
.RE
.IP " 2." 4
توصیه می‌شود سایر ابزارها نیز
\fI$SUDO_UID\fR
را در صورت لزوم تنظیم و بررسی کنند و با آن به عنوان یک رابط مشترک رفتار نمایند\&.