mention need to audit randomness of gamma

1 files changed, 24 insertions, 3 deletions

diff --git a/src/mint/taler-mint-httpd_keystate.h b/src/mint/taler-mint-httpd_keystate.h
index 62b041e9..0e20ef58 100644
--- a/src/mint/taler-mint-httpd_keystate.h
+++ b/src/mint/taler-mint-httpd_keystate.h
@@ -41,19 +41,40 @@ struct TMH_KS_StateHandle;
  * For every call to #TMH_KS_acquire(), a matching call
  * to #TMH_KS_release() must be made.
  *
+ * @param location name of the function in which the lock is acquired
  * @return the key state
  */
 struct TMH_KS_StateHandle *
-TMH_KS_acquire (void);
+TMH_KS_acquire_ (const char *location);
 
 
 /**
  * Release key state, free if necessary (if reference count gets to zero).
  *
+ * @param location name of the function in which the lock is acquired
  * @param key_state the key state to release
  */
 void
-TMH_KS_release (struct TMH_KS_StateHandle *key_state);
+TMH_KS_release_ (const char *location,
+                 struct TMH_KS_StateHandle *key_state);
+
+
+/**
+ * Acquire the key state of the mint.  Updates keys if necessary.
+ * For every call to #TMH_KS_acquire(), a matching call
+ * to #TMH_KS_release() must be made.
+ *
+ * @return the key state
+ */
+#define TMH_KS_acquire(void) TMH_KS_acquire_(__FUNCTION__)
+
+
+/**
+ * Release key state, free if necessary (if reference count gets to zero).
+ *
+ * @param key_state the key state to release
+ */
+#define TMH_KS_release(key_state) TMH_KS_release_ (__FUNCTION__, key_state)
 
 
 /**
@@ -65,7 +86,7 @@ TMH_KS_release (struct TMH_KS_StateHandle *key_state);
 enum TMH_KS_DenominationKeyUse {
 
   /**
-   * The key is to be used for a /withdraw/sign or /refresh (mint)
+   * The key is to be used for a /reserve/withdraw or /refresh (mint)
    * operation.
    */
   TMH_KS_DKU_WITHDRAW,