PTHREAD_CONDATTR_INIT(3)

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_REALTIME nor CLOCK_MONOTONIC.

SEE ALSO
clock_gettime(2), pthread_cond_init(3)

STANDARDS
pthread_condattr_init(), pthread_condattr_destroy(), pthread_condattr_setclock(), and pthread_condattr_getclock() conform to p1003.1-2008