Bug 275413 - etherswitchcfg.8: atu commands are not documented
Summary: etherswitchcfg.8: atu commands are not documented
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Warner Losh
URL:
Keywords:
: 275414 (view as bug list)
Depends on:
Blocks:
 
Reported: 2023-11-28 21:50 UTC by Mike Belanger
Modified: 2026-07-17 07:05 UTC (History)
3 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Mike Belanger 2023-11-28 21:50:09 UTC 
The following are not documented:
etherswitchcfg -f /dev/etherswitch1 atu dump
etherswitchcfg -f /dev/etherswitch1 atu flush all
etherswitchcfg -f /dev/etherswitch1 atu flush port x

The following results in a crash:
etherswitchcfg -f /dev/etherswitch1 atu flush
Comment 1 Mark Linimon freebsd_committer freebsd_triage 2023-11-30 06:01:24 UTC 
*** Bug 275414 has been marked as a duplicate of this bug. ***
Comment 2 commit-hook freebsd_committer freebsd_triage 2026-06-10 12:36:29 UTC 
A commit in branch main references this bug:

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(-)
Comment 3 Mark Linimon freebsd_committer freebsd_triage 2026-07-17 07:05:59 UTC 
^Triage: since there is no way to set MFC flags for Manual Pages, there is
nothing to do here but close this.