X-Git-Url: https://git.distorted.org.uk/u/mdw/catacomb/blobdiff_plain/34e4f738bcba58e6d8c4cabbb0b3232a65b42a9d..a1e745ad3b306d1e5173588e39d71b132466365e:/mpmont.h diff --git a/mpmont.h b/mpmont.h index 913f6f5..745cf5a 100644 --- a/mpmont.h +++ b/mpmont.h @@ -1,13 +1,13 @@ /* -*-c-*- * - * $Id: mpmont.h,v 1.7 2004/04/01 12:50:09 mdw Exp $ + * $Id$ * * Montgomery reduction * * (c) 1999 Straylight/Edgeware */ -/*----- Licensing notice --------------------------------------------------* +/*----- Licensing notice --------------------------------------------------* * * This file is part of Catacomb. * @@ -15,51 +15,18 @@ * it under the terms of the GNU Library General Public License as * published by the Free Software Foundation; either version 2 of the * License, or (at your option) any later version. - * + * * Catacomb is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Library General Public License for more details. - * + * * You should have received a copy of the GNU Library General Public * License along with Catacomb; if not, write to the Free * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, * MA 02111-1307, USA. */ -/*----- Revision history --------------------------------------------------* - * - * $Log: mpmont.h,v $ - * Revision 1.7 2004/04/01 12:50:09 mdw - * Add cyclic group abstraction, with test code. Separate off exponentation - * functions for better static linking. Fix a buttload of bugs on the way. - * Generally ensure that negative exponents do inversion correctly. Add - * table of standard prime-field subgroups. (Binary field subgroups are - * currently unimplemented but easy to add if anyone ever finds a good one.) - * - * Revision 1.6 2002/01/13 13:49:25 mdw - * Make @const@-correct. - * - * Revision 1.5 2001/06/16 13:00:04 mdw - * Moved @mpmont_factor@ to . Documented interface change to - * @mpmont_expr@ and @mpmont_mexpr@ -- the arguments are now in Montgomery - * form. - * - * Revision 1.4 1999/12/11 01:51:14 mdw - * Use a Karatsuba-based reduction for large moduli. - * - * Revision 1.3 1999/12/10 23:29:48 mdw - * Change header file guard names. - * - * Revision 1.2 1999/11/19 13:17:43 mdw - * Add extra interface to exponentiation which returns a Montgomerized - * result. Add simultaneous exponentiation interface. - * - * Revision 1.1 1999/11/17 18:02:16 mdw - * New multiprecision integer arithmetic suite. - * - */ - #ifndef CATACOMB_MPMONT_H #define CATACOMB_MPMONT_H @@ -125,13 +92,13 @@ typedef struct mpmont { * Arguments: @mpmont *mm@ = pointer to Montgomery reduction context * @mp *m@ = modulus to use * - * Returns: --- + * Returns: Zero on success, nonzero on error. * * Use: Initializes a Montgomery reduction context ready for use. * The argument @m@ must be a positive odd integer. */ -extern void mpmont_create(mpmont */*mm*/, mp */*m*/); +extern int mpmont_create(mpmont */*mm*/, mp */*m*/); /* --- @mpmont_destroy@ --- * *