git: fddd2c4d3789 - releng/14.3 - ar40xx.4: Initial manual page

The branch releng/14.3 has been updated by ziaee:

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

commit fddd2c4d37893dde3391d5c6d837e211483acad5
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-05-12 02:22:59 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-05-22 03:00:12 +0000

    ar40xx.4: Initial manual page
    
    For inclusion in apropos and the hardware release notes. While here,
    add xrefs to this page and the previous e6000sw in etherswitch.4.
    
    MFC after:              3 days (but adjusted for 14.3)
    Reported by:            adrian
    Reviewed by:            adrian, mhorne
    Approved by:            mhorne (mentor)
    Approved by:            re (cperciva)
    Differential Revision:  https://reviews.freebsd.org/D50324
    
    (cherry picked from commit 91c9751c3913497db2fbad1fcf7491557bbd2a75)
    (cherry picked from commit 17e9eb1e0eb721e2400232c71f20bc490c416c60)
---
 share/man/man4/etherswitch.4     |  8 ++++----
 share/man/man4/man4.arm/Makefile |  1 +
 share/man/man4/man4.arm/ar40xx.4 | 35 +++++++++++++++++++++++++++++++++++
 3 files changed, 40 insertions(+), 4 deletions(-)

diff --git a/share/man/man4/etherswitch.4 b/share/man/man4/etherswitch.4
index aeb5e484e7cf..928d5a09e49a 100644
--- a/share/man/man4/etherswitch.4
+++ b/share/man/man4/etherswitch.4
@@ -48,12 +48,12 @@ driver provides a framework for Ethernet switch devices.
 device nodes
 .El
 .Sh SEE ALSO
+.Xr adm6996fc 4 ,
+.Xr ar40xx 4 ,
 .Xr arswitch 4 ,
-.Xr iicbus 4 ,
-.Xr ip17x 4 ,
-.Xr rtl8366rb 4 ,
+.Xr e6000sw 4 ,
 .Xr e6060sw 4 ,
-.Xr adm6996fc 4 ,
+.Xr iicbus 4 ,
 .Xr ksz8995ma 4 ,
 .Xr ukswitch 4 ,
 .Xr etherswitchcfg 8
diff --git a/share/man/man4/man4.arm/Makefile b/share/man/man4/man4.arm/Makefile
index e2a41559410b..36540f690c5e 100644
--- a/share/man/man4/man4.arm/Makefile
+++ b/share/man/man4/man4.arm/Makefile
@@ -1,5 +1,6 @@
 
 MAN=	\
+	ar40xx.4 \
 	aw_gpio.4 \
 	aw_mmc.4 \
 	aw_rtc.4 \
diff --git a/share/man/man4/man4.arm/ar40xx.4 b/share/man/man4/man4.arm/ar40xx.4
new file mode 100644
index 000000000000..e314d30dd4c6
--- /dev/null
+++ b/share/man/man4/man4.arm/ar40xx.4
@@ -0,0 +1,35 @@
+.\"
+.\" Copyright (c) 2025 Alexander Ziaee
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
+.Dd May 10, 2025
+.Dt AR40XX 4 arm
+.Sh NAME
+.Nm ar40xx_switch
+.Nd Qualcomm IPQ4018/IPQ4019 Gigabit Ethernet switch driver
+.Sh SYNOPSIS
+.Cd device mdio
+.Cd etherswitch
+.Cd ar40xx_switch
+.Sh DESCRIPTION
+The
+.Nm
+driver supports the Gigabit Ethernet switch inside the
+Qualcomm IPQ4018/IPQ4019 SoC.
+.Sh HARDWARE
+The
+.Nm
+driver supports the following Gigabit Ethernet switch controllers:
+.Pp
+.Bl -bullet -compact
+.It
+Qualcomm IPQ 4019 Five-port Gigabit Ethernet Switch
+.It
+Qualcomm IPQ 4018 Five-port Gigabit Ethernet Switch
+.El
+.Sh SEE ALSO
+.Xr etherswitch 4 ,
+.Xr etherswitchcfg 8
+.Sh CAVEATS
+This driver currently only supports L2 port/VLAN mapping modes.