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.