2 /* $KAME: keydb.h,v 1.14 2000/08/02 17:58:26 sakane Exp $ */
5 * SPDX-License-Identifier: BSD-3-Clause
7 * Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. Neither the name of the project nor the names of its contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 #ifndef _NETIPSEC_KEYDB_H_
36 #define _NETIPSEC_KEYDB_H_
39 #include <sys/counter.h>
41 #include <sys/mutex.h>
43 #include <netipsec/key_var.h>
44 #include <opencrypto/_cryptodev.h>
46 #ifndef _SOCKADDR_UNION_DEFINED
47 #define _SOCKADDR_UNION_DEFINED
49 * The union of all possible address formats we handle.
51 union sockaddr_union {
53 struct sockaddr_in sin;
54 struct sockaddr_in6 sin6;
56 #endif /* _SOCKADDR_UNION_DEFINED */
58 /* Security Assocciation Index */
59 /* NOTE: Ensure to be same address family */
61 union sockaddr_union src; /* source address for SA */
62 union sockaddr_union dst; /* destination address for SA */
63 uint8_t proto; /* IPPROTO_ESP or IPPROTO_AH */
64 uint8_t mode; /* mode of protocol, see ipsec.h */
65 uint32_t reqid; /* reqid id who owned this SA */
66 /* see IPSEC_MANUAL_REQID_MAX. */
70 * In order to split out the keydb implementation from that of the
71 * PF_KEY sockets we need to define a few structures that while they
72 * may seem common are likely to diverge over time.
88 u_int32_t allocations;
95 union sockaddr_union oai; /* original addresses of initiator */
96 union sockaddr_union oar; /* original address of responder */
97 uint16_t sport; /* source port */
98 uint16_t dport; /* destination port */
99 uint16_t cksum; /* checksum delta */
101 #define IPSEC_NATT_F_OAI 0x0001
102 #define IPSEC_NATT_F_OAR 0x0002
105 /* Security Association Data Base */
106 TAILQ_HEAD(secasvar_queue, secasvar);
108 TAILQ_ENTRY(secashead) chain;
109 LIST_ENTRY(secashead) addrhash; /* hash by sproto+src+dst addresses */
110 LIST_ENTRY(secashead) drainq; /* used ONLY by flush callout */
112 struct secasindex saidx;
114 struct secident *idents; /* source identity */
115 struct secident *identd; /* destination identity */
116 /* XXX I don't know how to use them. */
118 volatile u_int refcnt; /* reference count */
119 uint8_t state; /* MATURE or DEAD. */
120 struct secasvar_queue savtree_alive; /* MATURE and DYING SA */
121 struct secasvar_queue savtree_larval; /* LARVAL SA */
130 * Security Association
132 * For INBOUND packets we do SA lookup using SPI, thus only SPIHASH is used.
133 * For OUTBOUND packets there may be several SA suitable for packet.
134 * We use key_preferred_oldsa variable to choose better SA. First of we do
135 * lookup for suitable SAH using packet's saidx. Then we use SAH's savtree
136 * to search better candidate. The newer SA (by created time) are placed
137 * in the beginning of the savtree list. There is no preference between
140 * NB: Fields with a tdb_ prefix are part of the "glue" used
141 * to interface to the OpenBSD crypto support. This was done
142 * to distinguish this code from the mainline KAME code.
143 * NB: Fields are sorted on the basis of the frequency of changes, i.e.
144 * constants and unchangeable fields are going first.
145 * NB: if you want to change this structure, check that this will not break
146 * key_updateaddresses().
149 uint32_t spi; /* SPI Value, network byte order */
150 uint32_t flags; /* holder for SADB_KEY_FLAGS */
151 uint32_t seq; /* sequence number */
152 pid_t pid; /* message's pid */
153 u_int ivlen; /* length of IV */
155 struct secashead *sah; /* back pointer to the secashead */
156 struct seckey *key_auth; /* Key for Authentication */
157 struct seckey *key_enc; /* Key for Encryption */
158 struct secreplay *replay; /* replay prevention */
159 struct secnatt *natt; /* NAT-T config */
160 struct mtx *lock; /* update/access lock */
162 const struct xformsw *tdb_xform; /* transform */
163 const struct enc_xform *tdb_encalgxform;/* encoding algorithm */
164 const struct auth_hash *tdb_authalgxform;/* authentication algorithm */
165 const struct comp_algo *tdb_compalgxform;/* compression algorithm */
166 crypto_session_t tdb_cryptoid; /* crypto session */
168 uint8_t alg_auth; /* Authentication Algorithm Identifier*/
169 uint8_t alg_enc; /* Cipher Algorithm Identifier */
170 uint8_t alg_comp; /* Compression Algorithm Identifier */
171 uint8_t state; /* Status of this SA (pfkeyv2.h) */
173 counter_u64_t lft_c; /* CURRENT lifetime */
174 #define lft_c_allocations lft_c
175 #define lft_c_bytes lft_c + 1
176 struct seclifetime *lft_h; /* HARD lifetime */
177 struct seclifetime *lft_s; /* SOFT lifetime */
179 uint64_t created; /* time when SA was created */
180 uint64_t firstused; /* time when SA was first used */
182 TAILQ_ENTRY(secasvar) chain;
183 LIST_ENTRY(secasvar) spihash;
184 LIST_ENTRY(secasvar) drainq; /* used ONLY by flush callout */
186 uint64_t cntr; /* counter for GCM and CTR */
187 volatile u_int refcnt; /* reference count */
190 #define SECASVAR_LOCK(_sav) mtx_lock((_sav)->lock)
191 #define SECASVAR_UNLOCK(_sav) mtx_unlock((_sav)->lock)
192 #define SECASVAR_LOCK_ASSERT(_sav) mtx_assert((_sav)->lock, MA_OWNED)
193 #define SAV_ISGCM(_sav) \
194 ((_sav)->alg_enc == SADB_X_EALG_AESGCM8 || \
195 (_sav)->alg_enc == SADB_X_EALG_AESGCM12 || \
196 (_sav)->alg_enc == SADB_X_EALG_AESGCM16)
197 #define SAV_ISCTR(_sav) ((_sav)->alg_enc == SADB_X_EALG_AESCTR)
198 #define SAV_ISCTRORGCM(_sav) (SAV_ISCTR((_sav)) || SAV_ISGCM((_sav)))
200 /* Replay prevention, protected by SECASVAR_LOCK:
202 * (c) read only except during creation / free
205 u_int32_t count; /* (m) */
206 u_int wsize; /* (c) window size, i.g. 4 bytes */
207 u_int32_t seq; /* (m) used by sender */
208 u_int32_t lastseq; /* (m) used by receiver */
209 u_int32_t *bitmap; /* (m) used by receiver */
210 u_int bitmap_size; /* (c) size of the bitmap array */
211 int overflow; /* (m) overflow flag */
214 /* socket table due to send PF_KEY messages. */
216 LIST_ENTRY(secreg) chain;
221 /* acquiring list table. */
223 LIST_ENTRY(secacq) chain;
224 LIST_ENTRY(secacq) addrhash;
225 LIST_ENTRY(secacq) seqhash;
227 struct secasindex saidx;
228 uint32_t seq; /* sequence number */
229 time_t created; /* for lifetime */
230 int count; /* for lifetime */
235 #endif /* _NETIPSEC_KEYDB_H_ */