eden-emu/mbedtls
15
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve docs for mbedtls_ct_memcmp

Browse source 
Signed-off-by: Dave Rodgman <dave.rodgman@arm.com>
This commit is contained in:
Dave Rodgman 2023-07-31 12:33:47 +01:00
parent 9ee0e1f6fe
commit ad9e5b9abe
1 changed files with 8 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

13
include/mbedtls/constant_time.h
View file

@ -26,16 +26,19 @@
/** Constant-time buffer comparison without branches. /** Constant-time buffer comparison without branches.
* *
* This is equivalent to the standard memcmp function, but is likely to be * This is equivalent to the standard memcmp function, but is likely to be
* compiled to code using bitwise operation rather than a branch. * compiled to code using bitwise operation rather than a branch, such that
* the time taken is constant w.r.t. the data pointed to by \p a and \p b,
* and w.r.t. whether \p a and \p b are equal or not. It is not constant-time
* w.r.t. \p n .
* *
* This function can be used to write constant-time code by replacing branches * This function can be used to write constant-time code by replacing branches
* with bit operations using masks. * with bit operations using masks.
* *
* \param a Pointer to the first buffer. * \param a Pointer to the first buffer, containing at least \p n bytes. May not be NULL.
* \param b Pointer to the second buffer. * \param b Pointer to the second buffer, containing at least \p n bytes. May not be NULL.
* \param n The number of bytes to compare in the buffer. * \param n The number of bytes to compare.
* *
* \return Zero if the content of the two buffer is the same, * \return Zero if the contents of the two buffers are the same,
* otherwise non-zero. * otherwise non-zero.
*/ */
int mbedtls_ct_memcmp(const void *a, int mbedtls_ct_memcmp(const void *a,