THR_GETPRIO(3C) Standard C Library Functions THR_GETPRIO(3C)

NAME

thr_getprio, thr_setprio - access dynamic thread scheduling

SYNOPSIS

cc -mt [ flag... ] file...[ library... ]
#include <thread.h>

int thr_setprio(thread_t target_thread, int priority);


int thr_getprio(thread_t target_thread, int *priority);

DESCRIPTION

The thr_setprio() function sets the scheduling priority for the thread
specified by target_thread within the current process to the value given
by priority.


The thr_getprio() function stores the current priority for the thread
specified by target_thread in the location pointed to by priority.


If the thr_setprio() function fails, the scheduling priority of the
target thread is not changed.


See priocntl(2), pthread_setschedprio(3C), and sched_setparam(3C).

RETURN VALUES

If successful, the thr_getprio() and thr_setprio() functions return 0.
Otherwise, an error number is returned to indicate the error.

ERRORS

The thr_getprio() and thr_setprio() functions will fail if:

ESRCH
The value specified by target_thread does not refer to an
existing thread.


The thr_setprio() function will fail if:

EINVAL
The value of priority 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.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+

SEE ALSO

priocntl(2), pthread_setschedprio(3C), sched_setparam(3C),
thr_create(3C), thr_suspend(3C), thr_yield(3C), attributes(7),
standards(7)


April 1, 2008 THR_GETPRIO(3C)