aboutsummaryrefslogtreecommitdiff
path: root/src/util/random.h
blob: 21d32deab3de458f5ffd654b31fa669ae66254d3 (plain)
1
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
/*
 * ecgen, tool for generating Elliptic curve domain parameters
 * Copyright (C) 2017-2018 J08nY
 */
/**
 * @file random.h
 */
#ifndef ECGEN_UTIL_RANDOM_H
#define ECGEN_UTIL_RANDOM_H

#include <pari/pari.h>
#include <stdbool.h>

/**
 * @brief Init the PARI-GP random generator.
 *
 * Initializes the PARI-GP random generator, tries to do so from
 * cryptographically strong sources(/dev/urandom) at first but falls back on
 * clock_gettime and time(NULL).
 *
 * @return whether the initialization was successful
 */
bool random_init(void);

/**
 * @brief Generate random <code>bits</code> sized prime.
 * @param bits the size of the prime to generate
 * @return a random prime in range [2^(bits - 1), 2^bits]
 */
GEN random_prime(unsigned long bits);

/**
 * @brief
 * @param lower
 * @param upper
 * @return
 */
GEN random_range(GEN lower, GEN upper);

/**
 * @brief Generate random <code>bits</code> sized integer.
 * @param bits the size of the integer to generate
 * @return a random integer in range [2^(bits - 1), 2^bits]
 */
GEN random_int(unsigned long bits);

/**
 * @brief
 * @param field
 * @return
 */
GEN random_field_element(GEN field);

#endif  // ECGEN_UTIL_RANDOM_H