PTHREAD_ATTR_GETSCHEDPOLICY(3C) Standard C Library Functions

NAME

pthread_attr_getschedpolicy, pthread_attr_setschedpolicy - get or set
schedpolicy attribute

SYNOPSIS

cc -mt [ flag... ] file... -lpthread [ library... ]
#include <pthread.h>

int pthread_attr_getschedpolicy(const pthread_attr_t *restrict attr,
int *restrict policy);


int pthread_attr_setschedpolicy(pthread_attr_t *attr, int policy);

DESCRIPTION

The functions pthread_attr_setschedpolicy() and
pthread_attr_getschedpolicy(), respectively, set and get the schedpolicy
attribute in the attr argument.


Supported values of policy include SCHED_FIFO, SCHED_RR and SCHED_OTHER,
which are defined by the header <sched.h>. When threads executing with
the scheduling policy SCHED_FIFO or SCHED_RR are waiting on a mutex, they
acquire the mutex in priority order when the mutex is unlocked.


See sched.h(3HEAD) for a description of all defined policy values. Valid
policy values can also be obtained from pthread_getschedparam(3C) and
sched_getscheduler(3C).

RETURN VALUES

If successful, the pthread_attr_setschedpolicy() and
pthread_attr_getschedpolicy() functions return 0. Otherwise, an error
number is returned to indicate the error.

ERRORS

The pthread_attr_setschedpolicy() or pthread_attr_getschedpolicy()
function may fail if:

EINVAL
attr or policy is invalid.

USAGE

After these attributes have been set, a thread can be created with the
specified attributes using pthread_create(). Using these routines does
not affect the current running thread.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------+
|Interface Stability | Committed |
+--------------------+-------------------+
|MT-Level | MT-Safe |
+--------------------+-------------------+
|Standard | See standards(7). |
+--------------------+-------------------+

SEE ALSO

pthread_attr_init(3C), pthread_attr_setinheritsched(3C),
pthread_attr_setschedparam(3C), pthread_attr_setscope(3C),
pthread_create(3C), pthread_getschedparam(3C), sched_getscheduler(3C),
sched.h(3HEAD), attributes(7), standards(7)

April 1, 2008 PTHREAD_ATTR_GETSCHEDPOLICY(3C)