From nobody Wed May 7 18:58:30 2025 X-Original-To: dev-commits-src-branches@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 4Zt4Kg0jKvz5v7k1; Wed, 07 May 2025 18:58:31 +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 4Zt4Kg00Mhz3qc3; Wed, 07 May 2025 18:58:31 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1746644311; 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=nOWY7x5qKNDZRNmLOquUPTxDLIfstIJrWNiLkHTKkzQ=; b=UOBacN7FrS9ZKXb1MbyFT3vn34KbIfNYHhCJZE1NwX+hIobuVwBFumleDzW7eP8U2bVWI2 tD9VCem+86i+GB7tkoGHY4a1MnSoqxxVXcncLJ7f7WuiUBk2UmjFN6992ixfV8nFJjx2zz aNH0cg8Ic5mYjznfzF29/1wCfcnP1x2tDX6uGMoIZ0f1lavi1cvrCo7rsKgkKMcfEEXP/H zouE/t04K1n8tnXusZf262N+sbCo/JrH9bmSJsQNI6HH72Af7i5UKrcdbLdCDH21Ao1Kny Bv8iNVHaFIeLQX83pexBTt26qSGK5WuzoWZOeno1Tq/Nyy2llfRJmQl9NSSsRg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1746644311; 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=nOWY7x5qKNDZRNmLOquUPTxDLIfstIJrWNiLkHTKkzQ=; b=dzoR0d10Eh5pLxQXQF/0K5wq/7zfWTibUftvPLaGq3ZPH8rCUSefCoXKSC0pj9MluBvmOj v/zxrl5DUukG1mDSx1/YxryTx3wxYwHpgvxncW6LT+nEC7Zx3tqgSH1m806ZpU+GAQ1ouk O1qC3C+5SmHOb6+9oeMqPYX56qO8MgOjyO/l9bm7xmmvwxmzheef5jN5+uRPrjN2Avf6t/ RmVFG93gUDW/0SbyDJtLU5Wma4JdC6uOY71xvqu30B0klfqKWojp8s5W2ko2g0x9YykZbP v/IFlqwZEI/TS3Y5vICRl4+TeEfQfi9INZ7a3E/OqsooUNfGVFBicifOzwgAFw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1746644311; a=rsa-sha256; cv=none; b=Ng0I8HQMLPcZS7+o7PBWgu8LhmX3jeDBowYjNOAD7+2YeIlsak2gVNni0SKaC/K8YCkgtu KZvjuz6PL0IhgXzaga0xSZCe3tzp14dOB6bA0CwDUh+vAK2TVhvJe3FBlgwBvKCxRpAIjR t5oN4kqhB2NlajlJ6E0lm20XP0UxeLA7P/1YPIZZgde/8+KJU0wxvLiM+ebRyuRcfv5D2g BQTpkjmTjW3u2pblCUQTqjpST7kHwm0Ti5hXDNWj3/tltnyjnaOOx4BJtdamur/1RkItTO OTBUW4wWV0G/4YYOGBPiz1yFL7TfEQEHOk2xR4gwkE+SXxjkiD4VGZUaPk2rdw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4Zt4Kf6gM9zj81; Wed, 07 May 2025 18:58:30 +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 547IwU7h089793; Wed, 7 May 2025 18:58:30 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 547IwUHW089790; Wed, 7 May 2025 18:58:30 GMT (envelope-from git) Date: Wed, 7 May 2025 18:58:30 GMT Message-Id: <202505071858.547IwUHW089790@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Lexi Winter Subject: git: 7e98bfd666c4 - stable/13 - netstat(1): add description for option -o and -O. List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@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/stable/13 X-Git-Reftype: branch X-Git-Commit: 7e98bfd666c42ec91491f0739d15da57cc5389c7 Auto-Submitted: auto-generated The branch stable/13 has been updated by ivy: URL: https://cgit.FreeBSD.org/src/commit/?id=7e98bfd666c42ec91491f0739d15da57cc5389c7 commit 7e98bfd666c42ec91491f0739d15da57cc5389c7 Author: K Rin AuthorDate: 2025-04-06 18:15:07 +0000 Commit: Lexi Winter CommitDate: 2025-05-07 18:53:52 +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 (cherry picked from commit afa30c5dec5afc8496172a062c93e96d78f5b9b9) --- 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 6767d48a279e..e789a626b634 100644 --- a/usr.bin/netstat/netstat.1 +++ b/usr.bin/netstat/netstat.1 @@ -27,7 +27,7 @@ .\" .\" @(#)netstat.1 8.8 (Berkeley) 4/18/94 .\" -.Dd July 29, 2024 +.Dd April 30, 2025 .Dt NETSTAT 1 .Os .Sh NAME @@ -109,6 +109,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 @@ -410,6 +414,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