'\" t
.\"     Title: mkswap
.\"    Manual: دستورات مدیریت سیستم
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "MKSWAP" "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)"
mkswap \- راه‌اندازی و ایجاد ناحیه مبادله لینوکس (Swap)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBmkswap\fP [\fIگزینه‌ها\fP] \fIدستگاه\fP [\fIبلوک‌ها\fP]
.sp
\fBmkswap\fP [\fIگزینه‌ها\fP] \-\-size \fIاندازه\fP \-\-file \fIفایل\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBmkswap\fR یک ناحیه مبادله (swap area) لینوکس را روی یک دستگاه یا درون یک فایل ایجاد و آماده‌سازی می‌کند.
.sp
آرگومان \fIدستگاه\fP معمولاً یک پارتیشن دیسک (مانند \fI/dev/sdb7\fP) است، اما می‌تواند یک فایل نیز باشد. هسته لینوکس به شناسه‌های پارتیشن نگاه نمی‌کند، اما بسیاری از اسکریپت‌های نصب فرض می‌کنند پارتیشن‌هایی با نوع هگزادسیمال 82 (LINUX_SWAP) برای پارتیشن‌های swap در نظر گرفته شده‌اند. (\fBهشدار: سولاریس نیز از این نوع استفاده می‌کند. مراقب باشید پارتیشن‌های سولاریس خود را نابود نکنید.\fP)
.sp
پارامتر \fIبلوک‌ها\fP زائد است اما برای سازگاری با گذشته حفظ شده است. (این پارامتر اندازه دلخواه ناحیه swap را در بلوک‌های ۱۰۲۴ بایتی مشخص می‌کند. در صورت حذف آن، \fBmkswap\fP از کل پارتیشن یا فایل استفاده خواهد کرد. مشخص کردن آن کار عاقلانه‌ای نیست \- یک اشتباه تایپی ممکن است دیسک شما را نابود کند.)
.sp
پس از ایجاد ناحیه مبادله، برای آغاز استفاده از آن به دستور \fBswapon\fP(8) نیاز دارید. معمولاً نواحی swap در \fI/etc/fstab\fP فهرست می‌شوند تا بتوان در زمان بوت با دستور \fBswapon \-a\fP در یکی از اسکریپت‌های بوت از آن‌ها استفاده کرد.
.SH "هشدار (WARNING)"
.sp
سرایند swap به اولین بلوک دست نمی‌زند. یک بوت‌لودر یا برچسب دیسک می‌تواند در آنجا قرار داشته باشد، اما این پیکربندی توصیه نمی‌شود. پیکربندی توصیه‌شده استفاده از یک پارتیشن جداگانه برای ناحیه swap لینوکس است.
.sp
دستور \fBmkswap\fP، مانند بسیاری دیگر از ابزارهای مشابه mkfs، \fBاولین بلوک پارتیشن را پاک می‌کند تا هر سیستم‌فایل قبلی نامرئی شود.\fP
.sp
با این حال، \fBmkswap\fP از پاک کردن اولین بلوک روی دستگاهی که دارای برچسب دیسک (مانند SUN، BSD و .\|.\|.) باشد خودداری می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-c\fP, \fB\-\-check\fP
.RS 4
پیش از ایجاد ناحیه swap، دستگاه را (در صورتی که یک دستگاه بلوکی باشد) برای بلوک‌های معیوب بررسی می‌کند. در صورت یافتن هر بلوک خراب، تعداد آن‌ها چاپ می‌شود.
.RE
.sp
\fB\-F\fP, \fB\-\-file\fP
.RS 4
یک فایل swap با مجوزهای دسترسی مناسب و بلوک‌های تخصیص‌یافته روی دیسک ایجاد می‌کند.
.RE
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
ادامه دادن حتی در صورتی که دستور غیرمنطقی باشد. این گزینه اجازه ایجاد ناحیه swap بزرگ‌تر از فایل یا پارتیشنی که روی آن قرار دارد را می‌دهد.
.sp
همچنین بدون این گزینه، \fBmkswap\fP از پاک کردن اولین بلوک روی دستگاهی که دارای جدول پارتیشن باشد خودداری خواهد کرد.
.RE
.sp
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
پنهان کردن خروجی‌ها و پیام‌های هشدار.
.RE
.sp
\fB\-L\fP, \fB\-\-label\fP \fIبرچسب\fP
.RS 4
تعیین یک \fIبرچسب\fP (label) برای دستگاه، جهت امکان فعال‌سازی با \fBswapon\fP(8) از طریق برچسب.
.RE
.sp
\fB\-\-lock\fP[\fB=\fP\fIحالت\fP]
.RS 4
استفاده از قفل انحصاری BSD برای دستگاه یا فایلی که روی آن عمل می‌کند. آرگومان اختیاری \fIحالت\fP می‌تواند \fByes\fP، \fBno\fP (یا ۱ و ۰) یا \fBnonblock\fP باشد. اگر آرگومان \fIحالت\fP حذف شود، مقدار پیش‌فرض آن \fByes\fP است. این گزینه متغیر محیطی \fB$LOCK_BLOCK_DEVICE\fP را بازنویسی می‌کند. حالت پیش‌فرض عدم استفاده از هیچ قفلی است، اما برای جلوگیری از تداخل با \fBsystemd\-udevd\fP(8) یا ابزارهای دیگر توصیه می‌شود.
.RE
.sp
\fB\-p\fP, \fB\-\-pagesize\fP \fIاندازه\fP
.RS 4
مشخص کردن اندازه صفحه \fIاندازه\fP (به بایت). این گزینه معمولاً غیرضروری است؛ \fBmkswap\fP اندازه را از هسته می‌خواند.
.RE
.sp
\fB\-U\fP, \fB\-\-uuid\fP \fIUUID\fP
.RS 4
تعیین \fIUUID\fP مورد استفاده. مقدار پیش‌فرض، تولید یک UUID جدید است. قالب UUID مجموعه‌ای از ارقام هگزادسیمال است که با خط تیره از هم جدا شده‌اند، مانند: "c1b9d5a2\-f162\-11cf\-9ece\-0020afc76f16". پارامتر UUID همچنین می‌تواند یکی از موارد زیر باشد:
.sp
\fBclear\fP
.RS 4
پاک کردن شناسه UUID سیستم‌فایل
.RE
.sp
\fBrandom\fP
.RS 4
تولید یک UUID تصادفی جدید
.RE
.sp
\fBtime\fP
.RS 4
تولید یک UUID جدید بر اساس زمان
.RE
.RE
.sp
\fB\-e\fP, \fB\-\-endianness\fP \fIENDIANNESS\fP
.RS 4
مشخص کردن ترتیب بایت‌ها (\fIENDIANNESS\fP) مورد استفاده. آرگومان‌های معتبر عبارتند از \fBnative\fP، \fBlittle\fP یا \fBbig\fP. مقدار پیش‌فرض \fBnative\fP است.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIآفست\fP
.RS 4
مشخص کردن \fIآفست\fP برای نوشتن ناحیه swap در آن.
.RE
.sp
\fB\-s\fP, \fB\-\-size\fP \fIاندازه\fP
.RS 4
مشخص کردن اندازه فایل swap ایجادشده به بایت؛ می‌تواند همراه با یک پسوند ضریب باشد: KiB (=۱۰۲۴)، MiB (=۱۰۲۴*۱۰۲۴) و به همین ترتیب برای GiB، TiB، PiB، EiB، ZiB و YiB (پسوند "iB" اختیاری است، مثلاً "K" همان معنای "KiB" را دارد). اگر فایل وجود داشته باشد و بزرگ‌تر از \fIاندازه\fP باشد، به این اندازه کوتاه (truncate) خواهد شد. این گزینه تنها زمانی کاربرد دارد که همراه با \fB\-\-file\fP استفاده شود.
.RE
.sp
\fB\-v\fP, \fB\-\-swapversion 1\fP
.RS 4
مشخص کردن نسخه فضای swap. (این گزینه در حال حاضر بی‌فایده است، زیرا گزینه قدیمی \fB\-v 0\fP منسوخ شده و اکنون فقط \fB\-v 1\fP پشتیبانی می‌شود. هسته از زمان نسخه 2.5.22 (ژوئن ۲۰۰۲) دیگر از قالب فضای swap نسخه 0 پشتیبانی نمی‌کند. نسخه جدید 1 از نسخه 2.1.117 (اوت ۱۹۹۸) پشتیبانی می‌شود.)
.RE
.sp
\fB\-\-verbose\fP
.RS 4
اجرای همراه با جزئیات. با این گزینه، \fBmkswap\fP جزئیات بیشتری درباره مشکلات شناسایی‌شده هنگام راه‌اندازی ناحیه swap ارائه می‌دهد.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش اطلاعات نسخه و خروج.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT)"
.sp
LIBBLKID_DEBUG=all
.RS 4
فعال‌سازی خروجی اشکال‌زدایی libblkid.
.RE
.sp
LOCK_BLOCK_DEVICE=<mode>
.RS 4
استفاده از قفل انحصاری BSD. حالت "1" یا "0" است. برای جزئیات بیشتر گزینه \fB\-\-lock\fP را ببینید.
.RE
.SH "نکات (NOTES)"
.sp
حداکثر اندازه مفید یک ناحیه swap به معماری و نسخه هسته بستگی دارد.
.sp
حداکثر تعداد صفحاتی که هدر ناحیه swap می‌تواند آدرس‌دهی کند ۴۲۹۴۹۶۷۲۹۵ (عدد صحیح ۳۲ بیتی بدون علامت) است. فضای باقی‌مانده روی دستگاه swap نادیده گرفته می‌شود.
.sp
در حال حاضر، لینوکس اجازه استفاده از ۳۲ ناحیه swap را می‌دهد. نواحی در حال استفاده را می‌توان در فایل \fI/proc/swaps\fP مشاهده کرد.
.sp
دستور \fBmkswap\fP از ایجاد نواحی کوچک‌تر از ۱۰ صفحه خودداری می‌کند.
.sp
اگر اندازه صفحه مورد استفاده سیستم خود را نمی‌دانید، می‌توانید آن را با دستور \fBgetconf PAGESIZE\fP پیدا کنید.
.sp
علاوه بر \fBmkswap \-\-file\fP، امکان ایجاد دستی فایل swap قبل از مقداردهی اولیه با \fBmkswap\fP نیز وجود دارد، به عنوان مثال با دستوری مانند:
.sp
از نسخه 2.41، گزینه \fBmkswap \-\-file\fP صفت nocow را برای فایل‌های جدیداً ایجادشده تنظیم می‌کند تا از فایل‌های swap روی Btrfs پشتیبانی شود.
.sp
.if n .RS 4
.nf
.fam C
# dd if=/dev/zero of=swapfile bs=1MiB count=$((8*1024))
.fam
.fi
.if n .RE
.sp
برای ایجاد یک فایل swap به اندازه 8GiB.
.sp
در چنین حالتی، لطفاً نکات ذکرشده در \fBswapon\fP(8) درباره \fBمحدودیت‌های استفاده از فایل swap\fP (مشکلات حفره‌ها، پیش‌تخصیص و مسائل copy\-on\-write) را مطالعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBfdisk\fP(8),
\fBswapon\fP(8)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBmkswap\fP بخشی از بسته util-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو کرنل لینوکس" "."
دانلود کرد.