s390_runtime_instr(2)

الاسم
s390_runtime_instr - تمكين/تعطيل أجهزة وقت التشغيل لوحدة المعالجة المركزية s390

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

موجز
#include <asm/runtime_instr.h> /* تعريف ثوابت S390_* */
#include <sys/syscall.h>       /* تعريف ثوابت SYS_* */
#include <unistd.h>

int syscall(SYS_s390_runtime_instr, int command, int signum);

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

الوصف
استدعاء النظام s390_runtime_instr() يبدأ أو يوقف أجهزة وقت التشغيل لوحدة المعالجة المركزية للخيط المستدعي.

تتحكم وسيطة command في ما إذا كانت أجهزة وقت التشغيل قد بدأت (S390_RUNTIME_INSTR_START، 1) أو توقفت (S390_RUNTIME_INSTR_STOP، 2) للخيط المستدعي.

تحدد وسيطة signum رقم إشارة زمن حقيقي. استُخدمت هذه الوسيطة لتحديد رقم إشارة يجب تسليمها إلى الخيط إذا كانت خبيئة أجهزة وقت التشغيل ممتلئة أو إذا حدث مقاطعة توقف أجهزة وقت التشغيل. لم تُستخدم هذه الميزة أبدًا، وفي Linux 4.4 أُزيل دعم هذه الميزة؛ وبالتالي، في النوى الحالية، تُتجاهل هذه الوسيطة.

قيمة الإرجاع
عند النجاح، تُرجع s390_runtime_instr() 0 وتمكن الخيط لأجهزة وقت التشغيل عن طريق تعيين كتلة تحكم أجهزة وقت تشغيل مبدئية للخيط. يمكن للمستدعي بعد ذلك قراءة وتعديل كتلة التحكم وبدء أجهزة وقت التشغيل. عند الخطأ، يُرجع -1 ويُضبط errno للإشارة إلى الخطأ.

الأخطاء

EINVAL
    القيمة المحددة في command ليست أمرًا صالحًا.

EINVAL
    القيمة المحددة في signum ليست رقم إشارة زمن حقيقي. من Linux 4.4 فصاعدًا، ليس لوسيطة signum أي تأثير، لذا لن يؤدي رقم إشارة غير صالح إلى خطأ.

ENOMEM
    فشل تخصيص الذاكرة لكتلة تحكم أجهزة وقت التشغيل.

EOPNOTSUPP
    مرفق أجهزة وقت التشغيل غير متوفر.

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

التاريخ
Linux 3.7. System z EC12.

ملاحظات
ملف الرأس asm/runtime_instr.h متوفر منذ Linux 4.16.

بدءًا من Linux 4.4، أُزيل دعم الإشارات، وكذلك التحقق مما إذا كان signum إشارة زمن حقيقي صالحة. للتوافق العكسي مع النوى الأقدم، يُوصى بتمرير رقم إشارة زمن حقيقي صالح في signum وتثبيت معالج لتلك الإشارة.

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

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

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

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