PTHREAD_SETSCHEDPRIO
Section: Linux Programmer's Manual (3)
Updated: 2014-05-28
Index
Return to Main Contents
NAME
pthread_setschedprio - set scheduling priority of a thread
SYNOPSIS
#include <pthread.h>
int pthread_setschedprio(pthread_t thread, int prio);
Compile and link with -pthread.
DESCRIPTION
The
pthread_setschedprio()
function sets the scheduling priority of the thread
thread
to the value specified in
prio.
(By contrast
pthread_setschedparam(3)
changes both the scheduling policy and priority of a thread.)
RETURN VALUE
On success, this function returns 0;
on error, it returns a nonzero error number.
If
pthread_setschedprio()
fails, the scheduling priority of
thread
is not changed.
ERRORS
- EINVAL
-
prio
is not valid for the scheduling policy of the specified thread.
- EPERM
-
The caller does not have appropriate privileges
to set the specified priority.
- ESRCH
-
No thread with the ID
thread
could be found.
POSIX.1-2001 also documents an
ENOTSUP
("attempt was made to set the priority
to an unsupported value") error for
pthread_setschedparam(3).
VERSIONS
This function is available in glibc since version 2.3.4.
ATTRIBUTES
Multithreading (see pthreads(7))
The
pthread_setschedprio()
function is thread-safe.
CONFORMING TO
POSIX.1-2001.
NOTES
For a description of the permissions required to, and the effect of,
changing a thread's scheduling priority,
and details of the permitted ranges for priorities
in each scheduling policy, see
sched(7).
SEE ALSO
getrlimit(2),
sched_get_priority_min(2),
pthread_attr_init(3),
pthread_attr_setinheritsched(3),
pthread_attr_setschedparam(3),
pthread_attr_setschedpolicy(3),
pthread_create(3),
pthread_self(3),
pthread_setschedparam(3),
pthreads(7),
sched(7)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- VERSIONS
-
- ATTRIBUTES
-
- Multithreading (see pthreads(7))
-
- CONFORMING TO
-
- NOTES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 02:55:01 GMT, September 18, 2014