shm_unlink.2 (2010 09)

shm_unlink(2) shm_unlink(2)

NAME

shm_unlink - unlink a shared memory object

SYNOPSIS

#include <sys/mman.h>

int shm_unlink(const char *name);

DESCRIPTION

The shm_unlink() system call 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 will be removed before

shm_unlink() returns, but the removal of the memory

object contents will be postponed until all open and map references to the shared memory object have

been removed.

RETURN VALUE

shm_unlink() returns the following values:

0 Successful completion.

-1 Failure,

errno is set to indicate the error.

ERRORS

shm_unlink() fails, errno is set to one of the following values:

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

[ENAMETOOLONG]

The length of the name string exceeds

PATH_MAX, or the length of a (pathname)

component of the name string exceeds 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 the implementation.