pthread_rwlockattr_setpshared(3)

pthread_rwlockattr_setpshared3

Set the process shared attribute

Usage

#include <pthread.h>

int

pthread_rwlockattr_setpshared(pthread_rwlockattr_t *attr, int pshared);

Overview

The pthread_rwlockattr_setpshared() function sets the process shared attribute of attr to the value referenced by pshared. The pshared argument may be one of two values:

PTHREAD_PROCESS_SHARED

Any thread of any process that has access to the memory where the read/write lock resides can manipulate the lock.

PTHREAD_PROCESS_PRIVATE

Only threads created within the same process as the thread that initialized the read/write lock can manipulate the lock. This is the default value.

Return values

If successful, the pthread_rwlockattr_setpshared() function will return zero. Otherwise an error number will be returned to indicate the error.

Errors

The pthread_rwlockattr_setpshared() function will fail if:

[EINVAL]

The value specified by attr or pshared is invalid.

Releases

149 releases since Mac OS X 10.2; the text changed 2 times.

  1. 10.2–10.4.11
  2. 10.5–10.11.6
  3. 10.12–26.5

Standards

The pthread_rwlockattr_setpshared() function is expected to conform to Version 2 of the Single UNIX Specification (“SUSv2”).

History

The pthread_rwlockattr_setpshared() function first appeared in FreeBSD 3.0.

Bugs

The PTHREAD_PROCESS_SHARED attribute is not supported.

From libpthread 539.100.4 in macOS 26.5. Parsed by carta from the page's mdoc source.