shm_unlink(2)                                                 shm_unlink(2)




 NAME    [Toc]    [Back]
      shm_unlink - unlink a shared memory object

 SYNOPSIS    [Toc]    [Back]
      #include <sys/mman.h>

      int shm_unlink(const char *name);

 DESCRIPTION    [Toc]    [Back]
      The shm_unlink() system call removes the name of the shared memory
      object named by the string pointed to by name.  If one or more
      references to the shared memory object exists when the object is
      unlinked, the name will be removed before shm_unlink() returns, but
      the removal of the memory object contents will be postponed until all
      open and map references to the shared memory object have been removed.

 RETURN VALUE    [Toc]    [Back]
      shm_unlink() returns the following values:

           0    Successful completion.

           -1   Failure, errno is set to indicate the error.

 ERRORS    [Toc]    [Back]
      If shm_unlink() fails, errno is set to one of the following values:

           [EACCES]       Permission to unlink the named shared memory
                          object is denied.

           [ENAMETOOLONG] The length of the name string exceeds PATH_MAX, or
                          the length of a (pathname) component of the name
                          string exceeds NAME_MAX while _POSIX_NO_TRUNC is
                          in effect.

           [ENOENT]       The named shared memory object does not exist.

           [ENOSYS]       shm_unlink() is not supported by the
                          implementation.

 SEE ALSO    [Toc]    [Back]
      shm_open(2), close(2), mmap(2), munmap(2).

 STANDARDS CONFORMANCE    [Toc]    [Back]
      shm_unlink() in librt: POSIX 1003.1b


 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003