PTHREAD_ATTR_GETSCHEDPOLICY(3C)PTHREAD_ATTR_GETSCHEDPOLICY(3C)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_getsched‐
policy(), 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(5) for descriptions of the following attributes:
┌────────────────────┬───────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼───────────────────┤
│Interface Stability │ Committed │
├────────────────────┼───────────────────┤
│MT-Level │ MT-Safe │
├────────────────────┼───────────────────┤
│Standard │ See standards(5). │
└────────────────────┴───────────────────┘
SEE ALSOpthread_attr_init(3C), pthread_attr_setscope(3C), pthread_attr_set‐
inheritsched(3C), pthread_attr_setschedparam(3C), pthread_create(3C),
pthread_getschedparam(3C), sched.h(3HEAD), sched_getscheduler(3C),
attributes(5), standards(5)
Apr 1, 2008 PTHREAD_ATTR_GETSCHEDPOLICY(3C)