SHMUNLINK(2)               BSD System Calls Manual              SHMUNLINK(2)

NAME
     shmunlink -- remove shared memory object

SYNOPSIS
     ##include <>

     int
     shmunlink(const char *name);

DESCRIPTION
     The shmunlink() function removes the shared memory object named by name.
     If no process has the file open, then all resources associated with the
     object are reclaimed.  If one or more process have the object open, the
     name removed, but the removal of the memory object is delayed until all
     references to it have been closed.

RETURN VALUES
     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of -1 is returned and errno is set to indicate the error, and the named
     shared memory object will remain unchanged.

ERORS
     The shmunlink() succeeds unless:

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

     [ENAMETOLONG]     name exceeded SHMNAMEMAX characters.

     [ENOENT]           The named object does not exist.

SEE ALSO
     close(2), mmap(2), munmap(2), shmat(2), shmctl(2), shmopen(2)

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

Darwin                        September 20, 1999                        Darwin