NAME
pthread_condattr_init
,
pthread_condattr_getpshared
,
pthread_condattr_setpshared
,
pthread_condattr_getclock
,
pthread_condattr_setclock
—
condition attribute
operations
LIBRARY
library “libpthread”
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. Thepthread_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
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.