upstream/opnsense-src
1
0
Fork 0
mirror of https://github.com/opnsense/src.git synced 2026-04-23 07:07:24 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

netmap: bridge: update man page with more information

Browse source 
Update the man page to describe how it is necessary to
enable promiscuous mode and/or disable offloads.
This commit is contained in:
Vincenzo Maffione 2020-11-21 18:20:21 +00:00
parent 5a2a4551f5
commit 792d05c2c8
1 changed files with 17 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
tools/tools/netmap/bridge.8
View file

@ -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 (zero-copy mode), unless
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 intent
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