[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    shm_unlink(3R) manual page Table of Contents

Name

shm_unlink - remove a shared memory object

Synopsis

cc [ flag ... ] file ... -lposix4 [ library ... ]

int shm_unlink(const char *name);

MT-Level

MT-Safe

Description

shm_unlink() 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

If successful, 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.

Errors

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
shm_unlink() is not supported by this implementation.

See Also

close(2) , mmap(2) , mlock(3C) , shm_open(3R)

Bugs

In Solaris 2.5, these functions always return -1 and set errno to ENOSYS, because this release does not support the Shared Memory Objects option. It is our intention to provide support for these interfaces in future releases.


Table of Contents