s390_sthyi(2)

الاسم
s390_sthyi - محاكاة تعليمة STHYI

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

موجز
#include <asm/sthyi.h>        /* Definition of STHYI_* constants */
#include <sys/syscall.h>      /* Definition of SYS_* constants */
#include <unistd.h>

int syscall(SYS_s390_sthyi, unsigned long function_code,
            void *resp_buffer, uint64_t *return_code,
            unsigned long flags);

ملاحظة: لا توفر glibc غلافًا لـ s390_sthyi()، مما يستلزم استخدام syscall(2).

الوصف
استدعاء النظام s390_sthyi() يحاكي تعليمة STHYI (تخزين معلومات المشرف). يوفر معلومات موارد العتاد للجهاز ومستويات المحاكاة الافتراضية الخاصة به. يشمل ذلك نوع وحدة المعالجة المركزية وسعتها، بالإضافة إلى نموذج الجهاز ومقاييس أخرى.

الوسيطة function_code تشير إلى الوظيفة المراد تنفيذها. الرموز التالية مدعومة:

STHYI_FC_CP_IFL_CAP
    إرجاع معلومات سعة CP (المعالج المركزي) وIFL (المنشأة المدمجة للينكس).

الوسيطة resp_buffer تحدد عنوان مخزن الاستجابة. عندما يكون function_code هو STHYI_FC_CP_IFL_CAP، يجب أن يكون حجم المخزن صفحة واحدة (4K). إذا أرجع استدعاء النظام 0، سيُملأ مخزن الاستجابة بمعلومات سعة وحدة المعالجة المركزية. وإلا، يبقى محتوى مخزن الاستجابة دون تغيير.

الوسيطة return_code تخزن كود الإرجاع لتعليمة STHYI، باستخدام إحدى القيم التالية:

0   نجاح.

4   كود وظيفة غير مدعوم.

لمزيد من التفاصيل حول return_code وfunction_code وresp_buffer، راجع المرجع المذكور في الملاحظات.

وُفر المعامل flags للسماح بالتوسعات المستقبلية ويجب ضبطه حاليًا على 0.

قيمة الإرجاع
عند النجاح (أي: نجحت المحاكاة)، تتطابق قيمة الإرجاع لـ s390_sthyi() مع كود الشرط لتعليمات STHYI، وهي قيمة في النطاق [0..3]. قيمة الإرجاع 0 تشير إلى تخزين معلومات سعة وحدة المعالجة المركزية في *resp_buffer. قيمة الإرجاع 3 تشير إلى "كود وظيفة غير مدعوم" ويبقى محتوى *resp_buffer دون تغيير. قيم الإرجاع 1 و2 محجوزة.

عند الخطأ، تُعاد القيمة -1، ويُضبط errno للإشارة إلى الخطأ.

الأخطاء

EFAULT
    القيمة المحددة في resp_buffer أو return_code ليست عنوانًا صالحًا.

EINVAL
    القيمة المحددة في flags غير صفرية.

ENOMEM
    فشل تخصيص الذاكرة لمعالجة معلومات سعة وحدة المعالجة المركزية.

EOPNOTSUPP
    القيمة المحددة في function_code غير صالحة.

المعايير
لينكس على s390.

التاريخ
لينكس 4.15.

ملاحظات
للحصول على تفاصيل حول تعليمات STHYI، انظر صفحة الوثائق (https://www.ibm.com/support/knowledgecenter/SSB27U_6.3.0/com.ibm.zvm.v630.hcpb4/hcpb4sth.htm).

عند استخدام واجهة استدعاء النظام، لا يجب على مخزن الاستجابة تلبية متطلبات المحاذاة الموصوفة في تعريف تعليمة STHYI.

يخبئ النواة الاستجابة (لمدة تصل إلى ثانية واحدة، اعتبارًا من لينكس 4.16). قد تُرجع استدعاءات النظام اللاحقة الاستجابة المخبأة.

انظر أيضًا
syscall(2)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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