.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
-.TH PTHREAD_ATTR_SETINHERITSCHED 3 2012-03-15 "Linux" "Linux Programmer's Manual"
+.TH PTHREAD_ATTR_SETINHERITSCHED 3 2013-04-19 "Linux" "Linux Programmer's Manual"
.SH NAME
pthread_attr_setinheritsched, pthread_attr_getinheritsched \- set/get
-inherit scheduler attribute in thread attributes object
+inherit-scheduler attribute in thread attributes object
.SH SYNOPSIS
.nf
.B #include <pthread.h>
.SH DESCRIPTION
The
.BR pthread_attr_setinheritsched ()
-function sets the inherit scheduler attribute of the
+function sets the inherit-scheduler attribute of the
thread attributes object referred to by
.IR attr
to the value specified in
.IR inheritsched .
-The inherit scheduler attribute determines whether a thread created using
+The inherit-scheduler attribute determines whether a thread created using
the thread attributes object
.I attr
will inherit its scheduling attributes from the calling thread
or whether it will take them from
.IR attr .
+The following scheduling attributes are affected by the
+inherit-scheduler attribute:
+scheduling policy
+.RB ( pthread_attr_setschedpolicy (3)),
+scheduling priority
+.RB ( pthread_attr_setschedparam (3)),
+and contention scope
+.RB ( pthread_attr_setscope (3)).
+
The following values may be specified in
.IR inheritsched :
.TP
by the attributes object.
.\" FIXME what are the defaults for scheduler settings?
.PP
-The default setting of the inherit scheduler attribute in
+The default setting of the inherit-scheduler attribute in
a newly initialized thread attributes object is
.BR PTHREAD_INHERIT_SCHED .
The
.BR pthread_attr_getinheritsched ()
-returns the inherit scheduler attribute of the thread attributes object
+returns the inherit-scheduler attribute of the thread attributes object
.IR attr
in the buffer pointed to by
.IR inheritsched .
then the scheduling policy of the attributes object is set to
.BR SCHED_OTHER
and the scheduling priority is set to 0.
-However, if the inherit scheduler attribute is then set to
+However, if the inherit-scheduler attribute is then set to
.BR PTHREAD_EXPLICIT_SCHED ,
then a thread created using the attribute object
wrongly inherits its scheduling attributes from the creating thread.
.BR pthread_attr_init (3),
.BR pthread_attr_setschedparam (3),
.BR pthread_attr_setschedpolicy (3),
+.BR pthread_attr_setscope (3),
.BR pthread_create (3),
.BR pthread_setschedparam (3),
.BR pthread_setschedprio (3),