'\" t
.TH "SYSEXT\&.CONF" "5" "" "systemd 261.2" "sysext.conf"
.\" -----------------------------------------------------------------
.\" * 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)"
sysext.conf, confext.conf, sysext.conf.d, confext.conf.d \- پیکربندی تصاویر افزونه سیستم و بسته‌های اکستنشن
.SH "خلاصه دستور (SYNOPSIS)"
.PP
/etc/systemd/sysext\&.conf
.PP
/etc/systemd/sysext\&.conf\&.d/*\&.conf
.PP
/run/systemd/sysext\&.conf
.PP
/run/systemd/sysext\&.conf\&.d/*\&.conf
.PP
/usr/lib/systemd/sysext\&.conf
.PP
/usr/lib/systemd/sysext\&.conf\&.d/*\&.conf
.PP
/etc/systemd/confext\&.conf
.PP
/etc/systemd/confext\&.conf\&.d/*\&.conf
.PP
/run/systemd/confext\&.conf
.PP
/run/systemd/confext\&.conf\&.d/*\&.conf
.PP
/usr/lib/systemd/confext\&.conf
.PP
/usr/lib/systemd/confext\&.conf\&.d/*\&.conf
.SH "توضیحات (DESCRIPTION)"
.PP
این فایل‌های پیکربندی رفتار
\fBsystemd-sysext\fR(8)
و
\fBsystemd-confext\fR(8)
را کنترل می‌کنند\&. این فایل‌ها به‌ویژه زمانی مفید هستند که نیاز به سفارشی‌سازی رفتار واحدهای سرویس افزونه (اکستنشن) مربوطه باشد\&.
.SH "دایرکتوری‌های پیکربندی و اولویت (CONFIGURATION DIRECTORIES AND PRECEDENCE)"
.PP
پیکربندی پیش‌فرض در زمان کامپایل تنظیم می‌شود، بنابراین پیکربندی تنها زمانی لازم است که انحراف از آن مقادیر پیش‌فرض ضروری باشد\&. فایل پیکربندی اصلی از یکی از دایرکتوری‌های فهرست‌شده به ترتیب اولویت بارگذاری می‌شود و فقط از اولین فایل یافت‌شده استفاده می‌گردد:
/etc/systemd/،
/run/systemd/،
/usr/local/lib/systemd/
\&\s-2\u[1]\d\s+2،
/usr/lib/systemd/\&. نسخه ارائه‌شده توسط توزیع‌کننده (vendor) شامل ورودی‌های کامنت‌شده‌ای است که پیش‌فرض‌ها را به عنوان راهنمای مدیر سیستم نشان می‌دهد\&. لغوهای محلی را نیز می‌توان با ایجاد فایل‌های تکمیلی (drop-in) مطابق توضیحات زیر ایجاد کرد\&. فایل پیکربندی اصلی را نیز می‌توان برای این منظور ویرایش کرد (یا یک نسخه در
/etc/
اگر تحت
/usr/
عرضه شده باشد)، با این حال استفاده از فایل‌های تکمیلی (drop-in) برای پیکربندی محلی نسبت به تغییر فایل پیکربندی اصلی توصیه می‌شود\&.
.PP
علاوه بر فایل پیکربندی اصلی، قطعه‌کدهای پیکربندی تکمیلی (drop-in) از دایرکتوری‌های
/usr/lib/systemd/*\&.conf\&.d/،
/usr/local/lib/systemd/*\&.conf\&.d/
و
/etc/systemd/*\&.conf\&.d/
خوانده می‌شوند\&. این فایل‌های تکمیلی اولویت بالاتری دارند و فایل پیکربندی اصلی را بازنویسی می‌کنند\&. فایل‌های موجود در زیردایرکتوری‌های پیکربندی
*\&.conf\&.d/
صرف‌نظر از اینکه در کدام‌یک از زیردایرکتوری‌ها قرار دارند، بر اساس نام فایل خود به ترتیب واژه‌نگاری (الفبایی) مرتب می‌شوند\&. هنگامی که چندین فایل یک گزینه یکسان را تعیین می‌کنند، برای گزینه‌هایی که فقط یک مقدار واحد را می‌پذیرند، ورودی موجود در فایلی که نام آن در آخرین جایگاه قرار می‌گیرد اولویت دارد، و برای گزینه‌هایی که فهرستی از مقادیر را می‌پذیرند، ورودی‌ها به همان ترتیبی که در فایل‌های مرتب‌شده ظاهر می‌شوند جمع‌آوری می‌گردند\&.
.PP
هنگامی که بسته‌ها نیاز به سفارشی‌سازی پیکربندی دارند، می‌توانند فایل‌های تکمیلی (drop-in) را در
/usr/
نصب کنند\&. فایل‌های موجود در
/etc/
برای مدیر محلی سیستم رزرو شده‌اند، که می‌تواند از این منطق برای بازنویسی فایل‌های پیکربندی نصب‌شده توسط بسته‌های توزیع‌کننده استفاده کند\&. برای بازنویسی فایل‌های تکمیلی بسته، باید از فایل‌های تکمیلی استفاده شود، زیرا فایل پیکربندی اصلی اولویت پایین‌تری دارد\&. توصیه می‌شود برای ساده‌تر کردن ترتیب، نام همه فایل‌ها در آن زیردایرکتوری‌ها با یک عدد دو رقمی و یک خط تیره پیشوندگذاری شود\&. این کار همچنین مفهوم اولویت‌های تکمیلی را تعریف می‌کند تا به توزیع‌کنندگان سیستم‌عامل اجازه دهد فایل‌های تکمیلی را در محدوده خاصی پایین‌تر از محدوده مورد استفاده کاربران عرضه کنند\&. این امر باید خطر بازنویسی تصادفی فایل‌های تکمیلی تعریف‌شده توسط کاربران را توسط فایل‌های تکمیلی بسته‌ها کاهش دهد\&. توصیه می‌شود از محدوده 10\-40 برای فایل‌های تکمیلی در
/usr/
و از محدوده 60\-90 برای فایل‌های تکمیلی در
/etc/
و
/run/
استفاده شود، تا اطمینان حاصل گردد که فایل‌های تکمیلی محلی و گذرا بر فایل‌های تکمیلی عرضه‌شده توسط توزیع‌کننده سیستم‌عامل اولویت دارند\&.
.PP
برای غیرفعال کردن یک فایل پیکربندی ارائه‌شده توسط توزیع‌کننده، روش توصیه‌شده قرار دادن یک پیوند نمادین (symlink) به
/dev/null
در دایرکتوری پیکربندی در
/etc/
با همان نام فایل پیکربندی توزیع‌کننده است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر در هر دو بخش
"[SysExt]"
و
"[ConfExt]"
پشتیبانی می‌شوند:
.SS "گزینه‌های بخش (Section Options)"
.PP
\fIMutable=\fR
.RS 4
حالت تغییرپذیری (mutable) را برای افزونه‌های سیستم تنظیم می‌کند\&. یکی از مقادیر
"no",
"yes",
"auto",
"import",
"ephemeral", یا
"ephemeral\-import"
را می‌پذیرد\&. برای جزئیات در مورد این حالت‌ها، گزینه
\fB\-\-mutable=\fR
در
\fBsystemd-sysext\fR(8)
را ببینید\&. مقدار پیش‌فرض
"no"
است\&.
.sp
در نسخه 259 اضافه شد\&.
.RE
.PP
\fIImagePolicy=\fR
.RS 4
سیاست ایمیج (image policy) را تنظیم می‌کند\&. مطابق با
\fBsystemd.image-policy\fR(7)
یک رشته سیاست ایمیج را به عنوان آرگومان می‌پذیرد\&. برای جزئیات بیشتر، گزینه
\fB\-\-image\-policy=\fR
در
\fBsystemd-sysext\fR(8)
را ببینید\&.
.sp
در نسخه 259 اضافه شد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-sysext\fR(8), \fBsystemd.syntax\fR(7)
.SH "نکات (NOTES)"
.IP " 1." 4
💣💥🧨💥💥💣 لطفاً توجه داشته باشید که این فایل‌های پیکربندی باید در تمام زمان‌ها در دسترس باشند. اگر
/usr/local/
یک پارتیشن جداگانه باشد، ممکن است در اوایل بوت در دسترس نباشد و نباید برای پیکربندی استفاده شود.