QNX Developer Support
|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Get the value of a named or unnamed semaphore
#include <semaphore.h> int sem_getvalue( sem_t * sem, int * value );
- A pointer to the sem_t object for the semaphore whose value you want to get.
- A pointer to a location where the function can store the semaphore's value. A positive value (i.e. greater than zero) indicates an unlocked semaphore, and a value of 0 (zero) indicates a locked semaphore.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The sem_getvalue() function takes a snapshot of the value of the semaphore, sem, and stores it in value. This value can change at any time, and is guaranteed valid only at some point in the sem_getvalue() call.
This function is provided for debugging semaphore code.
- An error occurred (errno is set).
- Invalid semaphore descriptor sem.