pthread_attr_setschedparam(3)

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

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

موجز
#include <pthread.h>

int pthread_attr_setschedparam(pthread_attr_t *restrict attr,
                              const struct sched_param *restrict param);
int pthread_attr_getschedparam(const pthread_attr_t *restrict attr,
                              struct sched_param *restrict param);

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

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

تُحفظ معاملات الجدولة في البنية التالية:

    struct sched_param {
        int sched_priority;     /* أولوية الجدولة */
    };

كما هو موضح، يُدعم معامل جدولة واحد فقط. لتفاصيل النطاقات المسموح بها لأولويات الجدولة في كل سياسة جدولة، انظر sched(7).

لكي يصبح إعداد المعامل الذي أجرته pthread_attr_setschedparam() ساري المفعول عند استدعاء pthread_create(3)، يجب على المستدعي استخدام pthread_attr_setinheritsched(3) لضبط سمة وراثة الجدولة لكائن السمات attr إلى PTHREAD_EXPLICIT_SCHED.

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

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

EINVAL
    الأولوية المحددة في param غير منطقية بالنسبة لسياسة الجدولة الحالية لـ attr.

يُوثق POSIX.1 أيضًا خطأ ENOTSUP لـ pthread_attr_setschedparam(). لا تُرجع هذه القيمة أبدًا على Linux (لكن التطبيقات المحمولة والمقاومة للمستقبل يجب أن تعالج قيمة الخطأ هذه على أي حال).

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

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

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

ملاحظات
انظر pthread_attr_setschedpolicy(3) للحصول على قائمة بسياسات جدولة الخيوط المدعومة على Linux.

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

انظر أيضًا
sched_get_priority_min(2), pthread_attr_init(3), pthread_attr_setinheritsched(3), pthread_attr_setschedpolicy(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.