From ece967c9c47034e5015dcacdcc9a6658e9c9f8a9 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Thu, 14 Mar 2013 11:29:07 +0100 Subject: [PATCH] random.4: ffix Signed-off-by: Michael Kerrisk --- man4/random.4 | 27 ++++++++++++++++----------- 1 file changed, 16 insertions(+), 11 deletions(-) diff --git a/man4/random.4 b/man4/random.4 index e835720dd..c9b4a3315 100644 --- a/man4/random.4 +++ b/man4/random.4 @@ -16,7 +16,7 @@ .\" Add a Usage subsection that recommends most users to use .\" /dev/urandom, and emphasizes parsimonious usage of /dev/random. .\" -.TH RANDOM 4 2013-02-17 "Linux" "Linux Programmer's Manual" +.TH RANDOM 4 2013-03-15 "Linux" "Linux Programmer's Manual" .SH NAME random, urandom \- kernel random number source devices .SH SYNOPSIS @@ -58,8 +58,9 @@ instead. .LP Writing to \fI/dev/random\fP or \fI/dev/urandom\fP will update the entropy pool with the data written, but this will not result in a -higher entropy count. This means that it will impact the contents -read from both files but it will not make reads from +higher entropy count. +This means that it will impact the contents +read from both files, but it will not make reads from \fI/dev/random\fP faster. .SS Usage If you are unsure about whether you should use @@ -222,12 +223,13 @@ generated once. The following .BR ioctl (2) requests are defined on file descriptors connected to either \fI/dev/random\fP -or \fI/dev/urandom\fP. All requests performed will interact with the input +or \fI/dev/urandom\fP. +All requests performed will interact with the input entropy pool impacting both \fI/dev/random\fP and \fI/dev/urandom\fP. The .B CAP_SYS_ADMIN capability is required for all requests except -.B RNDGETENTCNT. +.BR RNDGETENTCNT . .TP .BR RNDGETENTCNT Retrieve the entropy count of the input pool, the contents will be the same @@ -237,16 +239,19 @@ file under proc. The result will be stored in the int pointed to by the argument. .TP .BR RNDADDTOENTCNT -Increment or decrement the entropy count of the input pool by the value pointed -to by the argument. +Increment or decrement the entropy count of the input pool +by the value pointed to by the argument. .TP .BR RNDGETPOOL Removed in Linux 2.6.9. .TP .BR RNDADDENTROPY -Add some additional entropy to the input pool, incrementing the entropy count. -Unlike writing to \fI/dev/random\fP or \fI/dev/urandom\fP which only adds some -data but does not increment the entropy count. The following structure is used: +Add some additional entropy to the input pool, +incrementing the entropy count. +This differs from writing to \fI/dev/random\fP or \fI/dev/urandom\fP, +which only adds some +data but does not increment the entropy count. +The following structure is used: .IP .IN +4n .NF @@ -260,7 +265,7 @@ struct rand_pool_info { .IP Here .I entropy_count -is the value added to (or subtracted from) from the entropy count. And +is the value added to (or subtracted from) from the entropy count, and .I buf is the buffer of size .I buf_size