MPHELL  4.0.0
mphell_tuto_fp.c
Go to the documentation of this file.
1 /*
2  MPHELL-4.0
3  Author(s): The MPHELL team
4 
5  (C) Copyright 2015-2018 - Institut Fourier / Univ. Grenoble Alpes (France)
6 
7  This file is part of the MPHELL Library.
8  MPHELL is free software: you can redistribute it and/or modify
9  it under the terms of the GNU Lesser General Public License as published by
10  the Free Software Foundation, version 3 of the License.
11 
12  MPHELL is distributed in the hope that it will be useful,
13  but WITHOUT ANY WARRANTY; without even the implied warranty of
14  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  GNU Lesser General Public License for more details.
16 
17  You should have received a copy of the GNU Lesser General Public License
18  along with MPHELL. If not, see <http://www.gnu.org/licenses/>.
19 */
20 
26 #include <stdio.h>
27 #include "mphell/mphell.h"
28 
29 int main()
30 {
31  /* Initialise MPHELL with 128 bits of security strength for the entropy, RANDOM_AES128 as DRBG and DEVURANDOM as entropy source */
32 
34 
35  /* Allocate a field of size 3*block_SIZE = 3*64 = 192 on 64 bits architecture */
36 
37  field k;
38  field_alloc(k, FP, bits_to_nblock(192), NULL);
39 
40  /* Allocate a number of size 3*block_SIZE = 3*64 = 192 on 64 bits architecture */
41 
42  number p;
43  number_init(&p, bits_to_nblock(192));
44 
45  /* Set the number p from a string in base 16 */
46 
47  number_set_str(p, "fffffffffffffffffffffffffffffffeffffffffffffffff", 16);
48 
49  /* Create the field of characteristic p */
50 
51  field_create(k, "", STACK_1, 1, p);
52 
53  /* Allocate element of the field k */
54 
55  field_elt x;
56  field_elt y;
57  field_elt res;
58  field_elt_alloc(&x, k);
59  field_elt_init(x, k);
60  field_elt_alloc(&y, k);
61  field_elt_init(y, k);
62  field_elt_alloc(&res, k);
63  field_elt_init(res, k);
64 
65  /* Set field element from string in base 16, which are not under Montgomery form */
66 
67  field_elt_set_str(x, "f14b8dbafa22b6ba35626d40d2d00001381bef07d2c3017", 16, false, k, STACK_1);
68  field_elt_set_str(y, "85ca4bcae9e156f1eab07c7b6cc500004ebbc0e5e3b237ce", 16, false, k, STACK_1);
69 
70  printf("x = "); field_elt_print(x, 16, true, k, STACK_1); printf("\n");
71  printf("y = "); field_elt_print(y, 16, true, k, STACK_1); printf("\n");
72 
73  /* Addition */
74 
75  field_elt_inc(res, x, k);
76  printf("x+1 = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
77 
78  field_elt_add(res, x, y, k);
79  printf("x+y = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
80 
81  /* Substraction */
82 
83  field_elt_dec(res, x, k);
84  printf("x-1 = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
85 
86  field_elt_sub(res, x, y, k);
87  printf("x-y = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
88 
89  /* Multiplication */
90 
91  field_elt_mul(res, x, y, k, STACK_1);
92  printf("x*y = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
93 
94  field_elt_sqr(res, x, k, STACK_1);
95  printf("x^2 = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
96 
97  /* Division */
98 
99  field_elt_div(res, x, y, k, STACK_1);
100  printf("x/y = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
101 
102  /* Power */
103 
104  field_elt_pow_ui(res, x, 3, k, STACK_1);
105  printf("x^3 = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
106  printf("Res is a power of 3 : %d\n", field_elt_ispower_ui(res, 3, k, STACK_1)>0);
107 
108  number n; number_init(&n, bits_to_nblock(192)); number_set_str(n, "f14b8dbafa22b6ba35626d40d2d00001381bef07d2c3015", 16);
109  field_elt_pow_number(res, x, n, k, STACK_1);
110  printf("x^n = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
111  printf("Res is a power of n : %d\n", field_elt_ispower_number(res, n, k, STACK_1)>0);
112  number_free(&n);
113 
114  /* Inverse */
115 
116  field_elt_inv(res, x, k, STACK_1);
117  printf("x^(-1) = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
118 
119  /* Roots */
120 
121  field_elt_sqrt(res, x, k, STACK_1);
122  printf("x is square : %d\n", field_elt_issquare(x, k, STACK_1)>0);
123  printf("x^(1/2) = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
124 
125  field_elt_cube_root(res, x, k, STACK_1);
126  printf("x is a power of 3 : %d\n", field_elt_ispower_ui(x, 3, k, STACK_1)>0);
127  printf("x^(1/3) = "); field_elt_print(res, 16, true, k, STACK_1); printf("\n");
128 
129  /* Free allocated memory */
130 
131  field_elt_free(&x, k);
132  field_elt_free(&y, k);
133  field_elt_free(&res, k);
134  number_free(&p);
135  field_free(k);
136 
137  free_mphell();
138 
139  return 0;
140 }
fp_elt * field_elt
Generic field element.
Definition: mphell-field.h:39
void free_mphell()
Free MPHELL memory, especially the big amount of temporary memory.
Definition: mphell-init.c:97
void field_elt_free(fe_ptr *src, field_srcptr k)
Free space used by src.
Definition: mphell-field.c:356
static void field_elt_mul(fe_ptr dst, fe_srcptr src1, fe_srcptr src2, field_srcptr k, uint8_t stack)
Set dst <- src1 * src2, if Montgomery arithmetic is used, the Montgomery multiplication will be used ...
Definition: mphell-field.h:753
void init_mphell(const uint16_t security_strength, const random_type type, const entropy_type entropy)
Initialise MPHELL with security_strength bits of security (for random number only).
Definition: mphell-init.c:35
static void field_elt_inc(fe_ptr dst, fe_srcptr src, field_srcptr k)
Set dst <- src + 1.
Definition: mphell-field.h:535
uint8_t bits_to_nblock(const uint16_t nbits)
Return the number of blocks required to store a nbits number.
Definition: mphell-util.c:29
void field_elt_sqrt(fe_ptr dst, fe_srcptr src, field_srcptr k, uint8_t stack)
Set dst <- src^(1/2)
void field_elt_alloc(fe_ptr *dst, field_srcptr k)
Allocate space for a field element.
Definition: mphell-field.c:277
field_t field[1]
Address of a field structure.
Definition: mphell-field.h:110
void field_elt_div(fe_ptr dst, fe_srcptr src1, fe_srcptr src2, field_srcptr k, uint8_t stack)
Set dst <- src1 / src2.
void field_elt_cube_root(fe_ptr dst, fe_srcptr src, field_srcptr k, uint8_t stack)
Set dst <- src^(1/3)
void number_free(number *dst)
Free a number_ptr allocated on the RAM memory (malloc)
Definition: mphell-number.c:75
void field_create(field_ptr k, const char *id, uint8_t stack, const uint32_t n,...)
Initialize the different fields of the structure pointed by k.
Definition: mphell-field.c:76
bool field_elt_issquare(fe_srcptr src, field_srcptr k, uint8_t stack)
Test if src is a square using the Lengendre symbol.
Definition: mphell-field.c:921
int8_t field_elt_ispower_ui(fe_srcptr src, const block n, field_srcptr k, uint8_t stack)
Test if src is a n-power in src->k.
Definition: mphell-field.c:940
void field_alloc(field_ptr k, const field_type type, const uint8_t size, field_ptr base)
Allocates space for the different fields of the structure pointed by k.
Definition: mphell-field.c:37
void field_elt_inv(fe_ptr dst, fe_srcptr src, field_srcptr k, uint8_t stack)
Set dst <- src^(-1)
void field_elt_init(fe_ptr dst, field_srcptr k)
Initialise the field element.
Definition: mphell-field.c:299
void field_elt_pow_number(fe_ptr dst, fe_srcptr src, number_srcptr n, field_srcptr k, uint8_t stack)
Set dst <- src^n.
Definition: mphell-field.c:902
void number_set_str(number_ptr dst, const char *str, const uint8_t base)
Set dst to str.
void number_init(number *dst, const uint8_t n)
Allocate a number_ptr on the RAM memory (malloc)
Definition: mphell-number.c:59
void field_elt_print(fe_srcptr src, const uint8_t base, const bool lift, field_srcptr k, uint8_t stack)
Print src in base specified by base.
Definition: mphell-field.c:721
void field_elt_pow_ui(fe_ptr dst, fe_srcptr src, const block n, field_srcptr k, uint8_t stack)
Set dst <- src^n.
Definition: mphell-field.c:883
void field_free(field_ptr k)
Free the space of the field informations structure.
Definition: mphell-field.c:183
void field_elt_set_str(fe_ptr dst, const char *str, const uint8_t base, const bool isreduced, field_srcptr k, uint8_t stack)
Set dst to str, if Montgomery arithmetic is used, is_reduced == false -> transform dst into its Montg...
Definition: mphell-field.c:505
static void field_elt_sqr(fe_ptr dst, fe_srcptr src, field_srcptr k, uint8_t stack)
Set dst <- src^2.
Definition: mphell-field.h:913
static void field_elt_sub(fe_ptr dst, fe_srcptr src1, fe_srcptr src2, field_srcptr k)
Set dst <- src1 - src2.
Definition: mphell-field.h:642
static void field_elt_dec(fe_ptr dst, fe_srcptr src, field_srcptr k)
Set dst <- src - 1.
Definition: mphell-field.h:615
static void field_elt_add(fe_ptr dst, fe_srcptr src1, fe_srcptr src2, field_srcptr k)
Set dst <- src1 + src2.
Definition: mphell-field.h:562
int8_t field_elt_ispower_number(fe_srcptr src, number_srcptr n, field_srcptr k, uint8_t stack)
Test if src is a n-power in src->k.
Definition: mphell-field.c:961