1 /* $OpenBSD: math_group.h,v 1.10 2004/04/15 18:39:26 deraadt Exp $	 */
2 /* $EOM: math_group.h,v 1.7 1999/04/17 23:20:40 niklas Exp $	 */
3 
4 /*
5  * Copyright (c) 1998 Niels Provos.  All rights reserved.
6  * Copyright (c) 1999 Niklas Hallqvist.  All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 /*
30  * This code was written under funding by Ericsson Radio Systems.
31  */
32 
33 #ifndef _MATH_GROUP_H_
34 #define _MATH_GROUP_H_
35 
36 enum groups {
37 	MODP,			/* F_p, Z modulo a prime */
38 	EC2N,			/* Elliptic Curve over the Field GF(2**N) */
39 	ECP,			/* Elliptic Curve over the Field Z_p */
40 	NOTYET			/* Not yet assigned */
41 };
42 
43 /*
44  * The group on which diffie hellmann calculations are done.
45  */
46 
47 struct group {
48 	enum groups     type;
49 	int             id;	/* Group ID */
50 	int             bits;	/* Number of key bits provided by this group */
51 	void           *group;
52 	void           *a, *b, *c, *d;
53 	void           *gen;	/* Group Generator */
54 	int             (*getlen) (struct group *);
55 	void            (*getraw) (struct group *, void *, u_int8_t *);
56 	int             (*setraw) (struct group *, void *, u_int8_t *, int);
57 	int             (*setrandom) (struct group *, void *);
58 	int             (*operation) (struct group *, void *, void *, void *);
59 };
60 
61 /* Description of an Elliptic Group over GF(2**n) for Boot-Strapping */
62 
63 struct ec2n_dscr {
64 	int             id;
65 	int             bits;	/* Key Bits provided by this group */
66 	char           *polynomial;	/* Irreduceable polynomial */
67 	char           *gen_x;	/* X - Coord. of Generator */
68 	char           *a, *b;	/* Curve Parameters */
69 };
70 
71 /* Description of F_p for Boot-Strapping */
72 
73 struct modp_dscr {
74 	int             id;
75 	int             bits;	/* Key Bits provided by this group */
76 	char           *prime;	/* Prime */
77 	char           *gen;	/* Generator */
78 };
79 
80 /* Prototypes */
81 
82 void            group_init(void);
83 void            group_free(struct group *);
84 struct group   *group_get(u_int32_t);
85 
86 void            ec2n_free(struct group *);
87 struct group   *ec2n_clone(struct group *, struct group *);
88 void            ec2n_init(struct group *);
89 
90 void            modp_free(struct group *);
91 struct group   *modp_clone(struct group *, struct group *);
92 void            modp_init(struct group *);
93 
94 #endif				/* _MATH_GROUP_H_ */
95