int
     shm_unlink(const char *name);

DESCRIPTION

     The shm_unlink() 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.

ERRORS

     The shm_unlink() succeeds unless:

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

     [ENAMETOOLONG]     name exceeded SHM_NAME_MAX characters.

     [ENOENT]           The named object does not exist.

SEE ALSO

     close(2), mmap(2), munmap(2), shmat(2), shmctl(2), shm_open(2)

HISTORY

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

Darwin                        September 20, 1999                        Darwin