pthread_condattr_setpshared(3)pthread_condattr_setpshared(3)NAMEpthread_condattr_setpshared - Change the process-shared attribute of a
condition variable attributes object
SYNOPSIS
#include <pthread.h>
int pthread_condattr_setpshared(
pthread_condattr_t attr,
int pshared );
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
PARAMETERS
Address of the condition variable attributes objects whose process-
shared attribute is to be set. New value for the process-shared
attribute of the condition variable attributes object specified by
attr.
DESCRIPTION
This routine uses the value specified in the pshared argument to set
the process-shared attribute of the condition variable attributes
object specified in the attr argument.
Creating a condition variable whose process-shared attribute is set to
PTHREAD_PROCESS_PRIVATE permits it to be operated upon by threads cre‐
ated within the same process as the thread that initialized the condi‐
tion variable. If threads of differing processes attempt to operate on
such a condition variable, the behavior is undefined.
The default value of the process-shared attribute of an initialized
condition variable attributes object is PTHREAD_PROCESS_PRIVATE.
Creating a condition variable whose process-shared attribute is set to
PTHREAD_PROCESS_SHARED permits it to be operated upon by any thread
that has access to the memory where that condition variable is allo‐
cated, even if it is allocated in memory that is shared by multiple
processes.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error. Possible return values are as follows:
Successful completion. The value specified by attr is not a valid
attributes object, or the value specified by pshared is outside the
range of legal values for that attribute.
ERRORS
None
SEE ALSO
Functions: pthread_condattr_getpshared(3), pthread_condattr_init(3)
Manuals: Guide to DECthreads and Programmer's Guide
pthread_condattr_setpshared(3)