pthread_setschedprio
Section: C Library Functions (3)
Updated: 2022-12-15
Index
Return to Main Contents
NAME
pthread_setschedprio - set scheduling priority of a thread
LIBRARY
POSIX threads library
(libpthread, -lpthread)
SYNOPSIS
#include <pthread.h>
int pthread_setschedprio(pthread_t thread, int prio);
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 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 since glibc 2.3.4.
ATTRIBUTES
For an explanation of the terms used in this section, see
attributes(7).
Interface | Attribute | Value
|
pthread_setschedprio()
| Thread safety | MT-Safe
|
STANDARDS
POSIX.1-2001, POSIX.1-2008.
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
-
- LIBRARY
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- VERSIONS
-
- ATTRIBUTES
-
- STANDARDS
-
- NOTES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 05:35:10 GMT, April 27, 2024