NAME    [Toc]    [Back]

       tis_cond_init - Initializes a condition variable

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       int tis_cond_init(
               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 initialized.

DESCRIPTION    [Toc]    [Back]

       This routine initializes a condition variable (cond)  with
       the DECthreads default condition variable attributes.

       A  condition  variable is a synchronization object used in
       conjunction with a  mutex.  A  mutex  controls  access  to
       shared  data.  When threads are present, a condition variable
 allows threads to wait for data to  enter  a  defined
       state.

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

       Your program can use the macro PTHREAD_COND_INITIALIZER to
       initialize statically allocated condition variables to the
       DECthreads default condition variable  attributes.  Static
       initialization  can  be used only for a condition variable
       with storage class extern or  static  -  automatic  (stack
       local)    objects   must   be   initialized   by   calling
       tis_cond_destroy(3). Use this macro as follows:

       pthread_cond_t condition= PTHREAD_COND_INITIALIZER

       When statically initialized, a condition  variable  should
       not also be initialized using tis_cond_init(3).

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition occurs, the following occurs: The
       routine returns an integer value indicating  the  type  of
       error.   The  condition  variable is not initialized.  The
       contents of condition variable cond are undefined.

       The possible return values are as follows: Successful completion.
  The system lacks the necessary resources to initialize
 another condition variable, or The  system-imposed
       limit  on  the  total  number of condition variables under
       execution by a single user is exceeded.   The  implementation
  has  detected  an attempt to reinitialize the object
       referenced by cond, a previously initialized, but not  yet
       destroyed condition variable.  The value specified by attr
       is not a valid condition  variable.   Insufficient  memory
       exists to initialize the condition variable.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

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

       Manuals: Guide to DECthreads and Programmer's Guide



                                                 tis_cond_init(3)