bn_exp.c: improve portability.
[openssl.git] / crypto / bn / bn_exp.c
1 /* crypto/bn/bn_exp.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-2005 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 #define OPENSSL_FIPSAPI
113
114 #include "cryptlib.h"
115 #include "bn_lcl.h"
116
117 #include <stdlib.h>
118 #ifdef _WIN32
119 # include <malloc.h>
120 # ifndef alloca
121 #  define alloca _alloca
122 # endif
123 #elif defined(__GNUC__)
124 # ifndef alloca
125 #  define alloca(s) __builtin_alloca((s))
126 # endif
127 #endif
128
129 /* maximum precomputation table size for *variable* sliding windows */
130 #define TABLE_SIZE      32
131
132 /* this one works - simple but works */
133 int BN_exp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx)
134         {
135         int i,bits,ret=0;
136         BIGNUM *v,*rr;
137
138         if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0)
139                 {
140                 /* BN_FLG_CONSTTIME only supported by BN_mod_exp_mont() */
141                 BNerr(BN_F_BN_EXP,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
142                 return -1;
143                 }
144
145         BN_CTX_start(ctx);
146         if ((r == a) || (r == p))
147                 rr = BN_CTX_get(ctx);
148         else
149                 rr = r;
150         v = BN_CTX_get(ctx);
151         if (rr == NULL || v == NULL) goto err;
152
153         if (BN_copy(v,a) == NULL) goto err;
154         bits=BN_num_bits(p);
155
156         if (BN_is_odd(p))
157                 { if (BN_copy(rr,a) == NULL) goto err; }
158         else    { if (!BN_one(rr)) goto err; }
159
160         for (i=1; i<bits; i++)
161                 {
162                 if (!BN_sqr(v,v,ctx)) goto err;
163                 if (BN_is_bit_set(p,i))
164                         {
165                         if (!BN_mul(rr,rr,v,ctx)) goto err;
166                         }
167                 }
168         ret=1;
169 err:
170         if (r != rr) BN_copy(r,rr);
171         BN_CTX_end(ctx);
172         bn_check_top(r);
173         return(ret);
174         }
175
176
177 int BN_mod_exp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, const BIGNUM *m,
178                BN_CTX *ctx)
179         {
180         int ret;
181
182         bn_check_top(a);
183         bn_check_top(p);
184         bn_check_top(m);
185
186         /* For even modulus  m = 2^k*m_odd,  it might make sense to compute
187          * a^p mod m_odd  and  a^p mod 2^k  separately (with Montgomery
188          * exponentiation for the odd part), using appropriate exponent
189          * reductions, and combine the results using the CRT.
190          *
191          * For now, we use Montgomery only if the modulus is odd; otherwise,
192          * exponentiation using the reciprocal-based quick remaindering
193          * algorithm is used.
194          *
195          * (Timing obtained with expspeed.c [computations  a^p mod m
196          * where  a, p, m  are of the same length: 256, 512, 1024, 2048,
197          * 4096, 8192 bits], compared to the running time of the
198          * standard algorithm:
199          *
200          *   BN_mod_exp_mont   33 .. 40 %  [AMD K6-2, Linux, debug configuration]
201          *                     55 .. 77 %  [UltraSparc processor, but
202          *                                  debug-solaris-sparcv8-gcc conf.]
203          * 
204          *   BN_mod_exp_recp   50 .. 70 %  [AMD K6-2, Linux, debug configuration]
205          *                     62 .. 118 % [UltraSparc, debug-solaris-sparcv8-gcc]
206          *
207          * On the Sparc, BN_mod_exp_recp was faster than BN_mod_exp_mont
208          * at 2048 and more bits, but at 512 and 1024 bits, it was
209          * slower even than the standard algorithm!
210          *
211          * "Real" timings [linux-elf, solaris-sparcv9-gcc configurations]
212          * should be obtained when the new Montgomery reduction code
213          * has been integrated into OpenSSL.)
214          */
215
216 #define MONT_MUL_MOD
217 #define MONT_EXP_WORD
218 #define RECP_MUL_MOD
219
220 #ifdef MONT_MUL_MOD
221         /* I have finally been able to take out this pre-condition of
222          * the top bit being set.  It was caused by an error in BN_div
223          * with negatives.  There was also another problem when for a^b%m
224          * a >= m.  eay 07-May-97 */
225 /*      if ((m->d[m->top-1]&BN_TBIT) && BN_is_odd(m)) */
226
227         if (BN_is_odd(m))
228                 {
229 #  ifdef MONT_EXP_WORD
230                 if (a->top == 1 && !a->neg && (BN_get_flags(p, BN_FLG_CONSTTIME) == 0))
231                         {
232                         BN_ULONG A = a->d[0];
233                         ret=BN_mod_exp_mont_word(r,A,p,m,ctx,NULL);
234                         }
235                 else
236 #  endif
237                         ret=BN_mod_exp_mont(r,a,p,m,ctx,NULL);
238                 }
239         else
240 #endif
241 #ifdef RECP_MUL_MOD
242                 { ret=BN_mod_exp_recp(r,a,p,m,ctx); }
243 #else
244                 { ret=BN_mod_exp_simple(r,a,p,m,ctx); }
245 #endif
246
247         bn_check_top(r);
248         return(ret);
249         }
250
251
252 int BN_mod_exp_recp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
253                     const BIGNUM *m, BN_CTX *ctx)
254         {
255         int i,j,bits,ret=0,wstart,wend,window,wvalue;
256         int start=1;
257         BIGNUM *aa;
258         /* Table of variables obtained from 'ctx' */
259         BIGNUM *val[TABLE_SIZE];
260         BN_RECP_CTX recp;
261
262         if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0)
263                 {
264                 /* BN_FLG_CONSTTIME only supported by BN_mod_exp_mont() */
265                 BNerr(BN_F_BN_MOD_EXP_RECP,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
266                 return -1;
267                 }
268
269         bits=BN_num_bits(p);
270
271         if (bits == 0)
272                 {
273                 ret = BN_one(r);
274                 return ret;
275                 }
276
277         BN_CTX_start(ctx);
278         aa = BN_CTX_get(ctx);
279         val[0] = BN_CTX_get(ctx);
280         if(!aa || !val[0]) goto err;
281
282         BN_RECP_CTX_init(&recp);
283         if (m->neg)
284                 {
285                 /* ignore sign of 'm' */
286                 if (!BN_copy(aa, m)) goto err;
287                 aa->neg = 0;
288                 if (BN_RECP_CTX_set(&recp,aa,ctx) <= 0) goto err;
289                 }
290         else
291                 {
292                 if (BN_RECP_CTX_set(&recp,m,ctx) <= 0) goto err;
293                 }
294
295         if (!BN_nnmod(val[0],a,m,ctx)) goto err;                /* 1 */
296         if (BN_is_zero(val[0]))
297                 {
298                 BN_zero(r);
299                 ret = 1;
300                 goto err;
301                 }
302
303         window = BN_window_bits_for_exponent_size(bits);
304         if (window > 1)
305                 {
306                 if (!BN_mod_mul_reciprocal(aa,val[0],val[0],&recp,ctx))
307                         goto err;                               /* 2 */
308                 j=1<<(window-1);
309                 for (i=1; i<j; i++)
310                         {
311                         if(((val[i] = BN_CTX_get(ctx)) == NULL) ||
312                                         !BN_mod_mul_reciprocal(val[i],val[i-1],
313                                                 aa,&recp,ctx))
314                                 goto err;
315                         }
316                 }
317                 
318         start=1;        /* This is used to avoid multiplication etc
319                          * when there is only the value '1' in the
320                          * buffer. */
321         wvalue=0;       /* The 'value' of the window */
322         wstart=bits-1;  /* The top bit of the window */
323         wend=0;         /* The bottom bit of the window */
324
325         if (!BN_one(r)) goto err;
326
327         for (;;)
328                 {
329                 if (BN_is_bit_set(p,wstart) == 0)
330                         {
331                         if (!start)
332                                 if (!BN_mod_mul_reciprocal(r,r,r,&recp,ctx))
333                                 goto err;
334                         if (wstart == 0) break;
335                         wstart--;
336                         continue;
337                         }
338                 /* We now have wstart on a 'set' bit, we now need to work out
339                  * how bit a window to do.  To do this we need to scan
340                  * forward until the last set bit before the end of the
341                  * window */
342                 j=wstart;
343                 wvalue=1;
344                 wend=0;
345                 for (i=1; i<window; i++)
346                         {
347                         if (wstart-i < 0) break;
348                         if (BN_is_bit_set(p,wstart-i))
349                                 {
350                                 wvalue<<=(i-wend);
351                                 wvalue|=1;
352                                 wend=i;
353                                 }
354                         }
355
356                 /* wend is the size of the current window */
357                 j=wend+1;
358                 /* add the 'bytes above' */
359                 if (!start)
360                         for (i=0; i<j; i++)
361                                 {
362                                 if (!BN_mod_mul_reciprocal(r,r,r,&recp,ctx))
363                                         goto err;
364                                 }
365                 
366                 /* wvalue will be an odd number < 2^window */
367                 if (!BN_mod_mul_reciprocal(r,r,val[wvalue>>1],&recp,ctx))
368                         goto err;
369
370                 /* move the 'window' down further */
371                 wstart-=wend+1;
372                 wvalue=0;
373                 start=0;
374                 if (wstart < 0) break;
375                 }
376         ret=1;
377 err:
378         BN_CTX_end(ctx);
379         BN_RECP_CTX_free(&recp);
380         bn_check_top(r);
381         return(ret);
382         }
383
384
385 int BN_mod_exp_mont(BIGNUM *rr, const BIGNUM *a, const BIGNUM *p,
386                     const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *in_mont)
387         {
388         int i,j,bits,ret=0,wstart,wend,window,wvalue;
389         int start=1;
390         BIGNUM *d,*r;
391         const BIGNUM *aa;
392         /* Table of variables obtained from 'ctx' */
393         BIGNUM *val[TABLE_SIZE];
394         BN_MONT_CTX *mont=NULL;
395
396         if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0)
397                 {
398                 return BN_mod_exp_mont_consttime(rr, a, p, m, ctx, in_mont);
399                 }
400
401         bn_check_top(a);
402         bn_check_top(p);
403         bn_check_top(m);
404
405         if (!BN_is_odd(m))
406                 {
407                 BNerr(BN_F_BN_MOD_EXP_MONT,BN_R_CALLED_WITH_EVEN_MODULUS);
408                 return(0);
409                 }
410         bits=BN_num_bits(p);
411         if (bits == 0)
412                 {
413                 ret = BN_one(rr);
414                 return ret;
415                 }
416
417         BN_CTX_start(ctx);
418         d = BN_CTX_get(ctx);
419         r = BN_CTX_get(ctx);
420         val[0] = BN_CTX_get(ctx);
421         if (!d || !r || !val[0]) goto err;
422
423         /* If this is not done, things will break in the montgomery
424          * part */
425
426         if (in_mont != NULL)
427                 mont=in_mont;
428         else
429                 {
430                 if ((mont=BN_MONT_CTX_new()) == NULL) goto err;
431                 if (!BN_MONT_CTX_set(mont,m,ctx)) goto err;
432                 }
433
434         if (a->neg || BN_ucmp(a,m) >= 0)
435                 {
436                 if (!BN_nnmod(val[0],a,m,ctx))
437                         goto err;
438                 aa= val[0];
439                 }
440         else
441                 aa=a;
442         if (BN_is_zero(aa))
443                 {
444                 BN_zero(rr);
445                 ret = 1;
446                 goto err;
447                 }
448         if (!BN_to_montgomery(val[0],aa,mont,ctx)) goto err; /* 1 */
449
450         window = BN_window_bits_for_exponent_size(bits);
451         if (window > 1)
452                 {
453                 if (!BN_mod_mul_montgomery(d,val[0],val[0],mont,ctx)) goto err; /* 2 */
454                 j=1<<(window-1);
455                 for (i=1; i<j; i++)
456                         {
457                         if(((val[i] = BN_CTX_get(ctx)) == NULL) ||
458                                         !BN_mod_mul_montgomery(val[i],val[i-1],
459                                                 d,mont,ctx))
460                                 goto err;
461                         }
462                 }
463
464         start=1;        /* This is used to avoid multiplication etc
465                          * when there is only the value '1' in the
466                          * buffer. */
467         wvalue=0;       /* The 'value' of the window */
468         wstart=bits-1;  /* The top bit of the window */
469         wend=0;         /* The bottom bit of the window */
470
471         if (!BN_to_montgomery(r,BN_value_one(),mont,ctx)) goto err;
472         for (;;)
473                 {
474                 if (BN_is_bit_set(p,wstart) == 0)
475                         {
476                         if (!start)
477                                 {
478                                 if (!BN_mod_mul_montgomery(r,r,r,mont,ctx))
479                                 goto err;
480                                 }
481                         if (wstart == 0) break;
482                         wstart--;
483                         continue;
484                         }
485                 /* We now have wstart on a 'set' bit, we now need to work out
486                  * how bit a window to do.  To do this we need to scan
487                  * forward until the last set bit before the end of the
488                  * window */
489                 j=wstart;
490                 wvalue=1;
491                 wend=0;
492                 for (i=1; i<window; i++)
493                         {
494                         if (wstart-i < 0) break;
495                         if (BN_is_bit_set(p,wstart-i))
496                                 {
497                                 wvalue<<=(i-wend);
498                                 wvalue|=1;
499                                 wend=i;
500                                 }
501                         }
502
503                 /* wend is the size of the current window */
504                 j=wend+1;
505                 /* add the 'bytes above' */
506                 if (!start)
507                         for (i=0; i<j; i++)
508                                 {
509                                 if (!BN_mod_mul_montgomery(r,r,r,mont,ctx))
510                                         goto err;
511                                 }
512                 
513                 /* wvalue will be an odd number < 2^window */
514                 if (!BN_mod_mul_montgomery(r,r,val[wvalue>>1],mont,ctx))
515                         goto err;
516
517                 /* move the 'window' down further */
518                 wstart-=wend+1;
519                 wvalue=0;
520                 start=0;
521                 if (wstart < 0) break;
522                 }
523         if (!BN_from_montgomery(rr,r,mont,ctx)) goto err;
524         ret=1;
525 err:
526         if ((in_mont == NULL) && (mont != NULL)) BN_MONT_CTX_free(mont);
527         BN_CTX_end(ctx);
528         bn_check_top(rr);
529         return(ret);
530         }
531
532
533 /* BN_mod_exp_mont_consttime() stores the precomputed powers in a specific layout
534  * so that accessing any of these table values shows the same access pattern as far
535  * as cache lines are concerned.  The following functions are used to transfer a BIGNUM
536  * from/to that table. */
537
538 static int MOD_EXP_CTIME_COPY_TO_PREBUF(BIGNUM *b, int top, unsigned char *buf, int idx, int width)
539         {
540         size_t i, j;
541
542         if (bn_wexpand(b, top) == NULL)
543                 return 0;
544         while (b->top < top)
545                 {
546                 b->d[b->top++] = 0;
547                 }
548         
549         for (i = 0, j=idx; i < top * sizeof b->d[0]; i++, j+=width)
550                 {
551                 buf[j] = ((unsigned char*)b->d)[i];
552                 }
553
554         bn_correct_top(b);
555         return 1;
556         }
557
558 static int MOD_EXP_CTIME_COPY_FROM_PREBUF(BIGNUM *b, int top, unsigned char *buf, int idx, int width)
559         {
560         size_t i, j;
561
562         if (bn_wexpand(b, top) == NULL)
563                 return 0;
564
565         for (i=0, j=idx; i < top * sizeof b->d[0]; i++, j+=width)
566                 {
567                 ((unsigned char*)b->d)[i] = buf[j];
568                 }
569
570         b->top = top;
571         bn_correct_top(b);
572         return 1;
573         }       
574
575 /* Given a pointer value, compute the next address that is a cache line multiple. */
576 #define MOD_EXP_CTIME_ALIGN(x_) \
577         ((unsigned char*)(x_) + (MOD_EXP_CTIME_MIN_CACHE_LINE_WIDTH - (((size_t)(x_)) & (MOD_EXP_CTIME_MIN_CACHE_LINE_MASK))))
578
579 /* This variant of BN_mod_exp_mont() uses fixed windows and the special
580  * precomputation memory layout to limit data-dependency to a minimum
581  * to protect secret exponents (cf. the hyper-threading timing attacks
582  * pointed out by Colin Percival,
583  * http://www.daemonology.net/hyperthreading-considered-harmful/)
584  */
585 int BN_mod_exp_mont_consttime(BIGNUM *rr, const BIGNUM *a, const BIGNUM *p,
586                     const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *in_mont)
587         {
588         int i,bits,ret=0,window,wvalue;
589         int top;
590         BIGNUM *r;
591         BN_MONT_CTX *mont=NULL;
592
593         int numPowers;
594         unsigned char *powerbufFree=NULL;
595         int powerbufLen = 0;
596         unsigned char *powerbuf=NULL;
597         BIGNUM computeTemp, *am=NULL;
598
599         bn_check_top(a);
600         bn_check_top(p);
601         bn_check_top(m);
602
603         top = m->top;
604
605         if (!(m->d[0] & 1))
606                 {
607                 BNerr(BN_F_BN_MOD_EXP_MONT_CONSTTIME,BN_R_CALLED_WITH_EVEN_MODULUS);
608                 return(0);
609                 }
610         bits=BN_num_bits(p);
611         if (bits == 0)
612                 {
613                 ret = BN_one(rr);
614                 return ret;
615                 }
616
617         /* Initialize BIGNUM context and allocate intermediate result */
618         BN_CTX_start(ctx);
619         r = BN_CTX_get(ctx);
620         if (r == NULL) goto err;
621
622         /* Allocate a montgomery context if it was not supplied by the caller.
623          * If this is not done, things will break in the montgomery part.
624          */
625         if (in_mont != NULL)
626                 mont=in_mont;
627         else
628                 {
629                 if ((mont=BN_MONT_CTX_new()) == NULL) goto err;
630                 if (!BN_MONT_CTX_set(mont,m,ctx)) goto err;
631                 }
632
633         /* Get the window size to use with size of p. */
634         window = BN_window_bits_for_ctime_exponent_size(bits);
635 #if defined(OPENSSL_BN_ASM_MONT5)
636         if (window==6 && bits<=1024) window=5;  /* ~5% improvement of 2048-bit RSA sign */
637 #endif
638         /* Adjust the number of bits up to a multiple of the window size.
639          * If the exponent length is not a multiple of the window size, then
640          * this pads the most significant bits with zeros to normalize the
641          * scanning loop to there's no special cases.
642          *
643          * * NOTE: Making the window size a power of two less than the native
644          * * word size ensures that the padded bits won't go past the last
645          * * word in the internal BIGNUM structure. Going past the end will
646          * * still produce the correct result, but causes a different branch
647          * * to be taken in the BN_is_bit_set function.
648          */
649         bits = ((bits+window-1)/window)*window;
650
651         /* Allocate a buffer large enough to hold all of the pre-computed
652          * powers of a, plus computeTemp.
653          */
654         numPowers = 1 << window;
655         powerbufLen = sizeof(m->d[0])*(top*numPowers +
656                                 (top>numPowers?top:numPowers));
657 #ifdef alloca
658         if (powerbufLen < 3072)
659                 powerbufFree = alloca(powerbufLen+MOD_EXP_CTIME_MIN_CACHE_LINE_WIDTH);
660         else
661 #endif
662         if ((powerbufFree=(unsigned char*)OPENSSL_malloc(powerbufLen+MOD_EXP_CTIME_MIN_CACHE_LINE_WIDTH)) == NULL)
663                 goto err;
664                 
665         powerbuf = MOD_EXP_CTIME_ALIGN(powerbufFree);
666         memset(powerbuf, 0, powerbufLen);
667
668 #ifdef alloca
669         if (powerbufLen < 3072)
670                 powerbufFree = NULL;
671 #endif
672
673         computeTemp.d = (BN_ULONG *)(powerbuf + sizeof(m->d[0])*top*numPowers);
674         computeTemp.top = computeTemp.dmax = top;
675         computeTemp.neg = 0;
676         computeTemp.flags = BN_FLG_STATIC_DATA;
677
678         /* Initialize the intermediate result. Do this early to save double conversion,
679          * once each for a^0 and intermediate result.
680          */
681         if (!BN_to_montgomery(r,BN_value_one(),mont,ctx)) goto err;
682
683         /* Initialize computeTemp as a^1 with montgomery precalcs */
684         am = BN_CTX_get(ctx);
685         if (am==NULL) goto err;
686
687         if (a->neg || BN_ucmp(a,m) >= 0)
688                 {
689                 if (!BN_mod(am,a,m,ctx))                goto err;
690                 if (!BN_to_montgomery(am,am,mont,ctx))  goto err;
691                 }
692         else    if (!BN_to_montgomery(am,a,mont,ctx))   goto err;
693
694         if (!BN_copy(&computeTemp, am)) goto err;
695
696         if (bn_wexpand(am,top)==NULL || bn_wexpand(r,top)==NULL)
697                 goto err;
698
699 #if defined(OPENSSL_BN_ASM_MONT5)
700     /* This optimization uses ideas from http://eprint.iacr.org/2011/239,
701      * specifically optimization of cache-timing attack countermeasures
702      * and pre-computation optimization. */
703
704     /* Dedicated window==4 case improves 512-bit RSA sign by ~15%, but as
705      * 512-bit RSA is hardly relevant, we omit it to spare size... */ 
706     if (window==5)
707         {
708         void bn_mul_mont_gather5(BN_ULONG *rp,const BN_ULONG *ap,
709                         const void *table,const BN_ULONG *np,
710                         const BN_ULONG *n0,int num,int power);
711         void bn_scatter5(const BN_ULONG *inp,size_t num,
712                         void *table,size_t power);
713
714         BN_ULONG *acc, *np=mont->N.d, *n0=mont->n0;
715
716         bn_scatter5(r->d,r->top,powerbuf,0);
717         bn_scatter5(am->d,am->top,powerbuf,1);
718
719         acc = computeTemp.d;
720 #if 0
721         for (i=2; i<32; i++)
722                 {
723                 bn_mul_mont_gather5(acc,am->d,powerbuf,np,n0,top,i-1);
724                 bn_scatter5(acc,top,powerbuf,i);
725                 }
726 #else
727         /* same as above, but uses squaring for 1/2 of operations */
728         for (i=2; i<32; i*=2)
729                 {
730                 bn_mul_mont(acc,acc,acc,np,n0,top);
731                 bn_scatter5(acc,top,powerbuf,i);
732                 }
733         for (i=3; i<8; i+=2)
734                 {
735                 int j;
736                 bn_mul_mont_gather5(acc,am->d,powerbuf,np,n0,top,i-1);
737                 bn_scatter5(acc,top,powerbuf,i);
738                 for (j=2*i; j<32; j*=2)
739                         {
740                         bn_mul_mont(acc,acc,acc,np,n0,top);
741                         bn_scatter5(acc,top,powerbuf,j);
742                         }
743                 }
744         for (; i<16; i+=2)
745                 {
746                 bn_mul_mont_gather5(acc,am->d,powerbuf,np,n0,top,i-1);
747                 bn_scatter5(acc,top,powerbuf,i);
748                 bn_mul_mont(acc,acc,acc,np,n0,top);
749                 bn_scatter5(acc,top,powerbuf,2*i);
750                 }
751         for (; i<32; i+=2)
752                 {
753                 bn_mul_mont_gather5(acc,am->d,powerbuf,np,n0,top,i-1);
754                 bn_scatter5(acc,top,powerbuf,i);
755                 }
756 #endif
757         acc = r->d;
758
759         /* Scan the exponent one window at a time starting from the most
760          * significant bits.
761          */
762         bits--;
763         while (bits >= 0)
764                 {
765                 for (wvalue=0, i=0; i<5; i++,bits--)
766                         wvalue = (wvalue<<1)+BN_is_bit_set(p,bits);
767
768                 bn_mul_mont(acc,acc,acc,np,n0,top);
769                 bn_mul_mont(acc,acc,acc,np,n0,top);
770                 bn_mul_mont(acc,acc,acc,np,n0,top);
771                 bn_mul_mont(acc,acc,acc,np,n0,top);
772                 bn_mul_mont(acc,acc,acc,np,n0,top);
773                 bn_mul_mont_gather5(acc,acc,powerbuf,np,n0,top,wvalue);
774                 }
775
776         r->top=top;
777         bn_correct_top(r);
778         }
779     else
780 #endif
781         {
782         if (!MOD_EXP_CTIME_COPY_TO_PREBUF(r, top, powerbuf, 0, numPowers)) goto err;
783         if (!MOD_EXP_CTIME_COPY_TO_PREBUF(am, top, powerbuf, 1, numPowers)) goto err;
784
785         /* If the window size is greater than 1, then calculate
786          * val[i=2..2^winsize-1]. Powers are computed as a*a^(i-1)
787          * (even powers could instead be computed as (a^(i/2))^2
788          * to use the slight performance advantage of sqr over mul).
789          */
790         if (window > 1)
791                 {
792                 for (i=2; i<numPowers; i++)
793                         {
794                         /* Calculate a^i = a^(i-1) * a */
795                         if (!BN_mod_mul_montgomery(&computeTemp,am,&computeTemp,mont,ctx))
796                                 goto err;
797                         if (!MOD_EXP_CTIME_COPY_TO_PREBUF(&computeTemp, top, powerbuf, i, numPowers)) goto err;
798                         }
799                 }
800
801         /* Scan the exponent one window at a time starting from the most
802          * significant bits.
803          */
804         bits--;
805         while (bits >= 0)
806                 {
807                 wvalue=0; /* The 'value' of the window */
808                 
809                 /* Scan the window, squaring the result as we go */
810                 for (i=0; i<window; i++,bits--)
811                         {
812                         if (!BN_mod_mul_montgomery(r,r,r,mont,ctx))     goto err;
813                         wvalue = (wvalue<<1)+BN_is_bit_set(p,bits);
814                         }
815                 
816                 /* Fetch the appropriate pre-computed value from the pre-buf */
817                 if (!MOD_EXP_CTIME_COPY_FROM_PREBUF(&computeTemp, top, powerbuf, wvalue, numPowers)) goto err;
818
819                 /* Multiply the result into the intermediate result */
820                 if (!BN_mod_mul_montgomery(r,r,&computeTemp,mont,ctx)) goto err;
821                 }
822         }
823
824         /* Convert the final result from montgomery to standard format */
825         if (!BN_from_montgomery(rr,r,mont,ctx)) goto err;
826         ret=1;
827 err:
828         if ((in_mont == NULL) && (mont != NULL)) BN_MONT_CTX_free(mont);
829         if (powerbuf!=NULL)
830                 {
831                 OPENSSL_cleanse(powerbuf,powerbufLen);
832                 if (powerbufFree) OPENSSL_free(powerbufFree);
833                 }
834         if (am!=NULL) BN_clear(am);
835         BN_CTX_end(ctx);
836         return(ret);
837         }
838
839 int BN_mod_exp_mont_word(BIGNUM *rr, BN_ULONG a, const BIGNUM *p,
840                          const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *in_mont)
841         {
842         BN_MONT_CTX *mont = NULL;
843         int b, bits, ret=0;
844         int r_is_one;
845         BN_ULONG w, next_w;
846         BIGNUM *d, *r, *t;
847         BIGNUM *swap_tmp;
848 #define BN_MOD_MUL_WORD(r, w, m) \
849                 (BN_mul_word(r, (w)) && \
850                 (/* BN_ucmp(r, (m)) < 0 ? 1 :*/  \
851                         (BN_mod(t, r, m, ctx) && (swap_tmp = r, r = t, t = swap_tmp, 1))))
852                 /* BN_MOD_MUL_WORD is only used with 'w' large,
853                  * so the BN_ucmp test is probably more overhead
854                  * than always using BN_mod (which uses BN_copy if
855                  * a similar test returns true). */
856                 /* We can use BN_mod and do not need BN_nnmod because our
857                  * accumulator is never negative (the result of BN_mod does
858                  * not depend on the sign of the modulus).
859                  */
860 #define BN_TO_MONTGOMERY_WORD(r, w, mont) \
861                 (BN_set_word(r, (w)) && BN_to_montgomery(r, r, (mont), ctx))
862
863         if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0)
864                 {
865                 /* BN_FLG_CONSTTIME only supported by BN_mod_exp_mont() */
866                 BNerr(BN_F_BN_MOD_EXP_MONT_WORD,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
867                 return -1;
868                 }
869
870         bn_check_top(p);
871         bn_check_top(m);
872
873         if (!BN_is_odd(m))
874                 {
875                 BNerr(BN_F_BN_MOD_EXP_MONT_WORD,BN_R_CALLED_WITH_EVEN_MODULUS);
876                 return(0);
877                 }
878         if (m->top == 1)
879                 a %= m->d[0]; /* make sure that 'a' is reduced */
880
881         bits = BN_num_bits(p);
882         if (bits == 0)
883                 {
884                 ret = BN_one(rr);
885                 return ret;
886                 }
887         if (a == 0)
888                 {
889                 BN_zero(rr);
890                 ret = 1;
891                 return ret;
892                 }
893
894         BN_CTX_start(ctx);
895         d = BN_CTX_get(ctx);
896         r = BN_CTX_get(ctx);
897         t = BN_CTX_get(ctx);
898         if (d == NULL || r == NULL || t == NULL) goto err;
899
900         if (in_mont != NULL)
901                 mont=in_mont;
902         else
903                 {
904                 if ((mont = BN_MONT_CTX_new()) == NULL) goto err;
905                 if (!BN_MONT_CTX_set(mont, m, ctx)) goto err;
906                 }
907
908         r_is_one = 1; /* except for Montgomery factor */
909
910         /* bits-1 >= 0 */
911
912         /* The result is accumulated in the product r*w. */
913         w = a; /* bit 'bits-1' of 'p' is always set */
914         for (b = bits-2; b >= 0; b--)
915                 {
916                 /* First, square r*w. */
917                 next_w = w*w;
918                 if ((next_w/w) != w) /* overflow */
919                         {
920                         if (r_is_one)
921                                 {
922                                 if (!BN_TO_MONTGOMERY_WORD(r, w, mont)) goto err;
923                                 r_is_one = 0;
924                                 }
925                         else
926                                 {
927                                 if (!BN_MOD_MUL_WORD(r, w, m)) goto err;
928                                 }
929                         next_w = 1;
930                         }
931                 w = next_w;
932                 if (!r_is_one)
933                         {
934                         if (!BN_mod_mul_montgomery(r, r, r, mont, ctx)) goto err;
935                         }
936
937                 /* Second, multiply r*w by 'a' if exponent bit is set. */
938                 if (BN_is_bit_set(p, b))
939                         {
940                         next_w = w*a;
941                         if ((next_w/a) != w) /* overflow */
942                                 {
943                                 if (r_is_one)
944                                         {
945                                         if (!BN_TO_MONTGOMERY_WORD(r, w, mont)) goto err;
946                                         r_is_one = 0;
947                                         }
948                                 else
949                                         {
950                                         if (!BN_MOD_MUL_WORD(r, w, m)) goto err;
951                                         }
952                                 next_w = a;
953                                 }
954                         w = next_w;
955                         }
956                 }
957
958         /* Finally, set r:=r*w. */
959         if (w != 1)
960                 {
961                 if (r_is_one)
962                         {
963                         if (!BN_TO_MONTGOMERY_WORD(r, w, mont)) goto err;
964                         r_is_one = 0;
965                         }
966                 else
967                         {
968                         if (!BN_MOD_MUL_WORD(r, w, m)) goto err;
969                         }
970                 }
971
972         if (r_is_one) /* can happen only if a == 1*/
973                 {
974                 if (!BN_one(rr)) goto err;
975                 }
976         else
977                 {
978                 if (!BN_from_montgomery(rr, r, mont, ctx)) goto err;
979                 }
980         ret = 1;
981 err:
982         if ((in_mont == NULL) && (mont != NULL)) BN_MONT_CTX_free(mont);
983         BN_CTX_end(ctx);
984         bn_check_top(rr);
985         return(ret);
986         }
987
988
989 /* The old fallback, simple version :-) */
990 int BN_mod_exp_simple(BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
991                 const BIGNUM *m, BN_CTX *ctx)
992         {
993         int i,j,bits,ret=0,wstart,wend,window,wvalue;
994         int start=1;
995         BIGNUM *d;
996         /* Table of variables obtained from 'ctx' */
997         BIGNUM *val[TABLE_SIZE];
998
999         if (BN_get_flags(p, BN_FLG_CONSTTIME) != 0)
1000                 {
1001                 /* BN_FLG_CONSTTIME only supported by BN_mod_exp_mont() */
1002                 BNerr(BN_F_BN_MOD_EXP_SIMPLE,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1003                 return -1;
1004                 }
1005
1006         bits=BN_num_bits(p);
1007
1008         if (bits == 0)
1009                 {
1010                 ret = BN_one(r);
1011                 return ret;
1012                 }
1013
1014         BN_CTX_start(ctx);
1015         d = BN_CTX_get(ctx);
1016         val[0] = BN_CTX_get(ctx);
1017         if(!d || !val[0]) goto err;
1018
1019         if (!BN_nnmod(val[0],a,m,ctx)) goto err;                /* 1 */
1020         if (BN_is_zero(val[0]))
1021                 {
1022                 BN_zero(r);
1023                 ret = 1;
1024                 goto err;
1025                 }
1026
1027         window = BN_window_bits_for_exponent_size(bits);
1028         if (window > 1)
1029                 {
1030                 if (!BN_mod_mul(d,val[0],val[0],m,ctx))
1031                         goto err;                               /* 2 */
1032                 j=1<<(window-1);
1033                 for (i=1; i<j; i++)
1034                         {
1035                         if(((val[i] = BN_CTX_get(ctx)) == NULL) ||
1036                                         !BN_mod_mul(val[i],val[i-1],d,m,ctx))
1037                                 goto err;
1038                         }
1039                 }
1040
1041         start=1;        /* This is used to avoid multiplication etc
1042                          * when there is only the value '1' in the
1043                          * buffer. */
1044         wvalue=0;       /* The 'value' of the window */
1045         wstart=bits-1;  /* The top bit of the window */
1046         wend=0;         /* The bottom bit of the window */
1047
1048         if (!BN_one(r)) goto err;
1049
1050         for (;;)
1051                 {
1052                 if (BN_is_bit_set(p,wstart) == 0)
1053                         {
1054                         if (!start)
1055                                 if (!BN_mod_mul(r,r,r,m,ctx))
1056                                 goto err;
1057                         if (wstart == 0) break;
1058                         wstart--;
1059                         continue;
1060                         }
1061                 /* We now have wstart on a 'set' bit, we now need to work out
1062                  * how bit a window to do.  To do this we need to scan
1063                  * forward until the last set bit before the end of the
1064                  * window */
1065                 j=wstart;
1066                 wvalue=1;
1067                 wend=0;
1068                 for (i=1; i<window; i++)
1069                         {
1070                         if (wstart-i < 0) break;
1071                         if (BN_is_bit_set(p,wstart-i))
1072                                 {
1073                                 wvalue<<=(i-wend);
1074                                 wvalue|=1;
1075                                 wend=i;
1076                                 }
1077                         }
1078
1079                 /* wend is the size of the current window */
1080                 j=wend+1;
1081                 /* add the 'bytes above' */
1082                 if (!start)
1083                         for (i=0; i<j; i++)
1084                                 {
1085                                 if (!BN_mod_mul(r,r,r,m,ctx))
1086                                         goto err;
1087                                 }
1088                 
1089                 /* wvalue will be an odd number < 2^window */
1090                 if (!BN_mod_mul(r,r,val[wvalue>>1],m,ctx))
1091                         goto err;
1092
1093                 /* move the 'window' down further */
1094                 wstart-=wend+1;
1095                 wvalue=0;
1096                 start=0;
1097                 if (wstart < 0) break;
1098                 }
1099         ret=1;
1100 err:
1101         BN_CTX_end(ctx);
1102         bn_check_top(r);
1103         return(ret);
1104         }
1105