/* -*-c-*-
*
- * $Id: mpmont.h,v 1.6 2002/01/13 13:49:25 mdw Exp $
+ * $Id$
*
* Montgomery reduction
*
* MA 02111-1307, USA.
*/
-/*----- Revision history --------------------------------------------------*
- *
- * $Log: mpmont.h,v $
- * 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 <mp.h>. 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
* 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@ --- *
*
*
* Arguments: @mpmont *mm@ = pointer to Montgomery reduction context
* @mp *d@ = fake destination
- * @mp_expfactor *f@ = pointer to array of factors
+ * @const mp_expfactor *f@ = pointer to array of factors
* @size_t n@ = number of factors supplied
*
* Returns: If the bases are %$g_0, g_1, \ldots, g_{n-1}$% and the
*/
extern mp *mpmont_mexpr(mpmont */*mm*/, mp */*d*/,
- mp_expfactor */*f*/, size_t /*n*/);
+ const mp_expfactor */*f*/, size_t /*n*/);
/* --- @mpmont_mexp@ --- *
*