unix.7: Enhance the description of SCM_RIGHTS

The existing description is rather thin. More can be said.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2018-07-08 10:57:27 +02:00
parent 8bdcf4bf81
commit 13600496d3
1 changed files with 10 additions and 2 deletions

View File

@ -369,8 +369,16 @@ For more information see
.B SCM_RIGHTS
Send or receive a set of open file descriptors from another process.
The data portion contains an integer array of the file descriptors.
The passed file descriptors behave as though they have been created with
.BR dup (2).
Commonly, this operation is referred to as "passing a file descriptor"
to another process.
However, more accurately,
what is being passed is a reference to an open file description (see
.BR open (2)),
and in the receiving process it is likely that a different
file descriptor number will be used.
Semantically, this operation is equivalent to duplicating
.RB ( dup (2))
a file descriptor into the file descriptor table of another process.
.IP
The kernel constant
.BR SCM_MAX_FD