yuzu/mbedtls
1
0
Fork 0
mirror of https://github.com/yuzu-emu/mbedtls.git synced 2024-12-23 10:55:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

Address review comments for documentation

Browse source
This commit is contained in:
Jarno Lamsa 2019-10-04 15:42:39 +03:00
parent 1881ef53b7
commit c4315e6d5e
1 changed files with 16 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

35
include/mbedtls/platform_util.h
View file

@ -167,12 +167,11 @@ void mbedtls_platform_zeroize( void *buf, size_t len );
/**
* \brief Secure memset
*
* This function is meant to provide a more secure way to do
* memset. It starts by initialising the given memory area
* from random tail location with random data. After tail is
* initialised, the remaining head of the buffer is initialised
* with random data. After initialisation, the original memset
* is performed
* This is a constant-time version of memset(). If
* MBEDTLS_ENTROPY_HARDWARE_ALT is defined, the buffer is
* initialised with random data and the order is also
* randomised using the hardware RNG in order to further harden
* against side-channel attacks.
*
* \param ptr Buffer to be set.
* \param value Value to be used when setting the buffer.
@ -185,12 +184,11 @@ void *mbedtls_platform_memset( void *ptr, int value, size_t num );
/**
* \brief Secure memcpy
*
* This function is meant to provide a more secure way to do
* memcpy. It starts by initialising the given memory area
* with random data. After initialisation, the original memcpy
* is performed by starting first copying from random tail
* location of the buffer. After tail has been copied, the
* remaining head is copied as well.
* This is a constant-time version of memcpy(). If
* MBEDTLS_ENTROPY_HARDWARE_ALT is defined, the buffer is
* initialised with random data and the order is also
* randomised using the hardware RNG in order to further harden
* against side-channel attacks.
*
* \param dst Destination buffer where the data is being copied to.
* \param src Source buffer where the data is being copied from.
@ -203,18 +201,17 @@ void *mbedtls_platform_memcpy( void *dst, const void *src, size_t num );
/**
* \brief Secure memcmp
*
* This function is meant to provide a more secure way to do
* memcmp. It starts comparing from a random offset and goes
* through the tail part of buffers first byte by byte. After
* that it starts going through the head part of buffer. In the
* end, the number of equal bytes is compared to the length of the
* buffers, thus making the function a fixed time memcmp.
* This is a constant-time version of memcmp(). If
* MBEDTLS_ENTROPY_HARDWARE_ALT is defined, the order is also
* randomised using the hardware RNG in order to further harden
* against side-channel attacks.
*
* \param buf1 First buffer to compare.
* \param buf2 Second buffer to compare against.
* \param num The length of the buffers in bytes.
*
* \return 0 if the buffers were equal.
* \return 0 if the buffers were equal or an unspecified non-zero value
* otherwise.
*/
int mbedtls_platform_memcmp( const void *buf1, const void *buf2, size_t num );