SEMUNLINK(2)               BSD System Calls Manual              SEMUNLINK(2)

NAME
     semunlink -- remove a named semaphore

SYNOPSIS
     ##include <>

     int
     semunlink(const char *name);

DESCRIPTION
     The named semaphore named name is removed.  If the semaphore is in use my
     other processes, then name is immeditately dissasociated with the sema-
     phore, but the semaphore itself will not be removed until all references
     to it have been closed.  Subsequent calls to semopen() using name will
     refer to or create a new semaphore named name.

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

ERORS
     semunlink() succeeds unless:

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

     [ENAMETOLONG]     name exceeded SEMNAMELEN characters.

     [ENOENT]           The named semaphore does not exist.

SEE ALSO
     semctl(2), semget(2), semop(2), semclose(2), semopen(2)

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

Darwin                           June 8, 2000                           Darwin