sem_destroy(3)sem_destroy(3)NAMEsem_destroy - Destroys an unnamed semaphore (P1003.1b)
SYNOPSIS
#include <semaphore.h>
int sem_destroy ( sem_t *sem);
LIBRARY
Realtime Library (librt.so, librt.a)
PARAMETERS
References the unnamed semaphore to be destroyed. Use the sem argument
that was supplied to, and filled in by, the previous call to sem_init.
DESCRIPTION
The sem_destroy function destroys an unnamed semaphore indicated by
sem. Only a semaphore created using sem_init may be destroyed using
sem_destroy.
The potential for deadlock exists if a process calls sem_destroy for a
semaphore while there is a pending sem_wait, because a process may be
waiting for a poster that has not yet opened the semaphore.
RETURN VALUES
On successful completion, the function returns the value 0 (zero); oth‐
erwise, the function returns the value -1 and sets errno to indicate
the error, without destroying the semaphore indicated by the sem argu‐
ment.
ERRORS
The sem_destroy function fails under the following condition: The sem
argument is not a valid semaphore.
SEE ALSO
Functions: sem_init(3), sem_open(3)
Guide to Realtime Programming
sem_destroy(3)