factorial: Fix usage message to fit in with conventions.

[u/mdw/catacomb] / dsarand.h

diff --git a/dsarand.h b/dsarand.h
index 553efb1..2d4ea09 100644 (file)
--- a/dsarand.h
+++ b/dsarand.h
@@ -1,6 +1,6 @@
 /* -*-c-*-
  *
- * $Id: dsarand.h,v 1.1 1999/12/22 15:53:12 mdw Exp $
+ * $Id: dsarand.h,v 1.4 2004/04/08 01:36:15 mdw Exp $
  *
  * Random number generator for DSA
  *
@@ -27,14 +27,6 @@
  * MA 02111-1307, USA.
  */
 
-/*----- Revision history --------------------------------------------------* 
- *
- * $Log: dsarand.h,v $
- * Revision 1.1  1999/12/22 15:53:12  mdw
- * Random number generator for finding DSA parameters.
- *
- */
-
 #ifndef CATACOMB_DSARAND_H
 #define CATACOMB_DSARAND_H
 
@@ -113,7 +105,7 @@ extern void dsarand_destroy(dsarand */*d*/);
  *
  *             Let %$p$% be the numerical value of the input buffer, and let
  *             %$b$% be the number of bytes required.  Let
- *             %$z = \lceil b / 20 \rceil%$ be the number of SHA outputs
+ *             %$z = \lceil b / 20 \rceil$% be the number of SHA outputs
  *             required.  Then the output of pass %$n$% is
  *
  *               %$P_n = \sum_{0 \le i < z} 2^{160i} SHA(p + nz + i)$%
@@ -135,7 +127,9 @@ extern void dsarand_fill(dsarand */*d*/, void */*p*/, size_t /*sz*/);
 /* --- Miscellaneous operations --- */
 
 enum {
-  DSARAND_PASSES = GRAND_SPECIFIC
+  DSARAND_PASSES = GRAND_SPECIFIC('D'),        /* @unsigned n@ */
+  DSARAND_SEEDSZ,                      /* No args */
+  DSARAND_GETSEED                      /* @void *buf@ */
 };
 
 /* --- @dsarand_create@ --- *
@@ -145,8 +139,7 @@ enum {
  *
  * Returns:    Pointer to a generic generator.
  *
- * Use:                Constructs a generic generator interface over a Catacomb
- *             entropy pool generator.
+ * Use:                Constructs a generic generator interface to a DSA generator.
  */
 
 extern grand *dsarand_create(const void */*p*/, size_t /*sz*/);