RAND_bytes.pod 1.2 KB
Newer Older
U
Ulf Möller 已提交
1 2 3 4
=pod

=head1 NAME

U
Ulf Möller 已提交
5
RAND_bytes, RAND_pseudo_bytes - generate random data
U
Ulf Möller 已提交
6 7 8 9 10 11 12

=head1 SYNOPSIS

 #include <openssl/rand.h>

 int RAND_bytes(unsigned char *buf, int num);

M
Matt Caswell 已提交
13 14
Deprecated:

15
 #if OPENSSL_API_COMPAT < 0x10100000L
U
Ulf Möller 已提交
16
 int RAND_pseudo_bytes(unsigned char *buf, int num);
17
 #endif
U
Ulf Möller 已提交
18 19 20

=head1 DESCRIPTION

21 22 23 24
RAND_bytes() puts B<num> cryptographically strong pseudo-random bytes
into B<buf>. An error occurs if the PRNG has not been seeded with
enough randomness to ensure an unpredictable byte sequence.

R
Rich Salz 已提交
25
RAND_pseudo_bytes() has been deprecated; use RAND_bytes() instead.
U
Ulf Möller 已提交
26 27 28

=head1 RETURN VALUES

R
Rich Salz 已提交
29 30 31 32
RAND_bytes() returns 1 on success, -1 if not supported by the current
RAND method, or 0 on other failure. The error code can be
obtained by L<ERR_get_error(3)>.

R
Rich Salz 已提交
33
=head1 HISTORY
R
Rich Salz 已提交
34 35

RAND_pseudo_bytes() was deprecated in OpenSSL 1.1.0.
U
Ulf Möller 已提交
36 37 38

=head1 SEE ALSO

39
L<RAND_bytes(3)>, L<ERR_get_error(3)>,
R
Rich Salz 已提交
40
L<RAND_add(3)>
U
Ulf Möller 已提交
41

R
Rich Salz 已提交
42 43
=head1 COPYRIGHT

R
Rich Salz 已提交
44
Copyright 2000-2017 The OpenSSL Project Authors. All Rights Reserved.
R
Rich Salz 已提交
45 46 47 48 49 50 51

Licensed under the OpenSSL license (the "License").  You may not use
this file except in compliance with the License.  You can obtain a copy
in the file LICENSE in the source distribution or at
L<https://www.openssl.org/source/license.html>.

=cut