Movatterモバイル変換

pthread_condattr_destroy(3p) — Linux manual page

PTHREAD_..._DESTROY(3P) POSIX Programmer's ManualPTHREAD_..._DESTROY(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_condattr_destroy, pthread_condattr_init — destroy and       initialize the condition variable attributes object

SYNOPSIS        top

       #include <pthread.h>       int pthread_condattr_destroy(pthread_condattr_t *attr);       int pthread_condattr_init(pthread_condattr_t *attr);

DESCRIPTION        top

       Thepthread_condattr_destroy() function shall destroy a condition       variable attributes object; the object becomes, in effect,       uninitialized. An implementation may causepthread_condattr_destroy() to set the object referenced byattr to       an invalid value. A destroyedattr attributes object can be       reinitialized usingpthread_condattr_init(); the results of       otherwise referencing the object after it has been destroyed are       undefined.       Thepthread_condattr_init() function shall initialize a condition       variable attributes objectattr with the default value for all of       the attributes defined by the implementation.       Results are undefined ifpthread_condattr_init() is called       specifying an already initializedattr attributes object.       After a condition variable attributes object has been used to       initialize one or more condition variables, any function affecting       the attributes object (including destruction) shall not affect any       previously initialized condition variables.       This volume of POSIX.1‐2017 requires two attributes, theclock       attribute and theprocess-shared attribute.       Additional attributes, their default values, and the names of the       associated functions to get and set those attribute values are       implementation-defined.       The behavior is undefined if the value specified by theattr       argument topthread_condattr_destroy() does not refer to an       initialized condition variable attributes object.

RETURN VALUE        top

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

ERRORS        top

       Thepthread_condattr_init() function shall fail if:ENOMEMInsufficient memory exists to initialize the condition              variable attributes object.       These functions shall not return an error code of[EINTR].The following sections are informative.

EXAMPLES        top

       None.

APPLICATION USAGE        top

       None.

RATIONALE        top

       Aprocess-shared attribute has been defined for condition       variables for the same reason it has been defined for mutexes.       If an implementation detects that the value specified by theattr       argument topthread_condattr_destroy() does not refer to an       initialized condition variable attributes object, it is       recommended that the function should fail and report an[EINVAL]       error.       See alsopthread_attr_destroy(3p) andpthread_mutex_destroy(3p).

FUTURE DIRECTIONS        top

       None.

SEE ALSO        top

pthread_attr_destroy(3p),pthread_cond_destroy(3p),pthread_condattr_getpshared(3p),pthread_create(3p),pthread_mutex_destroy(3p)       The Base Definitions volume of POSIX.1‐2017,pthread.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_..._DESTROY(3P)

Pages that refer to this page:pthread.h(0p), pthread_condattr_getclock(3p), pthread_condattr_getpshared(3p), pthread_condattr_init(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.