libressl-RAND_load_file(3)

libressl-RAND_load_file3

Prng seed file

Usage

Crypto Library (libcrypto, -lcrypto)

#include <openssl/rand.h>

const char *

RAND_file_name(char *buf, size_t num);

int

RAND_load_file(const char *filename, long max_bytes);

int

RAND_write_file(const char *filename);

Overview

RAND_file_name() returns a default path for the random seed file. buf points to a buffer of size num in which to store the filename. If num is too small for the path name, an error occurs.

RAND_load_file() used to allow for the state of the random number generator to be controlled by external sources. It is kept for ABI compatibility but is no longer functional, and should not be used in new programs.

RAND_write_file() writes a number of random bytes (currently 1024) to file filename.

Return values

RAND_load_file() returns max_bytes, or a bogus positive value if max_bytes is -1.

RAND_write_file() returns the number of bytes written, or a number less than or equal to 1 if an error occurs.

RAND_file_name() returns a pointer to buf on success or NULL on error.

History

RAND_load_file(), RAND_write_file(), and RAND_file_name() first appeared in SSLeay 0.5.1 and have been available since OpenBSD 2.4.

From libressl 4.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.