From nobody Wed Apr 30 06:42:32 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ZnSKh2s4Gz5ty0d; Wed, 30 Apr 2025 06:42:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ZnSKh1r7dz42hT; Wed, 30 Apr 2025 06:42:32 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1745995352; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=diVIc/dglaqGZi0xFJG/aKkjVMdCFFIRGbV9VPu85ao=; b=PhJvlwStZs8lbmOb3Cqokl/M0GW0cEHF9iVOgG2wtC3yiustsoMj0V2IkfCq0dFcXLMIMv 0hX3nt2dvvTbaa8WRP//JAuKWAJQ9fKtLUK6afUqXNNTkT444N2kwZQL5tcektREUDBsQZ r+JLmisdtltvyJtRm6q0U/O8YCok99LgjlFTzgDtW70yLoX3d/UMa082Auc0UlXoEufsO8 gTRDXnkuBTYcyziJry5bAdRxffr5Sh3MaFwxh6vq71AMVaZQmi9Ed03BttVoZjfVxKNHR1 hLbxurhAM63aDfnOYuvS3dtGQf1Yu0IT+pEMlAVvvBxzAPzNSu91WvI60/0SAw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1745995352; a=rsa-sha256; cv=none; b=hxpClgAJuleA9+CRutYN7PfBsBNeDL7sXqJZ0C0jOK0W8EEkAPL8oMqt69LlFFDdIpEgCW UtABR7sKXnEZO0wjR2TAlOD1N7emHXvB7qRCEDBqVWyLpsIfovuMu96/a75MwJ/FluSEEE SZDVEdeVJz4hJr946h3rq69HUgX74JYCBAav3IDMGfdWRa5o+/izEumJH4ozL+LsG5OTQw NnnXEwSBRgfI/op8UGNQTyXBtPY/1KVwyTjw7hHzKkCYmHfakL1j/O23Npaz2YUmLQNamF S/1XC/LuN4ynBRAxU8neZyTENRsVAy9OHuP3hMlJ/p9RRd3dM7QAATGJJL/fHQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1745995352; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=diVIc/dglaqGZi0xFJG/aKkjVMdCFFIRGbV9VPu85ao=; b=wkn13kU3GTIV/I97FwdZvT4AzTVtNqLNMQUVqG91m8qpiG/vE/S1jy6CyG1K6Xk9jW/QGW Ja7goUonXrKTC0WQRr+K/IysOC8x3SWfPSDUrvkXtyiw0Tv7x78taj/tkEBTSqEgyxI1xF upyBvBFSeAuowsN+0WabAChLEjWOKoim2t1FdIBMek09RD3sIvMIjIAivKFyIvxU6/of/e W4DduqjAWiU4I7/W+stqgQmD/el27J0MyrDh4RQzGWFO9AXOwiORaOmu9B0hpxPs3zSgC0 O/GWc4LRiu757zc7Nf6ssbAko/qnT3uI6/yogb1t/m0CazuwfRgxTF9kGNAbTA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4ZnSKh18qBzvgf; Wed, 30 Apr 2025 06:42:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 53U6gWKh096834; Wed, 30 Apr 2025 06:42:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 53U6gWgf096830; Wed, 30 Apr 2025 06:42:32 GMT (envelope-from git) Date: Wed, 30 Apr 2025 06:42:32 GMT Message-Id: <202504300642.53U6gWgf096830@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Lexi Winter Subject: git: afa30c5dec5a - main - netstat(1): add description for option -o and -O. List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ivy X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: afa30c5dec5afc8496172a062c93e96d78f5b9b9 Auto-Submitted: auto-generated The branch main has been updated by ivy: URL: https://cgit.FreeBSD.org/src/commit/?id=afa30c5dec5afc8496172a062c93e96d78f5b9b9 commit afa30c5dec5afc8496172a062c93e96d78f5b9b9 Author: K Rin AuthorDate: 2025-04-06 18:15:07 +0000 Commit: Lexi Winter 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