NAME    [Toc]    [Back]

       pthread_condattr_init  -  Initializes a condition variable
       attributes object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_condattr_init(
               pthread_condattr_t *attr );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program
       Interface

PARAMETERS    [Toc]    [Back]

       Address of the condition variable attributes object to  be
       initialized.

DESCRIPTION    [Toc]    [Back]

       This routine initializes the condition variable attributes
       object specified by the (attr)  argument  with  a  set  of
       default attribute values.

       When  an  attributes  object is used to create a condition
       variable, the values of the individual  attributes  determine
  the  characteristics  of the new condition variable.
       Attributes objects act as additional arguments  to  condition
  variable creation. Changing individual attributes in
       an attributes object does not affect any  condition  variables
  that  were previously created using that attributes
       object.

       You can use the same condition variable attributes  object
       in  successive calls to pthread_condattr_init(3), from any
       thread. If multiple threads can  change  attributes  in  a
       shared attributes object, your program must use a mutex to
       protect the integrity of that attributes object.

       Results are undefined if this routine is  called  and  the
       attr  argument  specifies  a condition variable attributes
       object that is already initialized.

       The     pthread_condattr_init(3)     and      pthread_condattr_destroy(3)  routines are provided for future expandability
 of the DECthreads pthread interface and to conform
       with the POSIX.1c standard. These routines serve no useful
       function, because there  are  no  pthread_condattr_set*(3)
       type routines available at this time.

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
       value specified by attr is not a valid condition  variable
       attributes object.  Insufficient memory exists to initialize
 the condition variable attributes object.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:                    pthread_condattr_destroy(3),
       pthread_cond_init(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                         pthread_condattr_init(3)