Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/share/man/man4 New sentence, new line.
details: https://anonhg.NetBSD.org/src/rev/af4da3fcb17e
branches: trunk
changeset: 778850:af4da3fcb17e
user: wiz <wiz%NetBSD.org@localhost>
date: Tue Apr 17 08:28:20 2012 +0000
description:
New sentence, new line.
Sort type descriptions.
Bump date for previous.
diffstat:
share/man/man4/rnd.4 | 46 ++++++++++++++++++++++++----------------------
1 files changed, 24 insertions(+), 22 deletions(-)
diffs (105 lines):
diff -r d7e86017dc9e -r af4da3fcb17e share/man/man4/rnd.4
--- a/share/man/man4/rnd.4 Tue Apr 17 07:43:21 2012 +0000
+++ b/share/man/man4/rnd.4 Tue Apr 17 08:28:20 2012 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: rnd.4,v 1.19 2012/04/17 02:50:39 tls Exp $
+.\" $NetBSD: rnd.4,v 1.20 2012/04/17 08:28:20 wiz Exp $
.\"
.\" Copyright (c) 1997 Michael Graff
.\" All rights reserved.
@@ -26,7 +26,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd December 17, 2011
+.Dd April 17, 2012
.Dt RND 4
.Os
.Sh NAME
@@ -62,17 +62,19 @@
.Pp
Certain programs make very short reads from
.Pa /dev/urandom
-each time they begin execution. One program with this behavior is
+each time they begin execution.
+One program with this behavior is
.Xr perl 1 .
If such a program is run repeatedly (for example from a network
service or shell script), the resulting repeated keying of the stream
-generator can quickly drain the entropy pool dry. As an optimization
-for such cases, a separate per-CPU instance of the stream generator
-is used to handle reads from
+generator can quickly drain the entropy pool dry.
+As an optimization for such cases, a separate per-CPU instance of
+the stream generator is used to handle reads from
.Pa /dev/urandom
-which are smaller than the key length of the underlying cipher. Any
-read of a larger size causes an immediate allocation of a private
-instance of the stream generator for the reader. Since all stream
+which are smaller than the key length of the underlying cipher.
+Any read of a larger size causes an immediate allocation of a
+private instance of the stream generator for the reader.
+Since all stream
generators are automatically rekeyed upon use when sufficient entropy
is available, the shared short-request generators do still offer
some protection against other consumers of
@@ -147,7 +149,7 @@
can deplete the entropy pool (or, at least, its estimate of how many
bits of entropy it "contains") and reduce security for other consumers
of randomness both in userspace
-.Em and within the kernel.
+.Em and within the kernel .
Some system administrators may wish therefore to remove the
.Pa /dev/random
device node and replace it with a second copy of the node for the nonblocking
@@ -199,14 +201,16 @@
.Bl -tag -width RND_TYPE_DISK
.It Dv RND_TYPE_DISK
The device is a physical hard drive.
+.It Dv RND_TYPE_ENV
+The device is an environmental sensor such as a temperature sensor or
+a fan speed sensor.
.It Dv RND_TYPE_NET
The device is a network interface.
By default, timing information is
collected from this source type, but entropy is not estimated.
-.It Dv RND_TYPE_TAPE
-The device is a tape device.
-.It Dv RND_TYPE_TTY
-The device is a terminal, mouse, or other user input device.
+.It Dv RND_TYPE_POWER
+The device is a sensor returning changes in the power state of the
+system, such as battery charge state or A/C adapter state.
.It Dv RND_TYPE_RNG
The device is a random number generator.
.It Dv RND_TYPE_SKEW
@@ -215,23 +219,21 @@
an audio codec, or some other source of pairs of events where each
member of each pair is derived from a different instance of some
recurring physical process.
-.It Dv RND_TYPE_ENV
-The device is an environmental sensor such as a temperature sensor or
-a fan speed sensor.
+.It Dv RND_TYPE_TAPE
+The device is a tape device.
+.It Dv RND_TYPE_TTY
+The device is a terminal, mouse, or other user input device.
.It Dv RND_TYPE_VM
The "device" consists of timings of virtual memory system events.
-.It Dv RND_TYPE_POWER
-The device is a sensor returning changes in the power state of the
-system, such as battery charge state or A/C adapter state.
.El
.Pp
.Va flags
is a bitfield.
.Bl -tag -width RND_FLAG_NO_ESTIMATE
+.It Dv RND_FLAG_NO_COLLECT
+Do not even add timing information to the pool.
.It Dv RND_FLAG_NO_ESTIMATE
Do not assume any entropy is in the timing information.
-.It Dv RND_FLAG_NO_COLLECT
-Do not even add timing information to the pool.
.El
.Pp
.Bl -tag -width RNDADDTOENTCNT
Home |
Main Index |
Thread Index |
Old Index