Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

sem_unlink(2)							 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 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 ALSO
       sem_close(2), sem_open(2), privileges(5), <semaphore.h>.

STANDARDS CONFORMANCE
								 sem_unlink(2)

Vote for polarhome