PTHREAD_BARRIER_INIT(3)

NAME
pthread_barrier_init, pthread_barrier_destroy - initialize and destroy a barrier object

SYNOPSIS
libpthread
#include <pthread.h>
int
pthread_barrier_init(pthread_barrier_t *barrier, pthread_barrierattr_t *attr, unsigned int count);
int
pthread_barrier_destroy(pthread_barrier_t *barrier);

DESCRIPTION
The pthread_barrier_init() function creates a new barrier object, with attributes specified with attr and with a threshold specified with count. If attr is NULL, the default attributes are used. The count argument is later used by the pthread_barrier_wait() function to check if the required number of threads reached the barrier.

The pthread_barrier_destroy() function frees the resources allocated for barrier.

RETURN VALUES
If successful, pthread_barrier_init() and pthread_barrier_destroy() return zero; otherwise an error number is returned to indicate the error.

ERRORS
pthread_barrier_init() will fail if:

[EINVAL]
    The value specified by barrier or attr is invalid.

[ENOMEM]
    The process cannot allocate enough memory to create another barrier object.

[ENOTSUP]
    The attributes specified by attr are not supported by the current implementation.

pthread_barrier_destroy() will fail if:

[EINVAL]
    The value specified by barrier is invalid.

[EBUSY]
    There are still threads waiting on the barrier.

SEE ALSO
pthread_barrier_wait(3), pthread_barrierattr_getpshared(3), pthread_barrierattr_init(3)

STANDARDS
pthread_barrier_init() and pthread_barrier_destroy() conform to p1003.1-2008.

BUGS
Currently only private barriers are supported and the pshared attribute is always set that way. Any attempts to change that value will trigger ENOTSUP.