SHM_UNLINK(2)

NAME
shm_unlink - remove shared memory object

SYNOPSIS
#include <sys/mman.h>
int
shm_unlink(const char *name);

DESCRIPTION
The shm_unlink() function removes the shared memory object named by name. If no process has the file open, then all resources associated with the object are reclaimed. If one or more process have the object open, the name removed, but the removal of the memory object is delayed until all references to it have been closed.

RETURN VALUES
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error, and the named shared memory object will remain unchanged.

ERRORS
The shm_unlink() succeeds unless:

[EACCES]
    Permission is denied to be remove the object.

[ENAMETOOLONG]
    name exceeded SHM_NAME_MAX characters.

[ENOENT]
    The named object does not exist.

SEE ALSO
close(2), mmap(2), munmap(2), shmat(2), shmctl(2), shm_open(2)

HISTORY
shm_open() is specified in the POSIX Realtime Extension (1003.1b-1993/1003.1i-1995).