pthread_getschedparam(3T)pthread_getschedparam(3T)NAMEpthread_getschedparam(), pthread_setschedparam() - get or set the
scheduling policy and associated parameters
SYNOPSISPARAMETERS
thread The thread whose scheduling policy and associated
parameters are to be set/retrieved.
policy This parameter either points to the memory location
where the scheduling policy of thread is returned (get
function) or it specifies the new value of the sched‐
uling policy for thread (set function).
param This parameter either points to the memory location
where the scheduling parameters of thread are returned
(get function) or it specifies the new scheduling
parameters for thread (set function).
DESCRIPTION
These functions allow the scheduling policy and associated parameters
of threads within a multithreaded process to be retrieved and changed.
The legal values for the scheduling policy and associated scheduling
parameters are defined in
changes the scheduling policy and associated scheduling parameters for
thread to the policy and the associated parameters provided in policy
and param, respectively. On HP-UX, appropriate privileges are required
to change the scheduling parameters of a thread. The calling process
must have appropriate privileges or be a member of a group having
access to successfully call
The function retrieves the scheduling policy and associated parameters
for thread and stores those values in policy and param, respectively.
The values returned represent the actual scheduling values, not any
temporary values that may be in effect due to priority inheritance or
priority ceiling features.
Notes
For the and scheduling policies, only the sched_priority member of the
structure is required in the associated scheduling parameters. All
other scheduling policies have implementation-defined scheduling poli‐
cies. Refer to the documentation for rtsched(2) and for further infor‐
mation on implementation-defined scheduling policies.
RETURN VALUE
Upon successful completion, and return zero. Otherwise, an error num‐
ber is returned to indicate the error (the variable is not set).
ERRORS
If any of the following occur, the and functions return the correspond‐
ing error number:
is not defined and these functions are not supported.
For each of the following conditions, if the condition is detected, the
function returns the corresponding error number:
policy or one of the scheduling parameters in param is
invalid.
Either the policy or scheduling parameters contain an
unsupported value.
The caller does not have permission to set either the
scheduling policy specified in policy or the
scheduling parameters specified in param for
thread.
No thread could be found corresponding to
thread.
For each of the following conditions, if the condition is detected, the
function returns the corresponding error number:
No thread could be found corresponding to
thread.
The value specified by
policy or param is invalid.
AUTHOR
and were derived from the IEEE POSIX P1003.1c standard.
SEE ALSOpthread_attr_setschedparam(3T), pthread_attr_setschedpolicy(3T),
pthread_attr_getschedparam(3T), pthread_attr_getschedpolicy(3T),
rtsched(2).
STANDARDS CONFORMANCE
Pthread Library pthread_getschedparam(3T)