pthread_getschedparam()

Synopsis:

#include <pthread.h>

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

Since:

BlackBerry 10.0.0

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 BlackBerry 10 OS 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 BlackBerry 10 OS extension, policy can be NULL, in which case the function doesn't try to store the scheduling policy.

Note: 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:

POSIX 1003.1 THR TPS

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes