Add note about use of tor_memcmp()

diff --git a/src/lib/ctime/di_ops.c b/src/lib/ctime/di_ops.c
index 011baf2654c85dcfb1420c638875d410ea0eba58..73441f84f80c8d9cc635ce8a07ac9982bd469b80 100644 (file)
--- a/src/lib/ctime/di_ops.c
+++ b/src/lib/ctime/di_ops.c
@@ -23,6 +23,9 @@
  * This implementation differs from memcmp in that its timing behavior is not
  * data-dependent: it should return in the same amount of time regardless of
  * the contents of <b>a</b> and <b>b</b>.
+ *
+ * Note that if all you care about is equality, this implementation is
+ * overkill: it would be better to use tor_memeq() or tor_memneq().
  */
 int
 tor_memcmp(const void *a, const void *b, size_t len)