Index Index for
Section 3
Index Alphabetical
listing for P
Bottom of page Bottom of
page		 

pthread_attr_setinheritsched(3)


NAME

  pthread_attr_setinheritsched - Changes the inherit scheduling attribute of
  the specified thread attributes object


SYNOPSIS

  #include <pthread.h>

  int pthread_attr_setinheritsched(
	  pthread_attr_t *attr,
	  int inheritsched );


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

  attr
      Thread attributes object whose inherit scheduling attribute is to be
      modified.

  inheritsched
      New value for the inherit scheduling attribute. Valid values are as
      follows:

      PTHREAD_INHERIT_SCHED
	      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.

      PTHREAD_EXPLICIT_SCHED
	      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:

  0   Successful completion.

  [EINVAL]
      The value specified by the attr argument is not a valid thread
      attributes object, or the inheritsched argument contains an invalid
      value.

  [ENOTSUP]
      An attempt was made to set the attribute to an unsupported value.


ERRORS

  None


SEE ALSO

  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

Index Index for
Section 3
Index Alphabetical
listing for P
Top of page Top of
page