Content-type: text/html Man page of shm_unlink

shm_unlink

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

shm_unlink - Remove a shared memory object created by a call to the shm_open function (P1003.1b)  

SYNOPSIS

#include <sys/mman.h>

int shm_unlink (
const char *name);  

PARAMETERS

*name
Points to a name naming the shared memory object.
 

DESCRIPTION

The shm_unlink function removes the name of the shared memory object pointed to by name. 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 name argument exceeds PATH_MAX, or a pathname component is longer than NAME_MAX while _POSIX_NO_TRUNC is in effect.
[ENOENT]
The named shared memory object does not exist.
 

RELATED INFORMATION

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


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:18 GMT, October 02, 2010