pthread_rwlockattr_getpshared(3)

pthread_rwlockattr_getpshared3

Get the process shared attribute

Usage

#include <pthread.h>

int

pthread_rwlockattr_getpshared(const pthread_rwlockattr_t *attr, int *pshared);

Overview

The pthread_rwlockattr_getpshared() function is used to get the process shared setting of a read/write lock attribute object. The setting is returned via pshared, and 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_getpshared() function will return zero. Otherwise an error number will be returned to indicate the error.

Errors

The pthread_rwlockattr_getpshared() function may fail if:

[EINVAL]

The value specified by attr 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_getpshared() function is expected to conform to Version 2 of the Single UNIX Specification (“SUSv2”).

History

The pthread_rwlockattr_getpshared() function first appeared in FreeBSD 3.0.

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