[src/trunk]: src/share/man/man4 New sentence, new line.

[wiz <wiz%NetBSD.org@localhost>]

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