pthread_setschedprio(3C) Standard C Library Functions pthread_setschedprio(3C)NAME
pthread_setschedprio - dynamic thread scheduling parameters access
SYNOPSIS
cc -mt [ flag... ] file... -lpthread [ library... ]
#include <pthread.h>
int pthread_setschedprio(pthread_t thread, int prio);
DESCRIPTION
The pthread_setschedprio() function sets the scheduling priority for the thread whose thread ID is given by thread to the value given by
prio.
If the pthread_setschedprio() function fails, the scheduling priority of the target thread is not changed.
RETURN VALUES
If successful, the pthread_setschedprio() function returns 0; otherwise, an error number is returned to indicate the error.
ERRORS
The pthread_setschedprio() function will fail if:
EINVAL The value of prio is invalid for the scheduling policy of the specified thread.
EPERM The caller does not have the appropriate permission to set the priority to the value specified.
ESRCH The value specified by thread does not refer to an existing thread.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Committed |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
|Standard |See standards(5). |
+-----------------------------+-----------------------------+
SEE ALSO pthread_getschedparam(3C), attributes(5), standards(5)SunOS 5.11 1 Apr 2008 pthread_setschedprio(3C)
Check Out this Related Man Page
PTHREAD_SETSCHEDPRIO(3) Linux Programmer's Manual PTHREAD_SETSCHEDPRIO(3)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 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
For an explanation of the terms used in this section, see attributes(7).
+-----------------------+---------------+---------+
|Interface | Attribute | Value |
+-----------------------+---------------+---------+
|pthread_setschedprio() | Thread safety | MT-Safe |
+-----------------------+---------------+---------+
CONFORMING TO
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)COLOPHON
This page is part of release 4.15 of the Linux man-pages project. A description of the project, information about reporting bugs, and the
latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.
Linux 2015-08-08 PTHREAD_SETSCHEDPRIO(3)