svn commit: r367996 - stable/12/tools/tools/netmap

[Vincenzo Maffione]

Author: vmaffione
Date: Tue Nov 24 19:55:01 2020
New Revision: 367996
URL: https://svnweb.freebsd.org/changeset/base/367996

Log:
  MFC r367920, r367921
  
  netmap: bridge: update man page with more information
  
  Update the man page to describe how it is necessary to
  enable promiscuous mode and/or disable offloads.

Modified:
  stable/12/tools/tools/netmap/bridge.8
  stable/12/tools/tools/netmap/pkt-gen.8
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/tools/tools/netmap/bridge.8
==============================================================================
--- stable/12/tools/tools/netmap/bridge.8	Tue Nov 24 17:53:13 2020	(r367995)
+++ stable/12/tools/tools/netmap/bridge.8	Tue Nov 24 19:55:01 2020	(r367996)
@@ -23,7 +23,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 28, 2018
+.Dd November 21, 2020
 .Dt BRIDGE 8
 .Os
 .Sh NAME
@@ -49,6 +49,20 @@ forwards packets without copying the packets payload (
 explicitly prevented by the
 .Fl c
 flag.
+.Pp
+When bridging two physical ports, it is necessary that both NICS are in
+promiscuous mode, otherwise unicast traffic directed to other hosts will
+be dropped by the hardware, and bridging will not work.
+.Pp
+When bridging the hardware rings of a physical port with the corresponding
+host rings, it is necessary to turn off the offloads, because netmap does
+not prepare the NIC rings with offload information.
+Example:
+.Bd -literal -offset indent
+ifconfig em0 -rxcsum -txcsum -tso4 -tso6 -lro
+.Ed
+.Pp
+Available options:
 .Bl -tag -width Ds
 .It Fl i Ar port
 Name of the netmap port.
@@ -71,8 +85,8 @@ Disable zero-copy mode.
 .El
 .Sh SEE ALSO
 .Xr netmap 4 ,
-.Xr pkt-gen 8 ,
-.Xr lb 8
+.Xr lb 8 ,
+.Xr pkt-gen 8
 .Sh AUTHORS
 .An -nosplit
 .Nm

Modified: stable/12/tools/tools/netmap/pkt-gen.8
==============================================================================
--- stable/12/tools/tools/netmap/pkt-gen.8	Tue Nov 24 17:53:13 2020	(r367995)
+++ stable/12/tools/tools/netmap/pkt-gen.8	Tue Nov 24 19:55:01 2020	(r367996)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 3, 2020
+.Dd November 21, 2020
 .Dt PKT-GEN 8
 .Os
 .Sh NAME
@@ -287,7 +287,7 @@ Send a stream of fake DNS packets between two hosts wi
 length of 128 bytes.
 You must set the destination MAC address for
 packets to be received by the target host.
-.Bd -literal -offset intent
+.Bd -literal -offset indent
 pkt-gen -i netmap:ncxl0 -f tx -s 172.16.0.1:53 -d 172.16.1.3:53 -D 00:07:43:29:2a:e0
 .Ed
 .Sh SEE ALSO