Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 4 Oct 2025 16:44:32 GMT
From:      Zhenlei Huang <zlei@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: 7cbb184bbfa3 - stable/13 - gif.4: Mention that gif(4) can tunnel Ethernet traffic
Message-ID:  <202510041644.594GiWm3058032@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch stable/13 has been updated by zlei:

URL: https://cgit.FreeBSD.org/src/commit/?id=7cbb184bbfa3ffab031aca864647ddb387094e27

commit 7cbb184bbfa3ffab031aca864647ddb387094e27
Author:     Zhenlei Huang <zlei@FreeBSD.org>
AuthorDate: 2025-08-27 15:55:22 +0000
Commit:     Zhenlei Huang <zlei@FreeBSD.org>
CommitDate: 2025-10-04 16:43:21 +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
    
    (cherry picked from commit bf6027df0955cb79c9c56c47cc96709b2215c82a)
    (cherry picked from commit 1b42526ce9f4e4587f4179a7e78655ce34b95110)
---
 share/man/man4/gif.4 | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/share/man/man4/gif.4 b/share/man/man4/gif.4
index 959510451011..03fc712bf2a6 100644
--- a/share/man/man4/gif.4
+++ b/share/man/man4/gif.4
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd October 21, 2018
+.Dd August 27, 2025
 .Dt GIF 4
 .Os
 .Sh NAME
@@ -54,6 +54,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.
@@ -169,6 +179,7 @@ variable
 to the desired level of nesting.
 .Sh SEE ALSO
 .Xr gre 4 ,
+.Xr if_bridge 4 ,
 .Xr inet 4 ,
 .Xr inet6 4 ,
 .Xr ifconfig 8
@@ -188,6 +199,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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202510041644.594GiWm3058032>