pthread_attr_setinheritsched(3)

الاسم
pthread_attr_setinheritsched, pthread_attr_getinheritsched - ضبط/الحصول على سمة وارث-المجدول في كائن سمات الخيط

المكتبة
مكتبة مسالك POSIX (libpthread، -lpthread)

موجز
#include <pthread.h>

int pthread_attr_setinheritsched(pthread_attr_t *attr,
                                 int inheritsched);
int pthread_attr_getinheritsched(const pthread_attr_t *restrict attr,
                                 int *restrict inheritsched);

الوصف
تضبط الدالة pthread_attr_setinheritsched() سمة وارث-المجدول لكائن سمات الخيط المشار إليه بـ attr إلى القيمة المحددة في inheritsched. تحدد سمة وارث-المجدول ما إذا كان الخيط المُنشأ باستخدام كائن سمات الخيط attr سيرث سمات جدولته من الخيط المستدعي أم سيأخذها من attr.

تتأثر سمات الجدولة التالية بسمة وارث-المجدول: سياسة الجدولة (pthread_attr_setschedpolicy(3))، أولوية الجدولة (pthread_attr_setschedparam(3))، ونطاق التنافس (pthread_attr_setscope(3)).

يمكن تحديد القيم التالية في inheritsched:

PTHREAD_INHERIT_SCHED
    ترث الخيوط المنشأة باستخدام attr سمات الجدولة من الخيط المنشئ؛ تُتجاهل سمات الجدولة في attr.

PTHREAD_EXPLICIT_SCHED
    تأخذ الخيوط المنشأة باستخدام attr سمات جدولتها من القيم المحددة بواسطة كائن السمات.

الإعداد المبدئي لسمة وارث-المجدول في كائن سمات خيط مُهيأ حديثًا هو PTHREAD_INHERIT_SCHED.

تُرجع الدالة pthread_attr_getinheritsched() سمة وارث-المجدول لكائن سمات الخيط attr في المخزن المؤقت المشار إليه بـ inheritsched.

قيمة الإرجاع
عند النجاح، تُعيد هذه الدوال القيمة 0؛ وعند الخطأ، تُعيد رقم خطأ غير صفري.

الأخطاء
قد تفشل الدالة pthread_attr_setinheritsched() مع الخطأ التالي:

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

يُوثق POSIX.1 أيضًا خطأ اختياري ENOTSUP ("جرت محاولة لضبط السمة إلى قيمة غير مدعومة") للدالة pthread_attr_setinheritsched().

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
pthread_attr_setinheritsched(), pthread_attr_getinheritsched() | سلامة الخيوط | MT-Safe

المعايير
POSIX.1-2008.

التاريخ
glibc 2.0. POSIX.1-2001.

العلل
اعتبارًا من glibc 2.8، إذا هُيئ كائن سمات الخيط باستخدام pthread_attr_init(3)، فتُضبط سياسة الجدولة لكائن السمات إلى SCHED_OTHER وتُضبط أولوية الجدولة إلى 0. ومع ذلك، إذا ضُبطت سمة وارث-المجدول بعد ذلك إلى PTHREAD_EXPLICIT_SCHED، فإن الخيط المنشأ باستخدام كائن السمات يرث خطأً سمات جدولته من الخيط المنشئ. لا يحدث هذا الخلل إذا ضُبطت سياسة الجدولة أو سمة أولوية الجدولة صراحةً في كائن سمات الخيط قبل استدعاء pthread_create(3).

أمثلة
انظر pthread_setschedparam(3).

انظر أيضًا
pthread_attr_init(3), pthread_attr_setschedparam(3), pthread_attr_setschedpolicy(3), pthread_attr_setscope(3), pthread_create(3), pthread_setschedparam(3), pthread_setschedprio(3), pthreads(7), sched(7)

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

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

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