unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Darwin-7.0.1-ppc)
Page:
Section:
Apropos / Subsearch:
optional field

SHM_UNLINK(2)               BSD System Calls Manual              SHM_UNLINK(2)

NAME
     shm_unlink -- remove shared memory object

SYNOPSIS
     #include <&lt;sys/mman.h>&gt;

     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