This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pthread_condattr_setclock()

Set the clock attribute of a condition-variable attribute object

Synopsis:

#include <pthread.h>

int pthread_condattr_setclock( 
                     pthread_condattr_t * attr, 
                     clockid_t id );

Arguments:

attr: A pointer to the pthread_condattr_t object for which you want to set the clock. You must have initialized this object by calling pthread_condattr_init() before calling pthread_condattr_setclock().
id: A clockid_t object that specifies the ID of the clock that you want to use for the condition variable.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

The pthread_condattr_setclock() function sets the clock attribute in an initialized attributes object referenced by attr. If pthread_condattr_setclock() is called with an id argument that refers to a CPU-time clock, the call fails.

The clock attribute is the clock ID of the clock that you want to use to measure the timeout service of pthread_cond_timedwait(). The default value of the clock attribute refers to the system clock.

Returns:

EOK: Success.
EINVAL: Invalid value attr.

Classification:

POSIX 1003.1 THR CS

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes