X-Git-Url: https://git.distorted.org.uk/u/mdw/catacomb/blobdiff_plain/aa1082f28ddd05f3b946ca1a9c6bfaa17d18aca5..578a86d91941a0f722b87973d88e84ec2cf9a608:/grand.h diff --git a/grand.h b/grand.h index 04925bb..0446b2b 100644 --- a/grand.h +++ b/grand.h @@ -1,6 +1,6 @@ /* -*-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 * @@ -27,14 +27,6 @@ * 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 @@ -60,6 +52,7 @@ typedef struct grand_ops { /* --- Various important properties --- */ const char *name; /* Generator's name */ + unsigned f; /* Various flags */ uint32 max; /* Maximum raw output */ /* --- Maintenance methods --- */ @@ -75,12 +68,22 @@ typedef struct grand_ops { */ 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 { @@ -95,11 +98,11 @@ 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))