pthread_getschedparam()
Get a thread's scheduling parameters
Synopsis:
#include <pthread.h>
int pthread_getschedparam(
const pthread_t thread,
int *policy,
struct sched_param *param );
Arguments:
- thread
- The ID of the thread that you want to get the scheduling parameters for. You can get a thread ID by calling pthread_create() or pthread_self() .
- policy
- A pointer to a location where the function can store the scheduling policy, which is one of SCHED_FIFO, SCHED_RR, SCHED_SPORADIC, or SCHED_OTHER. As a QNX extension, you can pass NULL for this argument.
- param
- A pointer to a sched_param structure where the function can store the scheduling parameters.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The pthread_getschedparam() function gets the scheduling policy and associated scheduling parameters of thread thread and places them in the locations that policy and param point to.
As a QNX extension, policy can be NULL, in which case the function doesn't try to store the scheduling policy.
In order to get the scheduling policy for a process whose real or saved user ID is different from
the calling process's real or effective user ID, your process must have the
PROCMGR_AID_SCHEDULE ability enabled.
For more information, see
procmgr_ability()
.
Returns:
- EOK
- Success.
- EFAULT
- A fault occurred trying to access the buffers provided.
- EPERM
- The calling process doesn't have the required permission; see procmgr_ability() .
- ESRCH
- Invalid thread ID thread.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | No |
| Signal handler | Yes |
| Thread | Yes |