'\" t
.TH "SYSTEMD\&.SWAP" "5" "" "systemd 261.2" "systemd.swap"
.\" -----------------------------------------------------------------
.\" * 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.swap \- پیکربندی و تعاریف واحدهای حافظه مبادله (Swap) در systemd
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fIswap\fR\&.swap
.SH "توضیحات (DESCRIPTION)"
.PP
یک فایل پیکربندی واحد که نام آن به
"\&.swap"
ختم می‌شود، اطلاعات مربوط به یک دستگاه یا فایل حافظه مبادله (swap) را برای صفحه‌بندی حافظه (memory paging) که تحت کنترل و نظارت systemd است، کدگذاری می‌کند\&.
.PP
این صفحه راهنما، گزینه‌های پیکربندی مخصوص این نوع واحد را فهرست می‌کند\&. برای گزینه‌های مشترک تمام فایل‌های پیکربندی واحد،
\fBsystemd.unit\fR(5)
را ببینید\&. موارد پیکربندی مشترک در بخش‌های عمومی [Unit] و [Install] پیکربندی می‌شوند\&. گزینه‌های پیکربندی ویژه حافظه مبادله در بخش [Swap] پیکربندی می‌شوند\&.
.PP
گزینه‌های اضافی در
\fBsystemd.exec\fR(5)
فهرست شده‌اند، که محیط اجرایی را که برنامهٔ
\fBswapon\fR(8)
در آن اجرا می‌شود تعریف می‌کند، در
\fBsystemd.kill\fR(5)،
که نحوه خاتمه دادن به این فرایندها را تعریف می‌کند، و در
\fBsystemd.resource-control\fR(5)،
که تنظیمات کنترل منابع را برای این فرایندهای واحد پیکربندی می‌کند\&.
.PP
واحدهای swap باید بر اساس دستگاه‌ها یا فایل‌هایی که کنترل می‌کنند نام‌گذاری شوند\&. مثال: دستگاه swap
/dev/sda5
باید در یک فایل واحد به نام
dev\-sda5\&.swap
پیکربندی شود\&. برای جزئیات مربوط به منطق گریز (escaping) مورد استفاده برای تبدیل یک مسیر سیستم‌فایل به نام واحد،
\fBsystemd.unit\fR(5)
را ببینید\&. توجه داشته باشید که واحدهای swap نمی‌توانند به عنوان الگو (template) استفاده شوند، و همچنین افزودن چندین نام به یک واحد swap با ایجاد پیوندهای نمادین (symlinks) اضافی به آن امکان‌پذیر نیست\&.
.PP
توجه داشته باشید که پشتیبانی از swap در لینوکس نیازمند دسترسی‌های ویژه (privileged) است، از این رو واحدهای swap تنها در مدیر سرویس سیستم (و مدیر سرویس کاربری root) در دسترس هستند، و در مدیر سرویس کاربران غیرممتاز در دسترس نمی‌باشند\&.
.SH "وابستگی‌های خودکار (AUTOMATIC DEPENDENCIES)"
.SS "وابستگی‌های ضمنی (Implicit Dependencies)"
.PP
وابستگی‌های زیر به‌طور ضمنی اضافه می‌شوند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تمام واحدهای swap به‌طور خودکار وابستگی‌های
\fIRequires=\fR
و
\fIAfter=\fR
را نسبت به واحدهای دستگاه یا واحدهای سوار کردن فایل‌هایی که از آن‌ها فعال می‌شوند دریافت می‌کنند\&.
.RE
.PP
وابستگی‌های ضمنی اضافی ممکن است در نتیجه پارامترهای اجرا و کنترل منابع همان‌طور که در
\fBsystemd.exec\fR(5)
و
\fBsystemd.resource-control\fR(5)
مستند شده است اضافه شوند\&.
.SS "وابستگی‌های پیش‌فرض (Default Dependencies)"
.PP
وابستگی‌های زیر اضافه می‌شوند مگر اینکه
\fIDefaultDependencies=no\fR
تنظیم شده باشد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
واحدهای swap محلی به‌طور خودکار یک وابستگی
\fIConflicts=\fR
و یک وابستگی
\fIBefore=\fR
نسبت به
umount\&.target
کسب می‌کنند تا در زمان خاموش شدن سیستم غیرفعال شوند، و همچنین یک وابستگی
\fIBefore=swap\&.target\fR
به دست می‌آورند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
واحدهای swap شبکه‌ای (آن‌هایی که دارای
\fB_netdev\fR
در گزینه‌های خود هستند) به‌طور خودکار وابستگی‌های
\fIAfter=\fR
را نسبت به
remote\-fs\-pre\&.target
و
network\&.target، به علاوه وابستگی‌های
\fIAfter=\fR
و
\fIWants=\fR
را نسبت به
network\-online\&.target، و یک وابستگی
\fIBefore=\fR
را نسبت به
remote\-fs\&.target
به جای
swap\&.target
به دست می‌آورند\&.
.RE
.SH "FSTAB"
.PP
واحدهای swap را می‌توان از طریق فایل‌های واحد یا از طریق
/etc/fstab
پیکربندی کرد (برای جزئیات به
\fBfstab\fR(5)
مراجعه کنید)\&. swapهای فهرست‌شده در
/etc/fstab
به‌طور پویا هنگام راه‌اندازی سیستم و هنگام بارگذاری مجدد پیکربندی مدیر سیستم به واحدهای بومی تبدیل خواهند شد\&. برای جزئیات در مورد این تبدیل،
\fBsystemd-fstab-generator\fR(8)
را ببینید\&.
.PP
اگر یک دستگاه یا فایل swap هم در
/etc/fstab
و هم در یک فایل واحد پیکربندی شده باشد، پیکربندی موجود در دومی (فایل واحد) اولویت دارد\&.
.PP
هنگام خواندن
/etc/fstab،
چند گزینهٔ ویژه توسط systemd درک می‌شوند که بر نحوه ایجاد وابستگی‌ها برای واحدهای swap تأثیر می‌گذارند\&.
.PP
\fBnoauto\fR, \fBauto\fR
.RS 4
با
\fBnoauto\fR،
واحد swap به عنوان یک وابستگی برای
swap\&.target
(یا
remote\-fs\&.target
برای دستگاه‌های swap شبکه‌ای،
\fB_netdev\fR
در زیر را ببینید) اضافه نخواهد شد\&. این بدان معناست که در حین راه‌اندازی سیستم به‌طور خودکار فعال نخواهد شد، مگر اینکه توسط واحد دیگری فراخوانی شود\&. گزینهٔ
\fBauto\fR
معنای متضادی دارد و حالت پیش‌فرض است\&.
.sp
در نسخه 218 اضافه شد\&.
.RE
.PP
\fBnofail\fR
.RS 4
با
\fBnofail\fR،
واحد swap تنها توسط
swap\&.target
(یا
remote\-fs\&.target
برای دستگاه‌های swap شبکه‌ای) خواسته می‌شود (wanted) و مورد نیاز (required) نخواهد بود\&. این بدان معناست که حتی اگر این دستگاه swap با موفقیت فعال نشود، راه‌اندازی سیستم ادامه خواهد یافت\&.
.sp
در نسخه 218 اضافه شد\&.
.RE
.PP
\fBx\-systemd\&.device\-timeout=\fR
.RS 4
پیکربندی می‌کند که systemd پیش از صرف‌نظر کردن از یک مدخل در
/etc/fstab،
چه مدت باید منتظر ظاهر شدن یک دستگاه بماند\&. یک زمان را بر حسب ثانیه مشخص کنید یا به‌طور صریح یک واحد مانند
"s" (ثانیه)،
"min" (دقیقه)،
"h" (ساعت)،
"ms" (میلی‌ثانیه)
را به آن پیوست کنید\&.
.sp
توجه داشته باشید که این گزینه فقط در
/etc/fstab
قابل استفاده است، و هنگامی که بخشی از تنظیم
\fIOptions=\fR
در یک فایل واحد باشد نادیده گرفته خواهد شد\&.
.sp
در نسخه 215 اضافه شد\&.
.RE
.PP
\fBx\-systemd\&.makefs\fR
.RS 4
ساختار swap روی دستگاه مقداردهی اولیه خواهد شد\&. اگر دستگاه "خالی" نباشد، یعنی شامل هرگونه امضا (signature) باشد، از این عملیات صرف‌نظر می‌شود\&. بنابراین انتظار می‌رود این گزینه حتی پس از مقداردهی اولیه دستگاه همچنان تنظیم‌شده باقی بماند\&.
.sp
توجه داشته باشید که این گزینه فقط در
/etc/fstab
قابل استفاده است، و هنگامی که بخشی از تنظیم
\fIOptions=\fR
در یک فایل واحد باشد نادیده گرفته خواهد شد\&.
.sp
به
\fBsystemd-mkswap@.service\fR(8)
و مبحث
\fBwipefs\fR(8)
در
\fBsystemd.mount\fR(5)
مراجعه کنید\&.
.sp
در نسخه 240 اضافه شد\&.
.RE
.PP
\fB_netdev\fR
.RS 4
این دستگاه swap را به عنوان دستگاهی که نیازمند دسترسی شبکه است نشانه‌گذاری می‌کند\&. این برای swap روی دستگاه‌های بلوکی شبکه (مانند iSCSI) مفید است\&.
.sp
واحدهای swap شبکه‌ای به جای مرتب شدن قبل از
swap\&.target،
بین
remote\-fs\-pre\&.target
و
remote\-fs\&.target
مرتب می‌شوند\&. آن‌ها همچنین
network\-online\&.target
را فراخوانی می‌کنند و بعد از آن و
network\&.target
مرتب می‌شوند\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
فایل‌های واحد swap ممکن است شامل بخش‌های [Unit] و [Install] باشند که در
\fBsystemd.unit\fR(5)
توصیف شده‌اند\&.
.PP
فایل‌های واحد swap باید شامل یک بخش [Swap] باشند که حامل اطلاعاتی درباره دستگاه swap تحت نظارت آن است\&. تعدادی از گزینه‌هایی که ممکن است در این بخش استفاده شوند با سایر انواع واحدها مشترک هستند\&. این گزینه‌ها در
\fBsystemd.exec\fR(5)،
\fBsystemd.kill\fR(5)
و
\fBsystemd.resource-control\fR(5)
مستند شده‌اند\&. گزینه‌های ویژه بخش [Swap] واحدهای swap به شرح زیر هستند:
.PP
\fIWhat=\fR
.RS 4
یک مسیر مطلق یا یک شناسه به سبک fstab از یک گره دستگاه یا فایل را برای استفاده در صفحه‌بندی (paging) می‌پذیرد\&. برای جزئیات
\fBswapon\fR(8)
را ببینید\&. اگر این به یک گره دستگاه اشاره داشته باشد، یک وابستگی نسبت به واحد دستگاه مربوطه به‌طور خودکار ایجاد می‌شود\&. (برای اطلاعات بیشتر
\fBsystemd.device\fR(5)
را ببینید\&.) اگر این به یک فایل اشاره داشته باشد، یک وابستگی نسبت به واحد سوار کردن (mount) مربوطه به‌طور خودکار ایجاد می‌شود\&. (برای اطلاعات بیشتر
\fBsystemd.mount\fR(5)
را ببینید\&.) این گزینه اجباری است\&. توجه داشته باشید که بسط مشخص‌کنندهٔ معمول (specifier expansion) بر روی این تنظیم اعمال می‌شود، بنابراین نویسه‌های درصد تحت‌اللفظی باید به صورت
"%%"
نوشته شوند\&.
.RE
.PP
\fIPriority=\fR
.RS 4
اولویت swap برای استفاده هنگام فعال‌سازی دستگاه یا فایل swap\&. این گزینه یک مقدار عدد صحیح می‌گیرد\&. این تنظیم اختیاری است و زمانی که اولویت توسط
\fBpri=\fR
در کلید
\fIOptions=\fR
تنظیم شده باشد، نادیده گرفته می‌شود\&.
.RE
.PP
\fIOptions=\fR
.RS 4
ممکن است حاوی یک رشته گزینه برای دستگاه swap باشد\&. اگر دستگاه پشتیبان swap از عملیات discard یا trim پشتیبانی کند، این می‌تواند برای کنترل گزینه‌های discard در میان عملکردهای دیگر استفاده شود\&. (برای اطلاعات بیشتر
\fBswapon\fR(8)
را ببینید\&.) توجه داشته باشید که بسط مشخص‌کنندهٔ معمول بر روی این تنظیم اعمال می‌شود، بنابراین نویسه‌های درصد تحت‌اللفظی باید به صورت
"%%"
نوشته شوند\&.
.sp
در نسخه 217 اضافه شد\&.
.RE
.PP
\fITimeoutSec=\fR
.RS 4
مدت زمان انتظار برای پایان یافتن دستور swapon را پیکربندی می‌کند\&. اگر دستوری در مدت زمان پیکربندی‌شده خارج نشود، swap ناموفق در نظر گرفته شده و مجدداً خاموش می‌شود\&. تمام دستوراتی که همچنان در حال اجرا هستند، به‌طور اجباری از طریق
\fBSIGTERM\fR
و پس از یک تاخیر دیگر به اندازه همین زمان با
\fBSIGKILL\fR
خاتمه داده می‌شوند\&. (
\fBKillMode=\fR
در
\fBsystemd.kill\fR(5)
را ببینید\&.) یک مقدار بدون واحد بر حسب ثانیه، یا یک مقدار بازه زمانی مانند "5min 20s" را می‌پذیرد\&. برای غیرفعال کردن منطق مهلت زمانی (timeout)، مقدار
"0"
را وارد کنید\&. مقدار پیش‌فرض آن
\fIDefaultTimeoutStartSec=\fR
از فایل پیکربندی مدیر سیستم است (
\fBsystemd-system.conf\fR(5)
را ببینید)\&.
.RE
.PP
برای تنظیمات بیشتر،
\fBsystemd.unit\fR(5)،
\fBsystemd.exec\fR(5)
و
\fBsystemd.kill\fR(5)
را بررسی کنید\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1)، \fBsystemctl\fR(1)، \fBsystemd-system.conf\fR(5)، \fBsystemd.unit\fR(5)، \fBsystemd.exec\fR(5)، \fBsystemd.kill\fR(5)، \fBsystemd.resource-control\fR(5)، \fBsystemd.device\fR(5)، \fBsystemd.mount\fR(5)، \fBswapon\fR(8)، \fBsystemd-fstab-generator\fR(8)، \fBsystemd.directives\fR(7)