Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Threads Library Functionsthr_getprio(3THR)


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 dynamically changes the priority of the thread specified by target_thread within the current process to the priority specified by priority. By default, threads contend for synchronization objects based on fixed priorities that range from 0, the least significant, to 127. The target_thread will receive precedence by libthread over lower priority threads with respect to synchronization object contention.

The thr_getprio() function stores the current priority for the thread specified by target_thread in the location pointed to by priority. Thread priorities regulate the order in which threads unblock from synchronization objects and are different from realtime priorities, which regulate and enforce access to CPU resources. Programs that need access to "real" priorities should use bound threads in the realtime class (see priocntl(2)).

RETURN VALUES

 

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

ERRORS

 

For each of the following conditions, these functions return an error number if the condition is detected.

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

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

EINVAL
The value of priority makes no sense for the scheduling class associated with the target_thread.

ATTRIBUTES

 

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

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

SEE ALSO

 

priocntl(2), sched_setparam(3RT), thr_create(3THR), thr_suspend(3THR), thr_yield(3THR), attributes(5), standards(5)


SunOS 5.9Go To TopLast Changed 22 Mar 2001

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.