Standard C Library Functions                        semclose(3C)



NAME
     semclose - close a named semaphore

SYNOPSIS
     #include 

     int semclose(semt *sem);


DESCRIPTION
     The semclose() function is used to indicate that  the  cal-
     ling process is finished using the named semaphore indicated
     by sem. The effects of calling semclose()  for  an  unnamed
     semaphore  (one  created by seminit(3C)) are undefined. The
     semclose() function deallocates (that  is,  make  available
     for  reuse by a subsequent semopen(3C) by this process) any
     system resources allocated by the system  for  use  by  this
     process  for this semaphore. The effect of subsequent use of
     the semaphore indicated by sem by this process is undefined.
     If the semaphore has not been removed with a successful call
     to semunlink(3C), then semclose() has  no  effect  on  the
     state  of  the semaphore. If the semunlink(3C) function has
     been successfully invoked for name  after  the  most  recent
     call  to  semopen(3C) with OCREAT for this semaphore, then
     when all processes that have opened the semaphore close  it,
     the semaphore is no longer be accessible.

RETURN VALUES
     If successful, semclose() returns 0, otherwise  it  returns
     -1 and sets errno to indicate the error.

ERORS
     The semclose() function will fail if:

     EINVAL     The  sem  argument  is  not  a  valid   semaphore
                descriptor.


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


USAGE
     The semclose() function should not be called for an unnamed
     semaphore initialized by seminit(3C).

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






SunOS 5.11           Last change: 5 Feb 2008                    1






Standard C Library Functions                        semclose(3C)



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


SEE ALSO
     seminit(3C), semopen(3C),  semunlink(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