PTHREAD_BARRIERATTR_DESTROY(3C) Standard C Library Functions

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 implementation 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
number 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(7) for descriptions of the following attributes:


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

SEE ALSO

pthread_barrierattr_getpshared(3C), attributes(7), standards(7)


January 30, 2004 PTHREAD_BARRIERATTR_DESTROY(3C)