[PATCH 0/9] random: re-group and re-document functions

From: Jason A. Donenfeld
Date: Fri Feb 11 2022 - 07:36:13 EST


We previously had massive documentation comments and functions strewn
all about. This attempts to restore sanity by dividing the code into a
few sections:

- Initialization and readiness waiting.
- Fast key erasure RNG.
- Entropy accumulation and extraction.
- Entropy collection.
- Userspace read/write.
- Sysctl.

The result of this ordering and this grouping is only 2 forward
declarations, indicating that this is probably a sensible grouping.
Also, some documentation that was just hopelessly out of date been
removed. We'll later look into re-adding parts of this to the Linux man
pages project.

No functional changes.

Jason A. Donenfeld (9):
random: introduce drain_entropy() helper to declutter crng_reseed()
random: remove useless header comment
random: rewrite header introductory comment
random: group initialization wait functions
random: group crng functions
random: group entropy extraction functions
random: group entropy collection functions
random: group userspace read/write functions
random: group sysctl functions

drivers/char/random.c | 1912 ++++++++++++++++++++--------------------
include/linux/random.h | 6 +-
2 files changed, 952 insertions(+), 966 deletions(-)

--
2.35.0