thr_getprio(3thread)                            thr_getprio(3thread)


       NAME
             thr_getprio - retrieve a thread's scheduling priority

       SYNOPSIS
             cc [options] -Kthread file
             #include <thread.h>
             int thr_getprio(thread_t tid, int *prio);

          Parameters
             tid   target thread ID

             prio  pointer to priority value (set by thr_getprio)

       DESCRIPTION
             thr_getprio stores tid's scheduling priority in the location
             pointed to by prio.  thr_getscheduler can also be used to
             retrieve the priority of a thread, but thr_getprio is a
             shorthand for use when only the priority, not the scheduling
             class, is needed.

          Security Restrictions
             No privileges or special permissions are required to use
             thr_getprio.

          Return Values
             thr_getprio returns zero for success and an error number for
             failure, as described below.

          Errors
             If any of the following error conditions is detected,
             thr_getprio returns the corresponding value:

             ESRCH    No thread with identifier tid can be found in the
                      process.

       REFERENCES
             priocntl(2), thr_getscheduler(3thread), thr_setprio(3thread),
             thr_setscheduler(3thread), thr_yield(3thread), thread(3thread)










                           Copyright 1994 Novell, Inc.               Page 1