pthread_condattr_getclock()

Get the clock attribute from a condition-variable attribute object

Synopsis:

#include <pthread.h>

int pthread_condattr_getclock( 
                     const pthread_condattr_t * attr,
                     clockid_t * id );

Arguments:

attr: A pointer to the pthread_condattr_t object from which you want to get the clock.
id: A pointer to a clockid_t object where the function can store the clock ID.

Library:

libc

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

Description:

The pthread_condattr_getclock() function obtains the value of the clock attribute from the attributes object referenced by attr.

The clock attribute is the clock ID of the clock that's used to measure the timeout service of pthread_cond_timedwait(); one of:

CLOCK_REALTIME — the standard POSIX-defined clock. Timers based on this clock wake up the processor if it's in a power-saving mode.
CLOCK_SOFTTIME — (a QNX Neutrino extension) this clock is active only when the processor isn't in a power-saving mode. For example, an application using a CLOCK_SOFTTIME timer to sleep wouldn't wake up the processor when the application was due to wake up. This will allow the processor to enter a power-saving mode.
While the processor isn't in a power-saving mode, CLOCK_SOFTTIME behaves the same as CLOCK_REALTIME.
CLOCK_MONOTONIC — this clock always increases at a constant rate and can't be adjusted.

The default value of the clock attribute refers to the system clock. For more information about the different clocks, see “Other clock sources” in the Clocks, Timers, and Getting a Kick Every So Often chapter of Getting Started with QNX Neutrino.

Returns:

EOK: Success.
EINVAL: Invalid value attr.

Classification:

POSIX 1003.1

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