diff options
author | Tom Rini <trini@konsulko.com> | 2020-06-15 16:44:58 -0400 |
---|---|---|
committer | Tom Rini <trini@konsulko.com> | 2020-06-15 16:44:58 -0400 |
commit | c622afb0874e57cd7e9df51855e35286fa46aab7 (patch) | |
tree | 0e93777492b0dc0b2263c0cd2704e8fed1a39819 /include | |
parent | e88d6979d1fa0a11468204fa729229afc49d5bde (diff) | |
parent | 4bb4249b39ce7284408c4d604a656be941427e63 (diff) | |
download | u-boot-c622afb0874e57cd7e9df51855e35286fa46aab7.zip u-boot-c622afb0874e57cd7e9df51855e35286fa46aab7.tar.gz u-boot-c622afb0874e57cd7e9df51855e35286fa46aab7.tar.bz2 |
Merge tag 'efi-2020-07-rc5' of https://gitlab.denx.de/u-boot/custodians/u-boot-efi
Pull request for UEFI sub-system for efi-2020-07-rc5
Use correct printf code in efi_image_parse().
Add random number generation to HTML documentation.
Diffstat (limited to 'include')
-rw-r--r-- | include/rand.h | 6 | ||||
-rw-r--r-- | include/rng.h | 26 |
2 files changed, 21 insertions, 11 deletions
diff --git a/include/rand.h b/include/rand.h index c9d15f5..4c54fbb 100644 --- a/include/rand.h +++ b/include/rand.h @@ -22,7 +22,7 @@ void srand(unsigned int seed); /** * rand() - Get a 32-bit pseudo-random number * - * @returns next random number in the sequence + * Return: next random number in the sequence */ unsigned int rand(void); @@ -32,8 +32,8 @@ unsigned int rand(void); * This version of the function allows multiple sequences to be used at the * same time, since it requires the caller to store the seed value. * - * @seed value to use, updated on exit - * @returns next random number in the sequence + * @seedp: seed value to use, updated on exit + * Return: next random number in the sequence */ unsigned int rand_r(unsigned int *seedp); diff --git a/include/rng.h b/include/rng.h index d2c0f9a..37af554 100644 --- a/include/rng.h +++ b/include/rng.h @@ -10,22 +10,32 @@ struct udevice; /** * dm_rng_read() - read a random number seed from the rng device - * @buffer: input buffer to put the read random seed into - * @size: number of bytes of random seed read * - * Return: 0 if OK, -ve on error + * The function blocks until the requested number of bytes is read. + * + * @dev: random number generator device + * @buffer: input buffer to put the read random seed into + * @size: number of random bytes to read + * Return: 0 if OK, -ve on error */ int dm_rng_read(struct udevice *dev, void *buffer, size_t size); -/* struct dm_rng_ops - Operations for the hwrng uclass */ +/** + * struct dm_rng_ops - operations for the hwrng uclass + * + * This structures contains the function implemented by a hardware random + * number generation device. + */ struct dm_rng_ops { /** - * @read() - read a random number seed + * @read: read a random bytes * - * @data: input buffer to read the random seed - * @max: total number of bytes to read + * The function blocks until the requested number of bytes is read. * - * Return: 0 if OK, -ve on error + * @read.dev: random number generator device + * @read.data: input buffer to read the random seed into + * @read.max: number of random bytes to read + * @read.Return: 0 if OK, -ve on error */ int (*read)(struct udevice *dev, void *data, size_t max); }; |