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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Date:	Mon, 1 Dec 2008 11:16:31 -0500
From:	"Michael Kerrisk" <mtk.manpages@...glemail.com>
To:	"David Miller" <davem@...emloft.net>,
	netdev <netdev@...r.kernel.org>,
	"Andi Kleen" <andi@...stfloor.org>,
	"Stephen Hemminger" <shemminger@...ux-foundation.org>
Cc:	linux-man@...r.kernel.org, "Daniel Kabs" <dkabs@...otix.com>,
	"Herbert Xu" <herbert@...dor.apana.org.au>
Subject: RFC: Updating MSG_TRUNC documentation for datagram/netlink/unix sockets

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 netdev" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html