Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
Developer Support
QNX Documentation Library
QNX Developer Support

QNX Developer Support

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

[Previous] [Contents] [Index] [Next]

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 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().


[Previous] [Contents] [Index] [Next]