.\" -*- coding: UTF-8 -*-
.\" Copyright 2017, International Business Machines Corp.
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH s390_sthyi 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
s390_sthyi \- محاكاة تعليمة STHYI
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <asm/sthyi.h>\fP        /* Definition of \fBSTHYI_*\fP constants */
\fB#include <sys/syscall.h>\fP      /* Definition of \fBSYS_*\fP constants */
\fB#include <unistd.h>\fP
.P
\fBint syscall(SYS_s390_sthyi, unsigned long \fP\fIfunction_code\fP\fB,\fP
\fB            void *\fP\fIresp_buffer\fP\fB, uint64_t *\fP\fIreturn_code\fP\fB,\fP
\fB            unsigned long \fP\fIflags\fP\fB);\fP
.fi
.P
\fIملاحظة\fP: لا توفر glibc غلافًا لـ \fBs390_sthyi\fP()، مما يستلزم استخدام
\fBsyscall\fP(2).
.SH الوصف
استدعاء النظام \fBs390_sthyi\fP() يحاكي تعليمة STHYI (تخزين معلومات
المشرف). يوفر معلومات موارد العتاد للجهاز ومستويات المحاكاة الافتراضية
الخاصة به. يشمل ذلك نوع وحدة المعالجة المركزية وسعتها، بالإضافة إلى نموذج
الجهاز ومقاييس أخرى.
.P
الوسيطة \fIfunction_code\fP تشير إلى الوظيفة المراد تنفيذها. الرموز التالية
مدعومة:
.TP 
\fBSTHYI_FC_CP_IFL_CAP\fP
إرجاع معلومات سعة CP (المعالج المركزي) وIFL (المنشأة المدمجة للينكس).
.P
الوسيطة \fIresp_buffer\fP تحدد عنوان مخزن الاستجابة. عندما يكون
\fIfunction_code\fP هو \fBSTHYI_FC_CP_IFL_CAP\fP، يجب أن يكون حجم المخزن صفحة
واحدة (4K). إذا أرجع استدعاء النظام 0، سيُملأ مخزن الاستجابة بمعلومات سعة
وحدة المعالجة المركزية. وإلا، يبقى محتوى مخزن الاستجابة دون تغيير.
.P
الوسيطة \fIreturn_code\fP تخزن كود الإرجاع لتعليمة STHYI، باستخدام إحدى القيم
التالية:
.TP 
0
نجاح.
.TP 
4
كود وظيفة غير مدعوم.
.P
لمزيد من التفاصيل حول \fIreturn_code\fP و\fIfunction_code\fP و\fIresp_buffer\fP، راجع
المرجع المذكور في الملاحظات.
.P
وُفر المعامل \fIflags\fP للسماح بالتوسعات المستقبلية ويجب ضبطه حاليًا على 0.
.SH "قيمة الإرجاع"
عند النجاح (أي: نجحت المحاكاة)، تتطابق قيمة الإرجاع لـ \fBs390_sthyi\fP() مع
كود الشرط لتعليمات STHYI، وهي قيمة في النطاق [0..3]. قيمة الإرجاع 0 تشير إلى
تخزين معلومات سعة وحدة المعالجة المركزية في \fI*resp_buffer\fP. قيمة الإرجاع 3
تشير إلى "كود وظيفة غير مدعوم" ويبقى محتوى \fI*resp_buffer\fP دون تغيير. قيم
الإرجاع 1 و2 محجوزة.
.P
عند الخطأ، تُعاد القيمة \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEFAULT\fP
القيمة المحددة في \fIresp_buffer\fP أو \fIreturn_code\fP ليست عنوانًا صالحًا.
.TP 
\fBEINVAL\fP
القيمة المحددة في \fIflags\fP غير صفرية.
.TP 
\fBENOMEM\fP
فشل تخصيص الذاكرة لمعالجة معلومات سعة وحدة المعالجة المركزية.
.TP 
\fBEOPNOTSUPP\fP
القيمة المحددة في \fIfunction_code\fP غير صالحة.
.SH المعايير
لينكس على s390.
.SH التاريخ
لينكس 4.15.
.SH ملاحظات
للحصول على تفاصيل حول تعليمات STHYI، انظر
.UR https:\://www.ibm.com\:/support\:/knowledgecenter\:/SSB27U_6.3.0\:/com.ibm.zvm.v630.hcpb4\:/hcpb4sth.htm
صفحة الوثائق
.UE .
.P
عند استخدام واجهة استدعاء النظام، لا يجب على مخزن الاستجابة تلبية متطلبات
المحاذاة الموصوفة في تعريف تعليمة STHYI.
.P
يخبئ النواة الاستجابة (لمدة تصل إلى ثانية واحدة، اعتبارًا من لينكس 4.16). قد
تُرجع استدعاءات النظام اللاحقة الاستجابة المخبأة.
.SH "انظر أيضًا"
\fBsyscall\fP(2)
.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 .