NAME [Toc] [Back]
shm_unlink - unlink a shared memory object
SYNOPSIS [Toc] [Back]
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
[ENOENT] The named shared memory object does not exist.
[ENOSYS] shm_unlink() is not supported by the
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 [ Back ]