NAME
pthread_setschedparam
,
pthread_getschedparam
—
thread scheduling parameter
manipulation
LIBRARY
library “libpthread”
SYNOPSIS
#include
<pthread.h>
int
pthread_setschedparam
(pthread_t
thread, int policy,
const struct sched_param
*param);
int
pthread_getschedparam
(pthread_t
thread, int * restrict
policy, struct
sched_param * restrict param);
DESCRIPTION
Thepthread_setschedparam
()
and
pthread_getschedparam
()
functions set and get the scheduling parameters of individual threads. The
scheduling policy for a thread can be:
SCHED_FIFO
- First in, first out.
SCHED_RR
- Round-robin.
SCHED_OTHER
- The system default.
The thread priority (accessed via
param->sched_priority) must be at least
PTHREAD_MIN_PRIORITY
and no more than
PTHREAD_MAX_PRIORITY
.
RETURN VALUES
If successful, these functions return 0. Otherwise, an error number is returned to indicate the error.
ERRORS
pthread_setschedparam
() may fail if:
- [
EINVAL
] - The value specified by policy is invalid.
- [
ENOTSUP
] - Invalid value for scheduling parameters.
- [
ESRCH
] - Non-existent thread thread.
pthread_getschedparam
() may fail if:
- [
ESRCH
] - Non-existent thread thread.
SEE ALSO
STANDARDS
Both functions conform to IEEE Std 1003.1-2001 (“POSIX.1”).