'\" t
.\"     Title: swapon
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: إدارة النظام
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "SWAPON" "8" "2026-05-18" "util\-linux 2.42.1" "إدارة النظام"
.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 "الاسم"
swapon \- ، swapoff \- تفعيل/تعطيل الأجهزة والملفات للتبديل (swapping) والتبويب (paging)
.SH "موجز"
.sp
\fBswapon\fP [خيارات] [\fIspecialfile\fP.\|.\|.]
.sp
\fBswapoff\fP [\fB\-va\fP] [\fIspecialfile\fP.\|.\|.]
.SH "الوصف"
.sp
يُستخدم \fBswapon\fP لتحديد الأجهزة التي ستُجرى عليها عمليات التبويب والتبديل.
.sp
يُعطى الجهاز أو الملف المستخدم عبر المعلمة \fIspecialfile\fP. قد تكون على هيئة \fB\-L\fP \fIلصيقة\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 "الخيارات"
.sp
\fB\-a\fP، \fB\-\-all\fP
.RS 4
جميع الأجهزة المعلمة كـ "swap" في \fI/etc/fstab\fP تُجعل متاحة، باستثناء تلك التي تملك الخيار "noauto". تُتخطى الأجهزة المستخدمة بالفعل كمساحة تبديل بصمت. انظر قسم \fBضبط FSTAB\fP لمزيد من التفاصيل.
.RE
.sp
\fB\-T\fP، \fB\-\-fstab\fP \fIمسار\fP
.RS 4
يحدد ملف fstab بديل للتوافق مع \fBmount\fP(8). إذا كان \fIمسار\fP دليلًا، فتُفرز الملفات في الدليل بواسطة \fBstrverscmp\fP(3)؛ وتُتجاهل الملفات التي تبدأ بـ "." أو التي لا تملك امتداد .fstab. يمكن تحديد هذا الخيار أكثر من مرة. صُمم هذا الخيار غالبًا لسكريبتات initramfs أو chroot حيث يُضبط تكوين إضافي بخلاف تكوين النظام القياسي.
.RE
.sp
\fB\-d\fP، \fB\-\-discard\fP[\fB=\fP\fIسياسة\fP]
.RS 4
تفعيل نبذ (discard) التبديل، إذا كان الجهاز الخلفي للتبديل يدعم عملية النبذ أو التقليم (trim). قد يحسن هذا الأداء على بعض أجهزة الحالة الصلبة (SSD)، لكنه غالبًا لا يفعل. يسمح الخيار بالاختيار بين سياستين متاحين لنبذ التبديل:
.sp
\fB\-\-discard=once\fP
.RS 4
لإجراء عملية نبذ لمرة واحدة لمنطقة التبديل بالكامل عند تشغيل swapon؛ أو
.RE
.sp
\fB\-\-discard=pages\fP
.RS 4
لنبذ صفحات التبديل المحررة بشكل غير متزامن قبل أن تصبح متاحة لإعادة الاستخدام.
.RE
.sp
إذا لم تُحدد أي سياسة، فإن السلوك المبدئي هو تفعيل كلا نوعي النبذ. يمكن أيضًا استخدام خيارات الوصل في \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 \fIلصيقة\fP
.RS 4
استخدم القسم الذي لديه الـ \fIلصيقة\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 \fIالأولوية\fP
.RS 4
حدد أولوية جهاز التبديل. \fIأولوية\fP هي قيمة بين 0 و 32767. تشير الأرقام الأعلى إلى أولوية أعلى. راجع \fBswapon\fP(2) للحصول على وصف كامل لأولويات التبديل. أضف \fBpri=\fP\fIقيمة\fP إلى حقل الخيارات في \fI/etc/fstab\fP للاستخدام مع \fBswapon \-a\fP. عند عدم تحديد أي أولوية، تختار نواة لينكس قيمًا سالبة بشكل مبدئي.
.RE
.sp
\fB\-s\fP، \fB\-\-summary\fP
.RS 4
اعرض ملخص استخدام التبديل حسب الجهاز. يكافئ \fBcat /proc/swaps\fP. تنسيق المخرج هذا مهجور لصالح الخيار \fB\-\-show\fP الذي يوفر تحكمًا أفضل في بيانات المخرجات.
.RE
.sp
\fB\-\-show\fP[\fB=\fP\fIعمود\fP.\|.\|.]
.RS 4
اعرض جدولاً قابلاً للتحديد لمناطق التبديل. راجع مخرجات \fB\-\-help\fP للحصول على قائمة بالأعمدة المتاحة.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
أخرج كافة الأعمدة المتاحة.
.RE
.sp
\fB\-\-annotate\fP[\fB=\fP\fIمتى\fP]
.RS 4
يضيف توسيماً إلى اسم ترويسة كل عمود. يمكن إظهار هذا التوسيم كتلميح أدوات بواسطة الطرفيات التي تدعم هذه الميزة. يمكن أن يكون معامل \fIمتى\fP الاختياري \fBalways\fP أو \fBnever\fP أو \fBauto\fP. وإذا حُذف المعامل، فسيُضبط مبدئياً على \fBauto\fP، مما يعني أن التوسيمات ستُستخدم فقط عندما يذهب المخرج إلى طرفية.
.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 "ضبط FSTAB"
.sp
يقرأ الأمر \fBswapon \-\-all\fP الإعدادات من \fI/etc/fstab\fP (أو من ملف محدد عبر خيار سطر الأوامر \fB\-\-fstab\fP). لا تهم سوى مدخلات fstab التي ضُبط فيها نوع نظام الملفات (الحقل الثالث) على "swap".
.sp
يقبل الخيار \fB\-\-options\fP قيماً بنفس الصيغة التي يمكن تحديدها في الحقل الرابع في fstab.
.SS "الحقل الأول (المصدر)"
.sp
حدد مصدر التبديل (swap). إذا كان المصدر ملفاً عادياً، فيُشار إليه بمسار مطلق.
.sp
إذا كان التبديل جهازاً كتلياً، فيمكن الإشارة إليه بمسار الجهاز، أو أوسمة منطقة التبديل \fBLABEL=\fP أو \fBUUID=\fP (راجع \fBmkswap\fP(8) لمزيد من التفاصيل)، أو بأوسمة القسم مثل \fBPARTLABEL=\fP أو \fBPARTUUID=\fP.
.SS "الحقل الثاني (الهدف)"
.sp
غير مستخدم من قبل \fBswapon\fP، والعرف الموصى به هو استخدام "none".
.SS "الحقل الثالث (النوع)"
.sp
يتطلب "swap" كنوع لنظام الملفات.
.SS "الحقل الرابع (الخيارات)"
.sp
يُنسق كقائمة خيارات مفصولة بفاصلة. تُتجاهل جميع الخيارات غير المعروفة صمتاً. إذا كانت الخيارات غير ضرورية، فإن العرف الموصى به هو استخدام "defaults". توسع الخيارات المحددة في \fIfstab\fP الإعدادات المحددة في سطر أوامر \fBswapon\fP أو تكتب فوقها.
.sp
خيارات التبديل المدعومة:
.sp
\fBnoauto\fP
.RS 4
تجاهل المدخلة عند إعطاء \fBswapon \-\-all\fP.
.RE
.sp
\fBnofail\fP
.RS 4
عدم الإبلاغ عن أخطاء لهذا الجهاز إذا لم يكن موجوداً.
.RE
.sp
\fBdiscard\fP[\fB=\fP\fIالسياسة\fP]
.RS 4
تفعيل تجاهل (discard) التبديل. الإعدادات المدعومة هي \fBdiscard\fP، أو \fBdiscard=once\fP، أو \fBdiscard=pages\fP. لمزيد من التفاصيل، راجع خيار سطر الأوامر \fB\-\-discard\fP.
.RE
.sp
\fBpri=\fP\fIالأولوية\fP
.RS 4
حدد أولوية جهاز التبديل. لمزيد من التفاصيل، راجع خيار سطر الأوامر \fB\-\-priority\fP.
.RE
.SS "الحقل الخامس"
.sp
غير مستخدم من قبل \fBswapon\fP، والعرف الموصى به هو إبقاؤه فارغاً.
.SS "الحقل السادس"
.sp
غير مستخدم من قبل \fBswapon\fP، والعرف الموصى به هو إبقاؤه فارغاً.
.SH "حالة الخروج"
.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 "البيئة"
.sp
\fBLIBMOUNT_DEBUG\fP=all
.RS 4
يُفعل مخرجات تنقيح \fBlibmount\fP.
.RE
.sp
\fBLIBBLKID_DEBUG\fP=all
.RS 4
يُفعل مخرجات تنقِيح \fBlibblkid\fP.
.RE
.SH "الملفات"
.sp
\fI/dev/sd??\fP
.RS 4
أجهزة الصفحات القياسية
.RE
.sp
\fI/etc/fstab\fP
.RS 4
جدول وصف نظام ملفات ascii
.RE
.SH "ملاحظات"
.SS "الملفات ذات الثقوب"
.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 "تعليق"
.sp
يكتشف \fBswapon\fP آليًا توقيع مساحة التبديل الذي يحتوي على بيانات تعليق برمجية قديمة (مثل \fBS1SUSPEND\fP، \fBS2SUSPEND\fP، .\|.\|.) ويعيد كتابته. المشكلة تكمن في أنه إذا لم يُفعل ذلك، فسيحدث فساد في البيانات عند المحاولة التالية لإلغاء التعليق.
.SH "تاريخ"
.sp
ظهر الأمر \fBswapon\fP في 4.0BSD.
.SH "انظر أيضاً"
.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 "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBswapon\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."