sem_destroy(2) System Calls Manual sem_destroy(2)
NAME
sem_destroy - destroy an unnamed POSIX semaphore
SYNOPSIS
DESCRIPTION
is used to destroy an unnamed semaphore. A successful call to will invalidate the unnamed semaphore referred to by sem and removes all
descriptors referencing it. The semaphore should have been created by a previous call to and there should not be any processes blocked on
it.
To use this function, link in the realtime library by specifying on the compiler or linker command line.
EXAMPLES
The following call to will destroy an unnamed semaphore referred to by sem and remove all descriptors referencing it.
RETURN VALUE
If the semaphore was destroyed and the descriptors referencing it were removed, returns 0 to the caller.
If the semaphore could not be destroyed, the call returns -1 and sets to indicate the error.
ERRORS
fails and does not perform the requested operation if any of the following conditions are encountered:
[EBUSY] There are threads currently blocked on the semaphore or there are outstanding locks held on the semaphore.
[EINVAL] The argument sem is not a valid unnamed semaphore.
SEE ALSO
sem_init(2), sem_open(2), <semaphore.h>.
STANDARDS CONFORMANCE
sem_destroy(2)
