doc/man3/RAND_load_file.pod: RAND_load_file on non-regular files with bytes=-1

Mention that RAND_load_file attempts to read only RAND_DRBG_STRENGTH
bytes on non-regular files if the number of bytes to be read
is not specified explicitly.

Signed-off-by: Eugene Syromiatnikov <esyr@openssl.org>

Reviewed-by: Paul Dale <ppzgs1@gmail.com>
Reviewed-by: Saša Nedvědický <sashan@openssl.org>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/28379)
This commit is contained in:
Eugene Syromiatnikov 2025-08-29 10:29:26 +02:00 committed by Tomas Mraz
parent 35db6a15d4
commit 0daaf33275
1 changed files with 3 additions and 1 deletions

View File

@ -19,7 +19,9 @@ RAND_load_file, RAND_write_file, RAND_file_name - PRNG seed file
RAND_load_file() reads a number of bytes from file B<filename> and
adds them to the PRNG. If B<max_bytes> is nonnegative,
up to B<max_bytes> are read;
if B<max_bytes> is -1, the complete file is read.
if B<max_bytes> is -1, the complete file is read (unless the file
is not a regular file, in that case a fixed number of bytes,
256 in the current implementation, is attempted to be read).
RAND_load_file() can read less than the complete file or the requested number
of bytes if it doesn't fit in the return value type.
Do not load the same file multiple times unless its contents have