pthread_attr_getschedparam Subroutine
Purpose
Returns the value of the schedparam attribute of a thread attributes object.
Library
Threads Library (libpthreads.a)
Syntax
#include <pthread.h>
#include <sys/sched.h>
int pthread_attr_getschedparam (attr, schedparam)
const pthread_attr_t *attr;
struct sched_param *schedparam;Description
The pthread_attr_getschedparam subroutine returns the value of the schedparam attribute of the thread attributes object attr. The schedparam attribute specifies the scheduling parameters of a thread created with this attributes object. The sched_priority field of the sched_param structure contains the priority of the thread. It is an integer value.
Note: The pthread.h header file
must be the first included file of each source file using the threads
library. Otherwise, the -D_THREAD_SAFE compilation flag should
be used, or the cc_r compiler used. In this case, the flag is automatically
set.
Parameters
| Item | Description |
|---|---|
| attr | Specifies the thread attributes object. |
| schedparam | Points to where the schedparam attribute value will be stored. |
Return Values
Upon successful completion, the value of the schedparam attribute is returned via the schedparam parameter, and 0 is returned. Otherwise, an error code is returned.
Error Codes
The pthread_attr_getschedparam subroutine is unsuccessful if the following is true:
| Item | Description |
|---|---|
| EINVAL | The attr parameter is not valid. |
This function does not return EINTR.