git: afa30c5dec5a - main - netstat(1): add description for option -o and -O.

From: Lexi Winter <ivy_at_FreeBSD.org>
Date: Wed, 30 Apr 2025 06:42:32 UTC
The branch main has been updated by ivy:

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

commit afa30c5dec5afc8496172a062c93e96d78f5b9b9
Author:     K Rin <rin@sandb0x.tw>
AuthorDate: 2025-04-06 18:15:07 +0000
Commit:     Lexi Winter <ivy@FreeBSD.org>
CommitDate: 2025-04-30 06:41:24 +0000

    netstat(1): add description for option -o and -O.
    
    Reviewed by: kevans, ziaee, ivy
    Approved by: kevans (mentor)
    Fixes: fedeb08b6a58 ("Introduce scalable route multipath.")
    Fixes: a666325282ea ("Introduce nexthop objects and new routing KPI.")
    Pull Request: https://github.com/freebsd/freebsd-src/pull/1643
---
 usr.bin/netstat/netstat.1 | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/usr.bin/netstat/netstat.1 b/usr.bin/netstat/netstat.1
index 559cb1932080..1a2c786e90aa 100644
--- a/usr.bin/netstat/netstat.1
+++ b/usr.bin/netstat/netstat.1
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd January 29, 2025
+.Dd April 30, 2025
 .Dt NETSTAT 1
 .Os
 .Sh NAME
@@ -105,6 +105,10 @@
 .It Nm Fl Q
 .Op Fl j Ar jail
 .Op Fl -libxo
+.It Nm Fl o
+.Fl 4 | Fl 6
+.It Nm Fl O
+.Fl 4 | Fl 6
 .El
 .Ek
 .Sh DESCRIPTION
@@ -401,6 +405,34 @@ See
 .El
 .It Xo
 .Bk -words
+.Nm netstat
+.Fl o
+.Fl 4 | Fl 6
+.Ek
+.Xc
+Print nexthop (nhops) information associated with routing entries.
+When used with
+.Fl 4
+or
+.Fl 6 ,
+limit the output to IPv4 or IPv6 routes respectively.
+This option provides details about individual nexthop addresses used in routing decisions.
+.It Xo
+.Bk -words
+.Nm netstat
+.Fl O
+.Fl 4 | Fl 6
+.Ek
+.Xc
+Print nexthop groups (nhgrp) information associated with routing entries.
+When used with
+.Fl 4
+or
+.Fl 6 ,
+restrict the output to IPv4 or IPv6 nexthop groups respectively.
+This option shows grouped nexthop entries for multipath or load-balanced routing setups.
+.It Xo
+.Bk -words
 .Nm
 .Fl s
 .Op Fl 46sz