pthread_attr_setschedpolicy()

Set the thread scheduling policy attribute

Synopsis:

#include <pthread.h>
#include <sched.h>

int pthread_attr_setschedpolicy(
                 pthread_attr_t* attr,
                 int policy );

Arguments:

attr
A pointer to the pthread_attr_t structure that defines the attributes to use when creating new threads. For more information, see pthread_attr_init().
policy
The new value for the scheduling policy:
  • SCHED_FIFO — first-in first-out scheduling.
  • SCHED_RR — round-robin scheduling.
  • SCHED_OTHER — currently the same as SCHED_RR.
  • SCHED_NOCHANGE — don't change the policy.
  • SCHED_SPORADIC — sporadic scheduling.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pthread_attr_setschedpolicy() function sets the thread scheduling policy attribute in the thread attribute object attr to policy.

The policy attribute is used only if you've set the thread inherit-scheduling attribute to PTHREAD_EXPLICIT_SCHED by calling pthread_attr_setinheritsched().

For descriptions of the scheduling policies, see Scheduling policies in the chapter on the microkernel in the System Architecture guide.

Returns:

EOK
Success.
EINVAL
Invalid thread-scheduling policy policy.

Classification:

POSIX 1003.1 TPS

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