git: bf6027df0955 - main - gif.4: Mention that gif(4) can tunnel Ethernet traffic

From: Zhenlei Huang <zlei_at_FreeBSD.org>
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