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

1  –  C Binding

    #include <pthread.h>

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

2  –  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() routine for valid policies and their meanings.

 param

    Receives the value of the scheduling parameters for the thread
    specified in thread. Refer to the description of the pthread_
    setschedparam() routine for valid values.

3  –  Description

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

    The priority value returned in the param structure is the value
    specified either in the attr argument passed to pthread_create()
    or by the most recent call to pthread_setschedparam() that
    affects 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.

4  –  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.

5  –  Associated Routines

       pthread_attr_getschedparam()
       pthread_attr_getschedpolicy()
       pthread_create()
       pthread_self()
       pthread_setschedparam()