On Sat, 2 Oct 2010, Jason McIntyre wrote:

> On Sat, Oct 02, 2010 at 12:00:30PM -0400, Ted Unangst wrote:
> > Is this the best way to deprecate support for the srandom and urandom 
> > devices?  The devices themselves are going to stick around for a while, 
> > but we only need to tell people about one, right?
> > 
> 
> if you are going to leave the MLINKS for srandom and urandom, i think
> you should not kill the stuff, and instead say that they are the same as
> whatever you've changed it to.
> 
> otherwise kill the MLINKS.

Fair enough, how about this?

Index: random.4
===================================================================
RCS file: /home/tedu/cvs/src/share/man/man4/random.4,v
retrieving revision 1.22
diff -u -r1.22 random.4
--- random.4    10 Oct 2008 20:13:29 -0000      1.22
+++ random.4    2 Oct 2010 18:36:40 -0000
@@ -28,8 +28,6 @@
 .Os
 .Sh NAME
 .Nm random ,
-.Nm srandom ,
-.Nm urandom ,
 .Nm arandom
 .Nd random data source devices
 .Sh SYNOPSIS
@@ -43,22 +41,10 @@
 Entropy data is collected from system activity (like disk and
 network device interrupts and such), and then run through various
 hash or message digest functions to generate the output.
-.Bl -hang -width /dev/srandomX
+.Bl -hang -width /dev/arandomX
 .It Pa /dev/random
 This device is reserved for future support of hardware
 random generators.
-.It Pa /dev/srandom
-Strong random data.
-This device returns reliable random data.
-If sufficient entropy is not currently available (i.e., the entropy
-pool quality starts to run low), the driver pauses while more of
-such data is collected.
-The entropy pool data is converted into output data using MD5.
-.It Pa /dev/urandom
-Same as above, but does not guarantee the data to be strong.
-The entropy pool data is converted into output data using MD5.
-When the entropy pool quality runs low, the driver will continue
-to output data.
 .It Pa /dev/arandom
 As required, entropy pool data re-seeds an ARC4 generator,
 which then generates high-quality pseudo-random output data.
@@ -69,10 +55,8 @@
 providing a second level of ARC4 hashed data.
 .El
 .Sh FILES
-.Bl -tag -width /dev/srandom -compact
+.Bl -tag -width /dev/arandom -compact
 .It Pa /dev/random
-.It Pa /dev/srandom
-.It Pa /dev/urandom
 .It Pa /dev/arandom
 .El
 .Sh SEE ALSO
@@ -89,6 +73,16 @@
 .Nm
 device first appeared in the Linux operating system.
 This is a cloned interface.
+.Pp
+Previous versions of
+.Ox
+included the
+.Nm srandom
+and
+.Nm urandom
+devices.
+These interfaces have been deprecated and replaced with
+.Nm arandom .
 .Pp
 ARC4 routines added by David Mazieres.
 .Sh BUGS

Reply via email to