RFC: Updating MSG_TRUNC documentation for datagram/netlink/unix sockets

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



I'm trying to update the description of MSG_TRUNC as an *input* flag
value for calls to recv*().  I'd appreciate it if someone could could
confirm the changes in the following patch to the recv(2) man page.

(Dave, it looks like you implemented (commit commit
b558ff799977a4eda8b3823d1cf6c1c33becb671) at least some of the parts
that I'm trying to document here...  )

Cheers,

Michael

-.TH RECV 2 2008-07-14 "Linux" "Linux Programmer's Manual"
+.TH RECV 2 2008-12-01 "Linux" "Linux Programmer's Manual"
 .SH NAME
 recv, recvfrom, recvmsg \- receive a message from a socket
 .SH SYNOPSIS
@@ -254,9 +254,18 @@ Thus, a
 subsequent receive call will return the same data.
 .TP
 .BR MSG_TRUNC " (since Linux 2.2)"
-Return the real length of the packet, even when it was longer than
-the passed buffer.
-Only valid for packet sockets.
+For raw
+.RB ( AF_PACKET ),
+Internet datagram (since Linux 2.4.27/2.6.8),
+and netlink (since Linux 2.6.22) sockets:
+return the real length of the packet or datagram,
+even when it was longer than the passed buffer.
+Not implemented for Unix domain
+.RP ( unix (7))
+sockets.
+
+For use with Internet stream sockets, see
+.BR tcp (7).
 .TP
 .BR MSG_WAITALL " (since Linux 2.2)"
 This flag requests that the operation block until the full request is
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux