Merge branch 'master' of git.distorted.org.uk:~mdw/publish/public-git/catacomb

[u/mdw/catacomb] / dsarand.h

diff --git a/dsarand.h b/dsarand.h
index 553efb1..bc5e700 100644 (file)
--- a/dsarand.h
+++ b/dsarand.h
@@ -1,13 +1,13 @@
 /* -*-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
  *
  * (c) 1999 Straylight/Edgeware
  */
 
-/*----- Licensing notice --------------------------------------------------* 
+/*----- Licensing notice --------------------------------------------------*
  *
  * This file is part of Catacomb.
  *
@@ -15,26 +15,18 @@
  * it under the terms of the GNU Library General Public License as
  * published by the Free Software Foundation; either version 2 of the
  * License, or (at your option) any later version.
- * 
+ *
  * Catacomb is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU Library General Public License for more details.
- * 
+ *
  * You should have received a copy of the GNU Library General Public
  * License along with Catacomb; if not, write to the Free
  * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
  * 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*/);