git: 355989b21712 - main - route.8: Describe weight modifier

The branch main has been updated by pouria:

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

commit 355989b21712cbb7173cbec4a036c541e6f08c0e
Author:     Pouria Mousavizadeh Tehrani <pouria@FreeBSD.org>
AuthorDate: 2026-04-14 07:49:29 +0000
Commit:     Pouria Mousavizadeh Tehrani <pouria@FreeBSD.org>
CommitDate: 2026-05-15 21:29:49 +0000

    route.8: Describe weight modifier
    
    Describe `-weight` argument in the route manual.
    
    Reviewed by: glebius, ziaee
    Differential Revision: https://reviews.freebsd.org/D56246
---
 sbin/route/route.8 | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/sbin/route/route.8 b/sbin/route/route.8
index 572781ef59c8..5cb16120c8d8 100644
--- a/sbin/route/route.8
+++ b/sbin/route/route.8
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd November 12, 2024
+.Dd May 16, 2026
 .Dt ROUTE 8
 .Os
 .Sh NAME
@@ -297,6 +297,17 @@ Note that the qualifier works only for
 .Dv AF_INET6
 address family.
 .Pp
+For
+.Li ECMP
+routes, the
+.Fl weight
+modifier can be used to influence nexthop selection.
+For example, a destination with two nexthops defined as
+.Dq Fl gateway Ar 3fff::1 Fl weight Ar 100
+and
+.Dq Fl gateway Ar 3fff::2 Fl weight Ar 200
+will make the nexthop 3fff::2 twice as likely to be chosen as 3fff::1.
+.Pp
 Routes have associated flags which influence operation of the protocols
 when sending to destinations matched by the routes.
 These flags may be set (or sometimes cleared)