4272N/A/*
4272N/A * Copyright (c) 2007, 2011, Oracle and/or its affiliates. All rights reserved.
4272N/A * Use is subject to license terms.
4272N/A *
4272N/A * This library is free software; you can redistribute it and/or
4272N/A * modify it under the terms of the GNU Lesser General Public
4272N/A * License as published by the Free Software Foundation; either
4272N/A * version 2.1 of the License, or (at your option) any later version.
1674N/A *
4272N/A * This library is distributed in the hope that it will be useful,
4272N/A * but WITHOUT ANY WARRANTY; without even the implied warranty of
4272N/A * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
4272N/A * Lesser General Public License for more details.
1674N/A *
4272N/A * You should have received a copy of the GNU Lesser General Public License
4272N/A * along with this library; if not, write to the Free Software Foundation,
4272N/A * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
1674N/A *
4272N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
4272N/A * or visit www.oracle.com if you need additional information or have any
4272N/A * questions.
4272N/A */
4272N/A
4272N/A/* *********************************************************************
1674N/A *
1674N/A * The Original Code is the MPI Arbitrary Precision Integer Arithmetic library.
1674N/A *
1674N/A * The Initial Developer of the Original Code is
1674N/A * Michael J. Fromberger.
1674N/A * Portions created by the Initial Developer are Copyright (C) 1998
1674N/A * the Initial Developer. All Rights Reserved.
1674N/A *
1674N/A * Contributor(s):
1674N/A * Netscape Communications Corporation
1674N/A *
1674N/A *********************************************************************** */
4272N/A
4272N/A/* Arbitrary precision integer arithmetic library */
1674N/A
1674N/A#ifndef _MPI_H
1674N/A#define _MPI_H
1674N/A
1674N/A/* $Id: mpi.h,v 1.22 2004/04/27 23:04:36 gerv%gerv.net Exp $ */
1674N/A
1674N/A#include "mpi-config.h"
1674N/A
1674N/A#ifndef _WIN32
1674N/A#include <sys/param.h>
1674N/A#endif /* _WIN32 */
1674N/A
1674N/A#ifdef _KERNEL
1674N/A#include <sys/debug.h>
1674N/A#include <sys/systm.h>
1674N/A#define assert ASSERT
1674N/A#define labs(a) (a >= 0 ? a : -a)
1674N/A#define UCHAR_MAX 255
1674N/A#define memset(s, c, n) bzero(s, n)
1674N/A#define memcpy(a,b,c) bcopy((caddr_t)b, (caddr_t)a, c)
1674N/A/*
1674N/A * Generic #define's to cover missing things in the kernel
1674N/A */
1674N/A#ifndef isdigit
1674N/A#define isdigit(x) ((x) >= '0' && (x) <= '9')
1674N/A#endif
1674N/A#ifndef isupper
1674N/A#define isupper(x) (((unsigned)(x) >= 'A') && ((unsigned)(x) <= 'Z'))
1674N/A#endif
1674N/A#ifndef islower
1674N/A#define islower(x) (((unsigned)(x) >= 'a') && ((unsigned)(x) <= 'z'))
1674N/A#endif
1674N/A#ifndef isalpha
1674N/A#define isalpha(x) (isupper(x) || islower(x))
1674N/A#endif
1674N/A#ifndef toupper
1674N/A#define toupper(x) (islower(x) ? (x) - 'a' + 'A' : (x))
1674N/A#endif
1674N/A#ifndef tolower
1674N/A#define tolower(x) (isupper(x) ? (x) + 'a' - 'A' : (x))
1674N/A#endif
1674N/A#ifndef isspace
1674N/A#define isspace(x) (((x) == ' ') || ((x) == '\r') || ((x) == '\n') || \
1674N/A ((x) == '\t') || ((x) == '\b'))
1674N/A#endif
1674N/A#endif /* _KERNEL */
1674N/A
1674N/A#if MP_DEBUG
1674N/A#undef MP_IOFUNC
1674N/A#define MP_IOFUNC 1
1674N/A#endif
1674N/A
1674N/A#if MP_IOFUNC
1674N/A#include <stdio.h>
1674N/A#include <ctype.h>
1674N/A#endif
1674N/A
1674N/A#ifndef _KERNEL
1674N/A#include <limits.h>
1674N/A#endif
1674N/A
1674N/A#if defined(BSDI)
1674N/A#undef ULLONG_MAX
1674N/A#endif
1674N/A
1674N/A#if defined( macintosh )
1674N/A#include <Types.h>
1674N/A#elif defined( _WIN32_WCE)
1674N/A/* #include <sys/types.h> What do we need here ?? */
1674N/A#else
1674N/A#include <sys/types.h>
1674N/A#endif
1674N/A
1674N/A#define MP_NEG 1
1674N/A#define MP_ZPOS 0
1674N/A
1674N/A#define MP_OKAY 0 /* no error, all is well */
1674N/A#define MP_YES 0 /* yes (boolean result) */
1674N/A#define MP_NO -1 /* no (boolean result) */
1674N/A#define MP_MEM -2 /* out of memory */
1674N/A#define MP_RANGE -3 /* argument out of range */
1674N/A#define MP_BADARG -4 /* invalid parameter */
1674N/A#define MP_UNDEF -5 /* answer is undefined */
1674N/A#define MP_LAST_CODE MP_UNDEF
1674N/A
1674N/Atypedef unsigned int mp_sign;
1674N/Atypedef unsigned int mp_size;
1674N/Atypedef int mp_err;
1674N/Atypedef int mp_flag;
1674N/A
1674N/A#define MP_32BIT_MAX 4294967295U
1674N/A
1674N/A#if !defined(ULONG_MAX)
1674N/A#error "ULONG_MAX not defined"
1674N/A#elif !defined(UINT_MAX)
1674N/A#error "UINT_MAX not defined"
1674N/A#elif !defined(USHRT_MAX)
1674N/A#error "USHRT_MAX not defined"
1674N/A#endif
1674N/A
1674N/A#if defined(ULONG_LONG_MAX) /* GCC, HPUX */
1674N/A#define MP_ULONG_LONG_MAX ULONG_LONG_MAX
1674N/A#elif defined(ULLONG_MAX) /* Solaris */
1674N/A#define MP_ULONG_LONG_MAX ULLONG_MAX
1674N/A/* MP_ULONG_LONG_MAX was defined to be ULLONG_MAX */
1674N/A#elif defined(ULONGLONG_MAX) /* IRIX, AIX */
1674N/A#define MP_ULONG_LONG_MAX ULONGLONG_MAX
1674N/A#endif
1674N/A
1674N/A/* We only use unsigned long for mp_digit iff long is more than 32 bits. */
1674N/A#if !defined(MP_USE_UINT_DIGIT) && ULONG_MAX > MP_32BIT_MAX
1674N/Atypedef unsigned long mp_digit;
1674N/A#define MP_DIGIT_MAX ULONG_MAX
1674N/A#define MP_DIGIT_FMT "%016lX" /* printf() format for 1 digit */
1674N/A#define MP_HALF_DIGIT_MAX UINT_MAX
1674N/A#undef MP_NO_MP_WORD
1674N/A#define MP_NO_MP_WORD 1
1674N/A#undef MP_USE_LONG_DIGIT
1674N/A#define MP_USE_LONG_DIGIT 1
1674N/A#undef MP_USE_LONG_LONG_DIGIT
1674N/A
1674N/A#elif !defined(MP_USE_UINT_DIGIT) && defined(MP_ULONG_LONG_MAX)
1674N/Atypedef unsigned long long mp_digit;
1674N/A#define MP_DIGIT_MAX MP_ULONG_LONG_MAX
1674N/A#define MP_DIGIT_FMT "%016llX" /* printf() format for 1 digit */
1674N/A#define MP_HALF_DIGIT_MAX UINT_MAX
1674N/A#undef MP_NO_MP_WORD
1674N/A#define MP_NO_MP_WORD 1
1674N/A#undef MP_USE_LONG_LONG_DIGIT
1674N/A#define MP_USE_LONG_LONG_DIGIT 1
1674N/A#undef MP_USE_LONG_DIGIT
1674N/A
1674N/A#else
1674N/Atypedef unsigned int mp_digit;
1674N/A#define MP_DIGIT_MAX UINT_MAX
1674N/A#define MP_DIGIT_FMT "%08X" /* printf() format for 1 digit */
1674N/A#define MP_HALF_DIGIT_MAX USHRT_MAX
1674N/A#undef MP_USE_UINT_DIGIT
1674N/A#define MP_USE_UINT_DIGIT 1
1674N/A#undef MP_USE_LONG_LONG_DIGIT
1674N/A#undef MP_USE_LONG_DIGIT
1674N/A#endif
1674N/A
1674N/A#if !defined(MP_NO_MP_WORD)
1674N/A#if defined(MP_USE_UINT_DIGIT) && \
1674N/A (defined(MP_ULONG_LONG_MAX) || (ULONG_MAX > UINT_MAX))
1674N/A
1674N/A#if (ULONG_MAX > UINT_MAX)
1674N/Atypedef unsigned long mp_word;
1674N/Atypedef long mp_sword;
1674N/A#define MP_WORD_MAX ULONG_MAX
1674N/A
1674N/A#else
1674N/Atypedef unsigned long long mp_word;
1674N/Atypedef long long mp_sword;
1674N/A#define MP_WORD_MAX MP_ULONG_LONG_MAX
1674N/A#endif
1674N/A
1674N/A#else
1674N/A#define MP_NO_MP_WORD 1
1674N/A#endif
1674N/A#endif /* !defined(MP_NO_MP_WORD) */
1674N/A
1674N/A#if !defined(MP_WORD_MAX) && defined(MP_DEFINE_SMALL_WORD)
1674N/Atypedef unsigned int mp_word;
1674N/Atypedef int mp_sword;
1674N/A#define MP_WORD_MAX UINT_MAX
1674N/A#endif
1674N/A
1674N/A#ifndef CHAR_BIT
1674N/A#define CHAR_BIT 8
1674N/A#endif
1674N/A
1674N/A#define MP_DIGIT_BIT (CHAR_BIT*sizeof(mp_digit))
1674N/A#define MP_WORD_BIT (CHAR_BIT*sizeof(mp_word))
1674N/A#define MP_RADIX (1+(mp_word)MP_DIGIT_MAX)
1674N/A
1674N/A#define MP_HALF_DIGIT_BIT (MP_DIGIT_BIT/2)
1674N/A#define MP_HALF_RADIX (1+(mp_digit)MP_HALF_DIGIT_MAX)
1674N/A/* MP_HALF_RADIX really ought to be called MP_SQRT_RADIX, but it's named
1674N/A** MP_HALF_RADIX because it's the radix for MP_HALF_DIGITs, and it's
1674N/A** consistent with the other _HALF_ names.
1674N/A*/
1674N/A
1674N/A
1674N/A/* Macros for accessing the mp_int internals */
1674N/A#define MP_FLAG(MP) ((MP)->flag)
1674N/A#define MP_SIGN(MP) ((MP)->sign)
1674N/A#define MP_USED(MP) ((MP)->used)
1674N/A#define MP_ALLOC(MP) ((MP)->alloc)
1674N/A#define MP_DIGITS(MP) ((MP)->dp)
1674N/A#define MP_DIGIT(MP,N) (MP)->dp[(N)]
1674N/A
1674N/A/* This defines the maximum I/O base (minimum is 2) */
1674N/A#define MP_MAX_RADIX 64
1674N/A
1674N/Atypedef struct {
1674N/A mp_sign flag; /* KM_SLEEP/KM_NOSLEEP */
1674N/A mp_sign sign; /* sign of this quantity */
1674N/A mp_size alloc; /* how many digits allocated */
1674N/A mp_size used; /* how many digits used */
1674N/A mp_digit *dp; /* the digits themselves */
1674N/A} mp_int;
1674N/A
1674N/A/* Default precision */
1674N/Amp_size mp_get_prec(void);
1674N/Avoid mp_set_prec(mp_size prec);
1674N/A
1674N/A/* Memory management */
1674N/Amp_err mp_init(mp_int *mp, int kmflag);
1674N/Amp_err mp_init_size(mp_int *mp, mp_size prec, int kmflag);
1674N/Amp_err mp_init_copy(mp_int *mp, const mp_int *from);
1674N/Amp_err mp_copy(const mp_int *from, mp_int *to);
1674N/Avoid mp_exch(mp_int *mp1, mp_int *mp2);
1674N/Avoid mp_clear(mp_int *mp);
1674N/Avoid mp_zero(mp_int *mp);
1674N/Avoid mp_set(mp_int *mp, mp_digit d);
1674N/Amp_err mp_set_int(mp_int *mp, long z);
1674N/A#define mp_set_long(mp,z) mp_set_int(mp,z)
1674N/Amp_err mp_set_ulong(mp_int *mp, unsigned long z);
1674N/A
1674N/A/* Single digit arithmetic */
1674N/Amp_err mp_add_d(const mp_int *a, mp_digit d, mp_int *b);
1674N/Amp_err mp_sub_d(const mp_int *a, mp_digit d, mp_int *b);
1674N/Amp_err mp_mul_d(const mp_int *a, mp_digit d, mp_int *b);
1674N/Amp_err mp_mul_2(const mp_int *a, mp_int *c);
1674N/Amp_err mp_div_d(const mp_int *a, mp_digit d, mp_int *q, mp_digit *r);
1674N/Amp_err mp_div_2(const mp_int *a, mp_int *c);
1674N/Amp_err mp_expt_d(const mp_int *a, mp_digit d, mp_int *c);
1674N/A
1674N/A/* Sign manipulations */
1674N/Amp_err mp_abs(const mp_int *a, mp_int *b);
1674N/Amp_err mp_neg(const mp_int *a, mp_int *b);
1674N/A
1674N/A/* Full arithmetic */
1674N/Amp_err mp_add(const mp_int *a, const mp_int *b, mp_int *c);
1674N/Amp_err mp_sub(const mp_int *a, const mp_int *b, mp_int *c);
1674N/Amp_err mp_mul(const mp_int *a, const mp_int *b, mp_int *c);
1674N/A#if MP_SQUARE
1674N/Amp_err mp_sqr(const mp_int *a, mp_int *b);
1674N/A#else
1674N/A#define mp_sqr(a, b) mp_mul(a, a, b)
1674N/A#endif
1674N/Amp_err mp_div(const mp_int *a, const mp_int *b, mp_int *q, mp_int *r);
1674N/Amp_err mp_div_2d(const mp_int *a, mp_digit d, mp_int *q, mp_int *r);
1674N/Amp_err mp_expt(mp_int *a, mp_int *b, mp_int *c);
1674N/Amp_err mp_2expt(mp_int *a, mp_digit k);
1674N/Amp_err mp_sqrt(const mp_int *a, mp_int *b);
1674N/A
1674N/A/* Modular arithmetic */
1674N/A#if MP_MODARITH
1674N/Amp_err mp_mod(const mp_int *a, const mp_int *m, mp_int *c);
1674N/Amp_err mp_mod_d(const mp_int *a, mp_digit d, mp_digit *c);
1674N/Amp_err mp_addmod(const mp_int *a, const mp_int *b, const mp_int *m, mp_int *c);
1674N/Amp_err mp_submod(const mp_int *a, const mp_int *b, const mp_int *m, mp_int *c);
1674N/Amp_err mp_mulmod(const mp_int *a, const mp_int *b, const mp_int *m, mp_int *c);
1674N/A#if MP_SQUARE
1674N/Amp_err mp_sqrmod(const mp_int *a, const mp_int *m, mp_int *c);
1674N/A#else
1674N/A#define mp_sqrmod(a, m, c) mp_mulmod(a, a, m, c)
1674N/A#endif
1674N/Amp_err mp_exptmod(const mp_int *a, const mp_int *b, const mp_int *m, mp_int *c);
1674N/Amp_err mp_exptmod_d(const mp_int *a, mp_digit d, const mp_int *m, mp_int *c);
1674N/A#endif /* MP_MODARITH */
1674N/A
1674N/A/* Comparisons */
1674N/Aint mp_cmp_z(const mp_int *a);
1674N/Aint mp_cmp_d(const mp_int *a, mp_digit d);
1674N/Aint mp_cmp(const mp_int *a, const mp_int *b);
1674N/Aint mp_cmp_mag(mp_int *a, mp_int *b);
1674N/Aint mp_cmp_int(const mp_int *a, long z, int kmflag);
1674N/Aint mp_isodd(const mp_int *a);
1674N/Aint mp_iseven(const mp_int *a);
1674N/A
1674N/A/* Number theoretic */
1674N/A#if MP_NUMTH
1674N/Amp_err mp_gcd(mp_int *a, mp_int *b, mp_int *c);
1674N/Amp_err mp_lcm(mp_int *a, mp_int *b, mp_int *c);
1674N/Amp_err mp_xgcd(const mp_int *a, const mp_int *b, mp_int *g, mp_int *x, mp_int *y);
1674N/Amp_err mp_invmod(const mp_int *a, const mp_int *m, mp_int *c);
1674N/Amp_err mp_invmod_xgcd(const mp_int *a, const mp_int *m, mp_int *c);
1674N/A#endif /* end MP_NUMTH */
1674N/A
1674N/A/* Input and output */
1674N/A#if MP_IOFUNC
1674N/Avoid mp_print(mp_int *mp, FILE *ofp);
1674N/A#endif /* end MP_IOFUNC */
1674N/A
1674N/A/* Base conversion */
1674N/Amp_err mp_read_raw(mp_int *mp, char *str, int len);
1674N/Aint mp_raw_size(mp_int *mp);
1674N/Amp_err mp_toraw(mp_int *mp, char *str);
1674N/Amp_err mp_read_radix(mp_int *mp, const char *str, int radix);
1674N/Amp_err mp_read_variable_radix(mp_int *a, const char * str, int default_radix);
1674N/Aint mp_radix_size(mp_int *mp, int radix);
1674N/Amp_err mp_toradix(mp_int *mp, char *str, int radix);
1674N/Aint mp_tovalue(char ch, int r);
1674N/A
1674N/A#define mp_tobinary(M, S) mp_toradix((M), (S), 2)
1674N/A#define mp_tooctal(M, S) mp_toradix((M), (S), 8)
1674N/A#define mp_todecimal(M, S) mp_toradix((M), (S), 10)
1674N/A#define mp_tohex(M, S) mp_toradix((M), (S), 16)
1674N/A
1674N/A/* Error strings */
1674N/Aconst char *mp_strerror(mp_err ec);
1674N/A
1674N/A/* Octet string conversion functions */
1674N/Amp_err mp_read_unsigned_octets(mp_int *mp, const unsigned char *str, mp_size len);
1674N/Aint mp_unsigned_octet_size(const mp_int *mp);
1674N/Amp_err mp_to_unsigned_octets(const mp_int *mp, unsigned char *str, mp_size maxlen);
1674N/Amp_err mp_to_signed_octets(const mp_int *mp, unsigned char *str, mp_size maxlen);
1674N/Amp_err mp_to_fixlen_octets(const mp_int *mp, unsigned char *str, mp_size len);
1674N/A
1674N/A/* Miscellaneous */
1674N/Amp_size mp_trailing_zeros(const mp_int *mp);
1674N/A
1674N/A#define MP_CHECKOK(x) if (MP_OKAY > (res = (x))) goto CLEANUP
1674N/A#define MP_CHECKERR(x) if (MP_OKAY > (res = (x))) goto CLEANUP
1674N/A
1674N/A#if defined(MP_API_COMPATIBLE)
1674N/A#define NEG MP_NEG
1674N/A#define ZPOS MP_ZPOS
1674N/A#define DIGIT_MAX MP_DIGIT_MAX
1674N/A#define DIGIT_BIT MP_DIGIT_BIT
1674N/A#define DIGIT_FMT MP_DIGIT_FMT
1674N/A#define RADIX MP_RADIX
1674N/A#define MAX_RADIX MP_MAX_RADIX
1674N/A#define FLAG(MP) MP_FLAG(MP)
1674N/A#define SIGN(MP) MP_SIGN(MP)
1674N/A#define USED(MP) MP_USED(MP)
1674N/A#define ALLOC(MP) MP_ALLOC(MP)
1674N/A#define DIGITS(MP) MP_DIGITS(MP)
1674N/A#define DIGIT(MP,N) MP_DIGIT(MP,N)
1674N/A
1674N/A#if MP_ARGCHK == 1
1674N/A#define ARGCHK(X,Y) {if(!(X)){return (Y);}}
1674N/A#elif MP_ARGCHK == 2
1674N/A#ifdef _KERNEL
1674N/A#define ARGCHK(X,Y) ASSERT(X)
1674N/A#else
1674N/A#include <assert.h>
1674N/A#define ARGCHK(X,Y) assert(X)
1674N/A#endif
1674N/A#else
1674N/A#define ARGCHK(X,Y) /* */
1674N/A#endif
1674N/A#endif /* defined MP_API_COMPATIBLE */
1674N/A
1674N/A#endif /* _MPI_H */