Add framework for bn_mul_mont [from 098-fips].
[oweals/openssl.git] / crypto / bn / bn_mont.c
1 /* crypto/bn/bn_mont.c */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  * 
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  * 
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  * 
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *    notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *    notice, this list of conditions and the following disclaimer in the
30  *    documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *    must display the following acknowledgement:
33  *    "This product includes cryptographic software written by
34  *     Eric Young (eay@cryptsoft.com)"
35  *    The word 'cryptographic' can be left out if the rouines from the library
36  *    being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from 
38  *    the apps directory (application code) you must include an acknowledgement:
39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  * 
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  * 
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58 /* ====================================================================
59  * Copyright (c) 1998-2006 The OpenSSL Project.  All rights reserved.
60  *
61  * Redistribution and use in source and binary forms, with or without
62  * modification, are permitted provided that the following conditions
63  * are met:
64  *
65  * 1. Redistributions of source code must retain the above copyright
66  *    notice, this list of conditions and the following disclaimer. 
67  *
68  * 2. Redistributions in binary form must reproduce the above copyright
69  *    notice, this list of conditions and the following disclaimer in
70  *    the documentation and/or other materials provided with the
71  *    distribution.
72  *
73  * 3. All advertising materials mentioning features or use of this
74  *    software must display the following acknowledgment:
75  *    "This product includes software developed by the OpenSSL Project
76  *    for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
77  *
78  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
79  *    endorse or promote products derived from this software without
80  *    prior written permission. For written permission, please contact
81  *    openssl-core@openssl.org.
82  *
83  * 5. Products derived from this software may not be called "OpenSSL"
84  *    nor may "OpenSSL" appear in their names without prior written
85  *    permission of the OpenSSL Project.
86  *
87  * 6. Redistributions of any form whatsoever must retain the following
88  *    acknowledgment:
89  *    "This product includes software developed by the OpenSSL Project
90  *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
91  *
92  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
93  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
94  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
95  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
96  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
97  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
98  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
99  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
100  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
101  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
102  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
103  * OF THE POSSIBILITY OF SUCH DAMAGE.
104  * ====================================================================
105  *
106  * This product includes cryptographic software written by Eric Young
107  * (eay@cryptsoft.com).  This product includes software written by Tim
108  * Hudson (tjh@cryptsoft.com).
109  *
110  */
111
112 /*
113  * Details about Montgomery multiplication algorithms can be found at
114  * http://security.ece.orst.edu/publications.html, e.g.
115  * http://security.ece.orst.edu/koc/papers/j37acmon.pdf and
116  * sections 3.8 and 4.2 in http://security.ece.orst.edu/koc/papers/r01rsasw.pdf
117  */
118
119 #include <stdio.h>
120 #include "cryptlib.h"
121 #include "bn_lcl.h"
122
123 #define MONT_WORD /* use the faster word-based algorithm */
124
125 int BN_mod_mul_montgomery(BIGNUM *r, const BIGNUM *a, const BIGNUM *b,
126                           BN_MONT_CTX *mont, BN_CTX *ctx)
127         {
128         BIGNUM *tmp;
129         int ret=0;
130 #if defined(OPENSSL_BN_ASM_MONT) && defined(MONT_WORD)
131         int num = mont->N.top;
132
133         if (num>1 && a->top==num && b->top==num)
134                 {
135                 if (bn_wexpand(r,num) == NULL) return(0);
136                 if (bn_mul_mont(r->d,a->d,b->d,mont->N.d,&mont->n0,num))
137                         {
138                         r->neg = a->neg^b->neg;
139                         r->top = num;
140                         bn_correct_top(r);
141                         return(1);
142                         }
143                 }
144 #endif
145
146         BN_CTX_start(ctx);
147         tmp = BN_CTX_get(ctx);
148         if (tmp == NULL) goto err;
149
150         bn_check_top(tmp);
151         if (a == b)
152                 {
153                 if (!BN_sqr(tmp,a,ctx)) goto err;
154                 }
155         else
156                 {
157                 if (!BN_mul(tmp,a,b,ctx)) goto err;
158                 }
159         /* reduce from aRR to aR */
160         if (!BN_from_montgomery(r,tmp,mont,ctx)) goto err;
161         bn_check_top(r);
162         ret=1;
163 err:
164         BN_CTX_end(ctx);
165         return(ret);
166         }
167
168 int BN_from_montgomery(BIGNUM *ret, const BIGNUM *a, BN_MONT_CTX *mont,
169              BN_CTX *ctx)
170         {
171         int retn=0;
172
173 #ifdef MONT_WORD
174         BIGNUM *n,*r;
175         BN_ULONG *ap,*np,*rp,n0,v,*nrp;
176         int al,nl,max,i,x,ri;
177
178         BN_CTX_start(ctx);
179         if ((r = BN_CTX_get(ctx)) == NULL) goto err;
180
181         if (!BN_copy(r,a)) goto err;
182         n= &(mont->N);
183
184         ap=a->d;
185         /* mont->ri is the size of mont->N in bits (rounded up
186            to the word size) */
187         al=ri=mont->ri/BN_BITS2;
188         
189         nl=n->top;
190         if ((al == 0) || (nl == 0)) { r->top=0; return(1); }
191
192         max=(nl+al+1); /* allow for overflow (no?) XXX */
193         if (bn_wexpand(r,max) == NULL) goto err;
194
195         r->neg=a->neg^n->neg;
196         np=n->d;
197         rp=r->d;
198         nrp= &(r->d[nl]);
199
200         /* clear the top words of T */
201 #if 1
202         for (i=r->top; i<max; i++) /* memset? XXX */
203                 r->d[i]=0;
204 #else
205         memset(&(r->d[r->top]),0,(max-r->top)*sizeof(BN_ULONG)); 
206 #endif
207
208         r->top=max;
209         n0=mont->n0;
210
211 #ifdef BN_COUNT
212         fprintf(stderr,"word BN_from_montgomery %d * %d\n",nl,nl);
213 #endif
214         for (i=0; i<nl; i++)
215                 {
216 #ifdef __TANDEM
217                 {
218                    long long t1;
219                    long long t2;
220                    long long t3;
221                    t1 = rp[0] * (n0 & 0177777);
222                    t2 = 037777600000l;
223                    t2 = n0 & t2;
224                    t3 = rp[0] & 0177777;
225                    t2 = (t3 * t2) & BN_MASK2;
226                    t1 = t1 + t2;
227                    v=bn_mul_add_words(rp,np,nl,(BN_ULONG) t1);
228                 }
229 #else
230                 v=bn_mul_add_words(rp,np,nl,(rp[0]*n0)&BN_MASK2);
231 #endif
232                 nrp++;
233                 rp++;
234                 if (((nrp[-1]+=v)&BN_MASK2) >= v)
235                         continue;
236                 else
237                         {
238                         if (((++nrp[0])&BN_MASK2) != 0) continue;
239                         if (((++nrp[1])&BN_MASK2) != 0) continue;
240                         for (x=2; (((++nrp[x])&BN_MASK2) == 0); x++) ;
241                         }
242                 }
243         bn_correct_top(r);
244         
245         /* mont->ri will be a multiple of the word size and below code
246          * is kind of BN_rshift(ret,r,mont->ri) equivalent */
247         if (r->top <= ri)
248                 {
249                 ret->top=0;
250                 retn=1;
251                 goto err;
252                 }
253         al=r->top-ri;
254
255 # define BRANCH_FREE 1
256 # if BRANCH_FREE
257         if (bn_wexpand(ret,ri) == NULL) goto err;
258         x=0-(((al-ri)>>(sizeof(al)*8-1))&1);
259         ret->top=x=(ri&~x)|(al&x);      /* min(ri,al) */
260         ret->neg=r->neg;
261
262         rp=ret->d;
263         ap=&(r->d[ri]);
264
265         {
266         size_t m1,m2;
267
268         v=bn_sub_words(rp,ap,np,ri);
269         /* this ----------------^^ works even in al<ri case
270          * thanks to zealous zeroing of top of the vector in the
271          * beginning. */
272
273         /* if (al==ri && !v) || al>ri) nrp=rp; else nrp=ap; */
274         /* in other words if subtraction result is real, then
275          * trick unconditional memcpy below to perform in-place
276          * "refresh" instead of actual copy. */
277         m1=0-(size_t)(((al-ri)>>(sizeof(al)*8-1))&1);   /* al<ri */
278         m2=0-(size_t)(((ri-al)>>(sizeof(al)*8-1))&1);   /* al>ri */
279         m1|=m2;                 /* (al!=ri) */
280         m1|=(0-(size_t)v);      /* (al!=ri || v) */
281         m1&=~m2;                /* (al!=ri || v) && !al>ri */
282         nrp=(BN_ULONG *)(((size_t)rp&~m1)|((size_t)ap&m1));
283         }
284
285         /* 'i<ri' is chosen to eliminate dependency on input data, even
286          * though it results in redundant copy in al<ri case. */
287         for (i=0,ri-=4; i<ri; i+=4)
288                 {
289                 BN_ULONG t1,t2,t3,t4;
290                 
291                 t1=nrp[i+0];
292                 t2=nrp[i+1];
293                 t3=nrp[i+2];    ap[i+0]=0;
294                 t4=nrp[i+3];    ap[i+1]=0;
295                 rp[i+0]=t1;     ap[i+2]=0;
296                 rp[i+1]=t2;     ap[i+3]=0;
297                 rp[i+2]=t3;
298                 rp[i+3]=t4;
299                 }
300         for (ri+=4; i<ri; i++)
301                 rp[i]=nrp[i], ap[i]=0;
302         bn_correct_top(r);
303         bn_correct_top(ret);
304 # else
305         if (bn_wexpand(ret,al) == NULL) goto err;
306         ret->top=al;
307         ret->neg=r->neg;
308
309         rp=ret->d;
310         ap=&(r->d[ri]);
311         al-=4;
312         for (i=0; i<al; i+=4)
313                 {
314                 BN_ULONG t1,t2,t3,t4;
315                 
316                 t1=ap[i+0];
317                 t2=ap[i+1];
318                 t3=ap[i+2];
319                 t4=ap[i+3];
320                 rp[i+0]=t1;
321                 rp[i+1]=t2;
322                 rp[i+2]=t3;
323                 rp[i+3]=t4;
324                 }
325         al+=4;
326         for (; i<al; i++)
327                 rp[i]=ap[i];
328 # endif
329 #else /* !MONT_WORD */ 
330         BIGNUM *t1,*t2;
331
332         BN_CTX_start(ctx);
333         t1 = BN_CTX_get(ctx);
334         t2 = BN_CTX_get(ctx);
335         if (t1 == NULL || t2 == NULL) goto err;
336         
337         if (!BN_copy(t1,a)) goto err;
338         BN_mask_bits(t1,mont->ri);
339
340         if (!BN_mul(t2,t1,&mont->Ni,ctx)) goto err;
341         BN_mask_bits(t2,mont->ri);
342
343         if (!BN_mul(t1,t2,&mont->N,ctx)) goto err;
344         if (!BN_add(t2,a,t1)) goto err;
345         if (!BN_rshift(ret,t2,mont->ri)) goto err;
346 #endif /* MONT_WORD */
347
348 #if !defined(BRANCH_FREE) || BRANCH_FREE==0
349         if (BN_ucmp(ret, &(mont->N)) >= 0)
350                 {
351                 if (!BN_usub(ret,ret,&(mont->N))) goto err;
352                 }
353 #endif
354         retn=1;
355         bn_check_top(ret);
356  err:
357         BN_CTX_end(ctx);
358         return(retn);
359         }
360
361 BN_MONT_CTX *BN_MONT_CTX_new(void)
362         {
363         BN_MONT_CTX *ret;
364
365         if ((ret=(BN_MONT_CTX *)OPENSSL_malloc(sizeof(BN_MONT_CTX))) == NULL)
366                 return(NULL);
367
368         BN_MONT_CTX_init(ret);
369         ret->flags=BN_FLG_MALLOCED;
370         return(ret);
371         }
372
373 void BN_MONT_CTX_init(BN_MONT_CTX *ctx)
374         {
375         ctx->ri=0;
376         BN_init(&(ctx->RR));
377         BN_init(&(ctx->N));
378         BN_init(&(ctx->Ni));
379         ctx->flags=0;
380         }
381
382 void BN_MONT_CTX_free(BN_MONT_CTX *mont)
383         {
384         if(mont == NULL)
385             return;
386
387         BN_free(&(mont->RR));
388         BN_free(&(mont->N));
389         BN_free(&(mont->Ni));
390         if (mont->flags & BN_FLG_MALLOCED)
391                 OPENSSL_free(mont);
392         }
393
394 int BN_MONT_CTX_set(BN_MONT_CTX *mont, const BIGNUM *mod, BN_CTX *ctx)
395         {
396         int ret = 0;
397         BIGNUM *Ri,*R;
398
399         BN_CTX_start(ctx);
400         if((Ri = BN_CTX_get(ctx)) == NULL) goto err;
401         R= &(mont->RR);                                 /* grab RR as a temp */
402         if (!BN_copy(&(mont->N),mod)) goto err;         /* Set N */
403         mont->N.neg = 0;
404
405 #ifdef MONT_WORD
406                 {
407                 BIGNUM tmod;
408                 BN_ULONG buf[2];
409
410                 mont->ri=(BN_num_bits(mod)+(BN_BITS2-1))/BN_BITS2*BN_BITS2;
411                 BN_zero(R);
412                 if (!(BN_set_bit(R,BN_BITS2))) goto err;        /* R */
413
414                 buf[0]=mod->d[0]; /* tmod = N mod word size */
415                 buf[1]=0;
416                 tmod.d=buf;
417                 tmod.top = buf[0] != 0 ? 1 : 0;
418                 tmod.dmax=2;
419                 tmod.neg=0;
420                                                         /* Ri = R^-1 mod N*/
421                 if ((BN_mod_inverse(Ri,R,&tmod,ctx)) == NULL)
422                         goto err;
423                 if (!BN_lshift(Ri,Ri,BN_BITS2)) goto err; /* R*Ri */
424                 if (!BN_is_zero(Ri))
425                         {
426                         if (!BN_sub_word(Ri,1)) goto err;
427                         }
428                 else /* if N mod word size == 1 */
429                         {
430                         if (!BN_set_word(Ri,BN_MASK2)) goto err;  /* Ri-- (mod word size) */
431                         }
432                 if (!BN_div(Ri,NULL,Ri,&tmod,ctx)) goto err;
433                 /* Ni = (R*Ri-1)/N,
434                  * keep only least significant word: */
435                 mont->n0 = (Ri->top > 0) ? Ri->d[0] : 0;
436                 }
437 #else /* !MONT_WORD */
438                 { /* bignum version */
439                 mont->ri=BN_num_bits(&mont->N);
440                 BN_zero(R);
441                 if (!BN_set_bit(R,mont->ri)) goto err;  /* R = 2^ri */
442                                                         /* Ri = R^-1 mod N*/
443                 if ((BN_mod_inverse(Ri,R,&mont->N,ctx)) == NULL)
444                         goto err;
445                 if (!BN_lshift(Ri,Ri,mont->ri)) goto err; /* R*Ri */
446                 if (!BN_sub_word(Ri,1)) goto err;
447                                                         /* Ni = (R*Ri-1) / N */
448                 if (!BN_div(&(mont->Ni),NULL,Ri,&mont->N,ctx)) goto err;
449                 }
450 #endif
451
452         /* setup RR for conversions */
453         BN_zero(&(mont->RR));
454         if (!BN_set_bit(&(mont->RR),mont->ri*2)) goto err;
455         if (!BN_mod(&(mont->RR),&(mont->RR),&(mont->N),ctx)) goto err;
456
457         ret = 1;
458 err:
459         BN_CTX_end(ctx);
460         return ret;
461         }
462
463 BN_MONT_CTX *BN_MONT_CTX_copy(BN_MONT_CTX *to, BN_MONT_CTX *from)
464         {
465         if (to == from) return(to);
466
467         if (!BN_copy(&(to->RR),&(from->RR))) return NULL;
468         if (!BN_copy(&(to->N),&(from->N))) return NULL;
469         if (!BN_copy(&(to->Ni),&(from->Ni))) return NULL;
470         to->ri=from->ri;
471         to->n0=from->n0;
472         return(to);
473         }
474
475 BN_MONT_CTX *BN_MONT_CTX_set_locked(BN_MONT_CTX **pmont, int lock,
476                                         const BIGNUM *mod, BN_CTX *ctx)
477         {
478         int got_write_lock = 0;
479         BN_MONT_CTX *ret;
480
481         CRYPTO_r_lock(lock);
482         if (!*pmont)
483                 {
484                 CRYPTO_r_unlock(lock);
485                 CRYPTO_w_lock(lock);
486                 got_write_lock = 1;
487
488                 if (!*pmont)
489                         {
490                         ret = BN_MONT_CTX_new();
491                         if (ret && !BN_MONT_CTX_set(ret, mod, ctx))
492                                 BN_MONT_CTX_free(ret);
493                         else
494                                 *pmont = ret;
495                         }
496                 }
497         
498         ret = *pmont;
499         
500         if (got_write_lock)
501                 CRYPTO_w_unlock(lock);
502         else
503                 CRYPTO_r_unlock(lock);
504                 
505         return ret;
506         }