| |
1 /* |
| |
2 mpi.h |
| |
3 |
| |
4 by Michael J. Fromberger <http://www.dartmouth.edu/~sting/> |
| |
5 Copyright (C) 1998 Michael J. Fromberger, All Rights Reserved |
| |
6 |
| |
7 Arbitrary precision integer arithmetic library |
| |
8 |
| |
9 $Id: mpi.h 14563 2005-11-29 23:31:40Z taliesein $ |
| |
10 */ |
| |
11 |
| |
12 #ifndef _H_MPI_ |
| |
13 #define _H_MPI_ |
| |
14 |
| |
15 #include "mpi-config.h" |
| |
16 |
| |
17 #if MP_DEBUG |
| |
18 #undef MP_IOFUNC |
| |
19 #define MP_IOFUNC 1 |
| |
20 #endif |
| |
21 |
| |
22 #if MP_IOFUNC |
| |
23 #include <stdio.h> |
| |
24 #include <ctype.h> |
| |
25 #endif |
| |
26 |
| |
27 #include <limits.h> |
| |
28 |
| |
29 #define MP_NEG 1 |
| |
30 #define MP_ZPOS 0 |
| |
31 |
| |
32 /* Included for compatibility... */ |
| |
33 #define NEG MP_NEG |
| |
34 #define ZPOS MP_ZPOS |
| |
35 |
| |
36 #define MP_OKAY 0 /* no error, all is well */ |
| |
37 #define MP_YES 0 /* yes (boolean result) */ |
| |
38 #define MP_NO -1 /* no (boolean result) */ |
| |
39 #define MP_MEM -2 /* out of memory */ |
| |
40 #define MP_RANGE -3 /* argument out of range */ |
| |
41 #define MP_BADARG -4 /* invalid parameter */ |
| |
42 #define MP_UNDEF -5 /* answer is undefined */ |
| |
43 #define MP_LAST_CODE MP_UNDEF |
| |
44 |
| |
45 #include "mpi-types.h" |
| |
46 |
| |
47 /* Included for compatibility... */ |
| |
48 #define DIGIT_BIT MP_DIGIT_BIT |
| |
49 #define DIGIT_MAX MP_DIGIT_MAX |
| |
50 |
| |
51 /* Macros for accessing the mp_int internals */ |
| |
52 #define SIGN(MP) ((MP)->sign) |
| |
53 #define USED(MP) ((MP)->used) |
| |
54 #define ALLOC(MP) ((MP)->alloc) |
| |
55 #define DIGITS(MP) ((MP)->dp) |
| |
56 #define DIGIT(MP,N) (MP)->dp[(N)] |
| |
57 |
| |
58 #if MP_ARGCHK == 1 |
| |
59 #define ARGCHK(X,Y) {if(!(X)){return (Y);}} |
| |
60 #elif MP_ARGCHK == 2 |
| |
61 #include <assert.h> |
| |
62 #define ARGCHK(X,Y) assert(X) |
| |
63 #else |
| |
64 #define ARGCHK(X,Y) /* */ |
| |
65 #endif |
| |
66 |
| |
67 /* This defines the maximum I/O base (minimum is 2) */ |
| |
68 #define MAX_RADIX 64 |
| |
69 |
| |
70 typedef struct { |
| |
71 mp_sign sign; /* sign of this quantity */ |
| |
72 mp_size alloc; /* how many digits allocated */ |
| |
73 mp_size used; /* how many digits used */ |
| |
74 mp_digit *dp; /* the digits themselves */ |
| |
75 } mp_int; |
| |
76 |
| |
77 /*------------------------------------------------------------------------*/ |
| |
78 /* Default precision */ |
| |
79 |
| |
80 unsigned int mp_get_prec(void); |
| |
81 void mp_set_prec(unsigned int prec); |
| |
82 |
| |
83 /*------------------------------------------------------------------------*/ |
| |
84 /* Memory management */ |
| |
85 |
| |
86 mp_err mp_init(mp_int *mp); |
| |
87 mp_err mp_init_array(mp_int mp[], int count); |
| |
88 mp_err mp_init_size(mp_int *mp, mp_size prec); |
| |
89 mp_err mp_init_copy(mp_int *mp, mp_int *from); |
| |
90 mp_err mp_copy(mp_int *from, mp_int *to); |
| |
91 void mp_exch(mp_int *mp1, mp_int *mp2); |
| |
92 void mp_clear(mp_int *mp); |
| |
93 void mp_clear_array(mp_int mp[], int count); |
| |
94 void mp_zero(mp_int *mp); |
| |
95 void mp_set(mp_int *mp, mp_digit d); |
| |
96 mp_err mp_set_int(mp_int *mp, long z); |
| |
97 |
| |
98 /*------------------------------------------------------------------------*/ |
| |
99 /* Single digit arithmetic */ |
| |
100 |
| |
101 mp_err mp_add_d(mp_int *a, mp_digit d, mp_int *b); |
| |
102 mp_err mp_sub_d(mp_int *a, mp_digit d, mp_int *b); |
| |
103 mp_err mp_mul_d(mp_int *a, mp_digit d, mp_int *b); |
| |
104 mp_err mp_mul_2(mp_int *a, mp_int *c); |
| |
105 mp_err mp_div_d(mp_int *a, mp_digit d, mp_int *q, mp_digit *r); |
| |
106 mp_err mp_div_2(mp_int *a, mp_int *c); |
| |
107 mp_err mp_expt_d(mp_int *a, mp_digit d, mp_int *c); |
| |
108 |
| |
109 /*------------------------------------------------------------------------*/ |
| |
110 /* Sign manipulations */ |
| |
111 |
| |
112 mp_err mp_abs(mp_int *a, mp_int *b); |
| |
113 mp_err mp_neg(mp_int *a, mp_int *b); |
| |
114 |
| |
115 /*------------------------------------------------------------------------*/ |
| |
116 /* Full arithmetic */ |
| |
117 |
| |
118 mp_err mp_add(mp_int *a, mp_int *b, mp_int *c); |
| |
119 mp_err mp_sub(mp_int *a, mp_int *b, mp_int *c); |
| |
120 mp_err mp_mul(mp_int *a, mp_int *b, mp_int *c); |
| |
121 mp_err mp_mul_2d(mp_int *a, mp_digit d, mp_int *c); |
| |
122 #if MP_SQUARE |
| |
123 mp_err mp_sqr(mp_int *a, mp_int *b); |
| |
124 #else |
| |
125 #define mp_sqr(a, b) mp_mul(a, a, b) |
| |
126 #endif |
| |
127 mp_err mp_div(mp_int *a, mp_int *b, mp_int *q, mp_int *r); |
| |
128 mp_err mp_div_2d(mp_int *a, mp_digit d, mp_int *q, mp_int *r); |
| |
129 mp_err mp_expt(mp_int *a, mp_int *b, mp_int *c); |
| |
130 mp_err mp_2expt(mp_int *a, mp_digit k); |
| |
131 mp_err mp_sqrt(mp_int *a, mp_int *b); |
| |
132 |
| |
133 /*------------------------------------------------------------------------*/ |
| |
134 /* Modular arithmetic */ |
| |
135 |
| |
136 #if MP_MODARITH |
| |
137 mp_err mp_mod(mp_int *a, mp_int *m, mp_int *c); |
| |
138 mp_err mp_mod_d(mp_int *a, mp_digit d, mp_digit *c); |
| |
139 mp_err mp_addmod(mp_int *a, mp_int *b, mp_int *m, mp_int *c); |
| |
140 mp_err mp_submod(mp_int *a, mp_int *b, mp_int *m, mp_int *c); |
| |
141 mp_err mp_mulmod(mp_int *a, mp_int *b, mp_int *m, mp_int *c); |
| |
142 #if MP_SQUARE |
| |
143 mp_err mp_sqrmod(mp_int *a, mp_int *m, mp_int *c); |
| |
144 #else |
| |
145 #define mp_sqrmod(a, m, c) mp_mulmod(a, a, m, c) |
| |
146 #endif |
| |
147 mp_err mp_exptmod(mp_int *a, mp_int *b, mp_int *m, mp_int *c); |
| |
148 mp_err mp_exptmod_d(mp_int *a, mp_digit d, mp_int *m, mp_int *c); |
| |
149 #endif /* MP_MODARITH */ |
| |
150 |
| |
151 /*------------------------------------------------------------------------*/ |
| |
152 /* Comparisons */ |
| |
153 |
| |
154 int mp_cmp_z(mp_int *a); |
| |
155 int mp_cmp_d(mp_int *a, mp_digit d); |
| |
156 int mp_cmp(mp_int *a, mp_int *b); |
| |
157 int mp_cmp_mag(mp_int *a, mp_int *b); |
| |
158 int mp_cmp_int(mp_int *a, long z); |
| |
159 int mp_isodd(mp_int *a); |
| |
160 int mp_iseven(mp_int *a); |
| |
161 |
| |
162 /*------------------------------------------------------------------------*/ |
| |
163 /* Number theoretic */ |
| |
164 |
| |
165 #if MP_NUMTH |
| |
166 mp_err mp_gcd(mp_int *a, mp_int *b, mp_int *c); |
| |
167 mp_err mp_lcm(mp_int *a, mp_int *b, mp_int *c); |
| |
168 mp_err mp_xgcd(mp_int *a, mp_int *b, mp_int *g, mp_int *x, mp_int *y); |
| |
169 mp_err mp_invmod(mp_int *a, mp_int *m, mp_int *c); |
| |
170 #endif /* end MP_NUMTH */ |
| |
171 |
| |
172 /*------------------------------------------------------------------------*/ |
| |
173 /* Input and output */ |
| |
174 |
| |
175 #if MP_IOFUNC |
| |
176 void mp_print(mp_int *mp, FILE *ofp); |
| |
177 #endif /* end MP_IOFUNC */ |
| |
178 |
| |
179 /*------------------------------------------------------------------------*/ |
| |
180 /* Base conversion */ |
| |
181 |
| |
182 #define BITS 1 |
| |
183 #define BYTES CHAR_BIT |
| |
184 |
| |
185 mp_err mp_read_signed_bin(mp_int *mp, unsigned char *str, int len); |
| |
186 int mp_signed_bin_size(mp_int *mp); |
| |
187 mp_err mp_to_signed_bin(mp_int *mp, unsigned char *str); |
| |
188 |
| |
189 mp_err mp_read_unsigned_bin(mp_int *mp, unsigned char *str, int len); |
| |
190 int mp_unsigned_bin_size(mp_int *mp); |
| |
191 mp_err mp_to_unsigned_bin(mp_int *mp, unsigned char *str); |
| |
192 |
| |
193 int mp_count_bits(mp_int *mp); |
| |
194 |
| |
195 #if MP_COMPAT_MACROS |
| |
196 #define mp_read_raw(mp, str, len) mp_read_signed_bin((mp), (str), (len)) |
| |
197 #define mp_raw_size(mp) mp_signed_bin_size(mp) |
| |
198 #define mp_toraw(mp, str) mp_to_signed_bin((mp), (str)) |
| |
199 #define mp_read_mag(mp, str, len) mp_read_unsigned_bin((mp), (str), (len)) |
| |
200 #define mp_mag_size(mp) mp_unsigned_bin_size(mp) |
| |
201 #define mp_tomag(mp, str) mp_to_unsigned_bin((mp), (str)) |
| |
202 #endif |
| |
203 |
| |
204 mp_err mp_read_radix(mp_int *mp, unsigned char *str, int radix); |
| |
205 int mp_radix_size(mp_int *mp, int radix); |
| |
206 int mp_value_radix_size(int num, int qty, int radix); |
| |
207 mp_err mp_toradix(mp_int *mp, unsigned char *str, int radix); |
| |
208 |
| |
209 int mp_char2value(char ch, int r); |
| |
210 |
| |
211 #define mp_tobinary(M, S) mp_toradix((M), (S), 2) |
| |
212 #define mp_tooctal(M, S) mp_toradix((M), (S), 8) |
| |
213 #define mp_todecimal(M, S) mp_toradix((M), (S), 10) |
| |
214 #define mp_tohex(M, S) mp_toradix((M), (S), 16) |
| |
215 |
| |
216 /*------------------------------------------------------------------------*/ |
| |
217 /* Error strings */ |
| |
218 |
| |
219 const char *mp_strerror(mp_err ec); |
| |
220 |
| |
221 #endif /* end _H_MPI_ */ |