RANDloadfile(3) OpenSSL RANDloadfile(3)

NAME
       RANDloadfile, RANDwritefile, RANDfilename - PRNG seed file

SYNOPSIS
        #include 

        const char *RANDfilename(char *buf, sizet num);

        int RANDloadfile(const char *filename, long maxbytes);

        int RANDwritefile(const char *filename);

DESCRIPTION
       RANDfilename() generates a default path for the random seed file. bbuuff
       points to a buffer of size nnuumm in which to store the filename. The seed
       file is $RANDFILE if that environment variable is set, $HOME/.rnd
       otherwise. If $HOME is not set either, or nnuumm is too small for the path
       name, an error occurs.

       RANDloadfile() reads a number of bytes from file ffiilleennaammee and adds
       them to the PRNG. If mmaaxxbbyytteess is non-negative, up to to mmaaxxbbyytteess are
       read; starting with OpenSSL 0.9.5, if mmaaxxbbyytteess is -1, the complete
       file is read.

       RANDwritefile() writes a number of random bytes (currently 1024) to
       file ffiilleennaammee which can be used to initialize the PRNG by calling
       RANDloadfile() in a later session.

RETURN VALUES
       RANDloadfile() returns the number of bytes read.

       RANDwritefile() returns the number of bytes written, and -1 if the
       bytes written were generated without appropriate seed.

       RANDfilename() returns a pointer to bbuuff on success, and NULL on
       error.

SEE ALSO
       rand(3), RANDadd(3), RANDcleanup(3)

HISTORY       RANDloadfile(), RANDwritefile() and RANDfilename() are available
       in all versions of SSLeay and OpenSSL.



0.9.7l                            2001-03-21                 RANDloadfile(3)