Movatterモバイル変換

pthread_attr_getinheritsched(3p) — Linux manual page

PTHREAD_...RITSCHED(3P) POSIX Programmer's ManualPTHREAD_...RITSCHED(3P)

PROLOG        top

       This manual page is part of the POSIX Programmer's Manual.  The       Linux implementation of this interface may differ (consult the       corresponding Linux manual page for details of Linux behavior), or       the interface may not be implemented on Linux.

NAME        top

       pthread_attr_getinheritsched, pthread_attr_setinheritsched — get       and set the inheritsched attribute (REALTIME THREADS)

SYNOPSIS        top

       #include <pthread.h>       int pthread_attr_getinheritsched(const pthread_attr_t *restrictattr,           int *restrictinheritsched);       int pthread_attr_setinheritsched(pthread_attr_t *attr,           intinheritsched);

DESCRIPTION        top

       Thepthread_attr_getinheritsched() andpthread_attr_setinheritsched() functions, respectively, shall get       and set theinheritsched attribute in theattr argument.       When the attributes objects are used bypthread_create(), theinheritsched attribute determines how the other scheduling       attributes of the created thread shall be set.       The supported values ofinheritsched shall be:       PTHREAD_INHERIT_SCHED             Specifies that the thread scheduling attributes shall be             inherited from the creating thread, and the scheduling             attributes in thisattr argument shall be ignored.       PTHREAD_EXPLICIT_SCHED             Specifies that the thread scheduling attributes shall be set             to the corresponding values from this attributes object.       The symbols PTHREAD_INHERIT_SCHED and PTHREAD_EXPLICIT_SCHED are       defined in the<pthread.h> header.       The following thread scheduling attributes defined by POSIX.1‐2008       are affected by theinheritsched attribute: scheduling policy       (schedpolicy), scheduling parameters (schedparam), and scheduling       contention scope (contentionscope).       The behavior is undefined if the value specified by theattr       argument topthread_attr_getinheritsched() orpthread_attr_setinheritsched() does not refer to an initialized       thread attributes object.

RETURN VALUE        top

       If successful, thepthread_attr_getinheritsched() andpthread_attr_setinheritsched() functions shall return zero;       otherwise, an error number shall be returned to indicate the       error.

ERRORS        top

       Thepthread_attr_setinheritsched() function shall fail if:ENOTSUP              An attempt was made to set the attribute to an unsupported              value.       Thepthread_attr_setinheritsched() function may fail if:EINVALThe value ofinheritsched is not valid.       These functions shall not return an error code of[EINTR].The following sections are informative.

EXAMPLES        top

       None.

APPLICATION USAGE        top

       After these attributes have been set, a thread can be created with       the specified attributes usingpthread_create().  Using these       routines does not affect the current running thread.       SeeSection 2.9.4,Thread Scheduling for further details on thread       scheduling attributes and their default settings.

RATIONALE        top

       If an implementation detects that the value specified by theattr       argument topthread_attr_getinheritsched() orpthread_attr_setinheritsched() does not refer to an initialized       thread attributes object, it is recommended that the function       should fail and report an[EINVAL]error.

FUTURE DIRECTIONS        top

       None.

SEE ALSO        top

pthread_attr_destroy(3p),pthread_attr_getscope(3p),pthread_attr_getschedpolicy(3p),pthread_attr_getschedparam(3p),pthread_create(3p)       The   Base  Definitions  volume  of  POSIX.1‐2017,pthread.h(0p),sched.h(0p)

COPYRIGHT        top

       Portions of this text are reprinted and reproduced  in  electronic       form   from   IEEE   Std  1003.1-2017,  Standard  for  Information       Technology -- Portable Operating  System  Interface  (POSIX),  The       Open  Group  Base  Specifications Issue 7, 2018 Edition, Copyright       (C) 2018 by the Institute of Electrical and Electronics Engineers,       Inc and The Open Group.  In the event of any  discrepancy  between       this  version  and  the original IEEE and The Open Group Standard,       the original IEEE and The  Open  Group  Standard  is  the  referee       document.   The  original  Standard  can  be  obtained  online  athttp://www.opengroup.org/unix/online.html .       Any typographical or formatting errors that appear  in  this  page       are  most  likely to have been introduced during the conversion of       the source files to man page format. To report  such  errors,  seehttps://www.kernel.org/doc/man-pages/reporting_bugs.html .IEEE/The Open Group                2017PTHREAD_...RITSCHED(3P)

Pages that refer to this page:pthread.h(0p), pthread_attr_getschedparam(3p), pthread_attr_getschedpolicy(3p), pthread_attr_getscope(3p), pthread_attr_setinheritsched(3p)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.