Add an internal-representation no-op function.

[u/mdw/catacomb] / dsarand.h

diff --git a/dsarand.h b/dsarand.h
index 553efb1..4d36d6d 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.3 2001/02/03 16:08:56 mdw Exp $
  *
  * Random number generator for DSA
  *
@@ -30,6 +30,13 @@
 /*----- Revision history --------------------------------------------------* 
  *
  * $Log: dsarand.h,v $
+ * Revision 1.3  2001/02/03 16:08:56  mdw
+ * Give generic random objects separate namespaces for their supported misc
+ * ops.  Add operations for reading the current seed value.
+ *
+ * Revision 1.2  2000/06/17 10:54:14  mdw
+ * Typesetting fixes.
+ *
  * Revision 1.1  1999/12/22 15:53:12  mdw
  * Random number generator for finding DSA parameters.
  *
@@ -113,7 +120,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 +142,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 +154,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*/);