NAME
pthread_setschedprio() — sets scheduling priority of a thread
SYNOPSIS
#include <pthread.h>
int pthread_setschedprio(pthread_t thread, int prio)
PARAMETERS
- thread
The thread whose scheduling priority is to be set.
- prio
The new priority for the thread.
DESCRIPTION
The
pthread_setschedprio()
function sets the scheduling priority of
thread
to the value
prio.
If the
pthread_setschedprio()
function fails, the scheduling priority of the target thread is not changed.
RETURN VALUE
Upon successful completion,
pthread_setschedprio()
returns zero.
Otherwise, an error number is returned to indicate the error
(the
errno
variable is not set).
ERRORS
If any of the following occur, the
pthread_setschedprio()
function returns the corresponding error number:
- EINVAL
The value of
prio
is invalid for the scheduling policy of the specified
thread.
- EPERM
The implementation does not allow the application to modify the priority
to the value specified.
- ESRCH
No thread could be found corresponding to
thread.
AUTHOR
pthread_setschedprio()
is derived from the IEEE Std 1003.1-2001.
SEE ALSO
rtsched(2),
pthread_attr_setschedparam(3T),
pthread_attr_setschedpolicy(3T),
pthread_attr_getschedparam(3T),
pthread_attr_getschedpolicy(3T),
pthread_setschedparam(3T),
pthread_getschedparam(3T).
STANDARDS CONFORMANCE
pthread_setschedprio(): XPG6.