pthread_condattr_setpshared()

Set the process-shared attribute in a condition variable attribute object

Synopsis:

#include <pthread.h>

int pthread_condattr_setpshared( 
                        pthread_condattr_t* attr,
                        int pshared );

Library:

libc

Description:

The pthread_condattr_setpshared() function sets the process-shared attribute in a condition variable attribute object, attr to the value given by pshared.

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's 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

The condition variable attribute object specified by attr is invalid, or the new value specified in pshared isn't PTHREAD_PROCESS_SHARED or PTHREAD_PROCESS_PRIVATE.

Classification:

POSIX 1003.1 (Threads)

See also:

pthread_condattr_init(), pthread_condattr_getpshared(), pthread_create(), pthread_mutex_init(), pthread_cond_init()