6216c6cf5b
Create syscalls to make possible using random APIs from user mode threads. These APIs can have different implementations, like using entropy driver or Xoroshiro128. Some of these implementations also have some globals to preserve state between calls. Make it run entire in user space would require user adding these globals to their memeory domains and/or grant access to entropy device. Syscalls simplify its usage. Signed-off-by: Flavio Ceolin <flavio.ceolin@intel.com>
87 lines
2 KiB
C
87 lines
2 KiB
C
/*
|
|
* Copyright (c) 2013-2014 Wind River Systems, Inc.
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
* @brief Random number generator header file
|
|
*
|
|
* This header file declares prototypes for the kernel's random number
|
|
* generator APIs.
|
|
*
|
|
* Typically, a platform enables the appropriate source for the random
|
|
* number generation based on the hardware platform's capabilities or
|
|
* (for testing purposes only) enables the TEST_RANDOM_GENERATOR
|
|
* configuration option.
|
|
*/
|
|
|
|
#ifndef ZEPHYR_INCLUDE_RANDOM_RAND32_H_
|
|
#define ZEPHYR_INCLUDE_RANDOM_RAND32_H_
|
|
|
|
#include <zephyr/types.h>
|
|
#include <stddef.h>
|
|
#include <kernel.h>
|
|
|
|
/**
|
|
* @brief Random Function APIs
|
|
* @defgroup random_api Random Function APIs
|
|
* @ingroup crypto
|
|
* @{
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief 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.
|
|
*
|
|
* @return 32-bit random value.
|
|
*/
|
|
__syscall uint32_t sys_rand32_get(void);
|
|
|
|
/**
|
|
* @brief 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.
|
|
*
|
|
* @param [out] dst destination buffer to fill with random data.
|
|
* @param len size of the destination buffer.
|
|
*
|
|
*/
|
|
__syscall void sys_rand_get(void *dst, size_t len);
|
|
|
|
/**
|
|
* @brief 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.
|
|
*
|
|
* @param [out] dst destination buffer to fill.
|
|
* @param len size of the destination buffer.
|
|
*
|
|
* @return 0 if success, -EIO if entropy reseed error
|
|
*
|
|
*/
|
|
__syscall int sys_csrand_get(void *dst, size_t len);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#include <syscalls/rand32.h>
|
|
#endif /* ZEPHYR_INCLUDE_RANDOM_RAND32_H_ */
|