summaryrefslogtreecommitdiffstats
path: root/moon-abe/pbc-0.5.14/doc/paramfns.txt
blob: 74b1abff45e3f79b23742a9f5a3df5232d948be4 (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
[[paramchap]]
== Param functions ==

Pairings are initialized from _pairing parameters_, which are objects of type
`pbc_param_t`. Some applications can ignore this data type because
`pairing_init_set_str()` handles it behind the scenes: it reads a string as a
`pbc_param_t`, then initializes a pairing with these parameters.

include::gen/param.txt[]

[[paramgenchap]]
=== Param generation ===

These were used to prepare the sample parameters in the +param+ subdirectory.

We label the pairing families with capital letters roughly in the order of
discovery, so we can refer to them easily. Type A is fastest. Type D is a good
choice when elements should be short but is slower. Type F has even shorter
elements but is slower still. The speed differences are hardware-dependent, and
also change when preprocessing is used. Type B and C are unimplemented.

The +pbc_cm_t+ data type holds CM parameters that are used to generate type D
and G curves.

include::gen/cminfo.txt[]

include::gen/aparam.txt[]

include::gen/a1param.txt[]

include::gen/dparam.txt[]

include::gen/eparam.txt[]

include::gen/fparam.txt[]

include::gen/gparam.txt[]