5 * Efficient reduction modulo nice primes
7 * (c) 2004 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of Catacomb.
14 * Catacomb is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
19 * Catacomb is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
24 * You should have received a copy of the GNU Library General Public
25 * License along with Catacomb; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
30 /*----- Header files ------------------------------------------------------*/
32 #include <mLib/darray.h>
33 #include <mLib/macros.h>
37 #include "mpreduce-exp.h"
39 /*----- Data structures ---------------------------------------------------*/
41 DA_DECL(instr_v
, mpreduce_instr
);
43 /*----- Main code ---------------------------------------------------------*/
45 /* --- @mpreduce_create@ --- *
47 * Arguments: @gfreduce *r@ = structure to fill in
48 * @mp *x@ = an integer
50 * Returns: Zero if successful; nonzero on failure.
52 * Use: Initializes a context structure for reduction.
55 int mpreduce_create(mpreduce
*r
, mp
*p
)
58 enum { Z
= 0, Z1
= 2, X
= 4, X0
= 6 };
65 /* --- Fill in the easy stuff --- */
76 /* --- Stash a new instruction --- */
78 #define INSTR(op_, argx_, argy_) do { \
80 DA(&iv)[DA_LEN(&iv)].op = (op_); \
81 DA(&iv)[DA_LEN(&iv)].argx = (argx_); \
82 DA(&iv)[DA_LEN(&iv)].argy = (argy_); \
86 /* --- Main loop --- *
88 * A simple state machine decomposes @p@ conveniently into positive and
89 * negative powers of 2. The pure form of the state machine is left below
90 * for reference (and in case I need inspiration for a NAF exponentiator).
94 for (i
= 0, mp_scan(&sc
, p
); mp_step(&sc
); i
++) {
95 switch (st
| mp_bit(&sc
)) {
96 case Z
| 1: st
= Z1
; break;
97 case Z1
| 0: st
= Z
; printf("+ %lu\n", i
- 1); break;
98 case Z1
| 1: st
= X
; printf("- %lu\n", i
- 1); break;
99 case X
| 0: st
= X0
; break;
100 case X0
| 1: st
= X
; printf("- %lu\n", i
- 1); break;
101 case X0
| 0: st
= Z
; printf("+ %lu\n", i
- 1); break;
104 if (st
>= X
) printf("+ %lu\n", i
- 1);
108 bb
= MPW_BITS
- (d
+ 1)%MPW_BITS
;
109 for (i
= 0, mp_scan(&sc
, p
); i
< d
&& mp_step(&sc
); i
++) {
110 switch (st
| mp_bit(&sc
)) {
111 case Z
| 1: st
= Z1
; break;
112 case Z1
| 0: st
= Z
; op
= MPRI_SUB
; goto instr
;
113 case Z1
| 1: st
= X
; op
= MPRI_ADD
; goto instr
;
114 case X
| 0: st
= X0
; break;
115 case X0
| 1: st
= X
; op
= MPRI_ADD
; goto instr
;
116 case X0
| 0: st
= Z
; op
= MPRI_SUB
; goto instr
;
118 w
= (d
- i
)/MPW_BITS
+ 1;
119 b
= (bb
+ i
)%MPW_BITS
;
120 INSTR(op
| !!b
, w
, b
);
123 if (DA_LEN(&iv
) && (DA(&iv
)[DA_LEN(&iv
) - 1].op
& ~1u) == MPRI_SUB
) {
131 /* --- Wrap up --- */
137 r
->iv
= xmalloc(r
->in
* sizeof(mpreduce_instr
));
138 memcpy(r
->iv
, DA(&iv
), r
->in
* sizeof(mpreduce_instr
));
140 r
->iv
= xmalloc(r
->in
* 2 * sizeof(mpreduce_instr
));
141 for (i
= 0; i
< r
->in
; i
++) {
142 r
->iv
[i
] = DA(&iv
)[i
];
143 op
= r
->iv
[i
].op
& ~1u;
152 r
->iv
[i
+ r
->in
].op
= op
;
153 r
->iv
[i
+ r
->in
].argx
= w
;
154 r
->iv
[i
+ r
->in
].argy
= b
;
160 mpreduce_dump(r
, stdout
);
165 /* --- @mpreduce_destroy@ --- *
167 * Arguments: @mpreduce *r@ = structure to free
171 * Use: Reclaims the resources from a reduction context.
174 void mpreduce_destroy(mpreduce
*r
)
177 if (r
->iv
) xfree(r
->iv
);
180 /* --- @mpreduce_dump@ --- *
182 * Arguments: @mpreduce *r@ = structure to dump
183 * @FILE *fp@ = file to dump on
187 * Use: Dumps a reduction context.
190 void mpreduce_dump(mpreduce
*r
, FILE *fp
)
193 static const char *opname
[] = { "add", "addshift", "sub", "subshift" };
195 fprintf(fp
, "mod = "); mp_writefile(r
->p
, fp
, 16);
196 fprintf(fp
, "\n lim = %lu; s = %d\n", (unsigned long)r
->lim
, r
->s
);
197 for (i
= 0; i
< r
->in
; i
++) {
198 assert(r
->iv
[i
].op
< N(opname
));
199 fprintf(fp
, " %s %lu %lu\n",
201 (unsigned long)r
->iv
[i
].argx
,
202 (unsigned long)r
->iv
[i
].argy
);
205 fprintf(fp
, "tail end charlie\n");
206 for (i
= r
->in
; i
< 2 * r
->in
; i
++) {
207 assert(r
->iv
[i
].op
< N(opname
));
208 fprintf(fp
, " %s %lu %lu\n",
210 (unsigned long)r
->iv
[i
].argx
,
211 (unsigned long)r
->iv
[i
].argy
);
216 /* --- @mpreduce_do@ --- *
218 * Arguments: @mpreduce *r@ = reduction context
219 * @mp *d@ = destination
222 * Returns: Destination, @x@ reduced modulo the reduction poly.
225 static void run(const mpreduce_instr
*i
, const mpreduce_instr
*il
,
228 for (; i
< il
; i
++) {
231 mp_build(&vv
, v
- i
->argx
, v
+ 1);
232 printf(" 0x"); mp_writefile(&vv
, stdout
, 16);
233 printf(" %c (0x%lx << %u) == 0x",
234 (i
->op
& ~1u) == MPRI_ADD ?
'+' : '-',
239 case MPRI_ADD
: MPX_UADDN(v
- i
->argx
, v
+ 1, z
); break;
240 case MPRI_ADDLSL
: mpx_uaddnlsl(v
- i
->argx
, v
+ 1, z
, i
->argy
); break;
241 case MPRI_SUB
: MPX_USUBN(v
- i
->argx
, v
+ 1, z
); break;
242 case MPRI_SUBLSL
: mpx_usubnlsl(v
- i
->argx
, v
+ 1, z
, i
->argy
); break;
247 mp_build(&vv
, v
- i
->argx
, v
+ 1);
248 mp_writefile(&vv
, stdout
, 16);
254 mp
*mpreduce_do(mpreduce
*r
, mp
*d
, mp
*x
)
257 const mpreduce_instr
*il
;
261 mp
*_r
= 0, *_rr
= 0;
264 /* --- If source is negative, divide --- */
267 mp_div(0, &d
, x
, r
->p
);
271 /* --- Try to reuse the source's space --- */
275 MP_DEST(x
, MP_LEN(x
), x
->f
);
277 /* --- Do the reduction --- */
281 mp_div(0, &_r
, x
, r
->p
);
287 if (MP_LEN(x
) >= r
->lim
) {
294 run(r
->iv
, il
, vl
, z
);
297 mp_div(0, &_rr
, x
, r
->p
);
298 assert(MP_EQ(_r
, _rr
));
303 while (*vl
>> r
->s
) {
305 *vl
&= ((1 << r
->s
) - 1);
306 run(r
->iv
+ r
->in
, il
+ r
->in
, vl
, z
);
309 mp_div(0, &_rr
, x
, r
->p
);
310 assert(MP_EQ(_r
, _rr
));
316 /* --- Finishing touches --- */
319 if (MP_CMP(x
, >=, r
->p
))
320 x
= mp_sub(x
, x
, r
->p
);
325 assert(MP_EQ(_r
, x
));
332 /* --- @mpreduce_exp@ --- *
334 * Arguments: @mpreduce *mr@ = pointer to reduction context
335 * @mp *d@ = fake destination
339 * Returns: Result, %$a^e \bmod m$%.
342 mp
*mpreduce_exp(mpreduce
*mr
, mp
*d
, mp
*a
, mp
*e
)
345 mp
*spare
= (e
->f
& MP_BURN
) ? MP_NEWSEC
: MP_NEW
;
353 a
= mp_modinv(a
, a
, mr
->p
);
354 if (MP_LEN(e
) < EXP_THRESH
)
365 /*----- Test rig ----------------------------------------------------------*/
370 #define MP(x) mp_readstring(MP_NEW, #x, 0, 0)
372 static int vreduce(dstr
*v
)
374 mp
*d
= *(mp
**)v
[0].buf
;
375 mp
*n
= *(mp
**)v
[1].buf
;
376 mp
*r
= *(mp
**)v
[2].buf
;
381 mpreduce_create(&rr
, d
);
382 c
= mpreduce_do(&rr
, MP_NEW
, n
);
384 fprintf(stderr
, "\n*** reduction failed\n*** ");
385 mpreduce_dump(&rr
, stderr
);
386 fprintf(stderr
, "\n*** n = "); mp_writefile(n
, stderr
, 10);
387 fprintf(stderr
, "\n*** r = "); mp_writefile(r
, stderr
, 10);
388 fprintf(stderr
, "\n*** c = "); mp_writefile(c
, stderr
, 10);
389 fprintf(stderr
, "\n");
392 mpreduce_destroy(&rr
);
393 mp_drop(n
); mp_drop(d
); mp_drop(r
); mp_drop(c
);
394 assert(mparena_count(MPARENA_GLOBAL
) == 0);
398 static int vmodexp(dstr
*v
)
400 mp
*p
= *(mp
**)v
[0].buf
;
401 mp
*g
= *(mp
**)v
[1].buf
;
402 mp
*x
= *(mp
**)v
[2].buf
;
403 mp
*r
= *(mp
**)v
[3].buf
;
408 mpreduce_create(&rr
, p
);
409 c
= mpreduce_exp(&rr
, MP_NEW
, g
, x
);
411 fprintf(stderr
, "\n*** modexp failed\n*** ");
412 fprintf(stderr
, "\n*** p = "); mp_writefile(p
, stderr
, 10);
413 fprintf(stderr
, "\n*** g = "); mp_writefile(g
, stderr
, 10);
414 fprintf(stderr
, "\n*** x = "); mp_writefile(x
, stderr
, 10);
415 fprintf(stderr
, "\n*** c = "); mp_writefile(c
, stderr
, 10);
416 fprintf(stderr
, "\n*** r = "); mp_writefile(r
, stderr
, 10);
417 fprintf(stderr
, "\n");
420 mpreduce_destroy(&rr
);
421 mp_drop(p
); mp_drop(g
); mp_drop(r
); mp_drop(x
); mp_drop(c
);
422 assert(mparena_count(MPARENA_GLOBAL
) == 0);
426 static test_chunk defs
[] = {
427 { "reduce", vreduce
, { &type_mp
, &type_mp
, &type_mp
, 0 } },
428 { "modexp", vmodexp
, { &type_mp
, &type_mp
, &type_mp
, &type_mp
, 0 } },
432 int main(int argc
, char *argv
[])
434 test_run(argc
, argv
, defs
, SRCDIR
"/tests/mpreduce");
440 /*----- That's all, folks -------------------------------------------------*/