Standard C Library Functions                       shmunlink(3C)



NAME
     shmunlink - remove a shared memory object

SYNOPSIS
     #include 

     int shmunlink(const char *name);


DESCRIPTION
     The shmunlink() 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
     shmunlink() 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, shmunlink() 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.

ERORS
     The  shmunlink() function will fail if:

     EACES           Permission is denied to  unlink  the  named
                      shared memory object.


     ENAMETOLONG     The  length  of  the  name  string  exceeds
                      PATHMAX, or a pathname component is longer
                      than  NAMEMAX while  POSIXNOTRUNC is in
                      effect.


     ENOENT           The named shared  memory  object  does  not
                      exist.


     ENOSYS           The shmunlink() function is not  supported
                      by the system.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:







SunOS 5.11           Last change: 5 Feb 2008                    1






Standard C Library Functions                       shmunlink(3C)



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    
     Standard                     See standards(5).           
    


SEE ALSO
     close(2), mmap(2), mlock(3C),  shmopen(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