keydb.h revision 119643 
1/*	$FreeBSD: head/sys/netipsec/keydb.h 119643 2003-09-01 05:35:55Z sam $	*/
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 */
43union 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 */
51struct 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 */
61struct 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
78struct xformsw;
79struct enc_xform;
80struct auth_hash;
81struct comp_algo;
82
83/* Security Association */
84struct 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	long 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/* replay prevention */
129struct secreplay {
130	u_int32_t count;
131	u_int wsize;		/* window size, i.g. 4 bytes */
132	u_int32_t seq;		/* used by sender */
133	u_int32_t lastseq;	/* used by receiver */
134	caddr_t bitmap;		/* used by receiver */
135	int overflow;		/* overflow flag */
136};
137
138/* socket table due to send PF_KEY messages. */
139struct secreg {
140	LIST_ENTRY(secreg) chain;
141
142	struct socket *so;
143};
144
145#ifndef IPSEC_NONBLOCK_ACQUIRE
146/* acquiring list table. */
147struct secacq {
148	LIST_ENTRY(secacq) chain;
149
150	struct secasindex saidx;
151
152	u_int32_t seq;		/* sequence number */
153	long created;		/* for lifetime */
154	int count;		/* for lifetime */
155};
156#endif
157
158/* Sensitivity Level Specification */
159/* nothing */
160
161#define SADB_KILL_INTERVAL	600	/* six seconds */
162
163/* secpolicy */
164extern struct secpolicy *keydb_newsecpolicy __P((void));
165extern void keydb_delsecpolicy __P((struct secpolicy *));
166/* secashead */
167extern struct secashead *keydb_newsecashead __P((void));
168extern void keydb_delsecashead __P((struct secashead *));
169/* secasvar */
170extern struct secasvar *keydb_newsecasvar __P((void));
171extern void keydb_refsecasvar __P((struct secasvar *));
172extern void keydb_freesecasvar __P((struct secasvar *));
173/* secreplay */
174extern struct secreplay *keydb_newsecreplay __P((size_t));
175extern void keydb_delsecreplay __P((struct secreplay *));
176/* secreg */
177extern struct secreg *keydb_newsecreg __P((void));
178extern void keydb_delsecreg __P((struct secreg *));
179
180#endif /* _KERNEL */
181
182#endif /* _NETIPSEC_KEYDB_H_ */
183