summaryrefslogtreecommitdiff
path: root/misc.h
diff options
context:
space:
mode:
authorJeffrey Walton <noloader@gmail.com>2019-07-06 16:06:27 -0400
committerJeffrey Walton <noloader@gmail.com>2019-07-06 16:06:27 -0400
commit195cd6e7c859ae8d46715f1e50e0555faf0d8f7f (patch)
tree717895aeb66e8aaeff615ceb2bdadd87bfc67cb2 /misc.h
parent2ffa70fbc65d6db23ad20ec9e6bd9975cd6a9b49 (diff)
downloadcryptopp-git-195cd6e7c859ae8d46715f1e50e0555faf0d8f7f.tar.gz
Update documentation
Diffstat (limited to 'misc.h')
-rw-r--r--misc.h11
1 files changed, 6 insertions, 5 deletions
diff --git a/misc.h b/misc.h
index ce6fff28..a90bdb75 100644
--- a/misc.h
+++ b/misc.h
@@ -936,11 +936,12 @@ CRYPTOPP_DLL void CRYPTOPP_API xorbuf(byte *output, const byte *input, const byt
/// \param buf1 the first buffer
/// \param buf2 the second buffer
/// \param count the size of the buffers, in bytes
-/// \details The function effectively performs an XOR of the elements in two equally sized
-/// buffers and retruns a result based on the XOR operation. The function is near
-/// constant-time because CPU micro-code timings could affect the "constant-ness".
-/// Calling code is responsible for mitigating timing attacks if the buffers are not
-/// equally sized.
+/// \details VerifyBufsEqual performs an XOR of the elements in two equally sized
+/// buffers and retruns a result based on the XOR operation. A count of 0 returns
+/// true because two empty buffers are considered equal.
+/// \details The function is near constant-time because CPU micro-code timings could
+/// affect the "constant-ness". Calling code is responsible for mitigating timing
+/// attacks if the buffers are not equally sized.
/// \sa ModPowerOf2
CRYPTOPP_DLL bool CRYPTOPP_API VerifyBufsEqual(const byte *buf1, const byte *buf2, size_t count);