Make tables of standard encryption schemes etc.

[u/mdw/catacomb] / ghash.h

diff --git a/ghash.h b/ghash.h
index 762444c..9d63419 100644 (file)
--- a/ghash.h
+++ b/ghash.h
@@ -1,6 +1,6 @@
 /* -*-c-*-
  *
- * $Id: ghash.h,v 1.2 2000/06/17 11:22:17 mdw Exp $
+ * $Id: ghash.h,v 1.6 2004/04/04 19:42:30 mdw Exp $
  *
  * Generic hash function interface
  *
@@ -30,6 +30,21 @@
 /*----- Revision history --------------------------------------------------* 
  *
  * $Log: ghash.h,v $
+ * Revision 1.6  2004/04/04 19:42:30  mdw
+ * Make tables of standard encryption schemes etc.
+ *
+ * Revision 1.5  2000/07/15 10:00:58  mdw
+ * New generic hash operation for copying hash contexts.
+ *
+ * Revision 1.4  2000/07/03 18:08:24  mdw
+ * Include `bits.h'.
+ *
+ * Revision 1.3  2000/07/02 18:27:42  mdw
+ * (ghash->ops->done): Interface change.  Passing in a null buffer pointer
+ * uses a buffer internal to the ghash object.  The operation returns the
+ * address of the buffer it used.  Clients of generic hashes no longer need
+ * to use dynamically allocated memory for hash results.
+ *
  * Revision 1.2  2000/06/17 11:22:17  mdw
  * Minor changes in the generic hash interface.
  *
@@ -49,6 +64,8 @@
 
 #include <stddef.h>
 
+#include <mLib/bits.h>
+
 /*----- Generic hash function interface -----------------------------------*/
 
 typedef struct ghash {
@@ -58,16 +75,38 @@ typedef struct ghash {
 typedef struct ghash_ops {
   const struct gchash *c;              /* Pointer to hash class */
   void (*hash)(ghash */*h*/, const void */*p*/, size_t /*sz*/); /* Hash */
-  void (*done)(ghash */*h*/, void */*buf*/); /* Write result */
+  octet *(*done)(ghash */*h*/, void */*buf*/); /* Write result */
   void (*destroy)(ghash */*h*/);       /* Destroy hash block */
+  ghash *(*copy)(ghash */*h*/);                /* Make a copy of the hash context */
 } ghash_ops;
 
+#define GH_INIT(ch)            (ch)->init()
+#define GH_CLASS(H)            (h)->ops->c
+#define GH_HASH(h, p, sz)      (h)->ops->hash((h), (p), (sz))
+#define GH_DONE(h, buf)                (h)->ops->done((h), (buf))
+#define GH_DESTROY(h)          (h)->ops->destroy((h))
+#define GH_COPY(h)             (h)->ops->copy((h))
+
 typedef struct gchash {
   const char *name;                    /* Name of the hash function */
   size_t hashsz;                       /* Size of output hash */
   ghash *(*init)(void);                        /* Create a new hash instance */
+  size_t bufsz;                                /* Buffer size, or zero */
 } gchash;
 
+/*----- Tables ------------------------------------------------------------*/
+
+extern const gchash *const ghashtab[];
+
+/* --- @ghash_byname@ --- *
+ *
+ * Arguments:  @const char *p@ = pointer to name string
+ *
+ * Returns:    The named cipher class, or null.
+ */
+
+extern const gchash *ghash_byname(const char */*p*/);
+
 /*----- That's all, folks -------------------------------------------------*/
 
 #ifdef __cplusplus