pthread_barrierattr_getpshared()

Get the value of a barrier's process-shared attribute

Synopsis:

#include <pthread.h>

int pthread_barrierattr_getpshared( 
                   const pthread_barrierattr_t * attr
                   int * pshared );

Arguments:

attr: A pointer to the pthread_barrierattr_t object whose attribute you want to query. You must have initialized this object by calling pthread_barrierattr_init() before calling pthread_barrierattr_getpshared().
pshared: A pointer to a location where the function can store the value of the process-shared attribute. For information about the possible values, see pthread_barrierattr_setpshared().

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pthread_barrierattr_getpshared() function gets the value of the process-shared attribute from the attributes object referenced by attr and stores the value in the object referenced by pshared. The possible values are:

PTHREAD_PROCESS_SHARED — the barrier can be operated upon by any thread that has access to the memory where the barrier is allocated.
PTHREAD_PROCESS_PRIVATE — the barrier can be operated on only by threads created within the same process as the thread that initialized the barrier.

Note: (QNX Neutrino 7.0.1 or later) If you started procnto with the -s option, set the process-shared attribute to PTHREAD_PROCESS_SHARED for any barriers that are shared between processes. For more information, see “Safely sharing mutexes, barriers, and reader/writer locks between processes” in the “QNX Neutrino Microkernel” chapter of the System Architecture guide.

Returns:

EOK: Success.
EINVAL: Invalid barrier attribute object attr.

Classification:

POSIX 1003.1 TSH

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes