'\" t
.\"     Title: swapon
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: System Administration
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "SWAPON" "8" "2026-06-16" "util\-linux 2.41.5" "دستورات مدیریت سیستم"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n(.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
swapon, swapoff \- فعال‌سازی/غیرفعال‌سازی دستگاه‌ها و فایل‌ها برای صفحه‌بندی و مبادله
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBswapon\fP [options] [\fIspecialfile\fP.\|.\|.]
.sp
\fBswapoff\fP [\fB\-va\fP] [\fIspecialfile\fP.\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBswapon\fP برای مشخص کردن دستگاه‌هایی استفاده می‌شود که صفحه‌بندی و مبادله (paging and swapping) باید روی آن‌ها انجام شود.
.sp
دستگاه یا فایل مورد استفاده توسط پارامتر \fIspecialfile\fP مشخص می‌شود. این پارامتر می‌تواند به شکل \fB\-L\fP \fIlabel\fP یا \fB\-U\fP \fIuuid\fP باشد تا دستگاه را بر اساس برچسب یا uuid مشخص کند.
.sp
فراخوانی‌های \fBswapon\fP معمولاً در اسکریپت‌های بوت سیستم رخ می‌دهند تا تمام دستگاه‌های مبادله در دسترس قرار گیرند، به‌طوری‌که فعالیت صفحه‌بندی و مبادله در میان چندین دستگاه و فایل هم‌پوشانی و توزیع شود.
.sp
دستور \fBswapoff\fP مبادله روی دستگاه‌ها و فایل‌های مشخص‌شده را غیرفعال می‌کند. هنگامی که پرچم \fB\-a\fP داده شود، مبادله روی تمام دستگاه‌ها و فایل‌های مبادله شناخته‌شده (همان‌طور که در \fI/proc/swaps\fP یا \fI/etc/fstab\fP یافت می‌شود) غیرفعال می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
تمام دستگاه‌هایی که در \fI/etc/fstab\fP به عنوان "swap" علامت‌گذاری شده‌اند در دسترس قرار می‌گیرند، به جز مواردی که دارای گزینه "noauto" هستند. دستگاه‌هایی که از قبل به عنوان مبادله استفاده می‌شوند، بدون پیام رد می‌شوند.
.RE
.sp
\fB\-T\fP, \fB\-\-fstab\fP \fIpath\fP
.RS 4
یک پرونده fstab جایگزین برای سازگاری با \fBmount\fP(8) مشخص می‌کند. اگر \fIpath\fP یک پوشه باشد، پرونده‌های درون پوشه بر اساس \fBstrverscmp\fP(3) مرتب می‌شوند؛ پرونده‌هایی که با "." شروع می‌شوند یا فاقد پسوند .fstab هستند نادیده گرفته می‌شوند. این گزینه می‌تواند بیش از یک بار مشخص شود. این گزینه بیشتر برای اسکریپت‌های initramfs یا chroot طراحی شده است که در آن‌ها پیکربندی اضافی فراتر از پیکربندی استاندارد سیستم تعیین می‌شود.
.RE
.sp
\fB\-d\fP, \fB\-\-discard\fP[\fB=\fP\fIpolicy\fP]
.RS 4
فعال‌سازی دورریزی (discard) مبادله، در صورتی که دستگاه پشتیبان swap از عملیات discard یا trim پشتیبانی کند. این ممکن است کارایی را در برخی از درایوهای حالت جامد (SSD) بهبود بخشد، اما اغلب بی‌تاثیر است. این گزینه امکان انتخاب بین دو خط‌مشی دورریزی swap را فراهم می‌کند:
.sp
\fB\-\-discard=once\fP
.RS 4
برای اجرای یک‌باره عملیات discard برای کل فضای مبادله در هنگام swapon؛ یا
.RE
.sp
\fB\-\-discard=pages\fP
.RS 4
برای دورریزی ناهمگام صفحات آزادشده مبادله پیش از اینکه برای استفاده مجدد در دسترس قرار گیرند.
.RE
.sp
اگر هیچ خط‌مشی‌ای انتخاب نشود، رفتار پیش‌فرض فعال‌سازی هر دو نوع discard است. گزینه‌های مانت \fI/etc/fstab\fP شامل \fBdiscard\fP، \fBdiscard=once\fP یا \fBdiscard=pages\fP نیز ممکن است برای فعال‌سازی پرچم‌های دورریزی استفاده شوند.
.RE
.sp
\fB\-e\fP, \fB\-\-ifexists\fP
.RS 4
نادیده گرفتن بی‌صدای دستگاه‌هایی که وجود ندارند. گزینه مانت \fBnofail\fP در \fI/etc/fstab\fP نیز می‌تواند برای صرف‌نظر از دستگاه ناموجود استفاده شود.
.RE
.sp
\fB\-f\fP, \fB\-\-fixpgsz\fP
.RS 4
راه‌اندازی مجدد (اجرای mkswap) فضای مبادله در صورتی که اندازه صفحه آن با هسته در حال اجرا مطابقت نداشته باشد. دستور \fBmkswap\fP(8) کل دستگاه را راه‌اندازی می‌کند و بلوک‌های معیوب را بررسی نمی‌کند.
.RE
.sp
\fB\-L\fP \fIlabel\fP
.RS 4
استفاده از پارتیشنی که دارای \fIlabel\fP مشخص‌شده است. (برای این کار، دسترسی به \fI/proc/partitions\fP لازم است.)
.RE
.sp
\fB\-o\fP, \fB\-\-options\fP \fIopts\fP
.RS 4
مشخص کردن گزینه‌های مبادله با یک رشته جداشده با کاما و سازگار با \fIfstab\fP. برای نمونه:
.sp
\fBswapon \-o pri=1,discard=pages,nofail /dev/sda2\fP
.sp
رشته \fIopts\fP در آخر ارزیابی می‌شود و همه گزینه‌های دیگر خط فرمان را بازنویسی می‌کند.
.RE
.sp
\fB\-p\fP, \fB\-\-priority\fP \fIpriority\fP
.RS 4
تعیین اولویت دستگاه مبادله. مقدار \fIpriority\fP عددی بین 0 و 32767 است. اعداد بزرگ‌تر نشان‌دهنده اولویت بالاتر هستند. برای توضیحات کامل اولویت‌های مبادله به \fBswapon\fP(2) مراجعه کنید. مقدار \fBpri=\fP\fIvalue\fP را برای استفاده با \fBswapon \-a\fP به فیلد گزینه در \fI/etc/fstab\fP اضافه کنید. هنگامی که هیچ اولویتی تعریف نشده باشد، هسته لینوکس به‌طور پیش‌فرض از اعداد منفی استفاده می‌کند.
.RE
.sp
\fB\-s\fP, \fB\-\-summary\fP
.RS 4
نمایش خلاصه استفاده از مبادله بر اساس دستگاه. معادل با \fBcat /proc/swaps\fP. این قالب خروجی منسوخ شده است (DEPRECATED) و به جای آن استفاده از \fB\-\-show\fP ترجیح داده می‌شود که کنترل بهتری روی داده‌های خروجی فراهم می‌کند.
.RE
.sp
\fB\-\-show\fP[\fB=\fP\fIcolumn\fP.\|.\|.]
.RS 4
نمایش یک جدول قابل‌تنظیم از نواحی مبادله. برای دیدن فهرست ستون‌های موجود به خروجی \fB\-\-help\fP مراجعه کنید.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
خروجی دادن تمام ستون‌های موجود.
.RE
.sp
\fB\-\-noheadings\fP
.RS 4
عدم چاپ عنوان ستون‌ها هنگام نمایش خروجی \fB\-\-show\fP.
.RE
.sp
\fB\-\-raw\fP
.RS 4
نمایش خروجی \fB\-\-show\fP بدون تراز کردن ستون‌های جدول.
.RE
.sp
\fB\-\-bytes\fP
.RS 4
نمایش اندازه مبادله به بایت در خروجی \fB\-\-show\fP به جای واحدهای خوانا برای انسان.
.RE
.sp
\fB\-U\fP \fIuuid\fP
.RS 4
استفاده از پارتیشنی که دارای \fIuuid\fP مشخص‌شده است.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
نمایش با جزئیات بیشتر.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
دستور \fBswapoff\fP از نسخه v2.36 دارای مقادیر وضعیت خروج زیر است:
.sp
\fB0\fP
.RS 4
موفقیت
.RE
.sp
\fB2\fP
.RS 4
حافظه ناکافی سیستم برای متوقف کردن مبادله (OOM)
.RE
.sp
\fB4\fP
.RS 4
شکست فراخوانی سیستمی \fBswapoff\fP(2) به دلیلی دیگر
.RE
.sp
\fB8\fP
.RS 4
خطای سیستمی غیر از فراخوانی سیستمی \fBswapoff\fP(2) (کمبود حافظه، .\|.\|.)
.RE
.sp
\fB16\fP
.RS 4
خطای استفاده یا نگارشی
.RE
.sp
\fB32\fP
.RS 4
شکست تمام عملیات swapoff در هنگام استفاده از \fB\-\-all\fP
.RE
.sp
\fB64\fP
.RS 4
موفقیت برخی از عملیات swapoff در هنگام استفاده از \fB\-\-all\fP
.RE
.sp
دستور \fBswapoff \-\-all\fP مقادیر 0 (همه موفق)، 32 (همه ناموفق) یا 64 (برخی ناموفق، برخی موفق) را برمی‌گرداند.
.sp
نسخه‌های قدیمی قبل از v2.36 وضعیت خروج مستندشده‌ای ندارند، مقدار 0 در تمام نسخه‌ها به معنی موفقیت است.
.SH "محیط (ENVIRONMENT)"
.sp
\fBLIBMOUNT_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی \fBlibmount\fP را فعال می‌کند.
.RE
.sp
\fBLIBBLKID_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی \fBlibblkid\fP را فعال می‌کند.
.RE
.SH "پرونده‌ها (FILES)"
.sp
\fI/dev/sd??\fP
.RS 4
دستگاه‌های استاندارد صفحه‌بندی
.RE
.sp
\fI/etc/fstab\fP
.RS 4
جدول اسکی (ASCII) توصیف سیستم‌فایل
.RE
.SH "نکات (NOTES)"
.SS "پرونده‌های دارای حفره (Files with holes)"
.sp
پیاده‌سازی فایل مبادله در هسته انتظار دارد که بتواند مستقیماً و بدون دخالت سیستم‌فایل روی فایل بنویسد. این مورد در پرونده‌های دارای حفره یا در پرونده‌های کپی‌هنگام‌نوشتن (copy\-on\-write) روی سیستم‌فایل‌هایی مانند Btrfs یک مشکل است.
.sp
دستوراتی مانند \fBcp\fP(1) یا \fBtruncate\fP(1) پرونده‌هایی با حفره ایجاد می‌کنند. این پرونده‌ها توسط \fBswapon\fP رد خواهند شد.
.sp
پرونده‌های از پیش تخصیص‌یافته ایجادشده توسط \fBfallocate\fP(1) نیز ممکن است بسته به نوع سیستم‌فایل به عنوان پرونده‌های دارای حفره تفسیر شوند. پرونده‌های مبادله از پیش تخصیص‌یافته روی XFS از لینوکس 4.18 پشتیبانی می‌شوند.
.sp
سازگارترین راهکار برای ایجاد یک پرونده مبادله، استفاده از \fBdd\fP(1) و \fI/dev/zero\fP است.
.SS "Btrfs"
.sp
پرونده‌های مبادله روی Btrfs از لینوکس 5.0 روی پرونده‌های دارای صفت \fBnocow\fP پشتیبانی می‌شوند. برای جزئیات بیشتر به صفحه راهنمای \fBbtrfs\fP(5) مراجعه کنید.
.sp
از نسخه 2.41، دستور \fBmkswap \-\-file\fP می‌تواند یک پرونده مبادله جدید با صفت \fBnocow\fP ایجاد کند.
.SS "NFS"
.sp
مبادله روی \fBNFS\fP ممکن است کار نکند.
.SS "تعلیق (Suspend)"
.sp
دستور \fBswapon\fP به‌طور خودکار امضای فضای مبادله را با داده‌های قدیمی تعلیق نرم‌افزاری (مانند \fBS1SUSPEND\fP، \fBS2SUSPEND\fP، .\|.\|.) تشخیص داده و بازنویسی می‌کند. مشکل این است که اگر این کار انجام نشود، در تلاش بعدی برای بازگشت از تعلیق (unsuspending) تخریب داده رخ خواهد داد.
.SH "تاریخچه (HISTORY)"
.sp
دستور \fBswapon\fP در 4.0BSD معرفی شد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBswapoff\fP(2),
\fBswapon\fP(2),
\fBfstab\fP(5),
\fBinit\fP(8),
\fBfallocate\fP(1),
\fBmkswap\fP(8),
\fBmount\fP(8),
\fBrc\fP(8)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "دسترسی‌پذیری (AVAILABILITY)"
.sp
دستور \fBswapon\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو هسته لینوکس" "."
دریافت شود.