.TH "hcrypto_rand" 3 "Tue Jul 11 2017" "Version 7.4.0" "Heimdal crypto library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
hcrypto_rand \- RAND crypto functions
.SS "Functions"

.in +1c
.ti -1c
.RI "void \fBRAND_seed\fP (const void *indata, size_t size)"
.br
.ti -1c
.RI "int \fBRAND_bytes\fP (void *outdata, size_t size)"
.br
.ti -1c
.RI "void \fBRAND_cleanup\fP (void)"
.br
.ti -1c
.RI "void \fBRAND_add\fP (const void *indata, size_t size, double entropi)"
.br
.ti -1c
.RI "int \fBRAND_pseudo_bytes\fP (void *outdata, size_t size)"
.br
.ti -1c
.RI "int \fBRAND_status\fP (void)"
.br
.ti -1c
.RI "int \fBRAND_set_rand_method\fP (const RAND_METHOD *meth)"
.br
.ti -1c
.RI "const RAND_METHOD * \fBRAND_get_rand_method\fP (void)"
.br
.ti -1c
.RI "int \fBRAND_set_rand_engine\fP (ENGINE *engine)"
.br
.ti -1c
.RI "int \fBRAND_load_file\fP (const char *filename, size_t size)"
.br
.ti -1c
.RI "int \fBRAND_write_file\fP (const char *filename)"
.br
.ti -1c
.RI "const char * \fBRAND_file_name\fP (char *filename, size_t size)"
.br
.in -1c
.SH "Detailed Description"
.PP 
See the \fBRAND - random number\fP for description and examples\&. 
.SH "Function Documentation"
.PP 
.SS "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\&.
.PP
\fBParameters:\fP
.RS 4
\fIindata\fP the input data\&. 
.br
\fIsize\fP size of in data\&. 
.br
\fIentropi\fP entropi in data\&. 
.RE
.PP

.SS "int RAND_bytes (void * outdata, size_t size)"
Get a random block from the random generator, can be used for key material\&.
.PP
\fBParameters:\fP
.RS 4
\fIoutdata\fP random data 
.br
\fIsize\fP length random data
.RE
.PP
\fBReturns:\fP
.RS 4
1 on success, 0 on failure\&. 
.RE
.PP

.SS "void RAND_cleanup (void)"
Reset and free memory used by the random generator\&. 
.SS "const char* RAND_file_name (char * filename, size_t size)"
Return the default random state filename for a user to use for \fBRAND_load_file()\fP, and \fBRAND_write_file()\fP\&.
.PP
\fBParameters:\fP
.RS 4
\fIfilename\fP buffer to hold file name\&. 
.br
\fIsize\fP size of buffer filename\&.
.RE
.PP
\fBReturns:\fP
.RS 4
the buffer filename or NULL on failure\&. 
.RE
.PP

.SS "const RAND_METHOD* RAND_get_rand_method (void)"
Get the default random method\&.
.PP
\fBReturns:\fP
.RS 4
Returns a RAND_METHOD 
.RE
.PP

.SS "int RAND_load_file (const char * filename, size_t size)"
Load a a file and feed it into \fBRAND_seed()\fP\&.
.PP
\fBParameters:\fP
.RS 4
\fIfilename\fP name of file to read\&. 
.br
\fIsize\fP minimum size to read\&.
.RE
.PP
\fBReturns:\fP
.RS 4
Returns the number of seed bytes loaded (0 indicates failure) 
.RE
.PP

.SS "int RAND_pseudo_bytes (void * outdata, size_t size)"
Get a random block from the random generator, should NOT be used for key material\&.
.PP
\fBParameters:\fP
.RS 4
\fIoutdata\fP random data 
.br
\fIsize\fP length random data
.RE
.PP
\fBReturns:\fP
.RS 4
1 on success, 0 on failure\&. 
.RE
.PP

.SS "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\&.
.PP
\fBParameters:\fP
.RS 4
\fIindata\fP seed data 
.br
\fIsize\fP length seed data 
.RE
.PP

.SS "int RAND_set_rand_engine (ENGINE * engine)"
Set the default random method from engine\&.
.PP
\fBParameters:\fP
.RS 4
\fIengine\fP use engine, if NULL is passed it, old method and engine is cleared\&.
.RE
.PP
\fBReturns:\fP
.RS 4
1 on success, 0 on failure\&. 
.RE
.PP

.SS "int RAND_set_rand_method (const RAND_METHOD * meth)"
Set the default random method\&.
.PP
\fBParameters:\fP
.RS 4
\fImeth\fP set the new default method\&.
.RE
.PP
\fBReturns:\fP
.RS 4
1 on success\&. 
.RE
.PP

.SS "int RAND_status (void)"
Return status of the random generator
.PP
\fBReturns:\fP
.RS 4
1 if the random generator can deliver random data\&. 
.RE
.PP

.SS "int RAND_write_file (const char * filename)"
Write of random numbers to a file to store for later initiation with \fBRAND_load_file()\fP\&.
.PP
\fBParameters:\fP
.RS 4
\fIfilename\fP name of file to write\&.
.RE
.PP
\fBReturns:\fP
.RS 4
1 on success and non-one on failure\&. 
.RE
.PP

.SH "Author"
.PP 
Generated automatically by Doxygen for Heimdal crypto library from the source code\&.