hpux man page for sem_unlink

sem_unlink(2)							System Calls Manual						     sem_unlink(2)

NAME
       sem_unlink - unlink a named POSIX semaphore

SYNOPSIS
DESCRIPTION
       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  identi-
       fied  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 following 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 ALSO
       sem_close(2), sem_open(2), privileges(5), <semaphore.h>.

STANDARDS CONFORMANCE
																     sem_unlink(2)