/* -*-c-*-
*
- * $Id: grand.h,v 1.1 1999/12/10 23:16:01 mdw Exp $
+ * $Id: grand.h,v 1.5 2004/04/08 01:36:15 mdw Exp $
*
* Generic interface to random number generators
*
* MA 02111-1307, USA.
*/
-/*----- Revision history --------------------------------------------------*
- *
- * $Log: grand.h,v $
- * Revision 1.1 1999/12/10 23:16:01 mdw
- * Generic interface.
- *
- */
-
#ifndef CATACOMB_GRAND_H
#define CATACOMB_GRAND_H
/* --- Various important properties --- */
const char *name; /* Generator's name */
+ unsigned f; /* Various flags */
uint32 max; /* Maximum raw output */
/* --- Maintenance methods --- */
*/
uint32 (*raw)(grand */*r*/); /* Uniform over %$[0, max)$% */
- octet (*byte)(grand */*r*/); /* Uniform over %$[0, 256)%$ */
+ octet (*byte)(grand */*r*/); /* Uniform over %$[0, 256)$% */
uint32 (*word)(grand */*r*/); /* Uniform over %$[0, 2^{32})$% */
uint32 (*range)(grand */*r*/, uint32 /*l*/); /* Uniform over %$[0, l)$% */
void (*fill)(grand */*r*/, void */*p*/, size_t /*sz*/); /* Fill buffer */
} grand_ops;
+#define GR_DESTROY(r) (r)->ops->destroy((r))
+#define GR_RAW(r) (r)->ops->raw((r))
+#define GR_WORD(r) (r)->ops->word((r))
+#define GR_RANGE(r, l) (r)->ops->range((r), (l))
+#define GR_FILL(r, p, sz) (r)->ops->fill((r), (p), (sz))
+
+/* --- Flag types --- */
+
+#define GRAND_CRYPTO 1u /* Cryptographically strong */
+
/* --- Operation types --- */
enum {
GRAND_SEEDUINT32, /* @uint32 i@ */
GRAND_SEEDBLOCK, /* @const void *p, size_t sz@ */
GRAND_SEEDMP, /* @mp *m@ */
- GRAND_SEEDRAND, /* @grand *g@ */
+ GRAND_SEEDRAND /* @grand *g@ */
/* --- Generator-specific operations --- */
- GRAND_SPECIFIC = 256u
+#define GRAND_SPECIFIC(ch) ((unsigned)(ch) << 8)
};
#define GRAND_BADOP assert(((void)"bad grand_misc op", 0))