Manual Pages for UNIX Operating System command usage for man shm_unlink

Standard C Library Functions                       shm_unlink(3C)



NAME
     shm_unlink - remove a shared memory object

SYNOPSIS
     #include 

     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 refer-
     ences to the shared memory object have been removed.

RETURN VALUES
     Upon successful completion, shm_unlink() returns  0.  Other-
     wise it returns -1 and sets errno to indicate the error con-
     dition, 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  attri-
     butes:







SunOS 5.11           Last change: 5 Feb 2008                    1






Standard C Library Functions                       shm_unlink(3C)



     ____________________________________________________________
    | ATTRIBUTE TYPE              | ATTRIBUTE VALUE             |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     close(2), mmap(2), mlock(3C),  shm_open(3C),  attributes(5),
     standards(5)

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




































SunOS 5.11           Last change: 5 Feb 2008                    2