unix.7: Rework SO_PEERCRED text for greater clarity

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2018-12-23 18:24:06 +01:00
parent 88fedfa061
commit 3d3cddde94
1 changed files with 13 additions and 9 deletions

View File

@ -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 <sys/socket.h> .
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