Manual Pages for UNIX Operating System command usage for man sem_destroy

Standard C Library Functions                      sem_destroy(3C)



NAME
     sem_destroy - destroy an unnamed semaphore

SYNOPSIS
     #include 

     int sem_destroy(sem_t *sem);


DESCRIPTION
     The sem_destroy() function is used to  destroy  the  unnamed
     semaphore  indicated  by  sem.  Only  a  semaphore  that was
     created  using   sem_init(3C)   may   be   destroyed   using
     sem_destroy();  the  effect  of calling sem_destroy() with a
     named semaphore is undefined. The effect of  subsequent  use
     of   the  semaphore  sem  is  undefined  until  sem  is  re-
     initialized by another call to sem_init(3C).


     It is safe to destroy an initialised semaphore upon which no
     threads  are  currently  blocked. The effect of destroying a
     semaphore upon which other threads  are currently blocked is
     undefined.

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

ERRORS
     The  sem_destroy() function will fail if:

     EINVAL     The sem argument is not a valid semaphore.



     The sem_destroy() function may fail if:

     EBUSY     There are currently processes (or LWPs or threads)
               blocked on the semaphore.


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











SunOS 5.11           Last change: 5 Feb 2008                    1






Standard C Library Functions                      sem_destroy(3C)



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


SEE ALSO
     sem_init(3C), sem_open(3C), attributes(5), standards(5)










































SunOS 5.11           Last change: 5 Feb 2008                    2