Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ shm_unlink(3R) — SunOS 5.6

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

close(2)

mmap(2)

mlock(3C)

shm_open(3R)

attributes(5)

shm_unlink(3R)

NAME

shm_unlink − remove a shared memory object

SYNOPSIS

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

int shm_unlink(const char ∗name);

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. 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
MT-Level MT-Safe

SEE ALSO

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

SunOS 5.6  —  Last change: 30 Dec 1996

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026