Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


PTHREAD_CONDATTR(3)        Library Functions Manual        PTHREAD_CONDATTR(3)

NAME
     pthread_condattr_init, pthread_condattr_getpshared,
     pthread_condattr_setpshared, pthread_condattr_getclock,
     pthread_condattr_setclock - condition attribute operations

LIBRARY
     POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS
     #include <pthread.h>

     int
     pthread_condattr_init(pthread_condattr_t *attr);

     int
     pthread_condattr_getclock(const pthread_condattr_t *__restrict attr,
         clockid_t * __restrict clock_id);

     int
     pthread_condattr_setclock(pthread_condattr_t *attr, clockid_t clock);

     int
     pthread_condattr_destroy(pthread_condattr_t *attr);

     int
     pthread_condattr_getpshared(const pthread_condattr_t * __restrict attr,
         int * __restrict pshared);

     int
     pshared_condattr_setpshared(pthread_condattr_t *attr, int pshared);

DESCRIPTION
     Condition attribute objects are used to specify parameters to the
     pthread_cond_init(3) function.  The pthread_condattr_init() function
     initializes a condition attribute object with the default attributes and
     the pthread_condattr_destroy() function destroys a condition attribute
     object.  The pthread_condattr_getclock() function shall obtain the value
     of the clock attributes object referenced by attr.  The
     pthread_condattr_setclock() function sets the system clock to be used for
     time comparisons to the one specified in clock.  Valid clock values are
     CLOCK_MONOTONIC and CLOCK_REALTIME (the default).  The
     pthread_condattr_getpshared() function shall obtain the value of the
     process-shared attribute from the attributes object referenced by attr.
     The pthread_condattr_setpshared() function shall set the process-shared
     attribute in an initialized attributes object referenced by attr.

RETURN VALUES
     If successful, these functions return 0.  Otherwise, an error number is
     returned to indicate the error.

ERRORS
     No errors are defined for pthread_condattr_init().

     The pthread_condattr_destroy() function may fail if:

     [EINVAL]           The value specified by attr is invalid.

     The pthread_condattr_getclock() and pthread_condattr_setclock() may fail
     if:

     [EINVAL]           The value specified by attr is invalid.

     The pthread_condattr_getpshared() and pthread_condattr_setpshared() may
     fail if:

     [EINVAL]           The value specified by attr is invalid.

SEE ALSO
     pthread_cond_init(3)

STANDARDS
     Both functions conform to IEEE Std 1003.1-2001 ("POSIX.1").

BUGS
     The pthread_condattr_getpshared() and pthread_condattr_setpshared()
     functions are hidden by default since only thread shared attributes are
     supported.

NetBSD 10.99                    March 28, 2017                    NetBSD 10.99