From b55a697c676bec213476fdf1525e9291c5d4aaf6 Mon Sep 17 00:00:00 2001 From: schwarze <> Date: Thu, 3 Nov 2016 15:48:22 +0000 Subject: convert RAND manuals from pod to mdoc --- src/lib/libcrypto/man/RAND_bytes.3 | 52 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 src/lib/libcrypto/man/RAND_bytes.3 (limited to 'src/lib/libcrypto/man/RAND_bytes.3') diff --git a/src/lib/libcrypto/man/RAND_bytes.3 b/src/lib/libcrypto/man/RAND_bytes.3 new file mode 100644 index 0000000000..41f0950fe3 --- /dev/null +++ b/src/lib/libcrypto/man/RAND_bytes.3 @@ -0,0 +1,52 @@ +.Dd $Mdocdate: November 3 2016 $ +.Dt RAND_BYTES 3 +.Os +.Sh NAME +.Nm RAND_bytes , +.Nm RAND_pseudo_bytes +.Nd generate random data +.Sh SYNOPSIS +.In openssl/rand.h +.Ft int +.Fo RAND_bytes +.Fa "unsigned char *buf" +.Fa "int num" +.Fc +.Ft int +.Fo RAND_pseudo_bytes +.Fa "unsigned char *buf" +.Fa "int num" +.Fc +.Sh DESCRIPTION +.Fn RAND_bytes +puts +.Fa num +cryptographically strong pseudo-random bytes into +.Fa buf . +.Pp +.Fn RAND_pseudo_bytes +puts +.Fa num +pseudo-random bytes into +.Fa buf . +Pseudo-random byte sequences generated by +.Fn RAND_pseudo_bytes +will be unique if they are of sufficient length, but 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. +.Sh RETURN VALUES +.Fn RAND_bytes +returns 1. +.Fn RAND_pseudo_bytes +returns 1. +.Sh SEE ALSO +.Xr ERR_get_error 3 , +.Xr RAND_add 3 +.Sh HISTORY +.Fn RAND_bytes +is available in all versions of SSLeay and OpenSSL. +It has a return +value since OpenSSL 0.9.5. +.Fn RAND_pseudo_bytes +was added in OpenSSL 0.9.5. -- cgit v1.2.3-55-g6feb