*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> tis_cond_init (3)              



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]


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

       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]


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

[ Back ]
 Similar pages
Name OS Title
pthread_condattr_init Tru64 Initializes a condition variable attributes object
pthread_cond_init FreeBSD create a condition variable
cv_timedwait_sig FreeBSD kernel condition variable
cv_timedwait FreeBSD kernel condition variable
pthread_cond_wait FreeBSD wait on a condition variable
cv_wait_sig FreeBSD kernel condition variable
pthread_cond_destroy Tru64 Destroys a condition variable
cv_wait FreeBSD kernel condition variable
cv_init FreeBSD kernel condition variable
condvar FreeBSD kernel condition variable
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service