pub/dsa-misc.c, pub/dsa.h: Make arg name in comment match declaration.

[catacomb] / pub / dsa.h

diff --git a/pub/dsa.h b/pub/dsa.h
index 3b93d9338774e6434d96ac4bb104cd91bc60d684..c803c78f2a00f6a62df91fe99ce9b90c58d7fda6 100644 (file)
--- a/pub/dsa.h
+++ b/pub/dsa.h
@@ -190,6 +190,24 @@ extern int dsa_checkparam(keycheck */*kc*/, const dsa_param */*dp*/,
 
 extern mp *dsa_h2n(mp */*d*/, mp */*r*/, const void */*h*/, size_t /*hsz*/);
 
+/* --- @dsa_nonce@ --- *
+ *
+ * Arguments:  @mp *d@ = destination integer
+ *             @mp *q@ = order of the DSA group
+ *             @mp *x@ = secret key
+ *             @const octet *m@ = message hash
+ *             @const gchash *ch@ = hash class
+ *             @grand *r@ = random bit source, or null
+ *
+ * Returns:    A nonce.
+ *
+ * Use:                Generates a nonce for use in DSA (or another Fiat--Shamir
+ *             signature scheme).
+ */
+
+extern mp *dsa_nonce(mp */*d*/, mp */*q*/, mp */*x*/, const octet */*m*/,
+                    const gchash */*ch*/, grand */*r*/);
+
 /* --- @dsa_mksig@ --- *
  *
  * Arguments:  @const dsa_param *dp@ = pointer to DSA parameters