doc/man3/RAND_bytes.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 RAND_bytes, RAND_pseudo_bytes - generate random data
   6
   7 =head1 SYNOPSIS
   8
   9  #include <openssl/rand.h>
  10
  11  int RAND_bytes(unsigned char *buf, int num);
  12
  13 Deprecated:
  14
  15  #if OPENSSL_API_COMPAT < 0x10100000L
  16  int RAND_pseudo_bytes(unsigned char *buf, int num);
  17  #endif
  18
  19 =head1 DESCRIPTION
  20
  21 RAND_bytes() puts B<num> cryptographically strong pseudo-random bytes
  22 into B<buf>. An error occurs if the PRNG has not been seeded with
  23 enough randomness to ensure an unpredictable byte sequence.
  24
  25 RAND_pseudo_bytes() has been deprecated; use RAND_bytes() instead.
  26
  27 =head1 RETURN VALUES
  28
  29 RAND_bytes() returns 1 on success, -1 if not supported by the current
  30 RAND method, or 0 on other failure. The error code can be
  31 obtained by L<ERR_get_error(3)>.
  32
  33 =head1 HISTORY
  34
  35 RAND_pseudo_bytes() was deprecated in OpenSSL 1.1.0.
  36
  37 =head1 SEE ALSO
  38
  39 L<RAND_bytes(3)>, L<ERR_get_error(3)>,
  40 L<RAND_add(3)>
  41
  42 =head1 COPYRIGHT
  43
  44 Copyright 2000-2017 The OpenSSL Project Authors. All Rights Reserved.
  45
  46 Licensed under the OpenSSL license (the "License").  You may not use
  47 this file except in compliance with the License.  You can obtain a copy
  48 in the file LICENSE in the source distribution or at
  49 L<https://www.openssl.org/source/license.html>.
  50
  51 =cut