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

NAME
     sshhmmuunnlliinnkk - remove shared memory object

SYNOPSIS
     ##iinncclluuddee <>

     int
     sshhmmuunnlliinnkk(const char *name);

DESCRIPTION
     The sshhmmuunnlliinnkk() function disassociates the shared memory object speci-
     fied by name from that name.  The resources associated with the shared
     memory object remain intact until the last file descriptor reference is
     removed, e.g., by close(2) or munmap(2), at which point the resources are
     reclaimed (if no references exist at the time of the call to
     sshhmmuunnlliinnkk(), the resources are reclaimed immediately).  The name can
     only be reused when it is bound to a new shared memory object with a call
     to shmopen(2) with the OCREAT flag.

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.

EERRRROORRSS
     The sshhmmuunnlliinnkk() succeeds unless:

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

     [ENAMETOOLONG]     name exceeded SHMNAMEMAX characters.

     [ENOENT]           The named object does not exist.

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

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

Darwin                          August 31, 2006                         Darwin