NAME    [Toc]    [Back]

       shm_unlink  -  Removes a shared memory object created by a
       call to the shm_open function (P1003.1b)

SYNOPSIS    [Toc]    [Back]

       #include <sys/mman.h>

       int shm_unlink ( const char *name);

LIBRARY    [Toc]    [Back]

       Realtime Library (librt.so, librt.a)

PARAMETERS    [Toc]    [Back]

       Points to the name of the shared memory object.

DESCRIPTION    [Toc]    [Back]

       The shm_unlink function removes the  name  of  the  shared
       memory  object pointed to by name. If this file descriptor
       is used by other functions, all references to  the  shared
       memory  object are removed, but content removal is delayed
       until all open and mapped references to the shared  memory
       object are removed.

RETURN VALUES    [Toc]    [Back]

       On  a  successful call to the shm_unlink function, a value
       of 0 (zero) is returned.  Otherwise,  a  value  of  -1  is
       returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       The  shm_unlink  function fails under the following conditions:
 Permission to unlink the shared  memory  object  is
       denied.  The length of the name argument exceeds PATH_MAX,
       or a pathname component  is  longer  than  NAME_MAX  while
       _POSIX_NO_TRUNC  is  in  effect.   The named shared memory
       object does not exist.

SEE ALSO    [Toc]    [Back]

       Functions: close(2), mmap(2), munmap(2), shm_open(3)

       Guide to Realtime Programming



                                                    shm_unlink(3)