docs: sysctl/kernel: document random
PATCH 1/1 docs: sysctl/kernel: document random
This documents the random directory, based on the behaviour seen in drivers/char/random.c.
Signed-off-by Stephen Kitt <[email protected]>
--- Documentation/admin-guide/sysctl/kernel.rst | 32 +++++++++++++++++++++ 1 file changed, 32 insertions(+)
Documentation/admin-guide/sysctl/kernel.rst +32 -0
@@ -996,6 +996,38 @@ pty See Documentation/filesystems/devpts.rst. +random +====== + +This is a directory, with the following entries: + +* ``boot_id``: a UUID generated the first time this is retrieved, and + unvarying after that; + +* ``entropy_avail``: the pool's entropy count, in bits; + +* ``poolsize``: the entropy pool size, in bits; + +* ``urandom_min_reseed_secs``: obsolete (used to determine the minimum + number of seconds between urandom pool reseeding). + +* ``uuid``: a UUID generated every time this is retrieved (this can + thus be used to generate UUIDs at will); + +* ``write_wakeup_threshold``: when the entropy count drops below this + (as a number of bits), processes waiting to write to ``/dev/random`` + are woken up. + +If ``drivers/char/random.c`` is built with ``ADD_INTERRUPT_BENCH`` +defined, these additional entries are present: + +* ``add_interrupt_avg_cycles``: the average number of cycles between + interrupts used to feed the pool; + +* ``add_interrupt_avg_deviation``: the standard deviation seen on the + number of cycles between interrupts used to feed the pool. + + randomize_va_space ==================
base-commit: 46e906144c3f4b0a7b6dcc7713fafad65b1859e0
Signature · 1 line
2.20.1
Quoted 7 lines · On Tue, 23 Jun 2020 13:25:14 +0200 Stephen Kitt <[email protected]> wrote:
This documents the random directory, based on the behaviour seen in
drivers/char/random.c.Signed-off-by Stephen Kitt <[email protected]>--- Documentation/admin-guide/sysctl/kernel.rst | 32 +++++++++++++++++++++ 1 file changed, 32 insertions(+)
Applied, thanks.
jon