Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > S

shm_unlink(2)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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

STANDARDS CONFORMANCE

shm_unlink() in librt: POSIX 1003.1b

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.