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 =head1 RETURN VALUES
  26
  27 RAND_bytes() returns 1 on success, -1 if not supported by the current
  28 RAND method, or 0 on other failure. The error code can be
  29 obtained by L<ERR_get_error(3)>.
  30
  31 =head1 HISTORY
  32
  33 RAND_pseudo_bytes() was deprecated in OpenSSL 1.1.0; use RAND_bytes() instead.
  34
  35 =head1 SEE ALSO
  36
  37 L<RAND_bytes(3)>, L<ERR_get_error(3)>,
  38 L<RAND_add(3)>
  39
  40 =head1 COPYRIGHT
  41
  42 Copyright 2000-2017 The OpenSSL Project Authors. All Rights Reserved.
  43
  44 Licensed under the OpenSSL license (the "License").  You may not use
  45 this file except in compliance with the License.  You can obtain a copy
  46 in the file LICENSE in the source distribution or at
  47 L<https://www.openssl.org/source/license.html>.
  48
  49 =cut