thr_setprio(3scl)thr_setprio(3scl)NAMEthr_setprio - Sets the priority for the specified thread.
LIBRARY
SCL Threads Library (libthread.so)
SYNOPSIS
#include <thread.h>
int thr_setprio(
thread_t thread_id,
int priority );
PARAMETERS
Identifier of the thread for which the priority is to be set. The
specified thread's new priority.
DESCRIPTION
This routine sets the priority of the specified thread.
SCL IMPLEMENTATION NOTES
POSIX threads has no equivalent of thread priority. The POSIX thread
library manages thread scheduling.
The SCL thread library maintains a priority value for each thread, but
this value does not affect the scheduling of the thread.
When a thread is created, the SCL thread library sets its priority to
0. If the thread's priority is modifed by calls to thr_setprio(3scl),
SCL updates the thread's priority, such that subsequent calls to
thr_getprio(3scl) get the appropriate value.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error.
Additional error return information may be written to the SCL error
log. Refer to scl_error_log(4scl) for details.
Possible return values are as follows: Successful completion. The
value specified by thread_id does not refer to an existing thread. The
value of priority makes no sense for the scheduling class associated
with the target_thread. [Note: the SCL thread library has no awareness
of scheduling classes, and thus does not return this error value].
ERRORS
None.
RELATED INFORMATION
Functions: scl_intro(3scl), scl_thread_intro(3scl), thr_getprio(3scl)
Files: scl_error_log(4scl)
Manuals: Solaris Compatibility Libraries User's Guide
thr_setprio(3scl)