Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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:

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 algorithms in the chapter on the Neutrino microkernel in the System Architecture guide.

Returns:

EOK
Success.
EINVAL
Invalid thread attribute object attr.
ENOTSUP
Invalid thread scheduling policy policy.

Classification:

POSIX 1003.1 THR TPS

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

See also:

pthread_attr_getschedpolicy(), pthread_attr_init(), pthread_create().

Thread scheduling in the QNX Neutrino Microkernel chapter of the System Architecture guide

Scheduling algorithms in the Programming Overview chapter of the QNX Neutrino Programmer's Guide

Processes and Threads chapter of Getting Started with QNX Neutrino