udp: document udp_rcv_segment special case for looped packets

commit d0208bf4da97f76237300afb83c097de25645de6 upstream.

Commit 6cd021a58c18a ("udp: segment looped gso packets correctly")
fixes an issue with rare udp gso multicast packets looped onto the
receive path.

The stable backport makes the narrowest change to target only these
packets, when needed. As opposed to, say, expanding __udp_gso_segment,
which is harder to reason to be free from unintended side-effects.

But the resulting code is hardly self-describing.
Document its purpose and rationale.

Signed-off-by: Willem de Bruijn <willemb@google.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

1 files changed, 7 insertions, 0 deletions

diff --git a/include/net/udp.h b/include/net/udp.h
index 8f163d674f07..fabf507bce5d 100644
--- a/include/net/udp.h
+++ b/include/net/udp.h
@@ -476,6 +476,13 @@ static inline struct sk_buff *udp_rcv_segment(struct sock *sk,
         if (!inet_get_convert_csum(sk))
                 features |= NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM;
 
+        /* UDP segmentation expects packets of type CHECKSUM_PARTIAL or
+         * CHECKSUM_NONE in __udp_gso_segment. UDP GRO indeed builds partial
+         * packets in udp_gro_complete_segment. As does UDP GSO, verified by
+         * udp_send_skb. But when those packets are looped in dev_loopback_xmit
+         * their ip_summed is set to CHECKSUM_UNNECESSARY. Reset in this
+         * specific case, where PARTIAL is both correct and required.
+         */
         if (skb->pkt_type == PACKET_LOOPBACK)
                 skb->ip_summed = CHECKSUM_PARTIAL;