Sortix
Sortix Download Manual Development Source Code News Blog More
current nightly
RAND_load_file(3) LibreSSL RAND_load_file(3)

NAME

RAND_load_file, RAND_write_file, RAND_file_name - PRNG seed file

SYNOPSIS


#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);

DESCRIPTION

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 used in new programs.
RAND_write_file() writes a number of random bytes (currently 1024) to file filename.

RETURN VALUES

RAND_load_file() always returns 0.
RAND_write_file() returns the number of bytes written, and -1 if the bytes written were generated without appropriate seed.
RAND_file_name() returns a pointer to buf on success, and NULL on error.

SEE ALSO

rand(3), RAND_add(3), RAND_cleanup(3)

HISTORY

RAND_load_file(), RAND_write_file() and RAND_file_name() are available in all versions of SSLeay and OpenSSL.
2015-10-26 LibreSSL
Copyright 2011-2025 Jonas 'Sortie' Termansen and contributors.
Sortix's source code is free software under the ISC license.
#sortix on irc.sortix.org
@sortix_org