From c8bd4684eb39c170249d91a1e880569619f2b935 Mon Sep 17 00:00:00 2001
From: Michael Tuexen <tuexen@FreeBSD.org>
Date: Wed, 11 Dec 2024 19:47:11 +0100
Subject: [PATCH] icmp.4: improve icmplim and add icmplim_jitter description

Reviewed by:		cc, bcr
Sponsored by:		Netflix, Inc.
Differential Revision:	https://reviews.freebsd.org/D48025

(cherry picked from commit eba715c544ea89c6b402c55e03b388b77030b997)
---
 share/man/man4/icmp.4 | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/share/man/man4/icmp.4 b/share/man/man4/icmp.4
index 9417565eb48..8c1dc956617 100644
--- a/share/man/man4/icmp.4
+++ b/share/man/man4/icmp.4
@@ -27,7 +27,7 @@
 .\"
 .\"     @(#)icmp.4	8.1 (Berkeley) 6/5/93
 .\"
-.Dd August 1, 2022
+.Dd December 11, 2024
 .Dt ICMP 4
 .Os
 .Sh NAME
@@ -171,10 +171,31 @@ Defaults to false.
 Enable/disable dropping of ICMP Redirect packets.
 Defaults to false.
 .It Va icmplim
-.Pq Vt integer
-Bandwidth limit for ICMP replies in packets/second.
+.Pq Vt unsigned integer
+Mean rate limit for replies in packets/second.
+The actual limit is
+.Va icmplim
+plus a random jitter limited by
+.Va icmplim_jitter .
 If set to zero, no limiting will occur.
 Defaults to 200.
+.It Va icmplim_jitter
+.Pq Vt unsigned integer
+A random jitter between the negative of
+.Va icmplim_jitter
+and
+.Va icmplim_jitter
+is applied to
+.Va icmplim
+for limiting the sending rate of replies.
+.Va icmplim_jitter
+must be smaller than
+.Va icmplim ,
+if
+.Va icmplim
+is not zero.
+If set to zero, no jitter will be applied.
+Defaults to 16.
 .It Va icmplim_output
 .Pq Vt boolean
 Enable/disable logging of ICMP replies bandwidth limiting.