Manual Page Result
0
Command: pthread_attr_setinheritsched | Section: 3 | Source: Digital UNIX | File: pthread_attr_setinheritsched.3.gz
pthread_at...heritsched(3) Library Functions Manual pthread_at...heritsched(3)
NAME
pthread_attr_setinheritsched - Changes the inherit scheduling attribute
of the specified thread attributes object.
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
SYNOPSIS
#include <pthread.h>
int pthread_attr_setinheritsched(
pthread_attr_t *attr,
int inheritsched);
STANDARDS
Interfaces documented on this reference page conform to industry stan-
dards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
PARAMETERS
Thread attributes object whose inherit scheduling attribute is to be
modified. New value for the inherit scheduling attribute. Valid val-
ues are as follows: The created thread inherits the scheduling policy
and associated scheduling attributes of the thread calling pthread_cre-
ate(3). Any scheduling attributes in the attributes object specified
by the pthread_create(3) attr argument are ignored during thread cre-
ation. This is the default value. The scheduling policy and associ-
ated scheduling attributes of the created thread are set to the corre-
sponding values from the attribute object specified by the pthread_cre-
ate(3) attr argument.
DESCRIPTION
This routine changes the inherit scheduling attribute of the thread at-
tributes object specified by the attr argument. The inherit scheduling
attribute specifies whether a thread created using the specified at-
tributes object inherits the scheduling attributes of the creating
thread, or uses the scheduling attributes stored in the attributes ob-
ject specified by the pthread_create(3) attr argument.
The first thread in an application has a scheduling policy of
SCHED_OTHER. See the pthread_attr_setschedparam(3) and
pthread_attr_setschedpolicy(3) routines for more information on valid
priority values and valid scheduling policy values, respectively.
Inheriting scheduling attributes (instead of using the scheduling at-
tributes stored in the attributes object) is useful when a thread is
creating several helper threads--that is, threads that are intended to
work closely with the creating thread to cooperatively solve the same
problem. For example, inherited scheduling attributes ensure that
helper threads created in a sort routine execute with the same priority
as the calling thread.
RETURN VALUES
If an error condition occurs, this routine returns an integer value in-
dicating the type of error. Possible return values are as follows:
Successful completion. One or both of the values specified by inherit
and attr are invalid. An attempt was made to set the attribute to an
unsupported value.
ERRORS
None
RELATED INFORMATION
Functions: pthread_attr_init(3), pthread_attr_getinheritsched(3),
pthread_attr_setschedpolicy(3), pthread_attr_setschedparam(3),
pthread_create(3)
Manuals: Guide to DECthreads and Programmer's Guide
delim off
pthread_at...heritsched(3)