'\" t
.\"     Title: swapoff
.\"    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 "SWAPOFF" "8" "2026-06-16" "util\-linux 2.41.5" "System Administration"
.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)"
swapoff \- غیرفعال‌سازی دستگاه‌ها و فایل‌ها برای صفحه‌بندی و مبادله
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBswapon\fP [options] [\fIspecialfile\fP.\|.\|.]
.sp
\fBswapoff\fP [\fB\-va\fP] [\fIspecialfile\fP.\|.\|.]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBswapon\fP برای مشخص کردن دستگاه‌هایی استفاده می‌شود که صفحه‌بندی و مبادله حافظه (swapping) روی آن‌ها انجام می‌گیرد.
.sp
دستگاه یا پرونده مورد استفاده توسط پارامتر \fIspecialfile\fP مشخص می‌شود. این مقدار می‌تواند به صورت \fB\-L\fP \fIlabel\fP یا \fB\-U\fP \fIuuid\fP برای مشخص کردن یک دستگاه بر اساس برچسب یا uuid باشد.
.sp
فراخوانی‌های \fBswapon\fP معمولاً در اسکریپت‌های راه‌اندازی (boot) سیستم انجام می‌شوند تا تمام دستگاه‌های سواپ در دسترس قرار گیرند، به‌طوری که فعالیت صفحه‌بندی و مبادله حافظه میان چندین دستگاه و پرونده توزیع شود.
.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 به عنوان \(dqswap\(dq علامت‌گذاری شده‌اند در دسترس قرار می‌گیرند، به جز مواردی که گزینه \(dqnoauto\(dq دارند. دستگاه‌هایی که در حال حاضر به عنوان سواپ استفاده می‌شوند، بدون پیام نادیده گرفته می‌شوند.
.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) سواپ را فعال می‌کند، در صورتی که دستگاه پشتیبان سواپ از عملیات discard یا trim پشتیبانی کند. این ممکن است عملکرد را در برخی از دستگاه‌های حالت جامد (SSD) بهبود بخشد، اما اغلب چنین نیست. این گزینه امکان انتخاب بین دو سیاست دور انداختن سواپ را فراهم می‌کند:
.sp
\fB\-\-discard=once\fP
.RS 4
برای انجام عملیات دور انداختن یک‌باره برای کل فضای سواپ هنگام swapon؛ یا
.RE
.sp
\fB\-\-discard=pages\fP
.RS 4
برای دور انداختن ناهمگام صفحه‌های آزادشده سواپ پیش از آنکه برای استفاده مجدد در دسترس قرار گیرند.
.RE
.sp
اگر هیچ سیاستی انتخاب نشود، رفتار پیش‌فرض فعال کردن هر دو نوع discard است. گزینه‌های اتصال (mount) در \fI/etc/fstab\fP شامل \fBdiscard\fP، \fBdiscard=once\fP یا \fBdiscard=pages\fP نیز می‌توانند برای فعال کردن پرچم‌های discard استفاده شوند.
.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 در آخر ارزیابی می‌شود و تمام گزینه‌های دیگر خط فرمان را بازنویسی (override) می‌کند.
.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 است. این قالب خروجی به نفع \fB\-\-show\fP که کنترل بهتری روی داده‌های خروجی فراهم می‌کند، منسوخ شده است (DEPRECATED).
.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 و .\|.\|.) شناسایی کرده و بازنویسی می‌کند. مشکل این است که در صورت انجام ندادن این کار، در تلاش بعدی برای خروج از تعلیق، داده‌ها دچار خرابی می‌شوند.
.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
دستور \fBswapoff\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو هسته لینوکس" "."
دریافت شود.