Index Index for
Section 3
Index Alphabetical
listing for P
Bottom of page Bottom of
page		 

pthread_condattr_init(3)


NAME

  pthread_condattr_init - Initializes a condition variable attributes object


SYNOPSIS

  #include <pthread.h>

  int pthread_condattr_init(
	  pthread_condattr_t *attr );


LIBRARY

  DECthreads POSIX 1003.1c Library (libpthread.so)


STANDARDS

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

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


PARAMETERS

  attr
      Address of the condition variable attributes object to be initialized.


DESCRIPTION

  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

  If an error condition occurs, this routine returns an integer value
  indicating the type of error. Possible return values are as follows:

  0   Successful completion.

  [EINVAL]
      The value specified by attr is not a valid condition variable
      attributes object.

  [ENOMEM]
      Insufficient memory exists to initialize the condition variable
      attributes object.


ERRORS

  None


SEE ALSO

  Functions: pthread_condattr_destroy(3), pthread_cond_init(3)

  Manuals: Guide to DECthreads and Programmer's Guide

Index Index for
Section 3
Index Alphabetical
listing for P
Top of page Top of
page