man.bsd.lv manual page server

Manual Page Search Parameters
PTHREAD_CONDATTR(3) Library Functions Manual PTHREAD_CONDATTR(3)

pthread_condattr_init, pthread_condattr_destroy, pthread_condattr_getclock, pthread_condattr_setclock, pthread_condattr_getpshared, pthread_condattr_setpshared — condition attribute operations

library “libpthread”

#include <pthread.h>

int
pthread_condattr_init(pthread_condattr_t *attr);

int
pthread_condattr_destroy(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_id);

int
pthread_condattr_getpshared(const pthread_condattr_t * restrict attr, int * restrict pshared);

int
pthread_condattr_setpshared(pthread_condattr_t *attr, int pshared);

Condition attribute objects are used to specify parameters to (). DragonFly's implementation of conditions does not support any non-default attributes, so these functions are not very useful, though they are required to be present by POSIX.

The () function initializes a condition attribute object with the default attributes.

The () function destroys a condition attribute object.

The () function will put the value of the clock attribute from attr into the memory area pointed to by clock_id. The () function will set the clock attribute of attr to the value specified in clock_id. The clock attribute affects the interpretation of abstime in pthread_cond_timedwait(3) and may be set to CLOCK_REALTIME (default) or CLOCK_MONOTONIC.

The () function will put the value of the process-shared attribute from attr into the memory area pointed to by pshared. The () function will set the process-shared attribute of attr to the value specified in pshared. The argument pshared may have the following value:

The condition variable it is attached to may only be accessed by threads in the same process as the one that created the object.

If successful, these functions return 0. Otherwise, an error number is returned to indicate the error.

The pthread_condattr_init() function will fail if:

[]
Out of memory.

The pthread_condattr_destroy() function will fail if:

[]
Invalid value for attr.

The pthread_condattr_setclock() function will fail if:

[]
The value specified in clock_id is not one of the allowed values.

The pthread_condattr_setpshared() function will fail if:

[]
The value specified in pshared is not one of the allowed values.

pthread_cond_init(3), pthread_cond_timedwait(3)

The pthread_condattr_init() and pthread_condattr_destroy() functions conform to ISO/IEC 9945-1:1996 (“POSIX.1”).

November 30, 2017 DragonFly-5.6.1