From 866dcc94625d9f09f3df85a630b6b5a8d2d50852 Mon Sep 17 00:00:00 2001
From: Konstantin Belousov <kib@FreeBSD.org>
Date: Wed, 6 Oct 2010 09:05:47 +0000
Subject: [PATCH] Add cross-references to lrand48(3) and arc4random(3) from
 rand(3) and random(3).

Submitted by:	Valentin Nechayev <netch netch kiev ua>
MFC after:	1 week
---
 lib/libc/stdlib/rand.3   | 11 ++++++++++-
 lib/libc/stdlib/random.3 |  1 +
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/lib/libc/stdlib/rand.3 b/lib/libc/stdlib/rand.3
index 9b247959f533..beb144325a92 100644
--- a/lib/libc/stdlib/rand.3
+++ b/lib/libc/stdlib/rand.3
@@ -32,7 +32,7 @@
 .\"     @(#)rand.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd May 25, 1999
+.Dd October 6, 2010
 .Dt RAND 3
 .Os
 .Sh NAME
@@ -100,7 +100,16 @@ provides the same functionality as
 A pointer to the context value
 .Fa ctx
 must be supplied by the caller.
+.Pp
+For better generator quality, use
+.Xr random 3
+or
+.Xr lrand48 3 .
+Applications requiring cryptographic quality randomness should use
+.Xr arc4random 3 .
 .Sh SEE ALSO
+.Xr arc4random 3,
+.Xr lrand48 3 ,
 .Xr random 3 ,
 .Xr random 4
 .Sh STANDARDS
diff --git a/lib/libc/stdlib/random.3 b/lib/libc/stdlib/random.3
index aacf6e32bd5c..c6502bf554ea 100644
--- a/lib/libc/stdlib/random.3
+++ b/lib/libc/stdlib/random.3
@@ -173,6 +173,7 @@ detects that the state information has been garbled, error
 messages are printed on the standard error output.
 .Sh SEE ALSO
 .Xr arc4random 3 ,
+.Xr lrand48 3 ,
 .Xr rand 3 ,
 .Xr srand 3 ,
 .Xr random 4