shm_unlink(3RT) Realtime Library Functions shm_unlink(3RT)NAMEshm_unlink - remove a shared memory object
SYNOPSIS
cc [ flag... ] file... -lrt [ library... ]
#include <sys/mman.h>
int shm_unlink(const char *name);
DESCRIPTION
The shm_unlink() function 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
is removed before shm_unlink() returns, but the removal of the memory
object contents will be postponed until all open and mapped references
to the shared memory object have been removed.
RETURN VALUES
Upon successful completion, shm_unlink() returns 0. Otherwise it
returns −1 and sets errno to indicate the error condition, and the
named shared memory object is not affected by this function call.
ERRORS
The shm_unlink() function will fail if:
EACCES Permission is denied to unlink the named shared
memory object.
ENAMETOOLONG The length of the name string 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.
ENOSYS The shm_unlink() function is not supported by
the system.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Standard │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOclose(2), mmap(2), mlock(3C), shm_open(3RT), attributes(5), stan‐
dards(5)NOTES
Solaris 2.6 was the first release to support the Asynchronous Input and
Output option. Prior to this release, this function always returned −1
and set errno to ENOSYS.
SunOS 5.10 28 Jun 2002 shm_unlink(3RT)