pthread_attr_setinheritsched Subroutine



Purpose

Sets the value of the inheritsched attribute of a thread attributes
object.

Library

Threads Library (libpthreads.a)

Syntax

#include <pthread.h>

int pthread_attr_setinheritsched (attr, inheritsched)
pthread_attr_t *attr;
int inheritsched;

Description

The pthread_attr_setinheritsched subroutine sets the value of the
inheritsched attribute of the thread attributes object attr. This
attribute specifies the inheritance of scheduling properties for a
thread created with this attributes object.

Note:	The pthread.h header file must be the first included file of
each source file using the threads library.

Parameters

attr	Specifies the thread attributes object.

inheritsched	Specifies the inheritance of scheduling properties to
set. It must have one of the following values:

PTHREAD_EXPLICIT_SCHED	Specifies that the thread will take the scheduling
properties specified in its attribute object.

PTHREAD_INHERIT_SCHED	Specifies that the thread will inherit the scheduling
properties from its creating thread. This is the default value.

Return Values

Upon successful completion, 0 is returned. Otherwise, an error code
is returned.

Error Codes

The pthread_attr_setinheritsched subroutine is unsuccessful if the
following is true:

EINVAL	The attr parameter is not valid.

ENOSYS	The priority scheduling POSIX option is not implemented.

ENOTSUP	The value of the inheritsched parameter is not supported.

Implementation Specifics

This subroutine is part of the Base Operating System (BOS) Runtime.

The implementation of this subroutine is dependent on the priority
scheduling POSIX option. The priority scheduling POSIX option is implemented
in AIX.

Related Information

The pthread_attr_getinheritsched subroutine, pthread_attr_init subroutine,
pthread_create subroutine.

Threads Scheduling.

Threads Library Options and Threads Library Quick Reference.