pthread_getschedparam

Obtains the current scheduling policy and scheduling parameters of a thread.

Syntax

pthread_getschedparam(
                      thread,
                      policy,
                      param );
 



Argument         Data Type               Access

thread           opaque pthread_t        read

policy           integer                 write

param            struct sched_param      write

C Binding

#include 


int
pthread_getschedparam (
         pthread_t   thread,
         int   *policy,
         struct sched_param   *param);

Arguments

thread: Thread whose scheduling policy and parameters are obtained.
policy: Receives the value of the scheduling policy for the thread specified in thread. Refer to the description of the pthread_setschedparam function for valid parameters and their values.
param: Receives the value of the scheduling parameters for the thread specified in thread. Refer to the description of the pthread_setschedparam function for valid values.

Description

This routine obtains both the current scheduling policy and associated scheduling parameters of the thread specified by thread.

The priority value returned in the param structure is the value specified in attr at pthread_create or by the most recent pthread_setschedparam call affecting the target thread.

This routine differs from pthread_attr_getschedpolicy and pthread_attr_getschedparam, in that those routines get the scheduling policy and parameter attributes that are used to establish the priority and scheduling policy of a new thread when it is created. This routine, however, obtains the scheduling policy and parameters of an existing thread.

Return Values

If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows:

Return Description

0 Successful completion. [ESRCH] The value specified by thread does not refer to an existing thread.

Associated Routines

   pthread_create
   pthread_self
   pthread_attr_getschedpolicy
   pthread_attr_getschedparam
   pthread_setschedparam