'\" t .\" Title: kcapi_rng_seed .\" Author: .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: April 2024 .\" Manual: Programming Interface .\" Source: libkcapi Manual 1.4.0 .\" Language: English .\" .TH "KCAPI_RNG_SEED" "3" "April 2024" "libkcapi Manual 1\&.4\&.0" "Programming Interface" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" kcapi_rng_seed \- seed the RNG .SH "SYNOPSIS" .HP \w'int\ kcapi_rng_seed('u .BI "int kcapi_rng_seed(struct\ kcapi_handle\ *\ " "handle" ", uint8_t\ *\ " "seed" ", uint32_t\ " "seedlen" ");" .SH "ARGUMENTS" .PP \fIhandle\fR .RS 4 [in] cipher handle .RE .PP \fIseed\fR .RS 4 [in] seed data .RE .PP \fIseedlen\fR .RS 4 [in] size of seed .RE .SH "DESCRIPTION" .PP Note, this call must be called to initialize the selected RNG\&. When the SP800\-90A DRBG is used, this call causes the DRBG to seed itself from the internal noise sources\&. .PP Note, in case of using the SP800\-90A DRBG, the seed buffer may be NULL\&. If it is not NULL, the DRBG uses the given data either as personalization string in case of the initial seeding or additional data for reseeding\&. .PP \fIreturn\fR 0 upon success; a negative errno\-style error code if an error occurred .SH "AUTHOR" .PP \fBStephan Mueller\fR <\&smueller@chronox.de\&> .RS 4 Author. .RE .SH "COPYRIGHT" .br