From fddd2c4d37893dde3391d5c6d837e211483acad5 Mon Sep 17 00:00:00 2001
From: Alexander Ziaee <ziaee@FreeBSD.org>
Date: Sun, 11 May 2025 22:22:59 -0400
Subject: [PATCH] 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     | 10 ++++-----
 share/man/man4/man4.arm/Makefile |  1 +
 share/man/man4/man4.arm/ar40xx.4 | 35 ++++++++++++++++++++++++++++++++
 3 files changed, 41 insertions(+), 5 deletions(-)
 create mode 100644 share/man/man4/man4.arm/ar40xx.4

diff --git a/share/man/man4/etherswitch.4 b/share/man/man4/etherswitch.4
index aeb5e484e7c..928d5a09e49 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 arswitch 4 ,
-.Xr iicbus 4 ,
-.Xr ip17x 4 ,
-.Xr rtl8366rb 4 ,
-.Xr e6060sw 4 ,
 .Xr adm6996fc 4 ,
+.Xr ar40xx 4 ,
+.Xr arswitch 4 ,
+.Xr e6000sw 4 ,
+.Xr e6060sw 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 e2a41559410..36540f690c5 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 00000000000..e314d30dd4c
--- /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.