NAME
pthread_condattr_init,
pthread_condattr_destroy,
pthread_condattr_setclock,
pthread_condattr_getclock —
condition variable attribute
operations
SYNOPSIS
#include
<pthread.h>
int
pthread_condattr_init(pthread_condattr_t
*attr);
int
pthread_condattr_destroy(pthread_condattr_t
*attr);
int
pthread_condattr_setclock(pthread_condattr_t
*attr, clockid_t
clock_id);
int
pthread_condattr_getclock(pthread_condattr_t
*attr, clockid_t
*clock_id);
DESCRIPTION
Condition variable attributes are used to specify parameters to
pthread_cond_init().
One attribute object can be used in multiple calls to
pthread_cond_init(), with or without modifications
between calls.
The
pthread_condattr_init()
function initializes attr with all the default
condition variable attributes.
The
pthread_condattr_destroy()
function destroys attr.
The
pthread_condattr_setclock()
function sets the clock attribute of attr to the value
of the clock_id parameter. The
pthread_condattr_getclock()
function copies the value of the clock attribute from
attr to the location pointed to by the
clock_id parameter. The clock attribute is the ID of
the clock against which the timeout of
pthread_cond_timedwait()
is compared; the default value of the clock attribute is
CLOCK_REALTIME.
RETURN VALUES
If successful, these functions return 0. Otherwise, an error number is returned to indicate the error.
ERRORS
pthread_condattr_init() will fail if:
- [
ENOMEM] - Out of memory.
pthread_condattr_setclock() will fail
if:
- [
EINVAL] - The value of clock_id is neither
CLOCK_REALTIMEnorCLOCK_MONOTONIC.
SEE ALSO
STANDARDS
pthread_condattr_init(),
pthread_condattr_destroy(),
pthread_condattr_setclock(), and
pthread_condattr_getclock() conform to
IEEE Std 1003.1-2008 (“POSIX.1”)