mirror of
https://github.com/openssl/openssl.git
synced 2024-12-15 06:01:37 +08:00
25f2138b0a
Currently, there are two different directories which contain internal header files of libcrypto which are meant to be shared internally: While header files in 'include/internal' are intended to be shared between libcrypto and libssl, the files in 'crypto/include/internal' are intended to be shared inside libcrypto only. To make things complicated, the include search path is set up in such a way that the directive #include "internal/file.h" could refer to a file in either of these two directoroes. This makes it necessary in some cases to add a '_int.h' suffix to some files to resolve this ambiguity: #include "internal/file.h" # located in 'include/internal' #include "internal/file_int.h" # located in 'crypto/include/internal' This commit moves the private crypto headers from 'crypto/include/internal' to 'include/crypto' As a result, the include directives become unambiguous #include "internal/file.h" # located in 'include/internal' #include "crypto/file.h" # located in 'include/crypto' hence the superfluous '_int.h' suffixes can be stripped. The files 'store_int.h' and 'store.h' need to be treated specially; they are joined into a single file. Reviewed-by: Richard Levitte <levitte@openssl.org> (Merged from https://github.com/openssl/openssl/pull/9333)
42 lines
1.2 KiB
Plaintext
42 lines
1.2 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
rand_bytes_ex, rand_priv_bytes_ex
|
|
- internal random number routines
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include "crypto/rand.h"
|
|
|
|
int rand_bytes_ex(OPENSSL_CTX *ctx, unsigned char *buf, int num);
|
|
int rand_priv_bytes_ex(OPENSSL_CTX *ctx, unsigned char *buf, int num);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
rand_bytes_ex() and rand_priv_bytes_ex() are the equivalent of RAND_bytes() and
|
|
RAND_priv_bytes() in the public API except that they both take an additional
|
|
I<ctx> parameter.
|
|
The DRBG used for the operation is the public or private DRBG associated with
|
|
the specified I<ctx>. The parameter can be NULL, in which case
|
|
the default library ctx is used.
|
|
If the default RAND_METHOD has been changed then for compatibility reasons the
|
|
RAND_METHOD will be used in preference and the DRBG of the library context
|
|
ignored.
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
rand_bytes_ex() and rand_bytes_priv_ex() return 0 or less on error or 1 on
|
|
success.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2019 The OpenSSL Project Authors. All Rights Reserved.
|
|
|
|
Licensed under the Apache License 2.0 (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
|