summaryrefslogtreecommitdiff
path: root/lib/libcrypto/man
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@cvs.openbsd.org>2018-12-21 20:09:05 +0000
committerIngo Schwarze <schwarze@cvs.openbsd.org>2018-12-21 20:09:05 +0000
commitda3588742df9052a925d973446f22b64551d2943 (patch)
treee8646f9fdec327d5afa2b60d3ed569305f2b6360 /lib/libcrypto/man
parent799ec4937cf7f50d3815b930f7c6e76957764a8e (diff)
Since OpenBSD 6.1, BN_pseudo_rand*(3) does the same as BN_rand*(3).
Say so, and note that OpenSSL followed suit in 1.1.0 according to OpenSSL commit 5ecff87d Jun 21 13:55:02 2017 +0100.
Diffstat (limited to 'lib/libcrypto/man')
-rw-r--r--lib/libcrypto/man/BN_rand.328
1 files changed, 18 insertions, 10 deletions
diff --git a/lib/libcrypto/man/BN_rand.3 b/lib/libcrypto/man/BN_rand.3
index fbfad032507..8434740664c 100644
--- a/lib/libcrypto/man/BN_rand.3
+++ b/lib/libcrypto/man/BN_rand.3
@@ -1,5 +1,6 @@
-.\" $OpenBSD: BN_rand.3,v 1.11 2018/03/27 17:35:50 schwarze Exp $
-.\" OpenSSL 05ea606a May 20 20:52:46 2016 -0400
+.\" $OpenBSD: BN_rand.3,v 1.12 2018/12/21 20:09:04 schwarze Exp $
+.\" full merge up to: OpenSSL 05ea606a May 20 20:52:46 2016 -0400
+.\" selective merge up to: OpenSSL df75c2bf Dec 9 01:02:36 2018 +0100
.\"
.\" This file was written by Ulf Moeller <ulf@openssl.org>.
.\" Copyright (c) 2000, 2001, 2002, 2013, 2015 The OpenSSL Project.
@@ -49,7 +50,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 27 2018 $
+.Dd $Mdocdate: December 21 2018 $
.Dt BN_RAND 3
.Os
.Sh NAME
@@ -114,10 +115,8 @@ is +1 then
cannot also be 1.
.Pp
.Fn BN_pseudo_rand
-does the same, but pseudo-random numbers generated by this function are
-not necessarily unpredictable.
-They can be used for non-cryptographic purposes and for certain purposes
-in cryptographic protocols, but usually not for key generation etc.
+is a deprecated alias for
+.Fn BN_rand .
.Pp
.Fn BN_rand_range
generates a cryptographically strong pseudo-random number
@@ -125,9 +124,8 @@ generates a cryptographically strong pseudo-random number
in the range 0 <=
.Fa rnd No < Fa range .
.Fn BN_pseudo_rand_range
-does the same, but is based on
-.Fn BN_pseudo_rand ,
-and hence numbers generated by it are not necessarily unpredictable.
+is a deprecated alias for
+.Fn BN_rand_range .
.Sh RETURN VALUES
The functions return 1 on success, 0 on error.
The error codes can be obtained by
@@ -145,6 +143,11 @@ first appeared in SSLeay 0.5.1 and has been available since
.Fn BN_pseudo_rand
first appeared in OpenSSL 0.9.5 and has been available since
.Ox 2.7 .
+It does the same as
+.Fn BN_rand
+since
+.Ox 6.1
+and since OpenSSL 1.1.0.
.Pp
The
.Fa top
@@ -156,3 +159,8 @@ first appeared in OpenSSL 0.9.6a and have been available since
.Fn BN_pseudo_rand_range
first appeared in OpenSSL 0.9.6c and have been available since
.Ox 3.2 .
+It does the same as
+.Fn BN_rand_range
+since
+.Ox 6.1
+and since OpenSSL 1.1.0.