Coverage Report

Created: 2026-02-14 06:49

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/nettle/ecc-mod-arith.c
Line
Count
Source
1
/* ecc-mod-arith.c
2
3
   Copyright (C) 2013, 2014 Niels Möller
4
5
   This file is part of GNU Nettle.
6
7
   GNU Nettle is free software: you can redistribute it and/or
8
   modify it under the terms of either:
9
10
     * the GNU Lesser General Public License as published by the Free
11
       Software Foundation; either version 3 of the License, or (at your
12
       option) any later version.
13
14
   or
15
16
     * the GNU General Public License as published by the Free
17
       Software Foundation; either version 2 of the License, or (at your
18
       option) any later version.
19
20
   or both in parallel, as here.
21
22
   GNU Nettle is distributed in the hope that it will be useful,
23
   but WITHOUT ANY WARRANTY; without even the implied warranty of
24
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
25
   General Public License for more details.
26
27
   You should have received copies of the GNU General Public License and
28
   the GNU Lesser General Public License along with this program.  If
29
   not, see http://www.gnu.org/licenses/.
30
*/
31
32
/* Development of Nettle's ECC support was funded by the .SE Internet Fund. */
33
34
#if HAVE_CONFIG_H
35
# include "config.h"
36
#endif
37
38
#include <assert.h>
39
40
#include "ecc-internal.h"
41
42
/* Routines for modp arithmetic. All values are ecc->size limbs, but
43
   not necessarily < p. */
44
45
int
46
ecc_mod_zero_p (const struct ecc_modulo *m, const mp_limb_t *xp_in)
47
8.74k
{
48
8.74k
  volatile mp_limb_t is_non_zero, is_not_p;
49
8.74k
  const volatile mp_limb_t *xp;
50
8.74k
  mp_size_t i;
51
52
43.8k
  for (xp = xp_in, i = 0, is_non_zero = is_not_p = 0; i < m->size; i++)
53
35.0k
    {
54
35.0k
      is_non_zero |= xp[i];
55
35.0k
      is_not_p |= (xp[i] ^ m->m[i]);
56
35.0k
    }
57
58
8.74k
  return is_zero_limb (is_non_zero) | is_zero_limb (is_not_p);
59
8.74k
}
60
61
int
62
ecc_mod_equal_p (const struct ecc_modulo *m, const mp_limb_t *a,
63
     const mp_limb_t *ref, mp_limb_t *scratch)
64
0
{
65
0
  mp_limb_t cy;
66
0
  cy = mpn_sub_n (scratch, a, ref, m->size);
67
  /* If cy > 0, i.e., a < ref, then they can't be equal mod m. */
68
0
  return (1 - cy) & ecc_mod_zero_p (m, scratch);
69
0
}
70
71
void
72
ecc_mod_add (const struct ecc_modulo *m, mp_limb_t *rp,
73
       const mp_limb_t *ap, const mp_limb_t *bp)
74
31.8M
{
75
31.8M
  mp_limb_t cy;
76
31.8M
  cy = mpn_add_n (rp, ap, bp, m->size);
77
31.8M
  cy = mpn_cnd_add_n (cy, rp, rp, m->B, m->size);
78
31.8M
  cy = mpn_cnd_add_n (cy, rp, rp, m->B, m->size);
79
31.8M
  assert_maybe (cy == 0);
80
31.8M
}
81
82
void
83
ecc_mod_sub (const struct ecc_modulo *m, mp_limb_t *rp,
84
       const mp_limb_t *ap, const mp_limb_t *bp)
85
50.8M
{
86
50.8M
  mp_limb_t cy;
87
50.8M
  cy = mpn_sub_n (rp, ap, bp, m->size);
88
  /* The adjustments for this function work differently depending on
89
     the value of the most significant bit of m.
90
91
     If m has a most significant bit of zero, then the first
92
     adjustment step conditionally adds 2m. If in addition, inputs are
93
     in the 0 <= a,b < 2m range, then the first adjustment guarantees
94
     that result is in that same range. The second adjustment step is
95
     needed only if b > 2m, it then ensures output is correct modulo
96
     m, but nothing more.
97
98
     If m has a most significant bit of one, Bm2m and B are the same,
99
     and this function works analogously to ecc_mod_add.
100
   */
101
50.8M
  cy = mpn_cnd_sub_n (cy, rp, rp, m->Bm2m, m->size);
102
50.8M
  cy = mpn_cnd_sub_n (cy, rp, rp, m->B, m->size);
103
50.8M
  assert_maybe (cy == 0);
104
50.8M
}
105
106
void
107
ecc_mod_mul_1 (const struct ecc_modulo *m, mp_limb_t *rp,
108
         const mp_limb_t *ap, mp_limb_t b)
109
9.97M
{
110
9.97M
  mp_limb_t hi;
111
112
9.97M
  assert (b <= 0xffffffff);
113
9.97M
  hi = mpn_mul_1 (rp, ap, m->size, b);
114
9.97M
  hi = mpn_addmul_1 (rp, m->B, m->size, hi);
115
9.97M
  assert_maybe (hi <= 1);
116
9.97M
  hi = mpn_cnd_add_n (hi, rp, rp, m->B, m->size);
117
  /* Sufficient if b < B^size / p */
118
9.97M
  assert_maybe (hi == 0);
119
9.97M
}
120
121
void
122
ecc_mod_addmul_1 (const struct ecc_modulo *m, mp_limb_t *rp,
123
      const mp_limb_t *ap, mp_limb_t b)
124
645k
{
125
645k
  mp_limb_t hi;
126
127
645k
  assert (b <= 0xffffffff);
128
645k
  hi = mpn_addmul_1 (rp, ap, m->size, b);
129
645k
  hi = mpn_addmul_1 (rp, m->B, m->size, hi);
130
645k
  assert_maybe (hi <= 1);
131
645k
  hi = mpn_cnd_add_n (hi, rp, rp, m->B, m->size);
132
  /* Sufficient roughly if b < B^size / p */
133
645k
  assert_maybe (hi == 0);
134
645k
}
135
  
136
void
137
ecc_mod_submul_1 (const struct ecc_modulo *m, mp_limb_t *rp,
138
      const mp_limb_t *ap, mp_limb_t b)
139
13.7M
{
140
13.7M
  mp_limb_t hi;
141
142
13.7M
  assert (b <= 0xffffffff);
143
13.7M
  hi = mpn_submul_1 (rp, ap, m->size, b);
144
13.7M
  hi = mpn_submul_1 (rp, m->B, m->size, hi);
145
13.7M
  assert_maybe (hi <= 1);
146
13.7M
  hi = mpn_cnd_sub_n (hi, rp, rp, m->B, m->size);
147
  /* Sufficient roughly if b < B^size / p */
148
13.7M
  assert_maybe (hi == 0);
149
13.7M
}
150
151
void
152
ecc_mod_mul (const struct ecc_modulo *m, mp_limb_t *rp,
153
       const mp_limb_t *ap, const mp_limb_t *bp, mp_limb_t *tp)
154
77.0M
{
155
77.0M
  mpn_mul_n (tp, ap, bp, m->size);
156
77.0M
  m->reduce (m, rp, tp);
157
77.0M
}
158
159
void
160
ecc_mod_sqr (const struct ecc_modulo *m, mp_limb_t *rp,
161
       const mp_limb_t *ap, mp_limb_t *tp)
162
75.5M
{
163
75.5M
  mpn_sqr (tp, ap, m->size);
164
75.5M
  m->reduce (m, rp, tp);
165
75.5M
}
166
167
void
168
ecc_mod_mul_canonical (const struct ecc_modulo *m, mp_limb_t *rp,
169
           const mp_limb_t *ap, const mp_limb_t *bp, mp_limb_t *tp)
170
207k
{
171
207k
  mp_limb_t cy;
172
207k
  mpn_mul_n (tp, ap, bp, m->size);
173
207k
  m->reduce (m, tp + m->size, tp);
174
175
207k
  cy = mpn_sub_n (rp, tp + m->size, m->m, m->size);
176
207k
  cnd_copy (cy, rp, tp + m->size, m->size);
177
207k
}
178
179
void
180
ecc_mod_sqr_canonical (const struct ecc_modulo *m, mp_limb_t *rp,
181
           const mp_limb_t *ap, mp_limb_t *tp)
182
744
{
183
744
  mp_limb_t cy;
184
744
  mpn_sqr (tp, ap, m->size);
185
744
  m->reduce (m, tp + m->size, tp);
186
187
744
  cy = mpn_sub_n (rp, tp + m->size, m->m, m->size);
188
744
  cnd_copy (cy, rp, tp + m->size, m->size);
189
744
}
190
191
void
192
ecc_mod_pow_2k (const struct ecc_modulo *m,
193
    mp_limb_t *rp, const mp_limb_t *xp,
194
    unsigned k, mp_limb_t *tp)
195
970k
{
196
970k
  ecc_mod_sqr (m, rp, xp, tp);
197
31.9M
  while (--k > 0)
198
30.9M
    ecc_mod_sqr (m, rp, rp, tp);
199
970k
}
200
201
void
202
ecc_mod_pow_2k_mul (const struct ecc_modulo *m,
203
        mp_limb_t *rp, const mp_limb_t *xp,
204
        unsigned k, const mp_limb_t *yp,
205
        mp_limb_t *tp)
206
896k
{
207
896k
  ecc_mod_pow_2k (m, rp, xp, k, tp);
208
896k
  ecc_mod_mul (m, rp, rp, yp, tp);
209
896k
}