pthread_attr_setsched

Changes the scheduling policy attribute of thread creation.

Syntax

pthread_attr_setsched(
                      attr,
                      scheduler );
 



Argument         Data Type               Access

attr             opaque pthread_attr_t   read

scheduler        integer                 read

C Binding

int
pthread_attr_setsched (
pthread_attr_t *attr,
int scheduler);

Arguments

attr

Threads attributes object modified.

scheduler

New value for the scheduling policy attribute. (Policies listed on the same line are equivalent.) Valid values are as follows:

   SCHED_FIFO
   SCHED_RR
   SCHED_FG_NP or SCHED_OTHER
   SCHED_BG_NP

See Section 2.2.3.2 for a description of the scheduling policies.

Description

This routine sets the scheduling policy of a thread that is created using the attributes object specified by the attr argument. The default value of the scheduling attribute is SCHED_ OTHER.

By default, a created thread inherits the priority of the thread calling pthread_create. To specify a priority using this routine, scheduling inheritance must be disabled at the time the thread is created. Call pthread_attr_setinheritsched and specify the value PTHREAD_DEFAULT_SCHED for the inherit argument before calling pthread_create.

Return Values

If an error condition occurs, this routine returns -1 and sets errno to the corresponding error value. Possible return values are as follows:

---

Return  Error         Description

0                     Successful completion.

-1      [EINVAL]      The value specified by scheduler is
                      invalid.

---

---

---