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(7) for descriptions of the following attributes:


+--------------------+-------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------+
|Interface Stability | Committed |
+--------------------+-------------------+
|MT-Level | MT-Safe |
+--------------------+-------------------+
|Standard | See standards(7). |
+--------------------+-------------------+

SEE ALSO

pthread_getschedparam(3C), attributes(7), standards(7)


April 1, 2008 PTHREAD_SETSCHEDPRIO(3C)