This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

SEM_UNLINK(2)               BSD System Calls Manual              SEM_UNLINK(2)

NAME
     sem_unlink -- remove a named semaphore

SYNOPSIS
     #include <semaphore.h>

     int
     sem_unlink(const char *name);

DESCRIPTION
     The named semaphore named name is removed.  If the semaphore is in use by other processes, then name is
     immediately disassociated with the semaphore, but the semaphore itself will not be removed until all
     references to it have been closed.  Subsequent calls to sem_open() using name will refer to or create a
     new semaphore named name.

     If successful, sem_unlink() will return 0.  Otherwise, -1 is returned and errno is set, and the state
     of the semaphore is unchanged.

ERRORS
     sem_unlink() succeeds unless:

     [EACCES]           Permission is denied to be remove the semaphore.

     [ENAMETOOLONG]     name exceeded SEM_NAME_LEN characters.

     [ENOENT]           The named semaphore does not exist.

SEE ALSO
     sem_close(2), sem_open(2), semctl(2), semget(2), semop(2)

HISTORY
     sem_unlink() is specified in the POSIX Realtime Extension (1003.1b-1993/1003.1i-1995).

Darwin                           June 8, 2000                           Darwin