xref: /freebsd/sys/netipsec/keydb.h (revision 6b3455a7665208c366849f0b2b3bc916fb97516e)
1 /*	$FreeBSD$	*/
2 /*	$KAME: keydb.h,v 1.14 2000/08/02 17:58:26 sakane Exp $	*/
3 
4 /*
5  * Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
6  * 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  * 3. Neither the name of the project nor the names of its contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  */
32 
33 #ifndef _NETIPSEC_KEYDB_H_
34 #define _NETIPSEC_KEYDB_H_
35 
36 #ifdef _KERNEL
37 
38 #include <netipsec/key_var.h>
39 
40 /*
41  * The union of all possible address formats we handle.
42  */
43 union sockaddr_union {
44 	struct sockaddr		sa;
45 	struct sockaddr_in	sin;
46 	struct sockaddr_in6	sin6;
47 };
48 
49 /* Security Assocciation Index */
50 /* NOTE: Ensure to be same address family */
51 struct secasindex {
52 	union sockaddr_union src;	/* srouce address for SA */
53 	union sockaddr_union dst;	/* destination address for SA */
54 	u_int16_t proto;		/* IPPROTO_ESP or IPPROTO_AH */
55 	u_int8_t mode;			/* mode of protocol, see ipsec.h */
56 	u_int32_t reqid;		/* reqid id who owned this SA */
57 					/* see IPSEC_MANUAL_REQID_MAX. */
58 };
59 
60 /* Security Association Data Base */
61 struct secashead {
62 	LIST_ENTRY(secashead) chain;
63 
64 	struct secasindex saidx;
65 
66 	struct sadb_ident *idents;	/* source identity */
67 	struct sadb_ident *identd;	/* destination identity */
68 					/* XXX I don't know how to use them. */
69 
70 	u_int8_t state;			/* MATURE or DEAD. */
71 	LIST_HEAD(_satree, secasvar) savtree[SADB_SASTATE_MAX+1];
72 					/* SA chain */
73 					/* The first of this list is newer SA */
74 
75 	struct route sa_route;		/* route cache */
76 };
77 
78 struct xformsw;
79 struct enc_xform;
80 struct auth_hash;
81 struct comp_algo;
82 
83 /* Security Association */
84 struct secasvar {
85 	LIST_ENTRY(secasvar) chain;
86 	struct mtx lock;		/* update/access lock */
87 
88 	u_int refcnt;			/* reference count */
89 	u_int8_t state;			/* Status of this Association */
90 
91 	u_int8_t alg_auth;		/* Authentication Algorithm Identifier*/
92 	u_int8_t alg_enc;		/* Cipher Algorithm Identifier */
93 	u_int8_t alg_comp;		/* Compression Algorithm Identifier */
94 	u_int32_t spi;			/* SPI Value, network byte order */
95 	u_int32_t flags;		/* holder for SADB_KEY_FLAGS */
96 
97 	struct sadb_key *key_auth;	/* Key for Authentication */
98 	struct sadb_key *key_enc;	/* Key for Encryption */
99 	caddr_t iv;			/* Initilization Vector */
100 	u_int ivlen;			/* length of IV */
101 	void *sched;			/* intermediate encryption key */
102 	size_t schedlen;
103 
104 	struct secreplay *replay;	/* replay prevention */
105 	time_t created;			/* for lifetime */
106 
107 	struct sadb_lifetime *lft_c;	/* CURRENT lifetime, it's constant. */
108 	struct sadb_lifetime *lft_h;	/* HARD lifetime */
109 	struct sadb_lifetime *lft_s;	/* SOFT lifetime */
110 
111 	u_int32_t seq;			/* sequence number */
112 	pid_t pid;			/* message's pid */
113 
114 	struct secashead *sah;		/* back pointer to the secashead */
115 
116 	/*
117 	 * NB: Fields with a tdb_ prefix are part of the "glue" used
118 	 *     to interface to the OpenBSD crypto support.  This was done
119 	 *     to distinguish this code from the mainline KAME code.
120 	 */
121 	struct xformsw *tdb_xform;	/* transform */
122 	struct enc_xform *tdb_encalgxform;	/* encoding algorithm */
123 	struct auth_hash *tdb_authalgxform;	/* authentication algorithm */
124 	struct comp_algo *tdb_compalgxform;	/* compression algorithm */
125 	u_int64_t tdb_cryptoid;		/* crypto session id */
126 };
127 
128 #define	SECASVAR_LOCK_INIT(_sav) \
129 	mtx_init(&(_sav)->lock, "ipsec association", NULL, MTX_DEF)
130 #define	SECASVAR_LOCK(_sav)		mtx_lock(&(_sav)->lock)
131 #define	SECASVAR_UNLOCK(_sav)		mtx_unlock(&(_sav)->lock)
132 #define	SECASVAR_LOCK_DESTROY(_sav)	mtx_destroy(&(_sav)->lock)
133 #define	SECASVAR_LOCK_ASSERT(_sav)	mtx_assert(&(_sav)->lock, MA_OWNED)
134 
135 /* replay prevention */
136 struct secreplay {
137 	u_int32_t count;
138 	u_int wsize;		/* window size, i.g. 4 bytes */
139 	u_int32_t seq;		/* used by sender */
140 	u_int32_t lastseq;	/* used by receiver */
141 	caddr_t bitmap;		/* used by receiver */
142 	int overflow;		/* overflow flag */
143 };
144 
145 /* socket table due to send PF_KEY messages. */
146 struct secreg {
147 	LIST_ENTRY(secreg) chain;
148 
149 	struct socket *so;
150 };
151 
152 /* acquiring list table. */
153 struct secacq {
154 	LIST_ENTRY(secacq) chain;
155 
156 	struct secasindex saidx;
157 
158 	u_int32_t seq;		/* sequence number */
159 	time_t created;		/* for lifetime */
160 	int count;		/* for lifetime */
161 };
162 
163 /* Sensitivity Level Specification */
164 /* nothing */
165 
166 #define SADB_KILL_INTERVAL	600	/* six seconds */
167 
168 /* secpolicy */
169 extern struct secpolicy *keydb_newsecpolicy __P((void));
170 extern void keydb_delsecpolicy __P((struct secpolicy *));
171 /* secashead */
172 extern struct secashead *keydb_newsecashead __P((void));
173 extern void keydb_delsecashead __P((struct secashead *));
174 /* secasvar */
175 extern struct secasvar *keydb_newsecasvar __P((void));
176 extern void keydb_refsecasvar __P((struct secasvar *));
177 extern void keydb_freesecasvar __P((struct secasvar *));
178 /* secreplay */
179 extern struct secreplay *keydb_newsecreplay __P((size_t));
180 extern void keydb_delsecreplay __P((struct secreplay *));
181 /* secreg */
182 extern struct secreg *keydb_newsecreg __P((void));
183 extern void keydb_delsecreg __P((struct secreg *));
184 
185 #endif /* _KERNEL */
186 
187 #endif /* _NETIPSEC_KEYDB_H_ */
188