git: 2152c4e2db88 - main - pthread_mutexattr_init(3): describe pthread_mutexattr_{set,get}pshared

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Thu, 26 Oct 2023 21:12:15 UTC
The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=2152c4e2db88b9264c6400f2510440465d39c7b8

commit 2152c4e2db88b9264c6400f2510440465d39c7b8
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2023-10-23 22:54:54 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2023-10-26 21:05:29 +0000

    pthread_mutexattr_init(3): describe pthread_mutexattr_{set,get}pshared
    
    PR:     274678
    Reviewed by:    emaste
    Sponsored by:   The FreeBSD Foundation
    MFC after:      3 days
    Differential revision:  https://reviews.freebsd.org/D42344
---
 share/man/man3/pthread_mutexattr.3 | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/share/man/man3/pthread_mutexattr.3 b/share/man/man3/pthread_mutexattr.3
index 8e457b87dc8f..30537b9a9f86 100644
--- a/share/man/man3/pthread_mutexattr.3
+++ b/share/man/man3/pthread_mutexattr.3
@@ -132,6 +132,26 @@ all threads waiting on any mutex owned by this thread.
 .El
 .Pp
 The
+.Fn pthread_mutexattr_setpshared
+function sets the process-shared attribute of
+.Fa attr
+to the value specified in
+.Fa pshared .
+The argument
+.Fa pshared
+may have one of the following values:
+.Bl -tag -width ".Dv PTHREAD_PROCESS_PRIVATE"
+.It Dv PTHREAD_PROCESS_PRIVATE
+The mutex may only be used by threads in the same process as the one
+that created the object.
+.It Dv PTHREAD_PROCESS_SHARED
+The mutex may be used by
+threads in processes other than the one that created the object,
+assuming other processes share access to the memory where the mutex
+was allocated.
+.El
+.Pp
+The
 .Fn pthread_mutexattr_setrobust
 function specifies robustness attribute of the mutex.
 Possible values for the