Random Function APIs

Random Function APIs. More...

Functions
void	sys_rand_get (void *dst, size_t len)
	Fill the destination buffer with random data values that should pass general randomness tests.
int	sys_csrand_get (void *dst, size_t len)
	Fill the destination buffer with cryptographically secure random data values.
static uint8_t	sys_rand8_get (void)
	Return a 8-bit random value that should pass general randomness tests.
static uint16_t	sys_rand16_get (void)
	Return a 16-bit random value that should pass general randomness tests.
static uint32_t	sys_rand32_get (void)
	Return a 32-bit random value that should pass general randomness tests.
static uint64_t	sys_rand64_get (void)
	Return a 64-bit random value that should pass general randomness tests.

Detailed Description

Random Function APIs.

Since

1.0

Version

1.0.0

Function Documentation

sys_csrand_get()

int sys_csrand_get	(	void *	dst,
		size_t	len )

#include <zephyr/random/random.h>

Fill the destination buffer with cryptographically secure random data values.

Note

If the random values requested do not need to be cryptographically secure then use sys_rand_get() instead.

Parameters

[out]	dst	destination buffer to fill.
	len	size of the destination buffer.

Returns

0 if success, -EIO if entropy reseed error

sys_rand16_get()

uint16_t sys_rand16_get ( void )

inlinestatic

#include <zephyr/random/random.h>

Return a 16-bit random value that should pass general randomness tests.

Note

The random value returned is not a cryptographically secure random number value.

Returns

16-bit random value.

sys_rand32_get()

uint32_t sys_rand32_get ( void )

inlinestatic

#include <zephyr/random/random.h>

Return a 32-bit random value that should pass general randomness tests.

Note

The random value returned is not a cryptographically secure random number value.

Returns

32-bit random value.

sys_rand64_get()

uint64_t sys_rand64_get ( void )

inlinestatic

#include <zephyr/random/random.h>

Return a 64-bit random value that should pass general randomness tests.

Note

The random value returned is not a cryptographically secure random number value.

Returns

64-bit random value.

sys_rand8_get()

uint8_t sys_rand8_get ( void )

inlinestatic

#include <zephyr/random/random.h>

Return a 8-bit random value that should pass general randomness tests.

Note

The random value returned is not a cryptographically secure random number value.

Returns

8-bit random value.

sys_rand_get()

void sys_rand_get	(	void *	dst,
		size_t	len )

#include <zephyr/random/random.h>

Fill the destination buffer with random data values that should pass general randomness tests.

Note

The random values returned are not considered cryptographically secure random number values.

Parameters

[out]	dst	destination buffer to fill with random data.
	len	size of the destination buffer.