QNX Developer Support
|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Destroy a semaphore
#include <semaphore.h> int sem_destroy( sem_t * sem );
- A pointer to the sem_t object for the semaphore that you want to destroy.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The sem_destroy() function destroys the unnamed semaphore referred to by the sem argument. The semaphore must have been previously initialized by the sem_init() function.
The effect of using a semaphore after it has been destroyed is undefined. If you destroy a semaphore that other processes are currently blocked on, they're unblocked, with an error (EINVAL).
|Don't mix named semaphore operations (sem_open() and sem_close()) with unnamed semaphore operations (sem_init() and sem_destroy()) on the same semaphore.|
- An error occurred (errno is set).
- Invalid semaphore descriptor sem.