git: 3a71a24bbeae - main - etherswitchcfg(8): document atu commands

From: Warner Losh <imp_at_FreeBSD.org>
Date: Wed, 10 Jun 2026 12:36:17 UTC
The branch main has been updated by imp:

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

commit 3a71a24bbeae3b72c91fd7c0b212ee607f18cba6
Author:     Kit Dallege <xaum.io@gmail.com>
AuthorDate: 2026-03-27 04:25:27 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2026-06-10 12:35:04 +0000

    etherswitchcfg(8): document atu commands
    
    Add documentation for the ATU (Address Translation Unit) commands
    that were implemented but not documented in the man page:
    
    - atu dump: display the MAC address table
    - atu flush all: clear all dynamic ATU entries
    - atu flush port <n>: clear ATU entries for a specific port
    
    Also add atu to the SYNOPSIS section.
    
    PR: 275413
    Signed-off-by: Kit Dallege <xaum.io@gmail.com>
    Reviewed by: imp
    Pull Request: https://github.com/freebsd/freebsd-src/pull/2096
---
 sbin/etherswitchcfg/etherswitchcfg.8 | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/sbin/etherswitchcfg/etherswitchcfg.8 b/sbin/etherswitchcfg/etherswitchcfg.8
index f903975bd356..8f3198c543ea 100644
--- a/sbin/etherswitchcfg/etherswitchcfg.8
+++ b/sbin/etherswitchcfg/etherswitchcfg.8
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd June 23, 2021
+.Dd June 9, 2026
 .Dt ETHERSWITCHCFG 8
 .Os
 .Sh NAME
@@ -50,6 +50,10 @@
 .Ar register[=value]
 .Nm
 .Op Fl "f control file"
+.Cm atu
+.Ar command Op Ar parameter
+.Nm
+.Op Fl "f control file"
 .Cm vlangroup%d
 .Ar command parameter
 .Sh DESCRIPTION
@@ -166,6 +170,21 @@ Enable the ingress filter on the port.
 .It Fl ingress
 Disable the ingress filter.
 .El
+.Ss atu
+The atu command provides access to the Address Translation Unit table
+of the switch, which maps MAC addresses to switch ports.
+It supports the following commands:
+.Pp
+.Bl -tag -width ".Cm flush port number" -compact
+.It Cm dump
+Display the current ATU table entries.
+Each entry shows the MAC address and a bitmask of ports associated with it.
+.It Cm flush all
+Remove all dynamic entries from the ATU table.
+.It Cm flush port Ar number
+Remove all dynamic ATU entries associated with port
+.Ar number .
+.El
 .Ss reg
 The reg command provides access to the registers of the switch controller.
 .Ss vlangroup