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);

Library

POSIX Threads Library (libpthread, -lpthread)

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

79 releases since FreeBSD 2.2.8-RELEASE; the text changed 45 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–13.2
  46. 13.3–16.0

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. Support for process-shared read/write locks appeared in FreeBSD 11.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.