.\" -*- coding: UTF-8 -*- .\" Copyright 1992, Drew Eckhardt .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" FIXME Linux 3.11 added SWAP_FLAG_DISCARD_ONCE and SWAP_FLAG_DISCARD_PAGES .\" commit dcf6b7ddd7df8965727746f89c59229b23180e5a .\" Author: Rafael Aquini .\" Date: Wed Jul 3 15:02:46 2013 -0700 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH swapon 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم swapon, swapoff \- بدء/إيقاف المبادلة إلى ملف/جهاز .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint swapon(const char *\fP\fIpath\fP\fB, int \fP\fIswapflags\fP\fB);\fP \fBint swapoff(const char *\fP\fIpath\fP\fB);\fP .fi .SH الوصف \fBswapon\fP() يضبط منطقة المبادلة على الملف أو جهاز الكتلة المحدد بواسطة \fIpath\fP. \fBswapoff\fP() يوقف المبادلة إلى الملف أو جهاز الكتلة المحدد بواسطة \fIpath\fP. .P إذا تم تحديد العلم \fBSWAP_FLAG_PREFER\fP في وسيط \fBswapon\fP() \fIswapflags\fP، فستكون منطقة المبادلة الجديدة ذات أولوية أعلى من المبدئي. الأولوية مشفرة داخل \fIswapflags\fP كالتالي: .P .in +4n .EX \fI(prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK\fP .EE .in .P إذا تم تحديد العلم \fBSWAP_FLAG_DISCARD\fP في وسيط \fBswapon\fP() \fIswapflags\fP، فسيتم التخلص من صفحات المبادلة المحررة قبل إعادة استخدامها، إذا كان جهاز المبادلة يدعم عملية التخلص أو التقليم. (قد يحسن هذا الأداء على بعض أجهزة الحالة الصلبة، لكنه غالبًا لا يفعل.) انظر أيضًا الملاحظات. .P لا يمكن استخدام هذه الدوال إلا بواسطة عملية مميزة (تلك التي تمتلك القدرة \fBCAP_SYS_ADMIN\fP). .SS الأولوية كل منطقة مبادلة لها أولوية، إما عالية أو منخفضة. الأولوية المبدئية منخفضة. داخل المناطق ذات الأولوية المنخفضة، المناطق الأحدث لها أولوية أقل من المناطق الأقدم. .P جميع الأولويات المحددة بـ \fIswapflags\fP هي ذات أولوية عالية، أعلى من المبدئي. يمكن أن يكون لها أي قيمة غير سالبة يختارها المتصل. الأرقام الأعلى تعني أولوية أعلى. .P يتم تخصيص صفحات المبادلة من المناطق بترتيب الأولوية، الأعلى أولاً. للمناطق ذات الأولويات المختلفة، يتم استنفاد منطقة ذات أولوية أعلى قبل استخدام منطقة ذات أولوية أقل. إذا كانت منطقتان أو أكثر لها نفس الأولوية، وكانت أعلى أولوية متاحة، يتم تخصيص الصفحات على أساس دائري بينها. .P اعتبارًا من لينكس 1.3.6، يتبع النواة عادةً هذه القواعد، لكن هناك استثناءات. .SH "قيمة الإرجاع" عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEBUSY\fP (لـ \fBswapon\fP()) \fIpath\fP المحدد قيد الاستخدام بالفعل كمنطقة مبادلة. .TP \fBEINVAL\fP الملف \fIpath\fP موجود، لكنه لا يشير إلى ملف عادي ولا إلى جهاز كتلة؛ .TP \fBEINVAL\fP (\fBswapon\fP()) المسار المشار إليه لا يحتوي على توقيع مبادلة صالح أو يقع على نظام ملفات في الذاكرة مثل \fBtmpfs\fP(5). .TP \fBEINVAL\fP (منذ لينكس 3.4) (\fBswapon\fP()) تم تحديد قيمة علم غير صالحة في \fIswapflags\fP. .TP \fBEINVAL\fP (\fBswapoff\fP()) \fIpath\fP ليس حاليًا منطقة مبادلة. .TP \fBENFILE\fP وُصل إلى الحد الأقصى لإجمالي عدد الملفات المفتوحة على مستوى النظام. .TP \fBENOENT\fP الملف \fIpath\fP غير موجود. .TP \fBENOMEM\fP النظام لديه ذاكرة غير كافية لبدء المبادلة. .TP \fBEPERM\fP المتصل لا يمتلك القدرة \fBCAP_SYS_ADMIN\fP. بدلاً من ذلك، الحد الأقصى لعدد ملفات المبادلة قيد الاستخدام بالفعل؛ انظر الملاحظات أدناه. .SH المعايير لينكس. .SH التاريخ وسيط \fIswapflags\fP تم تقديمه في لينكس 1.3.2. .SH ملاحظات يجب تحضير القسم أو المسار باستخدام \fBmkswap\fP(8). .P هناك حد أعلى لعدد ملفات المبادلة التي يمكن استخدامها، محدد بواسطة ثابت النواة \fBMAX_SWAPFILES\fP. قبل لينكس 2.4.10، \fBMAX_SWAPFILES\fP له القيمة 8؛ منذ لينكس 2.4.10، له القيمة 32. منذ لينكس 2.6.18، يتم تقليل الحد بمقدار 2 (وبالتالي 30)، منذ لينكس 5.19، يتم تقليل الحد بمقدار 3 (وبالتالي: 29) إذا تم بناء النواة مع خيار \fBCONFIG_MIGRATION\fP (الذي يحجز مدخلين لجدول المبادلة لميزات ترحيل الصفحات لـ \fBmbind\fP(2) و \fBmigrate_pages\fP(2)). منذ لينكس 2.6.32، يتم تقليل الحد أكثر بمقدار 1 إذا تم بناء النواة مع خيار \fBCONFIG_MEMORY_FAILURE\fP. منذ لينكس 5.14، يتم تقليل الحد أكثر بمقدار 4 إذا تم بناء النواة مع خيار \fBCONFIG_DEVICE_PRIVATE\fP. منذ لينكس 5.19، يتم تقليل الحد أكثر بمقدار 1 إذا تم بناء النواة مع خيار \fBCONFIG_PTE_MARKER\fP. .P .\" To be precise: 2.6.35.5 التخلص من صفحات المبادلة تم تقديمه في لينكس 2.6.29، ثم جُعل مشروطًا بالعلم \fBSWAP_FLAG_DISCARD\fP في لينكس 2.6.36، والذي لا يزال يتخلص من منطقة المبادلة بأكملها عند استدعاء \fBswapon\fP()، حتى إذا لم يتم تعيين بت العلم هذا. .SH "انظر أيضًا" \fBmkswap\fP(8), \fBswapoff\fP(8), \fBswapon\fP(8) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .