unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 shm_unlink(2)						       shm_unlink(2)




 NAME
      shm_unlink - unlink a shared memory object

 SYNOPSIS
      #include <&lt&lt&lt;sys/mman.h>&gt&gt&gt;

      int shm_unlink(const char *name);

 DESCRIPTION
      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
      shm_unlink() returns the following values:

	   0	Successful completion.

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

 ERRORS
      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
      shm_open(2), close(2), mmap(2), munmap(2).

 STANDARDS CONFORMANCE
      shm_unlink() in librt: POSIX 1003.1b










 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000