From 3d3cddde9418e9d1c45122a41fb29d0e69db8dc8 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sun, 23 Dec 2018 18:24:06 +0100 Subject: [PATCH] unix.7: Rework SO_PEERCRED text for greater clarity Signed-off-by: Michael Kerrisk --- man7/unix.7 | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/man7/unix.7 b/man7/unix.7 index e91484c7d..1bc7804f0 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -320,25 +320,29 @@ See .BR socket (7). .TP .B SO_PEERCRED -Return the credentials of the peer process connected to this socket. -This is possible only for connected -.B AF_UNIX -stream sockets and -.B AF_UNIX -stream and datagram socket pairs created using -.BR socketpair (2). +This read-only socket option returns the +credentials of the peer process connected to this socket. The returned credentials are those that were in effect at the time of the call to .BR connect (2) or .BR socketpair (2). -The argument is a +.IP +The argument to +.BR getsockopt (2) +is a pointer to a .I ucred structure; define the .B _GNU_SOURCE feature test macro to obtain the definition of that structure from .IR . -This socket option is read-only. +.IP +The use of this option is possible only for connected +.B AF_UNIX +stream sockets and for +.B AF_UNIX +stream and datagram socket pairs created using +.BR socketpair (2). .\" .SS Autobind feature If a