pthread_rwlockattr_setpshared()

Updated: April 19, 2023

Set the process-shared attribute of a read-write lock attribute object

Synopsis:

#include <pthread.h>

int pthread_rwlockattr_setpshared(
       pthread_rwlockattr_t* attr,
       int pshared );

Arguments:

attr
A pointer to the pthread_rwlockattr_t object that you want to set the attribute for.
pshared
The new value of the process-shared attribute; one of:
  • PTHREAD_PROCESS_SHARED — let any thread with access to the read-write lock object's memory operate it, even if those threads are in different processes.
  • PTHREAD_PROCESS_PRIVATE — limit access to threads in the current process.

Library:

libc

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

Description:

The pthread_rwlockattr_setpshared() function sets the process-shared attribute for the read-write lock attribute object specified by attr to pshared.

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 read-write locks 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
The pshared argument is invalid.

Classification:

POSIX 1003.1 TSH

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