Content-type: text/html Man page of pthread_attr_setinheritsched

pthread_attr_setinheritsched

Section: C Library Functions (3)
Index Return to Main Contents
 

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 standards 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 values are as follows: The created thread inherits the scheduling policy and associated scheduling attributes of the thread calling pthread_create(3). Any scheduling attributes in the attributes object specified by the pthread_create(3) attr argument are ignored during thread creation. This is the default value. The scheduling policy and associated scheduling attributes of the created thread are set to the corresponding values from the attribute object specified by the pthread_create(3) attr argument.  

DESCRIPTION

This routine changes the inherit scheduling attribute of the thread attributes object specified by the attr argument. The inherit scheduling attribute specifies whether a thread created using the specified attributes object inherits the scheduling attributes of the creating thread, or uses the scheduling attributes stored in the attributes object 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 attributes 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 indicating 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


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:08 GMT, October 02, 2010