sched_setparam(2)

الاسم
sched_setparam, sched_getparam - ضبط وجلب وسائط الجدولة

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

موجز
#include <sched.h>

int sched_setparam(pid_t pid, const struct sched_param *param);
int sched_getparam(pid_t pid, struct sched_param *param);

struct sched_param {
    ...
    int sched_priority;
    ...
};

الوصف
تضبط sched_setparam() وسائط الجدولة المرتبطة بسياسة الجدولة للخيط الذي يُحدد معرف الخيط الخاص به في pid. إذا كان pid صفرًا، فتُضبط وسائط الخيط المستدعي. يعتمد تفسير الوسيط param على سياسة الجدولة للخيط المُحدد بواسطة pid. انظر sched(7) لوصف سياسات الجدولة المدعومة تحت لينكس.

تسترجع sched_getparam() وسائط الجدولة للخيط المُحدد بواسطة pid. إذا كان pid صفرًا، فتُسترجع وسائط الخيط المستدعي.

تتحقق sched_setparam() من صحة param لسياسة الجدولة للخيط. يجب أن تقع القيمة param->sched_priority ضمن النطاق المُعطى بواسطة sched_get_priority_min(2) وsched_get_priority_max(2).

لمناقشة الامتيازات وحدود الموارد المتعلقة بأولوية وسياسة الجدولة، انظر sched(7).

تعرف أنظمة POSIX التي تتوفر فيها sched_setparam() وsched_getparam() الثابت _POSIX_PRIORITY_SCHEDULING في <unistd.h>.

قيمة الإرجاع
عند النجاح، تُرجع sched_setparam() وsched_getparam() القيمة 0. عند الخطأ، تُرجع القيمة -1، ويُضبط errno للإشارة إلى الخطأ.

الأخطاء

EINVAL
    وسائط غير صالحة: param هو NULL أو pid سالب

EINVAL
    (sched_setparam()) الوسيط param لا معنى له لسياسة الجدولة الحالية.

EPERM
    (sched_setparam()) لا يمتلك المستدعي الامتيازات المناسبة (لينكس: لا يمتلك القدرة CAP_SYS_NICE).

ESRCH
    تعذر العثور على الخيط (thread) الذي معرفه pid.

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

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

انظر أيضًا
getpriority(2), gettid(2), nice(2), sched_get_priority_max(2), sched_get_priority_min(2), sched_getaffinity(2), sched_getscheduler(2), sched_setaffinity(2), sched_setattr(2), sched_setscheduler(2), setpriority(2), capabilities(7), sched(7)

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

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

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