opensolaris man page for pthread_barrierattr_init

pthread_barrierattr_destroy(3C) 			   Standard C Library Functions 			   pthread_barrierattr_destroy(3C)

NAME
       pthread_barrierattr_destroy, pthread_barrierattr_init - destroy and initialize barrier attributes object

SYNOPSIS
       cc -mt [ flag... ] file... [ library... ]
       #include <pthread.h>

       int pthread_barrierattr_destroy(pthread_barrierattr_t *attr);

       int pthread_barrierattr_init(pthread_barrierattr_t *attr);

DESCRIPTION
       The  pthread_barrierattr_destroy()  function  destroys a barrier attributes object. A destroyed attr attributes object can be reinitialized
       using pthread_barrierattr_init(). The results of otherwise referencing the object after it has been destroyed are undefined. An implementa-
       tion can cause pthread_barrierattr_destroy() to set the object referenced by attr to an invalid value.

       The  pthread_barrierattr_init()	function  initializes  a  barrier  attributes object attr with the default value for all of the attributes
       defined by the implementation.

       Results are undefined if pthread_barrierattr_init() is called specifying an already initialized attr attributes object.

       After a barrier attributes object has been used to initialize one or more barriers, any function affecting the attributes object (including
       destruction) does not affect any previously initialized barrier.

RETURN VALUES
       Upon  successful completion, the pthread_barrierattr_destroy() and pthread_barrierattr_init() functions returns 0. Otherwise, an error num-
       ber is returned to indicate the error.

ERRORS
       The pthread_barrierattr_init() function will fail if:

       ENOMEM	 Insufficient memory exists to initialize the barrier attributes object.

       The pthread_barrierattr_destroy() function may fail if:

       EINVAL	 The value specified by attr is invalid.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       pthread_barrierattr_getpshared(3C), attributes(5), standards(5)

SunOS 5.11							    30 Jan 2004 				   pthread_barrierattr_destroy(3C)