pthread_rwlockattr_getpshared(3)

pthread_rwlockattr_getpshared3

Get the process shared attribute

Usage

#include <pthread.h>

int

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

Library

POSIX Threads Library (libpthread, -lpthread)

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

79 releases since FreeBSD 2.2.8-RELEASE; the text changed 46 times.

  1. 2.2.8
  2. 2.2.9
  3. 3.0–3.2
  4. 3.3–3.4
  5. 3.5–3.5.1
  6. 4.0
  7. 4.1–4.2
  8. 4.3
  9. 4.4
  10. 4.5–4.11
  11. 5.0
  12. 5.1–5.2.1
  13. 5.3–5.5
  14. 6.0–6.3
  15. 6.4
  16. 7.0
  17. 7.1
  18. 7.2
  19. 7.3
  20. 7.4
  21. 8.0
  22. 8.1
  23. 8.2
  24. 8.3
  25. 8.4
  26. 9.0
  27. 9.1
  28. 9.2
  29. 9.3
  30. 10.0
  31. 10.1
  32. 10.2
  33. 10.3
  34. 10.4
  35. 11.0
  36. 11.1
  37. 11.2
  38. 11.3
  39. 11.4
  40. 12.0
  41. 12.1
  42. 12.2
  43. 12.3
  44. 12.4
  45. 13.0
  46. 13.1–13.2
  47. 13.3–16.0

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 base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.