sem_unlink(2)sem_unlink(2)NAMEsem_unlink - unlink a named POSIX semaphore
SYNOPSISDESCRIPTION
is used to unlink named semaphores. A successful call to marks the
semaphore, specified by name, for removal. Calling does not affect
processes, including the calling process, which currently have a
descriptor, obtained from a call to Named semaphores are uniquely iden‐
tified by character strings. All character string names will be pre-
processed to ensure variations of a pathname resolve to the same sema‐
phore name. If the semaphore is successfully marked for removal by a
call to the semaphore will be removed when all processes remove their
descriptors to the specified semaphore by calling Subsequent calls to
using the string name will refer to a new semaphore.
To use this function, link in the realtime library by specifying on the
compiler or linker command line.
EXAMPLES
The following call to will remove the named semaphore named by the
string name. If the semaphore is currently referenced by one or more
processes, the semaphore will be marked for removal and removed when
there are no more processes referencing it.
RETURN VALUE
If the semaphore was unlinked successfully, returns 0.
If the semaphore could not be unlinked, the call returns -1 and sets to
indicate the error.
ERRORS
fails and does not perform the requested operation if any of the fol‐
lowing conditions are encountered:
[EACCES] The named semaphore exists and the process does
not have the permissions to unlink the semaphore.
[ENAMETOOLONG] The name string is longer than
[ENOENT] The flag is not set in oflag (see sem_open(2))
and the named semaphore does not exist.
SEE ALSOsem_close(2), sem_open(2), privileges(5), <semaphore.h>.
STANDARDS CONFORMANCEsem_unlink(2)