git: bf6027df0955 - main - gif.4: Mention that gif(4) can tunnel Ethernet traffic
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 27 Aug 2025 15:56:38 UTC
The branch main has been updated by zlei:
URL: https://cgit.FreeBSD.org/src/commit/?id=bf6027df0955cb79c9c56c47cc96709b2215c82a
commit bf6027df0955cb79c9c56c47cc96709b2215c82a
Author: Zhenlei Huang <zlei@FreeBSD.org>
AuthorDate: 2025-08-27 15:55:22 +0000
Commit: Zhenlei Huang <zlei@FreeBSD.org>
CommitDate: 2025-08-27 15:55:22 +0000
gif.4: Mention that gif(4) can tunnel Ethernet traffic
Ideally this manpage shall have examples for the EtherIP setup, but
there has been one in if_bridge(4) since the introduction of EtherIP [1],
so direct the setup to if_bridge(4) at this moment.
While here, add RFC 3378 to the reference section.
[1] 73ff045c575b Add RFC 3378 EtherIP support
Reviewed by: meta
MFC after: 1 week
Differential Revision: https://reviews.freebsd.org/D51781
---
share/man/man4/gif.4 | 19 ++++++++++++++++++-
1 file changed, 18 insertions(+), 1 deletion(-)
diff --git a/share/man/man4/gif.4 b/share/man/man4/gif.4
index ad33d5d21e81..cc12d91b72ea 100644
--- a/share/man/man4/gif.4
+++ b/share/man/man4/gif.4
@@ -28,7 +28,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd July 14, 2025
+.Dd August 27, 2025
.Dt GIF 4
.Os
.Sh NAME
@@ -55,6 +55,16 @@ does not perform GRE encapsulation; use
.Xr gre 4
for GRE encapsulation.
.Pp
+The
+.Nm
+interface can also tunnel Ethernet traffic over IPv4 or IPv6
+when combined with a
+.Xr if_bridge 4
+interface using EtherIP protocol.
+See
+.Xr if_bridge 4
+for detailed setup.
+.Pp
Each
.Nm
interface is created at runtime using interface cloning.
@@ -316,6 +326,13 @@ to the desired level of nesting.
.%D December 1999
.%O draft-ietf-ipsec-ecn-02.txt
.Re
+.Rs
+.%A R. Housley
+.%A S. Hollenbeck
+.%T EtherIP: Tunneling Ethernet Frames in IP Datagrams
+.%R RFC 3378
+.%D September 2002
+.Re
.\"
.Sh HISTORY
The