الاسم¶

mlock, mlock2, munlock, mlockall, munlockall - قفل وفتح الذاكرة

المكتبة¶

مكتبة سي المعيارية (libc، -lc)

موجز¶

#include <sys/mman.h>

int mlock(size_t size;
          const void addr[size], size_t size);
int mlock2(size_t size;
          const void addr[size], size_t size, unsigned int flags);
int munlock(size_t size;
          const void addr[size], size_t size);

int mlockall(int flags);
int munlockall(void);

الوصف¶

mlock() و mlock2() و mlockall() تقفل جزءًا أو كل مساحة العنوان الافتراضية لعملية الاستدعاء في RAM، مما يمنع ترحيل تلك الذاكرة إلى منطقة المبادلة.

munlock() و munlockall() تنفذ العملية المعاكسة، بفتح جزء أو كل مساحة العنوان الافتراضية لعملية الاستدعاء، بحيث يمكن إخراج الصفحات في نطاق العنوان الافتراضي المحدد إلى المبادلة مرة أخرى إذا تطلب مدير ذاكرة النواة ذلك.

تُقفل الذاكرة وفتحها بوحدات من الصفحات الكاملة.

قيمة الإرجاع¶

عند النجاح، تعيد استدعاءات النظام هذه 0. عند الخطأ، يُرجع -1، ويُعين errno للإشارة إلى الخطأ، ولا يُجرى أي تغييرات على أي أقفال في مساحة العنوان للعملية.

الأخطاء¶

EAGAIN

(mlock() و mlock2() و munlock()) لا يمكن قفل بعض أو كل نطاق العنوان المحدد.

EINVAL

(mlock() و mlock2() و munlock()) كانت نتيجة الجمع addr+size أقل من addr (على سبيل المثال، قد يكون الجمع قد أدى إلى تجاوز).

EINVAL

(mlock2()) حُدد flags غير معروفة.

EINVAL

(mlockall()) حُدد flags غير معروفة أو حُدد MCL_ONFAULT دون MCL_FUTURE أو MCL_CURRENT.

EINVAL

(ليس على لينكس) addr لم يكن مضاعفًا لحجم الصفحة.

ENOMEM

(mlock(), mlock2(), و munlock()) بعض نطاق العناوين المحدد لا يتوافق مع صفحات معينة في مساحة عنوان العملية.

ENOMEM

(mlock(), mlock2(), و munlock()) قفل أو فتح منطقة سيؤدي إلى تجاوز العدد الإجمالي للتعيينات ذات السمات المميزة (مثل المقفلة مقابل غير المقفلة) الحد الأقصى المسموح به. (على سبيل المثال، فتح نطاق في منتصف تعيين مقفل حاليًا سيؤدي إلى ثلاثة تعيينات: تعيينان مقفلان في كل طرف وتعيين غير مقفل في المنتصف.)

ENOMEM

(لينكس 2.6.9 وما بعده) كان لدى المتصل حد مورد ناعم RLIMIT_MEMLOCK غير صفري، لكنه حاول قفل ذاكرة أكثر مما يسمح به الحد. لا يُرفض هذا الحد إذا كانت العملية مميزة (CAP_IPC_LOCK).

ENOMEM

(لينكس 2.4 وما قبله) حاولت العملية المتصلة قفل أكثر من نصف ذاكرة الوصول العشوائي.

EPERM

المتصل ليس مميزًا، لكنه يحتاج إلى امتياز (CAP_IPC_LOCK) لتنفيذ العملية المطلوبة.

EPERM

(munlockall()) (لينكس 2.6.8 وما قبله) لم يكن المتصل مميزًا (CAP_IPC_LOCK).

الإصدارات¶

المعايير¶

mlock()

munlock()

mlockall()

munlockall()

POSIX.1-2024.

mlock2()

لينكس.

على أنظمة POSIX التي تتوفر فيها mlock() و munlock()، تُعرف _POSIX_MEMLOCK_RANGE في <unistd.h> ويمكن تحديد عدد البايتات في الصفحة من الثابت PAGESIZE (إذا تم تعريفه) في <limits.h> أو عن طريق استدعاء sysconf(_SC_PAGESIZE).

على أنظمة POSIX التي تتوفر فيها mlockall() و munlockall()، تُعرف _POSIX_MEMLOCK في <unistd.h> بقيمة أكبر من 0. (انظر أيضًا sysconf(3).)

التاريخ¶

mlock()

munlock()

mlockall()

munlockall()

SVr4, POSIX.1-1996.

mlock2()

لينكس 4.4، glibc 2.27.

ملاحظات¶

لقفل الذاكرة تطبيقان رئيسيان: الخوارزميات في الوقت الفعلي ومعالجة البيانات عالية الأمان. تتطلب التطبيقات في الوقت الفعلي توقيتًا حتميًا، ومثل الجدولة، فإن الترحيل هو أحد الأسباب الرئيسية لتأخيرات تنفيذ البرنامج غير المتوقعة. عادةً ما تتحول التطبيقات في الوقت الفعلي أيضًا إلى جدولة في الوقت الفعلي باستخدام sched_setscheduler(2). غالبًا ما تتعامل برامج الأمان المشفرة مع البايتات الحرجة مثل كلمات السر أو المفاتيح السرية كهياكل بيانات. نتيجة للترحيل، يمكن نقل هذه الأسرار إلى وسيط تخزين مبادلة دائم، حيث قد تكون قابلة للوصول للعدو بعد وقت طويل من قيام برنامج الأمان بمسح الأسرار في ذاكرة الوصول العشوائي وإنهائه. (لكن كن على علم أن وضع الإيقاف المؤقت على أجهزة الكمبيوتر المحمولة وبعض أجهزة الكمبيوتر المكتبية سيحفظ نسخة من ذاكرة الوصول العشوائي للنظام على القرص، بغض النظر عن أقفال الذاكرة.)

يجب على العمليات في الوقت الفعلي التي تستخدم mlockall() لمنع التأخيرات في أخطاء الصفحات أن تحجز صفحات مكدس مقفلة كافية قبل الدخول إلى القسم الحرج زمنيًا، بحيث لا يمكن أن يحدث أي خطأ صفحة بسبب استدعاءات الدوال. يمكن تحقيق ذلك عن طريق استدعاء دالة تخصص متغيرًا آليًا كبيرًا بما يكفي (مصفوفة) وتكتب إلى الذاكرة التي تشغلها هذه المصفوفة من أجل لمس صفحات المكدس هذه. بهذه الطريقة، ستُتعين صفحات كافية للمكدس ويمكن قفلها في ذاكرة الوصول العشوائي. تضمن عمليات الكتابة الوهمية عدم حدوث حتى أخطاء صفحات النسخ عند الكتابة في القسم الحرج.

لا تُورث أقفال الذاكرة إلى عملية فرعية تم إنشاؤها عبر fork(2) وتُزال آليًا (فتحها) أثناء execve(2) أو عند إنهاء العملية. إعدادات mlockall() MCL_FUTURE و MCL_FUTURE | MCL_ONFAULT لا تُورث إلى عملية فرعية مُنشأة عبر fork(2) وتُمسح أثناء execve(2).

لاحظ أن fork(2) ستحضر مساحة العنوان لعملية نسخ عند الكتابة. النتيجة هي أن أي وصول للكتابة يليه سيسبب خطأ صفحة والذي بدوره قد يسبب زمن استجابة مرتفعًا لعملية في الوقت الفعلي. لذلك، من الضروري عدم استدعاء fork(2) بعد عملية mlockall() أو mlock()—ولا حتى من خيط يعمل بأولوية منخفضة داخل عملية تحتوي أيضًا على خيط يعمل بأولوية مرتفعة.

يُزال قفل الذاكرة على نطاق عنوان آليًا إذا أُلغي تعيين نطاق العنوان عبر munmap(2).

لا تتراكم أقفال الذاكرة، أي أن الصفحات التي أُقفلت عدة مرات عن طريق استدعاءات mlock()، mlock2()، أو mlockall() ستُفتح باستدعاء واحد لـ munlock() للنطاق المقابل أو بواسطة munlockall(). تبقى الصفحات التي عُينت لعدة مواقع أو بواسطة عدة عمليات مقفلة في ذاكرة الوصول العشوائي طالما أنها مقفلة على الأقل في موقع واحد أو بواسطة عملية واحدة على الأقل.

إذا تبع استدعاء لـ mlockall() يستخدم العلم MCL_FUTURE استدعاء آخر لا يحدد هذا العلم، فستفقد التغييرات التي أجراها استدعاء MCL_FUTURE.

يسمح علم mlock2() MLOCK_ONFAULT وعلم mlockall() MCL_ONFAULT بقفل ذاكرة فعال للتطبيقات التي تتعامل مع تعيينات كبيرة حيث يُلمس جزء (صغير) فقط من الصفحات في التعيين. في مثل هذه الحالات، سيتسبب قفل جميع الصفحات في تعيين في عقوبة كبيرة لقفل الذاكرة.

العلل¶

في لينكس 4.8 وما قبله، تسبب خطأ في محاسبة النواة للذاكرة المقفلة للعمليات غير المميزة (أي، بدون CAP_IPC_LOCK) في أنه إذا تداخلت المنطقة المحددة بواسطة addr و size مع قفل موجود، فإن البايتات المقفلة بالفعل في المنطقة المتداخلة كانت تُحسب مرتين عند التحقق من الحد. يمكن أن يؤدي هذا الحساب المزدوج إلى حساب غير صحيح لقيمة "الذاكرة المقفلة الإجمالية" للعملية التي تجاوزت حد RLIMIT_MEMLOCK، مما يؤدي إلى فشل mlock() و mlock2() في الطلبات التي كان يجب أن تنجح. أُصلح هذا الخطأ في لينكس 4.9.

في سلسلة نواة لينكس 2.4 حتى لينكس 2.4.17، تسبب خطأ في توريث علامة mlockall() MCL_FUTURE عبر fork(2). صُحح هذا في لينكس 2.4.18.

منذ لينكس 2.6.9، إذا استدعت عملية مميزة mlockall(MCL_FUTURE) ثم تخلت عن الامتيازات (فقدت قدرة CAP_IPC_LOCK عن طريق، على سبيل المثال، تعيين UID الفعال إلى قيمة غير صفرية)، فإن تخصيصات الذاكرة اللاحقة (مثل mmap(2)، brk(2)) ستفشل إذا واجهت حد مورد RLIMIT_MEMLOCK.

انظر أيضًا¶

mincore(2)، mmap(2)، setrlimit(2)، shmctl(2)، sysconf(3)، proc(5)، capabilities(7)

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com> و #

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.