unix.7: Note SCM_RIGHTS interaction with RLIMIT_NOFILE

If the file descriptors received in SCM_RIGHTS would cause
the process to its exceed RLIMIT_NOFILE limit, the excess
FDs are discarded.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man7/unix.7 b/man7/unix.7
index f22e9c0eda3753d3034fe936cc24da4c9df68307..b4b60308a0abb341e2c8c9c7dc6160d7d0fcda5c 100644 (file)
--- a/man7/unix.7
+++ b/man7/unix.7
@@ -452,6 +452,14 @@ then the ancillary data is truncated (or discarded)
 and the excess file descriptors are automatically closed
 in the receiving process.
 .IP
+If the number of file descriptors received in the ancillary data would
+cause the process to exceed its
+.B RLIMIT_NOFILE
+resource limit (see
+.BR getrlimit (2)),
+the excess file descriptors are automatically closed
+in the receiving process.
+.IP
 The kernel constant
 .BR SCM_MAX_FD
 defines a limit on the number of file descriptors in the array.