Movatterモバイル変換

pthread_attr_getschedpolicy(3p) — Linux manual page

PTHREAD...EDPOLICY(3P)  POSIX Programmer's ManualPTHREAD...EDPOLICY(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_getschedpolicy, pthread_attr_setschedpolicy — get and       set the schedpolicy attribute (REALTIME THREADS)

SYNOPSIS        top

       #include <pthread.h>       int pthread_attr_getschedpolicy(const pthread_attr_t *restrictattr,           int *restrictpolicy);       int pthread_attr_setschedpolicy(pthread_attr_t *attr, intpolicy);

DESCRIPTION        top

       Thepthread_attr_getschedpolicy() andpthread_attr_setschedpolicy() functions, respectively, shall get       and set theschedpolicy attribute in theattr argument.       The supported values ofpolicy shall include SCHED_FIFO, SCHED_RR,       and SCHED_OTHER, which are defined in the<sched.h> header. When       threads executing with the scheduling policy SCHED_FIFO, SCHED_RR,       or SCHED_SPORADIC are waiting on a mutex, they shall acquire the       mutex in priority order when the mutex is unlocked.       The behavior is undefined if the value specified by theattr       argument topthread_attr_getschedpolicy() orpthread_attr_setschedpolicy() does not refer to an initialized       thread attributes object.

RETURN VALUE        top

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

ERRORS        top

       Thepthread_attr_setschedpolicy() function shall fail if:ENOTSUP              An attempt was made to set the attribute to an unsupported              value.       Thepthread_attr_setschedpolicy() function may fail if:EINVALThe value ofpolicy 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_getschedpolicy() orpthread_attr_setschedpolicy() 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_getinheritsched(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...EDPOLICY(3P)

Pages that refer to this page:pthread.h(0p), pthread_attr_getinheritsched(3p), pthread_attr_getschedparam(3p), pthread_attr_getscope(3p), pthread_attr_setschedpolicy(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.