.\" -*- coding: UTF-8 -*-
.\" Copyright 2006, Silicon Graphics, Inc.
.\" Copyright 2009, Intel Corp.
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft-2-para
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH migrate_pages 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
migrate_pages \- نقل جميع الصفحات في عملية إلى مجموعة أخرى من العقد
.SH المكتبة
مكتبة سياسات NUMA (الوصول غير الموحد للذاكرة) (\fIlibnuma\fP،\ \fI\-lnuma\fP)
.SH موجز
.nf
\fB#include <numaif.h>\fP
.P
\fBlong migrate_pages(int \fP\fIpid\fP\fB, unsigned long \fP\fImaxnode,\fP
\fB                   const unsigned long *\fP\fIold_nodes,\fP
\fB                   const unsigned long *\fP\fInew_nodes\fP\fB);\fP
.fi
.SH الوصف
تحاول \fBmigrate_pages\fP() نقل جميع صفحات العملية \fIpid\fP الموجودة في عقد
الذاكرة \fIold_nodes\fP إلى عقد الذاكرة في \fInew_nodes\fP. لن يتم ترحيل الصفحات
غير الموجودة في أي عقدة في \fIold_nodes\fP. بقدر الإمكان، تحافظ النواة على
علاقة الطوبولوجيا النسبية داخل \fIold_nodes\fP أثناء الترحيل إلى \fInew_nodes\fP.
.P
الوسيطان \fIold_nodes\fP و \fInew_nodes\fP هما مؤشران لأقنعة بت لأرقام العقد، مع
ما يصل إلى \fImaxnode\fP بت في كل قناع. تُحافظ هذه الأقنعة كمصفوفات من الأعداد
الصحيحة الطويلة غير الموقعة (في آخر عدد صحيح طويل، يتم تجاهل البتات التي
تتجاوز تلك المحددة بواسطة \fImaxnode\fP). الوسيط \fImaxnode\fP هو أقصى رقم عقدة في
قناع البت زائد واحد (هذا هو نفسه كما في \fBmbind\fP(2)، لكنه مختلف عن
\fBselect\fP(2)).
.P
الوسيط \fIpid\fP هو معرف العملية التي سيتم نقل صفحاتها. لنقل الصفحات في عملية
أخرى، يجب أن يكون المتصل متميزًا (\fBCAP_SYS_NICE\fP) أو يجب أن يتطابق معرف
المستخدم الحقيقي أو الفعال للعملية المتصلة مع معرف المستخدم الحقيقي أو
المحفوظ للعملية المستهدفة. إذا كان \fIpid\fP يساوي 0، فإن \fBmigrate_pages\fP()
ينقل صفحات العملية المتصلة.
.P
سيتم نقل الصفحات المشتركة مع عملية أخرى فقط إذا كانت العملية البادئة تمتلك
امتياز \fBCAP_SYS_NICE\fP.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع \fBmigrate_pages\fP() عدد الصفحات التي لم يمكن نقلها (أي أن
القيمة المرجعة صفر تعني أنه تم نقل جميع الصفحات بنجاح). عند الخطأ، تُرجع \-1،
وتضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEFAULT\fP
جزء أو كل نطاق الذاكرة المحدد بواسطة \fIold_nodes\fP/\fInew_nodes\fP و \fImaxnode\fP
يشير إلى خارج مساحة العنوان القابلة للوصول.
.TP 
\fBEINVAL\fP
.\" As at 3.5, this limit is "a page worth of bits", e.g.,
.\" 8 * 4096 bits, assuming a 4kB page size.
القيمة المحددة بواسطة \fImaxnode\fP تتجاوز حدًا تفرضه النواة. أو، يحدد
\fIold_nodes\fP أو \fInew_nodes\fP معرف عقدة واحدًا أو أكثر أكبر من أقصى معرف عقدة
مدعوم. أو، لا يوجد أي من معرفات العقد المحددة بواسطة \fInew_nodes\fP متصلاً
ومسموحًا به بواسطة سياق cpuset الحالي للعملية، أو لا تحتوي أي من العقد
المحددة على ذاكرة.
.TP 
\fBEPERM\fP
امتياز غير كافٍ (\fBCAP_SYS_NICE\fP) لنقل صفحات العملية المحددة بواسطة \fIpid\fP،
أو امتياز غير كافٍ (\fBCAP_SYS_NICE\fP) للوصول إلى العقد المستهدفة المحددة.
.TP 
\fBESRCH\fP
.\" FIXME Document the other errors that can occur for migrate_pages()
لم يُعثر على عملية تطابق \fIpid\fP.
.SH المعايير
لينكس.
.SH التاريخ
لينكس 2.6.16.
.SH ملاحظات
للحصول على معلومات حول دعم المكتبات، انظر \fBnuma\fP(7).
.P
استخدم \fBget_mempolicy\fP(2) مع العلم \fBMPOL_F_MEMS_ALLOWED\fP للحصول على مجموعة
العقد المسموح بها بواسطة cpuset للعملية المتصلة. لاحظ أن هذه المعلومات قابلة
للتغيير في أي وقت عن طريق إعادة التشكيل اليدوي أو الآلي لـ cpuset.
.P
قد يؤدي استخدام \fBmigrate_pages\fP() إلى صفحات ينتهك موقعها (العقدة) سياسة
الذاكرة المقررة للعناوين المحددة (انظر \fBmbind\fP(2)) و/أو العملية المحددة
(انظر \fBset_mempolicy\fP(2)). أي أن سياسة الذاكرة لا تقيد العقد الوجهة
المستخدمة بواسطة \fBmigrate_pages\fP().
.P
ترويسة \fI<numaif.h>\fP غير مضمنة في glibc، ولكنها تتطلب تثبيت
\fIlibnuma\-devel\fP أو حزمة مماثلة.
.SH "انظر أيضًا"
\fBget_mempolicy\fP(2)، و\fBmbind\fP(2)، و\fBset_mempolicy\fP(2)، و\fBnuma\fP(3)،
و\fBnuma_maps\fP(5)، و\fBcpuset\fP(7)، و\fBnuma\fP(7)، و\fBmigratepages\fP(8)،
و\fBnumastat\fP(8)
.P
\fIDocumentation/vm/page_migration.rst\fP في شجرة مصدر نواة لينكس
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .