/* -*-c-*-
*
- * $Id: rand.h,v 1.5 1999/12/13 15:34:15 mdw Exp $
+ * $Id: rand.h,v 1.7 2000/10/08 12:07:18 mdw Exp $
*
* Secure random number generator
*
/*----- Revision history --------------------------------------------------*
*
* $Log: rand.h,v $
+ * Revision 1.7 2000/10/08 12:07:18 mdw
+ * Remove spurious comma in enum.
+ *
+ * Revision 1.6 2000/06/17 11:53:38 mdw
+ * Deprecate `rand_getgood'. Provide a new interface to ensure that a pool
+ * is well seeded.
+ *
* Revision 1.5 1999/12/13 15:34:15 mdw
* Fix a typo.
*
extern void rand_noisesrc(rand_pool */*r*/, const rand_source */*s*/);
+/* --- @rand_seed@ --- *
+ *
+ * Arguments: @rand_pool *r@ = pointer to a randomness pool
+ * @unsigned bits@ = number of bits to ensure
+ *
+ * Returns: ---
+ *
+ * Use: Ensures that there are at least @bits@ good bits of entropy
+ * in the pool. It is recommended that you call this after
+ * initializing a new pool. Requesting @bits > RAND_IBITS@ is
+ * doomed to failure (and is an error).
+ */
+
+extern void rand_seed(rand_pool */*r*/, unsigned /*bits*/);
+
/* --- @rand_key@ --- *
*
* Arguments: @rand_pool *r@ = pointer to a randomness pool
RAND_GATE = GRAND_SPECIFIC, /* No args */
RAND_STRETCH, /* No args */
RAND_KEY, /* @const void *k, size_t sz@ */
- RAND_NOISESRC /* @const rand_source *s@ */
+ RAND_NOISESRC, /* @const rand_source *s@ */
+ RAND_SEED /* @unsigned bits@ */
};
/* --- Default random number generator --- */