bignum.h 3.75 KB
Newer Older
1
/* bignum.h
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

   Bignum operations that are missing from gmp.

   Copyright (C) 2001 Niels Möller

   This file is part of GNU Nettle.

   GNU Nettle is free software: you can redistribute it and/or
   modify it under the terms of either:

     * the GNU Lesser General Public License as published by the Free
       Software Foundation; either version 3 of the License, or (at your
       option) any later version.

   or

     * the GNU General Public License as published by the Free
       Software Foundation; either version 2 of the License, or (at your
       option) any later version.

   or both in parallel, as here.

   GNU Nettle is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   General Public License for more details.

   You should have received copies of the GNU General Public License and
   the GNU Lesser General Public License along with this program.  If
   not, see http://www.gnu.org/licenses/.
*/
33 34 35 36
 
#ifndef NETTLE_BIGNUM_H_INCLUDED
#define NETTLE_BIGNUM_H_INCLUDED

37 38
#include "nettle-meta.h"

39
#include "nettle-types.h"
40

41 42
/* For NETTLE_USE_MINI_GMP */
#include "version.h"
43 44 45 46 47 48 49 50 51 52 53 54 55

#if NETTLE_USE_MINI_GMP
# include "mini-gmp.h"

# define GMP_NUMB_MASK (~(mp_limb_t) 0)

/* Functions missing in older gmp versions, and checked for with ifdef */
# define mpz_limbs_read mpz_limbs_read
# define mpn_copyd mpn_copyd
# define mpn_sqr mpn_sqr
# define mpz_combit mpz_combit
# define mpz_import mpz_import
# define mpz_export mpz_export
Niels Möller's avatar
Niels Möller committed
56 57
/* Side-channel silent powm not available in mini-gmp. */
# define mpz_powm_sec mpz_pwm
58 59 60 61
#else
# include <gmp.h>
#endif

Niels Möller's avatar
Niels Möller committed
62 63 64 65
#ifdef __cplusplus
extern "C" {
#endif

66 67
/* Size needed for signed encoding, including extra sign byte if
 * necessary. */
68
size_t
69
nettle_mpz_sizeinbase_256_s(const mpz_t x);
70

71
/* Size needed for unsigned encoding */
72
size_t
73 74 75 76
nettle_mpz_sizeinbase_256_u(const mpz_t x);

/* Writes an integer as length octets, using big endian byte order,
 * and two's complement for negative numbers. */
77
void
78
nettle_mpz_get_str_256(size_t length, uint8_t *s, const mpz_t x);
79

80 81 82
/* Reads a big endian, two's complement, integer. */
void
nettle_mpz_set_str_256_s(mpz_t x,
83
			 size_t length, const uint8_t *s);
84 85 86

void
nettle_mpz_init_set_str_256_s(mpz_t x,
87
			      size_t length, const uint8_t *s);
88 89 90

/* Similar, but for unsigned format. These function don't interpret
 * the most significant bit as the sign. */
91
void
92
nettle_mpz_set_str_256_u(mpz_t x,
93
			 size_t length, const uint8_t *s);
94 95

void
96
nettle_mpz_init_set_str_256_u(mpz_t x,
97
			      size_t length, const uint8_t *s);
98

99 100 101
/* Returns a uniformly distributed random number 0 <= x < 2^n */
void
nettle_mpz_random_size(mpz_t x,
102
		       void *ctx, nettle_random_func *random,
103 104 105 106 107 108
		       unsigned bits);

/* Returns a number x, almost uniformly random in the range
 * 0 <= x < n. */
void
nettle_mpz_random(mpz_t x, 
109
		  void *ctx, nettle_random_func *random,
110 111
		  const mpz_t n);

112
void
113
nettle_random_prime(mpz_t p, unsigned bits, int top_bits_set,
114 115
		    void *ctx, nettle_random_func *random,
		    void *progress_ctx, nettle_progress_func *progress);
116

117
void
118 119
_nettle_generate_pocklington_prime (mpz_t p, mpz_t r,
				    unsigned bits, int top_bits_set, 
120
				    void *ctx, nettle_random_func *random, 
121 122 123 124
				    const mpz_t p0,
				    const mpz_t q,
				    const mpz_t p0q);
  
125
/* sexp parsing */
126 127
struct sexp_iterator;

128 129
/* If LIMIT is non-zero, the number must be at most LIMIT bits.
 * Implies sexp_iterator_next. */
130
int
131
nettle_mpz_set_sexp(mpz_t x, unsigned limit, struct sexp_iterator *i);
132

133 134 135 136 137

/* der parsing */
struct asn1_der_iterator;

int
138
nettle_asn1_der_get_bignum(struct asn1_der_iterator *iterator,
Niels Möller's avatar
Niels Möller committed
139
			   mpz_t x, unsigned max_bits);
140

Niels Möller's avatar
Niels Möller committed
141 142 143 144
#ifdef __cplusplus
}
#endif

145
#endif /* NETTLE_BIGNUM_H_INCLUDED */