[src/trunk]: src/lib/libc/gen Note relation of arc4random(3) to rand(3)/rando...

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

details:   https://anonhg.NetBSD.org/src/rev/fc45fb59114a
branches:  trunk
changeset: 803949:fc45fb59114a
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Mon Nov 17 06:37:23 2014 +0000

description:
Note relation of arc4random(3) to rand(3)/random(3).

diffstat:

 lib/libc/gen/arc4random.3 |  9 +++++++--
 1 files changed, 7 insertions(+), 2 deletions(-)

diffs (23 lines):

diff -r a4152b079dc6 -r fc45fb59114a lib/libc/gen/arc4random.3
--- a/lib/libc/gen/arc4random.3 Mon Nov 17 06:04:01 2014 +0000
+++ b/lib/libc/gen/arc4random.3 Mon Nov 17 06:37:23 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: arc4random.3,v 1.11 2014/11/16 20:37:35 wiz Exp $
+.\"    $NetBSD: arc4random.3,v 1.12 2014/11/17 06:37:23 riastradh Exp $
 .\"
 .\" Copyright (c) 2014 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -58,7 +58,12 @@
 generator automatically seeded from the system entropy pool and safe to
 use from multiple threads.
 .Nm
-is faster and more convenient than reading from
+is designed to prevent an adversary from guessing outputs,
+unlike
+.Xr rand 3
+and
+.Xr random 3 ,
+and is faster and more convenient than reading from
 .Pa /dev/urandom
 directly.
 .Pp