random.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2013-03-14 11:29:07 +01:00
parent 5a933be0f4
commit ece967c9c4
1 changed files with 16 additions and 11 deletions

View File

@ -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