man/man3/hcrypto_rand.3

         "RAND crypto functions" 3 "11 Jan 2012" "Version 1.5.2" "Heimdal crypto library" \" -*- nroff -*-
 NAME
RAND crypto functions -
 "Functions"

 "void RAND_seed (const void *indata, size_t size)"
 "int RAND_bytes (void *outdata, size_t size)"
 "void RAND_cleanup (void)"
 "void RAND_add (const void *indata, size_t size, double entropi)"
 "int RAND_pseudo_bytes (void *outdata, size_t size)"
 "int RAND_status (void)"
 "int RAND_set_rand_method (const RAND_METHOD *meth)"
 "const RAND_METHOD * RAND_get_rand_method (void)"
 "int RAND_set_rand_engine (ENGINE *engine)"
 "int RAND_load_file (const char *filename, size_t size)"
 "int RAND_write_file (const char *filename)"
 "const char * RAND_file_name (char *filename, size_t size)"
 "Detailed Description"

See the RAND - random number for description and examples.
 "Function Documentation"

 "void RAND_add (const void * indata, size_t size, double entropi)"

Seed that random number generator. Secret material can securely be feed into the function, they will never be returned.

Parameters:

indata the input data.

size size of in data.

entropi entropi in data.


 "int RAND_bytes (void * outdata, size_t size)"

Get a random block from the random generator, can be used for key material.

Parameters:

outdata random data

size length random data


Returns:

1 on success, 0 on failure.


 "void RAND_cleanup (void)"

Reset and free memory used by the random generator.
 "const char* RAND_file_name (char * filename, size_t size)"

Return the default random state filename for a user to use for RAND_load_file(), and RAND_write_file().

Parameters:

filename buffer to hold file name.

size size of buffer filename.


Returns:

the buffer filename or NULL on failure.


 "const RAND_METHOD* RAND_get_rand_method (void)"

Get the default random method.
 "int RAND_load_file (const char * filename, size_t size)"

Load a a file and feed it into RAND_seed().

Parameters:

filename name of file to read.

size minimum size to read.


 "int RAND_pseudo_bytes (void * outdata, size_t size)"

Get a random block from the random generator, should NOT be used for key material.

Parameters:

outdata random data

size length random data


Returns:

1 on success, 0 on failure.


 "void RAND_seed (const void * indata, size_t size)"

Seed that random number generator. Secret material can securely be feed into the function, they will never be returned.

Parameters:

indata seed data

size length seed data


 "int RAND_set_rand_engine (ENGINE * engine)"

Set the default random method from engine.

Parameters:

engine use engine, if NULL is passed it, old method and engine is cleared.


Returns:

1 on success, 0 on failure.


 "int RAND_set_rand_method (const RAND_METHOD * meth)"

Set the default random method.

Parameters:

meth set the new default method.


Returns:

1 on success.


 "int RAND_status (void)"

Return status of the random generator

Returns:

1 if the random generator can deliver random data.


 "int RAND_write_file (const char * filename)"

Write of random numbers to a file to store for later initiation with RAND_load_file().

Parameters:

filename name of file to write.


Returns:

1 on success and non-one on failure.