NAME
shm_unlink — unlink a shared memory object
SYNOPSIS
#include <sys/mman.h>
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.
STANDARDS CONFORMANCE
shm_unlink() in librt: POSIX 1003.1b
