.\" -*- coding: UTF-8 -*- .\" Copyright 2018, Eugene Syromyatnikov .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH s390_guarded_storage 2 "22 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم s390_guarded_storage \- عمليات مع ميزة التخزين المحروس لمعمارية z/Architecture .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP/* تعريف ثوابت \fBGS_*\fP */ \fB#include \fP/* تعريف ثوابت \fBSYS_*\fP */ \fB#include \fP .P \fBint syscall(SYS_s390_guarded_storage, int \fP\fIcommand\fP\fB,\fP \fB struct gs_cb *\fP\fIgs_cb\fP\fB);\fP .fi .P \fIملاحظة\fP: لا توفر glibc غلافًا لـ \fBs390_guarded_storage\fP()، مما يستلزم استخدام \fBsyscall\fP(2). .SH الوصف استدعاء النظام \fBs390_guarded_storage\fP() يمكّن استخدام ميزة التخزين المحروس (ميزة خاصة بمعمارية z/Architecture) لعمليات مساحة المستخدم. .P .\" The description is based on .\" http://www-05.ibm.com/de/linux-on-z-ws-us/agenda/pdfs/8_-_Linux_Whats_New_-_Stefan_Raspl.pdf .\" and "z/Architecture Principles of Operation" obtained from .\" http://publibfi.boulder.ibm.com/epubs/pdf/dz9zr011.pdf ميزة التخزين المحروس هي ميزة عتادية تسمح بتعليم ما يصل إلى 64 منطقة ذاكرة (اعتبارًا من z14) كمحروسة؛ قراءة مؤشر بتعليمات "تحميل محروس" (LGG) أو "تحميل منطقي وإزاحة محروس" (LLGFSG) ستؤدي إلى فحص نطاق للقيمة المحملة واستدعاء معالج مساحة مستخدم (مُعد مسبقًا) إذا تأثرت إحدى المناطق المحروسة. .P .\" The command description is copied from v4.12-rc1~139^2~56^2 commit message وسيطة \fIcommand\fP تشير إلى الوظيفة التي سيتم تنفيذها. الأوامر التالية مدعومة: .TP \fBGS_ENABLE\fP تمكين ميزة التخزين المحروس للمهمة المستدعية. المحتوى الأولي لكتلة التحكم في التخزين المحروس سيكون جميع الأصفار. بعد التمكين، يمكن لرمز مساحة المستخدم استخدام تعليمة "تحميل ضوابط التخزين المحروس" (LGSC) (أو غلاف الدالة \fBload_gs_cb\fP() المقدم في ملف الرأس \fIasm/guarded_storage.h\fP) لتحميل كتلة تحكم عشوائية. بينما تكون المهمة ممكنة، سيحفظ النواة ويستعيد المحتوى المستدعي لسجلات التخزين المحروس عند تبديل السياق. .TP \fBGS_DISABLE\fP تعطيل استخدام ميزة التخزين المحروس للمهمة المستدعية. ستتوقف النواة عن حفظ واستعادة محتوى سجلات التخزين المحروس، ويُفقد المحتوى الخاص بالمهمة لهذه السجلات. .TP \fBGS_SET_BC_CB\fP تعيين كتلة تحكم تخزين محروس بث إلى تلك المقدمة في وسيطة \fIgs_cb\fP. يُستدعى هذا لكل خيط ويربط كتلة تحكم تخزين محروس محددة بالمهمة المستدعية. ستُستخدم كتلة التحكم هذه في أمر البث \fBGS_BROADCAST\fP. .TP \fBGS_CLEAR_BC_CB\fP مسح كتلة التحكم في التخزين المحروس للبث. لن تحتوي كتلة التحكم في التخزين المحروس بعد الآن على الارتباط الذي أنشأه أمر \fBGS_SET_BC_CB\fP. .TP \fBGS_BROADCAST\fP إرسال بث إلى جميع أشقاء الخيط للمهمة المستدعية. كل شقيق أنشأ كتلة تحكم تخزين محروس بث سيحمل كتلة التحكم هذه وسيتم تمكينه للتخزين المحروس. تُستهلك كتلة التحكم في التخزين المحروس للبث؛ البث الثاني دون تحديث كتلة التحكم المخزنة بـ \fBGS_SET_BC_CB\fP لن يكون له أي تأثير. .P وسيطة \fIgs_cb\fP تحدد عنوان بنية كتلة تحكم تخزين محروس وتُستخدم حاليًا فقط بواسطة أمر \fBGS_SET_BC_CB\fP؛ جميع الأوامر الأخرى المذكورة أعلاه تتجاهل هذه الوسيطة. .SH "قيمة الإرجاع" عند النجاح، تكون قيمة الإرجاع لـ \fBs390_guarded_storage\fP() هي 0. .P عند الخطأ، تُعاد القيمة \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEFAULT\fP كان \fIcommand\fP هو \fBGS_SET_BC_CB\fP وفشلت نسخ بنية كتلة التحكم في التخزين المحروس المشار إليها بواسطة وسيطة \fIgs_cb\fP. .TP \fBEINVAL\fP القيمة المقدمة في وسيطة \fIcommand\fP لم تكن صالحة. .TP \fBENOMEM\fP كان \fIcommand\fP أحد \fBGS_ENABLE\fP أو \fBGS_SET_BC_CB\fP، وفشل تخصيص كتلة تحكم تخزين محروس جديدة. .TP \fBEOPNOTSUPP\fP ميزة التخزين المحروس غير مدعومة من قبل العتاد. .SH المعايير لينكس على s390. .SH التاريخ .\" 916cda1aa1b412d7cf2991c3af7479544942d121, v4.12-rc1~139^2~56^2 لينكس 4.12، النظام z14. .SH ملاحظات وصف ميزة التخزين المحروس مع التعليمات ذات الصلة وتخطيطات بنية كتلة التحكم في التخزين المحروس وقائمة معلمات حدث التخزين المحروس متاح في "مبادئ تشغيل z/Architecture" بدءًا من الإصدار الثاني عشر. .P .\" .P .\" For the example of using the guarded storage facility, see .\" .UR https://developer.ibm.com/javasdk/2017/09/25/concurrent-scavenge-using-guarded-storage-facility-works/ .\" the article with the description of its usage in the Java Garbage Collection .\" .UE بنية \fIgs_cb\fP تحتوي على حقل \fIgsepla\fP (عنوان قائمة معلمات حدث التخزين المحروس)، وهو مؤشر مساحة مستخدم إلى بنية قائمة معلمات حدث التخزين المحروس (التي تحتوي على عنوان معالج الأحداث المذكور أعلاه في حقل \fIgseha\fP)، وتخطيطها متاح كتعريف نوع بنية \fBgs_epl\fP في ملف الرأس \fIasm/guarded_storage.h\fP. .SH "انظر أيضًا" \fBsyscall\fP(2) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .