Digital

NAME

shm_unlink − Remove a shared memory object created by a call to the shm_open function (P1003.4/D11)

SYNOPSIS

int shm_unlink (
const char ∗path);

PARAMETERS

∗path Points to a pathname naming the shared memory object. 

DESCRIPTION

The shm_unlink function removes the name of the shared memory object pointed to by path.  If this file descriptor is used by other functions, all references to the shared memory object are removed, but content removal is delayed until all open and mapped references to the shared memory object are removed. 

RETURN VALUES

On a successful call to the shm_unlink function, a zero is returned.  Otherwise, a value of −1 is returned and errno is set to indicate the error. 

ERRORS

The shm_unlink function fails under the following conditions:

[EACCES] Permission to unlink the shared memory object is denied. 

[ENAMETOOLONG] The length of the path argument exceeds PATH_MAX, or a pathname component is longer than NAME_MAX while _POSIX_NO_TRUNC is in effect. 

[ENOENT] The shared memory object does not exist, or the path argument points to an empty string. 

[ENOSYS] The function shm_unlink is not supported by this implementation. 

RELATED INFORMATION

Functions: close(2), mmap(2), munmap(2), shm_open(3)