Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Realtime Library Functionsshm_unlink(3RT)


NAME

 shm_unlink - remove a shared memory object

SYNOPSIS

 
cc [ flag... ] file... -lrt [ library... ]
#include <sys/mman.h>
int shm_unlink(const char *name);

DESCRIPTION

 

The shm_unlink() function 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 is removed before shm_unlink() returns, but the removal of the memory object contents will be postponed until all open and mapped references to the shared memory object have been removed.

RETURN VALUES

 

Upon successful completion, shm_unlink() returns 0. Otherwise it returns -1 and sets errno to indicate the error condition, and the named shared memory object is not affected by this function call.

ERRORS

 

The shm_unlink() function will fail if:

EACCES
Permission is denied to unlink the named shared memory object.
ENAMETOOLONG
The length of the name string 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.
ENOSYS
The shm_unlink() function is not supported by the system.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

SEE ALSO

 

close(2), mmap(2), mlock(3C), shm_open(3RT), attributes(5)

NOTES

 

Solaris 2.6 was the first release to support the Asynchronous Input and Output option. Prior to this release, this function always returned -1 and set errno to ENOSYS.


SunOS 5.9Go To TopLast Changed 22 Jun 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.