*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> shm_unlink (3)              



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

[ Back ]
 Similar pages
Name OS Title
shm_open Tru64 Opens a shared memory object, creating the object if necessary (P1003.1b)
shm_open FreeBSD open or create a shared memory object shm_unlink -- remove a shared memory object
ipcrm Tru64 Removes message queue, semaphore set, or shared memory identifiers
shm_unlink FreeBSD remove a shared memory object
shm_unlink IRIX deletes a shared memory object
shm_unlink HP-UX unlink a shared memory object
shm_open HP-UX create/open a shared memory object
dmMPEG1AudioDecode IRIX decodes a single compressed block of data created by a call to dmMPEG1AudioEncode(3dm).
shm_open IRIX establishes a connection between a shared memory object and a file descriptor
mq_unlink Tru64 Removes a message queue (P1003.1b)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service