pthread_attr_setschedpolicy(3) — Subroutines

NAME

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

SYNOPSIS

#include <pthread.h>
int pthread_attr_setschedpolicy(
pthread_attr_t ∗attr,
int policy );

LIBRARY

DECthreads POSIX 1003.1c Library (libpthread.so)

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.

policy
New 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

Museum

Related Articles