From: Breno Leitao Date: Mon, 14 Jul 2025 12:06:27 +0000 (-0700) Subject: docs: kernel: Clarify printk_ratelimit_burst reset behavior X-Git-Url: https://www.infradead.org/git/?a=commitdiff_plain;h=2a1390c81305ba9d5311fe82adccd3a34603065a;p=users%2Fwilly%2Flinux.git docs: kernel: Clarify printk_ratelimit_burst reset behavior Add clarification that the printk_ratelimit_burst window resets after printk_ratelimit seconds have elapsed, allowing another burst of messages to be sent. This helps users understand that the rate limiting is not permanent but operates in periodic windows. Signed-off-by: Breno Leitao Reviewed-by: Paul E. McKenney Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/20250714-docs_ratelimit-v1-1-51a6d9071f1a@debian.org --- diff --git a/Documentation/admin-guide/sysctl/kernel.rst b/Documentation/admin-guide/sysctl/kernel.rst index f1b2ab219a08..269f9a9a9e1a 100644 --- a/Documentation/admin-guide/sysctl/kernel.rst +++ b/Documentation/admin-guide/sysctl/kernel.rst @@ -1111,7 +1111,8 @@ printk_ratelimit_burst While long term we enforce one message per `printk_ratelimit`_ seconds, we do allow a burst of messages to pass through. ``printk_ratelimit_burst`` specifies the number of messages we can -send before ratelimiting kicks in. +send before ratelimiting kicks in. After `printk_ratelimit`_ seconds +have elapsed, another burst of messages may be sent. The default value is 10 messages.