'\" t .\" Title: kcapi_rng_get_bytes .\" Author: .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: April 2024 .\" Manual: Programming Interface .\" Source: libkcapi Manual 1.4.0 .\" Language: English .\" .TH "KCAPI_RNG_GET_BYTES" "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_get_bytes \- Convenience function to generate random bytes .SH "SYNOPSIS" .HP \w'ssize_t\ kcapi_rng_get_bytes('u .BI "ssize_t kcapi_rng_get_bytes(uint8_t\ *\ " "buffer" ", size_t\ " "outlen" ");" .SH "ARGUMENTS" .PP \fIbuffer\fR .RS 4 [out] filled with the random number .RE .PP \fIoutlen\fR .RS 4 [in] buffer length .RE .SH "DESCRIPTION" .PP This convenience function generates random bytes of the size of outlen and stores them into the provided buffer\&. .PP \fIreturn\fR size of random number generated upon success; \-EIO \- data cannot be obtained .SH "AUTHOR" .PP \fBStephan Mueller\fR <\&smueller@chronox.de\&> .RS 4 Author. .RE .SH "COPYRIGHT" .br