X-Git-Url: https://git.distorted.org.uk/u/mdw/catacomb/blobdiff_plain/8b810a45dec25017a6256e4ef134236444a00921..aa1082f28ddd05f3b946ca1a9c6bfaa17d18aca5:/dsa.h

diff --git a/dsa.h b/dsa.h
index 1958d50..97f8241 100644
--- a/dsa.h
+++ b/dsa.h
@@ -1,6 +1,6 @@
 /* -*-c-*-
  *
- * $Id: dsa.h,v 1.1 1999/11/19 19:28:00 mdw Exp $
+ * $Id: dsa.h,v 1.2 1999/11/20 22:23:48 mdw Exp $
  *
  * Digital Signature Algorithm
  *
@@ -30,6 +30,9 @@
 /*----- Revision history --------------------------------------------------* 
  *
  * $Log: dsa.h,v $
+ * Revision 1.2  1999/11/20 22:23:48  mdw
+ * Allow event handler to abort the search process.
+ *
  * Revision 1.1  1999/11/19 19:28:00  mdw
  * Implementation of the Digital Signature Algorithm.
  *
@@ -110,9 +113,8 @@ typedef struct dsa_sig {
  * Arguments:	@dsa_param *dp@ = where to store parameters
  *		@unsigned l@ = bitlength of @p@ in bits
  *		@const void *k@ = pointer to key material
+ *		@int (*proc)(int ev, mp *m, void *p)@ = event procedure
  *		@size_t sz@ = size of key material
- *		@void (*proc)(int ev, mp *m, void *p)@ = event procedure
- *		@void *p@ = argument for event procedure
  *
  * Returns:	Zero if all went well, nonzero if key material was
  *		unsuitable (one of the @DSAEV@ codes).
@@ -126,12 +128,14 @@ typedef struct dsa_sig {
  *		The event procedure is informed of various happenings during
  *		generation.  It is passed an event code describing what
  *		happened, and a multiprecision number which pertains to the
- *		event code.
+ *		event code.  It may abort the search at any time by returning
+ *		a nonzero value, which is returned as the result of the
+ *		function.
  */
 
 extern int dsa_seed(dsa_param */*dp*/, unsigned /*l*/,
 		    const void */*k*/, size_t /*sz*/,
-		    void (*proc)(int /*ev*/, mp */*m*/, void */*p*/),
+		    int (*proc)(int /*ev*/, mp */*m*/, void */*p*/),
 		    void */*p*/);
 
 /* --- @dsa_mksig@ --- *