NAME

pthread_attr_setschedpolicy − Changes the scheduling policy attribute of the specified thread attributes object. 

LIBRARY

DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

#include <pthread.h>

int pthread_attr_setschedpolicy(
                  pthread_attr_t  ∗attr,
                  int             policy);

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

IEEE Std 1003.1c-1995, POSIX System Application Program Interface

PARAMETERS

attrThread attributes object to be modified. 

policyNew value for the scheduling policy attribute. Valid values are as follows:

       •SCHED_FIFO, SCHED_RR, SCHED_FG_NP (also known as SCHED_OTHER), SCHED_BG_NP

       •SCHED_OTHER is the default value. 

DESCRIPTION

This routine sets the scheduling policy of a thread that is created using the attributes object specified by the attr argument. The default value of the scheduling attribute is SCHED_OTHER. 

By default, a created thread inherits the priority of the thread calling pthread_create(3).  To specify a policy using this routine, scheduling inheritance must be disabled at the time the thread is created.  Before calling pthread_create(3), call pthread_attr_setinheritsched(3) and specify the value PTHREAD_EXPLICIT_SCHED for the inherit argument. 

Never attempt to use scheduling as a mechanism for synchronization. 

RETURN VALUES

If an error condition occurs, this routine returns an integer value indicating the type of error.  Possible return values are as follows:

0Successful completion. 

[EINVAL]The value specified by policy is invalid. 

ERRORS

None

RELATED INFORMATION

Functions: pthread_attr_init(3), pthread_attr_getschedpolicy(3), pthread_attr_setinheritsched(3), pthread_attr_setschedparam(3), pthread_create(3)

Manuals: Guide to DECthreads and Programmer’s Guide