HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

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

If 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) com-

ponent 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.