msem_remove(3)msem_remove(3)NAMEmsem_remove - Remove a semaphore
SYNOPSIS
#include <sys/mman.h>
int msem_remove(
msemaphore *sem );
LIBRARY
Standard C Library (libc)
PARAMETERS
Points to an msemaphore structure which specifies the semaphore to be
removed.
DESCRIPTION
The msem_remove() function removes a binary semaphore. Any subsequent
use of the msemaphore structure before it is again initialized by call‐
ing the msem_init() function will have undefined results.
The msem_remove() function also causes any process waiting in the
msem_lock() function on the removed semaphore to return with an error.
If the msemaphore structure contains any value not resulting from a
call to the msem_init() function followed by a (possibly empty)
sequence of calls to the msem_lock() and msem_unlock() functions, the
result is undefined. The address of an msemaphore structure may be sig‐
nificant. If the msemaphore structure contains any value copied from
an msemaphore structure at a different address, the result is unde‐
fined.
NOTES
Trial use
RETURN VALUES
On successful completion, the msem_remove() function returns 0 (zero).
On error, the msem_remove() function returns -1 and sets errno to indi‐
cate the error.
ERRORS
If the msem_remove() function fails, errno may be set to the following
value: The sem parameter points to an msemaphore structure which speci‐
fies a semaphore which has been removed.
SEE ALSO
Functions: msem_init(3), msem_lock(3), msem_unlock(3), munmap(2)msem_remove(3)