aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorWillem de Bruijn <willemb@google.com>2023-03-02 10:48:08 -0500
committerAlejandro Colomar <alx@kernel.org>2023-03-06 14:33:58 +0100
commit3360dceb59e09bd77259d4b30db9b0c3bfe91309 (patch)
tree60fc8ff01bc8205916792c3d26cfa4da230ed7db
parent806eabd74910447f21005160e90957bde4db0183 (diff)
downloadman-pages-3360dceb59e09bd77259d4b30db9b0c3bfe91309.tar.gz
udp.7: add UDP_GRO
UDP_GRO was added in commit e20cf8d3f1f7 ("udp: implement GRO for plain UDP sockets.") $ git describe --contains e20cf8d3f1f7 linux/v5.0-rc1~129^2~379^2~8 Kernel source has example code in tools/testing/selftests/net/udpgro* Per https://www.kernel.org/doc/man-pages/patches.html, "Describe how you obtained the information in your patch": I reviewed the relevant UDP_GRO patches. Signed-off-by: Willem de Bruijn <willemb@google.com> Reviewed-by: Simon Horman <simon.horman@corigine.com> Cc: <pabeni@redhat.com> Cc: <netdev@vger.kernel.org> [ alx: srcfix ] Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man7/udp.714
1 files changed, 14 insertions, 0 deletions
diff --git a/man7/udp.7 b/man7/udp.7
index 79fe130fbd..a9fdfbac9c 100644
--- a/man7/udp.7
+++ b/man7/udp.7
@@ -233,6 +233,20 @@ calls by passing it as a
.BR cmsg (7).
A value of zero disables the feature.
This option should not be used in code intended to be portable.
+.TP
+.BR UDP_GRO " (since Linux 5.0)"
+Enables UDP receive offload.
+If enabled,
+the socket may receive multiple datagrams worth of data
+as a single large buffer,
+together with a
+.BR cmsg (7)
+that holds the segment size.
+This option is the inverse of segmentation offload.
+It reduces receive cost by handling multiple datagrams worth of data
+as a single large packet in the kernel receive path,
+even when that exceeds MTU.
+This option should not be used in code intended to be portable.
.SS Ioctls
These ioctls can be accessed using
.BR ioctl (2).