thr_getscheduler(3thread)
thr_getscheduler --
get the scheduling policy information for a thread
Synopsis
cc [options] -Kthread file
#include <thread.h>
int thr_getscheduler(thread_t tid, sched_param_t *param);
Description
thr_getscheduler sets the sched_param_t pointed to by
param to the policy-specific parameters for tid.
tid parameter
tid is the ID of the thread whose scheduling policy information
thr_getscheduler will retrieve.
Parameters
- tid
-
a thread ID
- param
-
a pointer to a sched_param_t
structure containing the policy-specific parameters
(set by thr_getscheduler)
param parameter
param points to a sched_param_t structure
in which thr_getscheduler will store
tid's scheduling policy and parameters.
sched_param_t is defined as follows:
struct {
id_t policy;
long policy_params[POLICY_PARAM_SZ];
} sched_param_t;
See
thr_setscheduler(3thread)
for the available scheduling policies
and parameters.
Security restrictions
No privileges or special permissions are required to use
thr_getscheduler.
Usage
thr_getscheduler is
used by multithreaded applications which
need to control their scheduling.
Return values
thr_getscheduler returns zero for success
and an error number for failure, as described below.
Errors
If the following condition is detected,
thr_getscheduler fails and
returns the corresponding value:
- ESRCH
-
No thread can be found in the current process with identity tid.
- EINVAL
-
param is null.
References
Intro(3thread),
priocntl(2),
thr_getprio(3thread),
thr_setprio(3thread),
thr_setscheduler(3thread),
thr_yield(3thread)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.