NAME    [Toc]    [Back]

       tis_cond_destroy  - Destroys the specified condition variable

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_cond_destroy(
               pthread_cond_t *cond );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc.so, libc.a)

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Address of the condition variable (passed by reference) to
       be destroyed.

DESCRIPTION    [Toc]    [Back]

       This  routine destroys the condition variable specified by
       cond.   After  this  routine  is  called,  DECthreads  may
       reclaim  internal  storage  used by the condition variable
       object. Call this routine when a condition  variable  will
       no longer be referenced.

       The  results of this routine are unpredictable if the condition
 variable specified in cond does not exist or is not
       initialized.

       For  more  information about actions when threads are present,
 refer to the pthread_cond_destroy(3) description.

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  the  type  of error.  Possible
       return values are as follows: Successful completion.   The
       object  being  referenced  by  cond is being referenced by
       another    thread    that    is    currently     executing
       tis_cond_wait(3)  on  the  condition variable specified in
       cond.  (This error can only occur when  threads  are  present.)
   The value specified by cond is not a valid condition
 variable.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:    tis_cond_broadcast(3),     tis_cond_init(3),
       tis_cond_signal(3), tis_cond_wait(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                              tis_cond_destroy(3)