pthread_attr_setschedpolicy

Changes the scheduling policy attribute of the specified thread attributes object.

Syntax

pthread_attr_setschedpolicy(
                            attr,
                            policy );
 



Argument         Data Type               Access

attr             opaque pthread_attr_t   write

policy           integer                 read

C Binding

#include 


int
pthread_attr_setschedpolicy (
         pthread_attr_t   *attr,
         int   policy);

Arguments

attr

Thread attributes object to be modified.

policy

New value for the scheduling policy attribute. Valid values are as follows:

   SCHED_BG_NP
   SCHED_FG_NP (also known as SCHED_OTHER)
   SCHED_FIFO
   SCHED_RR

SCHED_OTHER is the default value. 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_EXPLICIT_SCHED for the inherit argument before calling pthread_create.

Never attempt to use scheduling as a mechanism for synchronization. (Refer to Chapter 1 and Chapter 2.)

Return Values

If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows:

---

Return        Description

0             Successful completion.

[EINVAL]      The value specified by policy is invalid.

---

Associated Routines

   pthread_attr_init
   pthread_attr_getschedpolicy
   pthread_attr_setinheritsched
   pthread_attr_setschedparam
   pthread_create

---

---

---