X-Git-Url: https://git.distorted.org.uk/u/mdw/catacomb/blobdiff_plain/3d64a35c9b151e739eb6a8712915810ea574eac8..2b645fb792c62ae0d38fcde4c39e1bd0889b0e06:/gfshare.h

diff --git a/gfshare.h b/gfshare.h
index 1e1f984..fe09d8a 100644
--- a/gfshare.h
+++ b/gfshare.h
@@ -1,6 +1,6 @@
 /* -*-c-*-
  *
- * $Id: gfshare.h,v 1.4 2000/06/24 18:29:05 mdw Exp $
+ * $Id: gfshare.h,v 1.6 2000/12/06 20:30:10 mdw Exp $
  *
  * Secret sharing over %$\gf{2^8}$%
  *
@@ -30,6 +30,13 @@
 /*----- Revision history --------------------------------------------------* 
  *
  * $Log: gfshare.h,v $
+ * Revision 1.6  2000/12/06 20:30:10  mdw
+ * Change secret sharing interface: present the secret at share
+ * construction time.
+ *
+ * Revision 1.5  2000/06/24 19:11:47  mdw
+ * Fix daft error in the comment for @gfshare_get@.
+ *
  * Revision 1.4  2000/06/24 18:29:05  mdw
  * Interface change: allow shares to be extracted from a context on demand,
  * rather than building them all up-front.
@@ -85,11 +92,10 @@ typedef struct gfshare {
   unsigned t;				/* Threshold */
   unsigned i;				/* Next free slot in vector */
   size_t sz;				/* Size of the secret and shares */
-  void *s;				/* The secret */
   octet *v;				/* Vector of share information */
 } gfshare;
 
-#define GFSHARE_INIT(t, sz) { t, 0, sz, 0, 0 }
+#define GFSHARE_INIT(t, sz) { t, 0, sz, 0 }
 
 /*----- Functions provided ------------------------------------------------*/
 
@@ -123,18 +129,20 @@ extern void gfshare_destroy(gfshare */*s*/);
  *
  * Arguments:	@gfshare *s@ = pointer to share context to fill in
  *		@grand *r@ = pointer to random number source
+ *		@const void *buf@ = pointer to the secret to share
  *
  * Returns:	---
  *
  * Use:		Initializes a sharing context to be able to create shares.
  *		The context structure is expected to be mostly filled in.  In
- *		particular, @t@ and @s@ must be initialized.  If @v@ is zero,
- *		a vector of appropriate size is allocated.  You should use
- *		the macro @GFSHARE_INIT@ or @gfshare_create@ to construct
- *		sharing contexts.
+ *		particular, @t@ must be initialized.  If @v@ is zero, a
+ *		vector of appropriate size is allocated.  You should use the
+ *		macro @GFSHARE_INIT@ or @gfshare_create@ to construct sharing
+ *		contexts.
  */
 
-extern void gfshare_mkshares(gfshare */*s*/, grand */*r*/);
+extern void gfshare_mkshares(gfshare */*s*/, grand */*r*/,
+			     const void */*buf*/);
 
 /* --- @gfshare_get@ --- *
  *
@@ -142,7 +150,7 @@ extern void gfshare_mkshares(gfshare */*s*/, grand */*r*/);
  *		@unsigned x@ = share index to fetch
  *		@void *buf@ = pointer to output buffer
  *
- * Returns:	The share, as requested.
+ * Returns:	---
  *
  * Use:		Extracts a share from the system.  You may extract up to 255
  *		shares from the system.  Shares are indexed from 0.