Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

timer_stats/doc: Fix /proc/timer_stats documentation

Documentation/timers/timer_stats.txt claims:

"The readout of /proc/timer_stats automatically disables sampling. The sampled
information is kept until a new sample period is started. This allows multiple
readouts."

Some simple testing shows that reading from /proc/timer_stats
does not disable sampling. Looking back over past source code,
it appears that it never did.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Cc: Randy Dunlap <rdunlap@infradead.org>
Link: http://lkml.kernel.org/r/53636FB6.9060407@gmail.com
[ Small tidyup of the changelog. ]
Signed-off-by: Ingo Molnar <mingo@kernel.org>

authored by

Michael Kerrisk and committed by
Ingo Molnar
2779ac16 0384dcae

+3 -3
+3 -3
Documentation/timers/timer_stats.txt
··· 39 39 The statistics can be retrieved by: 40 40 # cat /proc/timer_stats 41 41 42 - The readout of /proc/timer_stats automatically disables sampling. The sampled 43 - information is kept until a new sample period is started. This allows multiple 44 - readouts. 42 + While sampling is enabled, each readout from /proc/timer_stats will see 43 + newly updated statistics. Once sampling is disabled, the sampled information 44 + is kept until a new sample period is started. This allows multiple readouts. 45 45 46 46 Sample output of /proc/timer_stats: 47 47