pthread_condattr_getpshared()

Get the process-shared attribute from a condition variable attribute object

Synopsis:

#include <pthread.h>

int pthread_condattr_getpshared( 
            const pthread_condattr_t* attr,
            int* pshared );

Library:

libc

Description:

The pthread_condattr_getpshared() function stores, in the memory pointed to by pshared, the process-shared attribute from a condition variable attribute object, attr.

If the process-shared attribute is set to PTHREAD_PROCESS_SHARED, any thread that has access to the memory where the condition variable is allocated can operate on it, even if the condition variable is allocated in memory that is shared by multiple processes.

If the process-shared attribute is PTHREAD_PROCESS_PRIVATE, the condition variable can only be accessed by threads created within the same process as the thread that initialized the condition variable; if threads from other processes try to access the PTHREAD_PROCESS_PRIVATE condition variable, the behavior is undefined. The default value of the process-shared attribute is PTHREAD_PROCESS_PRIVATE.

Returns:

EOK

Success.

EINVAL

Invalid condition variable attribute object specified by attr.

Classification:

POSIX 1003.1 (Threads)

See also:

pthread_condattr_init(), pthread_condattr_setpshared(), pthread_create(), pthread_mutex_init(), pthread_cond_init().