aboutsummaryrefslogtreecommitdiffstats
path: root/man7/unix.7
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2018-07-08 11:00:23 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2018-07-08 21:13:08 +0200
commitc87721467e21e060c332ca53f3f4ec6e01686c17 (patch)
treee400c78ae507fdb62635af1face5d5d20591a61c /man7/unix.7
parent13600496d347ec95a1afe67bd67530ff74563316 (diff)
downloadman-pages-c87721467e21e060c332ca53f3f4ec6e01686c17.tar.gz
unix.7: Note behavior if buffer to receive ancillary data is too small
If the buffer supplied to recvmsg() to receive ancillary data is too small, then the data is truncated and the MSG_CTRUNC flag is set. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man7/unix.7')
-rw-r--r--man7/unix.713
1 files changed, 13 insertions, 0 deletions
diff --git a/man7/unix.7 b/man7/unix.7
index 0850ebc1be..e4c19324de 100644
--- a/man7/unix.7
+++ b/man7/unix.7
@@ -435,6 +435,19 @@ To receive a
message, the
.B SO_PASSCRED
option must be enabled on the socket.
+.PP
+If the space allocated for receiving incoming ancillary data is too small,
+then the ancillary data is truncated to the number of headers
+that will fit in the supplied buffer (or, in the case of an
+.BR SCM_RIGHTS
+file descriptor list, the list of file descriptors may be truncated).
+In the event of such truncation, the
+.BR MSG_CTRUNC
+flag will be set in the
+.I msg.msg_flags
+value returned by
+.BR recvmsg (2).
+.\"
.SS Ioctls
The following
.BR ioctl (2)