Manual Pages  — SEM_DESTROY

sem_destroy – destroy an unnamed semaphore

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES ERRORS SEE ALSO STANDARDS

Standard C Library (libc, -lc)

#include <semaphore.h>

int
sem_destroy(sem_t *sem);

The sem_destroy function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

The sem_destroy() function will fail if:

[EINVAL]
	The sem argument points to an invalid semaphore.
[EBUSY]
	There are currently threads blocked on the semaphore that sem points to.

The sem_destroy() function conforms to IEEE Std 1003.1-96 ("POSIX.1").

POSIX does not define the behavior of sem_destroy() if called while there are threads blocked on sem, but this implementation is guaranteed to return -1 and set errno to EBUSY if there are threads blocked on sem.