Index for Section 3

Alphabetical listing for S

Bottom of page

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

SYNOPSIS
  #include <sys/mman.h>

  int shm_unlink (
  const char *name);

LIBRARY
  Realtime Library (librt.so, librt.a)

PARAMETERS
  *name
      Points to the name of the shared memory object.

DESCRIPTION
  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
  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
  The shm_unlink function fails under the following conditions:

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

  [ENAMETOOLONG]
      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.

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

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

  Guide to Realtime Programming

Index for Section 3

Alphabetical listing for S

Top of page