pthread_attr_setinheritsched(3) 			     Library Functions Manual				   pthread_attr_setinheritsched(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 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 val-
       ues 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 schedul-
       ing 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 pri-
       ority 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.  The value specified by the attr argument is not a valid thread attributes object, or the inheritsched argument con-
       tains an invalid value.	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_attr_setinheritsched(3)