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.

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.