xref: /illumos-gate/usr/src/uts/common/net/pfkeyv2.h (revision 635216b673cf196ac523ff2a7ab715717e553292)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 /*
22  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
23  * Use is subject to license terms.
24  */
25 
26 #ifndef	_NET_PFKEYV2_H
27 #define	_NET_PFKEYV2_H
28 
29 /*
30  * Definitions and structures for PF_KEY version 2.  See RFC 2367 for
31  * more details.  SA == Security Association, which is what PF_KEY provides
32  * an API for managing.
33  */
34 
35 #ifdef	__cplusplus
36 extern "C" {
37 #endif
38 
39 #define	PF_KEY_V2		2
40 #define	PFKEYV2_REVISION	200109L
41 
42 /*
43  * Base PF_KEY message.
44  */
45 
46 typedef struct sadb_msg {
47 	uint8_t sadb_msg_version;	/* Version, currently PF_KEY_V2 */
48 	uint8_t sadb_msg_type;		/* ADD, UPDATE, etc. */
49 	uint8_t sadb_msg_errno;		/* Error number from UNIX errno space */
50 	uint8_t sadb_msg_satype;	/* ESP, AH, etc. */
51 	uint16_t sadb_msg_len;		/* Length in 64-bit words. */
52 	uint16_t sadb_msg_reserved;	/* must be zero */
53 /*
54  * Use the reserved field for extended diagnostic information on errno
55  * responses.
56  */
57 #define	sadb_x_msg_diagnostic sadb_msg_reserved
58 	/* Union is for guaranteeing 64-bit alignment. */
59 	union {
60 		struct {
61 			uint32_t sadb_x_msg_useq;	/* Set by originator */
62 			uint32_t sadb_x_msg_upid;	/* Set by originator */
63 		} sadb_x_msg_actual;
64 		uint64_t sadb_x_msg_alignment;
65 	} sadb_x_msg_u;
66 #define	sadb_msg_seq sadb_x_msg_u.sadb_x_msg_actual.sadb_x_msg_useq
67 #define	sadb_msg_pid sadb_x_msg_u.sadb_x_msg_actual.sadb_x_msg_upid
68 } sadb_msg_t;
69 
70 /*
71  * Generic extension header.
72  */
73 
74 typedef struct sadb_ext {
75 	union {
76 		/* Union is for guaranteeing 64-bit alignment. */
77 		struct {
78 			uint16_t sadb_x_ext_ulen;	/* In 64s, inclusive */
79 			uint16_t sadb_x_ext_utype;	/* 0 is reserved */
80 		} sadb_x_ext_actual;
81 		uint64_t sadb_x_ext_alignment;
82 	} sadb_x_ext_u;
83 #define	sadb_ext_len sadb_x_ext_u.sadb_x_ext_actual.sadb_x_ext_ulen
84 #define	sadb_ext_type sadb_x_ext_u.sadb_x_ext_actual.sadb_x_ext_utype
85 } sadb_ext_t;
86 
87 /*
88  * Security Association information extension.
89  */
90 
91 typedef struct sadb_sa {
92 	/* Union is for guaranteeing 64-bit alignment. */
93 	union {
94 		struct {
95 			uint16_t sadb_x_sa_ulen;
96 			uint16_t sadb_x_sa_uexttype;	/* ASSOCIATION */
97 			uint32_t sadb_x_sa_uspi;	/* Sec. Param. Index */
98 		} sadb_x_sa_uactual;
99 		uint64_t sadb_x_sa_alignment;
100 	} sadb_x_sa_u;
101 #define	sadb_sa_len sadb_x_sa_u.sadb_x_sa_uactual.sadb_x_sa_ulen
102 #define	sadb_sa_exttype sadb_x_sa_u.sadb_x_sa_uactual.sadb_x_sa_uexttype
103 #define	sadb_sa_spi sadb_x_sa_u.sadb_x_sa_uactual.sadb_x_sa_uspi
104 	uint8_t sadb_sa_replay;		/* Replay counter */
105 	uint8_t sadb_sa_state;		/* MATURE, DEAD, DYING, LARVAL */
106 	uint8_t sadb_sa_auth;		/* Authentication algorithm */
107 	uint8_t sadb_sa_encrypt;	/* Encryption algorithm */
108 	uint32_t sadb_sa_flags;		/* SA flags. */
109 } sadb_sa_t;
110 
111 /*
112  * SA Lifetime extension.  Already 64-bit aligned thanks to uint64_t fields.
113  */
114 
115 typedef struct sadb_lifetime {
116 	uint16_t sadb_lifetime_len;
117 	uint16_t sadb_lifetime_exttype;		/* SOFT, HARD, CURRENT */
118 	uint32_t sadb_lifetime_allocations;
119 	uint64_t sadb_lifetime_bytes;
120 	uint64_t sadb_lifetime_addtime;	/* These fields are assumed to hold */
121 	uint64_t sadb_lifetime_usetime;	/* >= sizeof (time_t). */
122 } sadb_lifetime_t;
123 
124 /*
125  * SA address information.
126  */
127 
128 typedef struct sadb_address {
129 	/* Union is for guaranteeing 64-bit alignment. */
130 	union {
131 		struct {
132 			uint16_t sadb_x_address_ulen;
133 			uint16_t sadb_x_address_uexttype; /* SRC, DST, PROXY */
134 			uint8_t sadb_x_address_uproto; /* Proto for ports... */
135 			uint8_t sadb_x_address_uprefixlen; /* Prefix length. */
136 			uint16_t sadb_x_address_ureserved; /* Padding */
137 		} sadb_x_address_actual;
138 		uint64_t sadb_x_address_alignment;
139 	} sadb_x_address_u;
140 #define	sadb_address_len \
141 	sadb_x_address_u.sadb_x_address_actual.sadb_x_address_ulen
142 #define	sadb_address_exttype \
143 	sadb_x_address_u.sadb_x_address_actual.sadb_x_address_uexttype
144 #define	sadb_address_proto \
145 	sadb_x_address_u.sadb_x_address_actual.sadb_x_address_uproto
146 #define	sadb_address_prefixlen \
147 	sadb_x_address_u.sadb_x_address_actual.sadb_x_address_uprefixlen
148 #define	sadb_address_reserved \
149 	sadb_x_address_u.sadb_x_address_actual.sadb_x_address_ureserved
150 	/* Followed by a sockaddr structure which may contain ports. */
151 } sadb_address_t;
152 
153 /*
154  * SA key information.
155  */
156 
157 typedef struct sadb_key {
158 	/* Union is for guaranteeing 64-bit alignment. */
159 	union {
160 		struct {
161 			uint16_t sadb_x_key_ulen;
162 			uint16_t sadb_x_key_uexttype;	/* AUTH, ENCRYPT */
163 			uint16_t sadb_x_key_ubits;	/* Actual len (bits) */
164 			uint16_t sadb_x_key_ureserved;
165 		} sadb_x_key_actual;
166 		uint64_t sadb_x_key_alignment;
167 	} sadb_x_key_u;
168 #define	sadb_key_len sadb_x_key_u.sadb_x_key_actual.sadb_x_key_ulen
169 #define	sadb_key_exttype sadb_x_key_u.sadb_x_key_actual.sadb_x_key_uexttype
170 #define	sadb_key_bits sadb_x_key_u.sadb_x_key_actual.sadb_x_key_ubits
171 #define	sadb_key_reserved sadb_x_key_u.sadb_x_key_actual.sadb_x_key_ureserved
172 	/* Followed by actual key(s) in canonical (outbound proc.) order. */
173 } sadb_key_t;
174 
175 /*
176  * SA Identity information.  Already 64-bit aligned thanks to uint64_t fields.
177  */
178 
179 typedef struct sadb_ident {
180 	uint16_t sadb_ident_len;
181 	uint16_t sadb_ident_exttype;	/* SRC, DST, PROXY */
182 	uint16_t sadb_ident_type;	/* FQDN, USER_FQDN, etc. */
183 	uint16_t sadb_ident_reserved;	/* Padding */
184 	uint64_t sadb_ident_id;		/* For userid, etc. */
185 	/* Followed by an identity null-terminate C string if present. */
186 } sadb_ident_t;
187 
188 /*
189  * SA sensitivity information.  This is mostly useful on MLS systems.
190  */
191 
192 typedef struct sadb_sens {
193 	/* Union is for guaranteeing 64-bit alignment. */
194 	union {
195 		struct {
196 			uint16_t sadb_x_sens_ulen;
197 			uint16_t sadb_x_sens_uexttype;	/* SENSITIVITY */
198 			uint32_t sadb_x_sens_udpd;	/* Protection domain */
199 		} sadb_x_sens_actual;
200 		uint64_t sadb_x_sens_alignment;
201 	} sadb_x_sens_u;
202 #define	sadb_sens_len sadb_x_sens_u.sadb_x_sens_actual.sadb_x_sens_ulen
203 #define	sadb_sens_exttype sadb_x_sens_u.sadb_x_sens_actual.sadb_x_sens_uexttype
204 #define	sadb_sens_dpd sadb_x_sens_u.sadb_x_sens_actual.sadb_x_sens_udpd
205 	uint8_t sadb_sens_sens_level;
206 	uint8_t sadb_sens_sens_len;		/* 64-bit words */
207 	uint8_t sadb_sens_integ_level;
208 	uint8_t sadb_sens_integ_len;		/* 64-bit words */
209 	uint32_t sadb_sens_reserved;
210 	/*
211 	 * followed by two uint64_t arrays
212 	 * uint64_t sadb_sens_bitmap[sens_bitmap_len];
213 	 * uint64_t sadb_integ_bitmap[integ_bitmap_len];
214 	 */
215 } sadb_sens_t;
216 
217 /*
218  * A proposal extension.  This is found in an ACQUIRE message, and it
219  * proposes what sort of SA the kernel would like to ACQUIRE.
220  */
221 
222 /* First, a base structure... */
223 
224 typedef struct sadb_x_propbase {
225 	uint16_t sadb_x_propb_len;
226 	uint16_t sadb_x_propb_exttype;	/* PROPOSAL, X_EPROP */
227 	union {
228 		struct {
229 			uint8_t sadb_x_propb_lenres_replay;
230 			uint8_t sadb_x_propb_lenres_eres;
231 			uint16_t sadb_x_propb_lenres_numecombs;
232 		} sadb_x_propb_lenres;
233 		struct {
234 			uint8_t sadb_x_propb_oldres_replay;
235 			uint8_t sadb_x_propb_oldres_reserved[3];
236 		} sadb_x_propb_oldres;
237 	} sadb_x_propb_u;
238 #define	sadb_x_propb_replay \
239 	sadb_x_propb_u.sadb_x_propb_lenres.sadb_x_propb_lenres_replay
240 #define	sadb_x_propb_reserved \
241 	sadb_x_propb_u.sadb_x_propb_oldres.sadb_x_propb_oldres_reserved
242 #define	sadb_x_propb_ereserved \
243 	sadb_x_propb_u.sadb_x_propb_lenres.sadb_x_propb_lenres_eres
244 #define	sadb_x_propb_numecombs \
245 	sadb_x_propb_u.sadb_x_propb_lenres.sadb_x_propb_lenres_numecombs
246 	/* Followed by sadb_comb[] array or sadb_ecomb[] array. */
247 } sadb_x_propbase_t;
248 
249 /* Now, the actual sadb_prop structure, which will have alignment in it! */
250 
251 typedef struct sadb_prop {
252 	/* Union is for guaranteeing 64-bit alignment. */
253 	union {
254 		sadb_x_propbase_t sadb_x_prop_actual;
255 		uint64_t sadb_x_prop_alignment;
256 	} sadb_x_prop_u;
257 #define	sadb_prop_len sadb_x_prop_u.sadb_x_prop_actual.sadb_x_propb_len
258 #define	sadb_prop_exttype sadb_x_prop_u.sadb_x_prop_actual.sadb_x_propb_exttype
259 #define	sadb_prop_replay sadb_x_prop_u.sadb_x_prop_actual.sadb_x_propb_replay
260 #define	sadb_prop_reserved \
261 	sadb_x_prop_u.sadb_x_prop_actual.sadb_x_propb_reserved
262 #define	sadb_x_prop_ereserved \
263 	sadb_x_prop_u.sadb_x_prop_actual.sadb_x_propb_ereserved
264 #define	sadb_x_prop_numecombs \
265 	sadb_x_prop_u.sadb_x_prop_actual.sadb_x_propb_numecombs
266 } sadb_prop_t;
267 
268 /*
269  * This is a proposed combination.  Many of these can follow a proposal
270  * extension.  Already 64-bit aligned thanks to uint64_t fields.
271  */
272 
273 typedef struct sadb_comb {
274 	uint8_t sadb_comb_auth;			/* Authentication algorithm */
275 	uint8_t sadb_comb_encrypt;		/* Encryption algorithm */
276 	uint16_t sadb_comb_flags;		/* Comb. flags (e.g. PFS) */
277 	uint16_t sadb_comb_auth_minbits;	/* Bit strengths for auth */
278 	uint16_t sadb_comb_auth_maxbits;
279 	uint16_t sadb_comb_encrypt_minbits;	/* Bit strengths for encrypt */
280 	uint16_t sadb_comb_encrypt_maxbits;
281 	uint32_t sadb_comb_reserved;
282 	uint32_t sadb_comb_soft_allocations;	/* Lifetime proposals for */
283 	uint32_t sadb_comb_hard_allocations;	/* this combination. */
284 	uint64_t sadb_comb_soft_bytes;
285 	uint64_t sadb_comb_hard_bytes;
286 	uint64_t sadb_comb_soft_addtime;
287 	uint64_t sadb_comb_hard_addtime;
288 	uint64_t sadb_comb_soft_usetime;
289 	uint64_t sadb_comb_hard_usetime;
290 } sadb_comb_t;
291 
292 /*
293  * An extended combination that can comprise of many SA types.
294  * A single combination has algorithms and SA types locked.
295  * These are represented by algorithm descriptors, the second structure
296  * in the list.  For example, if the EACQUIRE requests AH(MD5) + ESP(DES/null)
297  * _or_ ESP(DES/MD5), it would have two combinations:
298  *
299  * COMB: algdes(AH, AUTH, MD5), algdes(ESP, CRYPT, DES)
300  * COMB: algdes(ESP, AUTH, MD5), algdes(ESP, CRYPT, DES)
301  *
302  * If an SA type supports an algorithm type, and there's no descriptor,
303  * assume it requires NONE, just like it were explicitly stated.
304  * (This includes ESP NULL encryption, BTW.)
305  *
306  * Already 64-bit aligned thanks to uint64_t fields.
307  */
308 
309 typedef struct sadb_x_ecomb {
310 	uint8_t sadb_x_ecomb_numalgs;
311 	uint8_t sadb_x_ecomb_reserved;
312 	uint16_t sadb_x_ecomb_flags;	/* E.g. PFS? */
313 	uint32_t sadb_x_ecomb_reserved2;
314 	uint32_t sadb_x_ecomb_soft_allocations;
315 	uint32_t sadb_x_ecomb_hard_allocations;
316 	uint64_t sadb_x_ecomb_soft_bytes;
317 	uint64_t sadb_x_ecomb_hard_bytes;
318 	uint64_t sadb_x_ecomb_soft_addtime;
319 	uint64_t sadb_x_ecomb_hard_addtime;
320 	uint64_t sadb_x_ecomb_soft_usetime;
321 	uint64_t sadb_x_ecomb_hard_usetime;
322 } sadb_x_ecomb_t;
323 
324 typedef struct sadb_x_algdesc {
325 	/* Union is for guaranteeing 64-bit alignment. */
326 	union {
327 		struct {
328 			uint8_t sadb_x_algdesc_usatype;	/* ESP, AH, etc. */
329 			uint8_t sadb_x_algdesc_ualgtype; /* AUTH, CRYPT, COMP */
330 			uint8_t sadb_x_algdesc_ualg;	/* 3DES, MD5, etc. */
331 			uint8_t sadb_x_algdesc_ureserved;
332 			uint16_t sadb_x_algdesc_uminbits; /* Bit strengths. */
333 			uint16_t sadb_x_algdesc_umaxbits;
334 		} sadb_x_algdesc_actual;
335 		uint64_t sadb_x_algdesc_alignment;
336 	} sadb_x_algdesc_u;
337 #define	sadb_x_algdesc_satype \
338 	sadb_x_algdesc_u.sadb_x_algdesc_actual.sadb_x_algdesc_usatype
339 #define	sadb_x_algdesc_algtype \
340 	sadb_x_algdesc_u.sadb_x_algdesc_actual.sadb_x_algdesc_ualgtype
341 #define	sadb_x_algdesc_alg \
342 	sadb_x_algdesc_u.sadb_x_algdesc_actual.sadb_x_algdesc_ualg
343 #define	sadb_x_algdesc_reserved \
344 	sadb_x_algdesc_u.sadb_x_algdesc_actual.sadb_x_algdesc_ureserved
345 #define	sadb_x_algdesc_minbits \
346 	sadb_x_algdesc_u.sadb_x_algdesc_actual.sadb_x_algdesc_uminbits
347 #define	sadb_x_algdesc_maxbits \
348 	sadb_x_algdesc_u.sadb_x_algdesc_actual.sadb_x_algdesc_umaxbits
349 } sadb_x_algdesc_t;
350 
351 /*
352  * When key mgmt. registers with the kernel, the kernel will tell key mgmt.
353  * its supported algorithms.
354  */
355 
356 typedef struct sadb_supported {
357 	/* Union is for guaranteeing 64-bit alignment. */
358 	union {
359 		struct {
360 			uint16_t sadb_x_supported_ulen;
361 			uint16_t sadb_x_supported_uexttype;
362 			uint32_t sadb_x_supported_ureserved;
363 		} sadb_x_supported_actual;
364 		uint64_t sadb_x_supported_alignment;
365 	} sadb_x_supported_u;
366 #define	sadb_supported_len \
367 	sadb_x_supported_u.sadb_x_supported_actual.sadb_x_supported_ulen
368 #define	sadb_supported_exttype \
369 	sadb_x_supported_u.sadb_x_supported_actual.sadb_x_supported_uexttype
370 #define	sadb_supported_reserved \
371 	sadb_x_supported_u.sadb_x_supported_actual.sadb_x_supported_ureserved
372 } sadb_supported_t;
373 
374 /* First, a base structure... */
375 typedef struct sadb_x_algb {
376 	uint8_t sadb_x_algb_id;		/* Algorithm type. */
377 	uint8_t sadb_x_algb_ivlen;		/* IV len, in bits */
378 	uint16_t sadb_x_algb_minbits;	/* Min. key len (in bits) */
379 	uint16_t sadb_x_algb_maxbits;	/* Max. key length */
380 	union {
381 		uint16_t sadb_x_algb_ureserved;
382 		uint8_t sadb_x_algb_udefaults[2];
383 	} sadb_x_algb_union;
384 
385 #define	sadb_x_algb_reserved sadb_x_algb_union.sadb_x_algb_ureserved
386 #define	sadb_x_algb_increment sadb_x_algb_union.sadb_x_algb_udefaults[0]
387 #define	sadb_x_algb_defincr sadb_x_algb_union.sadb_x_algb_udefaults[1]
388 /*
389  * alg_increment: the number of bits from a key length to the next
390  * alg_defincr: the number of increments from the smallest possible
391  * key to the default key length
392  */
393 } sadb_x_algb_t;
394 /* useful macros for dealing with defincr */
395 #define	SADB_ALG_DEFAULT_LEN(min, incr, defincr) ((min) + ((defincr) * (incr)))
396 #define	SADB_ALG_DEFAULT_INCR(min, incr, default) (((default) - (min)) / (incr))
397 
398 /* Now, the actual sadb_alg structure, which will have alignment in it. */
399 typedef struct sadb_alg {
400 	/* Union is for guaranteeing 64-bit alignment. */
401 	union {
402 		sadb_x_algb_t sadb_x_alg_actual;
403 		uint64_t sadb_x_alg_alignment;
404 	} sadb_x_alg_u;
405 #define	sadb_alg_id sadb_x_alg_u.sadb_x_alg_actual.sadb_x_algb_id
406 #define	sadb_alg_ivlen sadb_x_alg_u.sadb_x_alg_actual.sadb_x_algb_ivlen
407 #define	sadb_alg_minbits sadb_x_alg_u.sadb_x_alg_actual.sadb_x_algb_minbits
408 #define	sadb_alg_maxbits sadb_x_alg_u.sadb_x_alg_actual.sadb_x_algb_maxbits
409 #define	sadb_alg_reserved sadb_x_alg_u.sadb_x_alg_actual.sadb_x_algb_reserved
410 #define	sadb_x_alg_increment \
411 	sadb_x_alg_u.sadb_x_alg_actual.sadb_x_algb_increment
412 #define	sadb_x_alg_defincr sadb_x_alg_u.sadb_x_alg_actual.sadb_x_algb_defincr
413 } sadb_alg_t;
414 
415 /*
416  * If key mgmt. needs an SPI in a range (including 0 to 0xFFFFFFFF), it
417  * asks the kernel with this extension in the SADB_GETSPI message.
418  */
419 
420 typedef struct sadb_spirange {
421 	uint16_t sadb_spirange_len;
422 	uint16_t sadb_spirange_exttype;	/* SPI_RANGE */
423 	uint32_t sadb_spirange_min;
424 	/* Union is for guaranteeing 64-bit alignment. */
425 	union {
426 		struct {
427 			uint32_t sadb_x_spirange_umax;
428 			uint32_t sadb_x_spirange_ureserved;
429 		} sadb_x_spirange_actual;
430 		uint64_t sadb_x_spirange_alignment;
431 	} sadb_x_spirange_u;
432 #define	sadb_spirange_max \
433 	sadb_x_spirange_u.sadb_x_spirange_actual.sadb_x_spirange_umax
434 #define	sadb_spirange_reserved \
435 	sadb_x_spirange_u.sadb_x_spirange_actual.sadb_x_spirange_ureserved
436 } sadb_spirange_t;
437 
438 /*
439  * For the "extended REGISTER" which'll tell the kernel to send me
440  * "extended ACQUIREs".
441  */
442 
443 typedef struct sadb_x_ereg {
444 	/* Union is for guaranteeing 64-bit alignment. */
445 	union {
446 		struct {
447 			uint16_t sadb_x_ereg_ulen;
448 			uint16_t sadb_x_ereg_uexttype;	/* X_EREG */
449 			/* Array of SA types, 0-terminated. */
450 			uint8_t sadb_x_ereg_usatypes[4];
451 		} sadb_x_ereg_actual;
452 		uint64_t sadb_x_ereg_alignment;
453 	} sadb_x_ereg_u;
454 #define	sadb_x_ereg_len \
455 	sadb_x_ereg_u.sadb_x_ereg_actual.sadb_x_ereg_ulen
456 #define	sadb_x_ereg_exttype \
457 	sadb_x_ereg_u.sadb_x_ereg_actual.sadb_x_ereg_uexttype
458 #define	sadb_x_ereg_satypes \
459 	sadb_x_ereg_u.sadb_x_ereg_actual.sadb_x_ereg_usatypes
460 } sadb_x_ereg_t;
461 
462 /*
463  * For conveying a Key Management Cookie with SADB_GETSPI, SADB_ADD,
464  * SADB_ACQUIRE, or SADB_X_INVERSE_ACQUIRE.
465  */
466 
467 typedef struct sadb_x_kmc {
468 	uint16_t sadb_x_kmc_len;
469 	uint16_t sadb_x_kmc_exttype;	/* X_KM_COOKIE */
470 	uint32_t sadb_x_kmc_proto;	/* KM protocol */
471 	union {
472 		struct {
473 			uint32_t sadb_x_kmc_ucookie;	/* KMP-specific */
474 			uint32_t sadb_x_kmc_ureserved;	/* Must be zero */
475 		} sadb_x_kmc_actual;
476 		uint64_t sadb_x_kmc_alignment;
477 	} sadb_x_kmc_u;
478 #define	sadb_x_kmc_cookie sadb_x_kmc_u.sadb_x_kmc_actual.sadb_x_kmc_ucookie
479 #define	sadb_x_kmc_reserved sadb_x_kmc_u.sadb_x_kmc_actual.sadb_x_kmc_ureserved
480 } sadb_x_kmc_t;
481 
482 typedef struct sadb_x_pair {
483 	union {
484 		/* Union is for guaranteeing 64-bit alignment. */
485 		struct {
486 			uint16_t sadb_x_pair_ulen;
487 			uint16_t sadb_x_pair_uexttype;
488 			uint32_t sadb_x_pair_uspi;	/* SPI of paired SA */
489 		} sadb_x_pair_actual;
490 		uint64_t sadb_x_ext_alignment;
491 	} sadb_x_pair_u;
492 #define	sadb_x_pair_len sadb_x_pair_u.sadb_x_pair_actual.sadb_x_pair_ulen
493 #define	sadb_x_pair_exttype \
494 	sadb_x_pair_u.sadb_x_pair_actual.sadb_x_pair_uexttype
495 #define	sadb_x_pair_spi sadb_x_pair_u.sadb_x_pair_actual.sadb_x_pair_uspi
496 } sadb_x_pair_t;
497 
498 /*
499  * For the Sequence numbers to be used with SADB_DUMP, SADB_GET, SADB_UPDATE.
500  */
501 
502 typedef struct sadb_x_replay_ctr {
503 	uint16_t sadb_x_rc_len;
504 	uint16_t sadb_x_rc_exttype;
505 	uint32_t sadb_x_rc_replay32;    /* For 240x SAs. */
506 	uint64_t sadb_x_rc_replay64;    /* For 430x SAs. */
507 } sadb_x_replay_ctr_t;
508 
509 /*
510  * For extended DUMP request. Dumps the SAs which were idle for
511  * longer than the timeout specified.
512  */
513 
514 typedef struct sadb_x_edump {
515 	uint16_t sadb_x_edump_len;
516 	uint16_t sadb_x_edump_exttype;
517 	uint32_t sadb_x_edump_reserved;
518 	uint64_t sadb_x_edump_timeout;
519 } sadb_x_edump_t;
520 
521 /*
522  * Base message types.
523  */
524 
525 #define	SADB_RESERVED	0
526 #define	SADB_GETSPI	1
527 #define	SADB_UPDATE	2
528 #define	SADB_ADD	3
529 #define	SADB_DELETE	4
530 #define	SADB_GET	5
531 #define	SADB_ACQUIRE	6
532 #define	SADB_REGISTER	7
533 #define	SADB_EXPIRE	8
534 #define	SADB_FLUSH	9
535 #define	SADB_DUMP	10   /* not used normally */
536 #define	SADB_X_PROMISC	11
537 #define	SADB_X_INVERSE_ACQUIRE	12
538 #define	SADB_X_UPDATEPAIR	13
539 #define	SADB_X_DELPAIR		14
540 #define	SADB_X_DELPAIR_STATE	15
541 #define	SADB_MAX		15
542 
543 /*
544  * SA flags
545  */
546 
547 #define	SADB_SAFLAGS_PFS	0x1	/* Perfect forward secrecy? */
548 #define	SADB_SAFLAGS_NOREPLAY	0x2	/* Replay field NOT PRESENT. */
549 
550 /* Below flags are used by this implementation.  Grow from left-to-right. */
551 #define	SADB_X_SAFLAGS_USED	0x80000000	/* SA used/not used */
552 #define	SADB_X_SAFLAGS_UNIQUE	0x40000000	/* SA unique/reusable */
553 #define	SADB_X_SAFLAGS_AALG1	0x20000000	/* Auth-alg specific flag 1 */
554 #define	SADB_X_SAFLAGS_AALG2	0x10000000	/* Auth-alg specific flag 2 */
555 #define	SADB_X_SAFLAGS_EALG1	 0x8000000	/* Encr-alg specific flag 1 */
556 #define	SADB_X_SAFLAGS_EALG2	 0x4000000	/* Encr-alg specific flag 2 */
557 #define	SADB_X_SAFLAGS_KM1	 0x2000000	/* Key mgmt. specific flag 1 */
558 #define	SADB_X_SAFLAGS_KM2	 0x1000000	/* Key mgmt. specific flag 2 */
559 #define	SADB_X_SAFLAGS_KM3	  0x800000	/* Key mgmt. specific flag 3 */
560 #define	SADB_X_SAFLAGS_KM4	  0x400000	/* Key mgmt. specific flag 4 */
561 #define	SADB_X_SAFLAGS_KRES1	  0x200000	/* Reserved by the kernel */
562 #define	SADB_X_SAFLAGS_NATT_LOC	  0x100000	/* this has a natted src SA */
563 #define	SADB_X_SAFLAGS_NATT_REM	   0x80000	/* this has a natted dst SA */
564 #define	SADB_X_SAFLAGS_KRES2	   0x40000	/* Reserved by the kernel */
565 #define	SADB_X_SAFLAGS_TUNNEL	   0x20000	/* tunnel mode */
566 #define	SADB_X_SAFLAGS_PAIRED	   0x10000	/* inbound/outbound pair */
567 #define	SADB_X_SAFLAGS_OUTBOUND	    0x8000	/* SA direction bit */
568 #define	SADB_X_SAFLAGS_INBOUND	    0x4000	/* SA direction bit */
569 #define	SADB_X_SAFLAGS_NATTED	    0x1000	/* Local node is behind a NAT */
570 
571 #define	SADB_X_SAFLAGS_KRES	\
572 	SADB_X_SAFLAGS_KRES1 | SADB_X_SAFLAGS_KRES2
573 
574 /*
575  * SA state.
576  */
577 
578 #define	SADB_SASTATE_LARVAL		0
579 #define	SADB_SASTATE_MATURE		1
580 #define	SADB_SASTATE_DYING		2
581 #define	SADB_SASTATE_DEAD		3
582 #define	SADB_X_SASTATE_ACTIVE_ELSEWHERE	4
583 #define	SADB_X_SASTATE_IDLE		5
584 #define	SADB_X_SASTATE_ACTIVE		6
585 
586 #define	SADB_SASTATE_MAX		6
587 
588 /*
589  * SA type.  Gaps are present in the number space because (for the time being)
590  * these types correspond to the SA types in the IPsec DOI document.
591  */
592 
593 #define	SADB_SATYPE_UNSPEC	0
594 #define	SADB_SATYPE_AH		2  /* RFC-1826 */
595 #define	SADB_SATYPE_ESP		3  /* RFC-1827 */
596 #define	SADB_SATYPE_RSVP	5  /* RSVP Authentication */
597 #define	SADB_SATYPE_OSPFV2	6  /* OSPFv2 Authentication */
598 #define	SADB_SATYPE_RIPV2	7  /* RIPv2 Authentication */
599 #define	SADB_SATYPE_MIP		8  /* Mobile IPv4 Authentication */
600 
601 #define	SADB_SATYPE_MAX		8
602 
603 /*
604  * Algorithm types.  Gaps are present because (for the time being) these types
605  * correspond to the SA types in the IPsec DOI document.
606  *
607  * NOTE:  These are numbered to play nice with the IPsec DOI.  That's why
608  *	  there are gaps.
609  */
610 
611 /* Authentication algorithms */
612 #define	SADB_AALG_NONE		0
613 #define	SADB_AALG_MD5HMAC	2
614 #define	SADB_AALG_SHA1HMAC	3
615 #define	SADB_AALG_SHA256HMAC	5
616 #define	SADB_AALG_SHA384HMAC	6
617 #define	SADB_AALG_SHA512HMAC	7
618 
619 #define	SADB_AALG_MAX		7
620 
621 /* Encryption algorithms */
622 #define	SADB_EALG_NONE		0
623 #define	SADB_EALG_DESCBC	2
624 #define	SADB_EALG_3DESCBC	3
625 #define	SADB_EALG_BLOWFISH	7
626 #define	SADB_EALG_NULL		11
627 #define	SADB_EALG_AES		12
628 #define	SADB_EALG_MAX		12
629 
630 /*
631  * Extension header values.
632  */
633 
634 #define	SADB_EXT_RESERVED		0
635 
636 #define	SADB_EXT_SA			1
637 #define	SADB_EXT_LIFETIME_CURRENT	2
638 #define	SADB_EXT_LIFETIME_HARD		3
639 #define	SADB_EXT_LIFETIME_SOFT		4
640 #define	SADB_EXT_ADDRESS_SRC		5
641 #define	SADB_EXT_ADDRESS_DST		6
642 /* These two are synonyms. */
643 #define	SADB_EXT_ADDRESS_PROXY		7
644 #define	SADB_X_EXT_ADDRESS_INNER_SRC	SADB_EXT_ADDRESS_PROXY
645 #define	SADB_EXT_KEY_AUTH		8
646 #define	SADB_EXT_KEY_ENCRYPT		9
647 #define	SADB_EXT_IDENTITY_SRC		10
648 #define	SADB_EXT_IDENTITY_DST		11
649 #define	SADB_EXT_SENSITIVITY		12
650 #define	SADB_EXT_PROPOSAL		13
651 #define	SADB_EXT_SUPPORTED_AUTH		14
652 #define	SADB_EXT_SUPPORTED_ENCRYPT	15
653 #define	SADB_EXT_SPIRANGE		16
654 #define	SADB_X_EXT_EREG			17
655 #define	SADB_X_EXT_EPROP		18
656 #define	SADB_X_EXT_KM_COOKIE		19
657 #define	SADB_X_EXT_ADDRESS_NATT_LOC	20
658 #define	SADB_X_EXT_ADDRESS_NATT_REM	21
659 #define	SADB_X_EXT_ADDRESS_INNER_DST	22
660 #define	SADB_X_EXT_PAIR			23
661 #define	SADB_X_EXT_REPLAY_VALUE		24
662 #define	SADB_X_EXT_EDUMP		25
663 #define	SADB_X_EXT_LIFETIME_IDLE	26
664 
665 #define	SADB_EXT_MAX			26
666 
667 /*
668  * Identity types.
669  */
670 
671 #define	SADB_IDENTTYPE_RESERVED 0
672 
673 /*
674  * For PREFIX and ADDR_RANGE, use the AF of the PROXY if present, or the SRC
675  * if not present.
676  */
677 #define	SADB_IDENTTYPE_PREFIX		1
678 #define	SADB_IDENTTYPE_FQDN		2  /* Fully qualified domain name. */
679 #define	SADB_IDENTTYPE_USER_FQDN	3  /* e.g. root@domain.com */
680 #define	SADB_X_IDENTTYPE_DN		4  /* ASN.1 DER Distinguished Name. */
681 #define	SADB_X_IDENTTYPE_GN		5  /* ASN.1 DER Generic Name. */
682 #define	SADB_X_IDENTTYPE_KEY_ID		6  /* Generic KEY ID. */
683 #define	SADB_X_IDENTTYPE_ADDR_RANGE	7
684 
685 #define	SADB_IDENTTYPE_MAX 	7
686 
687 /*
688  * Protection DOI values for the SENSITIVITY extension.  There are no values
689  * currently, so the MAX is the only non-zero value available.
690  */
691 
692 #define	SADB_DPD_NONE	0
693 
694 #define	SADB_DPD_MAX	1
695 
696 /*
697  * Diagnostic codes.  These supplement error messages.  Be sure to
698  * update libipsecutil's keysock_diag() if you change any of these.
699  */
700 
701 #define	SADB_X_DIAGNOSTIC_PRESET		-1	/* Internal value. */
702 
703 #define	SADB_X_DIAGNOSTIC_NONE			0
704 
705 #define	SADB_X_DIAGNOSTIC_UNKNOWN_MSG		1
706 #define	SADB_X_DIAGNOSTIC_UNKNOWN_EXT		2
707 #define	SADB_X_DIAGNOSTIC_BAD_EXTLEN		3
708 #define	SADB_X_DIAGNOSTIC_UNKNOWN_SATYPE	4
709 #define	SADB_X_DIAGNOSTIC_SATYPE_NEEDED		5
710 #define	SADB_X_DIAGNOSTIC_NO_SADBS		6
711 #define	SADB_X_DIAGNOSTIC_NO_EXT		7
712 /* Bad address family value */
713 #define	SADB_X_DIAGNOSTIC_BAD_SRC_AF		8
714 /* in sockaddr->sa_family. */
715 #define	SADB_X_DIAGNOSTIC_BAD_DST_AF		9
716 /* These two are synonyms. */
717 #define	SADB_X_DIAGNOSTIC_BAD_PROXY_AF		10
718 #define	SADB_X_DIAGNOSTIC_BAD_INNER_SRC_AF	10
719 
720 #define	SADB_X_DIAGNOSTIC_AF_MISMATCH		11
721 
722 #define	SADB_X_DIAGNOSTIC_BAD_SRC		12
723 #define	SADB_X_DIAGNOSTIC_BAD_DST		13
724 
725 #define	SADB_X_DIAGNOSTIC_ALLOC_HSERR		14
726 #define	SADB_X_DIAGNOSTIC_BYTES_HSERR		15
727 #define	SADB_X_DIAGNOSTIC_ADDTIME_HSERR		16
728 #define	SADB_X_DIAGNOSTIC_USETIME_HSERR		17
729 
730 #define	SADB_X_DIAGNOSTIC_MISSING_SRC		18
731 #define	SADB_X_DIAGNOSTIC_MISSING_DST		19
732 #define	SADB_X_DIAGNOSTIC_MISSING_SA		20
733 #define	SADB_X_DIAGNOSTIC_MISSING_EKEY		21
734 #define	SADB_X_DIAGNOSTIC_MISSING_AKEY		22
735 #define	SADB_X_DIAGNOSTIC_MISSING_RANGE		23
736 
737 #define	SADB_X_DIAGNOSTIC_DUPLICATE_SRC		24
738 #define	SADB_X_DIAGNOSTIC_DUPLICATE_DST		25
739 #define	SADB_X_DIAGNOSTIC_DUPLICATE_SA		26
740 #define	SADB_X_DIAGNOSTIC_DUPLICATE_EKEY	27
741 #define	SADB_X_DIAGNOSTIC_DUPLICATE_AKEY	28
742 #define	SADB_X_DIAGNOSTIC_DUPLICATE_RANGE	29
743 
744 #define	SADB_X_DIAGNOSTIC_MALFORMED_SRC		30
745 #define	SADB_X_DIAGNOSTIC_MALFORMED_DST		31
746 #define	SADB_X_DIAGNOSTIC_MALFORMED_SA		32
747 #define	SADB_X_DIAGNOSTIC_MALFORMED_EKEY	33
748 #define	SADB_X_DIAGNOSTIC_MALFORMED_AKEY	34
749 #define	SADB_X_DIAGNOSTIC_MALFORMED_RANGE	35
750 
751 #define	SADB_X_DIAGNOSTIC_AKEY_PRESENT		36
752 #define	SADB_X_DIAGNOSTIC_EKEY_PRESENT		37
753 #define	SADB_X_DIAGNOSTIC_PROP_PRESENT		38
754 #define	SADB_X_DIAGNOSTIC_SUPP_PRESENT		39
755 
756 #define	SADB_X_DIAGNOSTIC_BAD_AALG		40
757 #define	SADB_X_DIAGNOSTIC_BAD_EALG		41
758 #define	SADB_X_DIAGNOSTIC_BAD_SAFLAGS		42
759 #define	SADB_X_DIAGNOSTIC_BAD_SASTATE		43
760 
761 #define	SADB_X_DIAGNOSTIC_BAD_AKEYBITS		44
762 #define	SADB_X_DIAGNOSTIC_BAD_EKEYBITS		45
763 
764 #define	SADB_X_DIAGNOSTIC_ENCR_NOTSUPP		46
765 
766 #define	SADB_X_DIAGNOSTIC_WEAK_EKEY		47
767 #define	SADB_X_DIAGNOSTIC_WEAK_AKEY		48
768 
769 #define	SADB_X_DIAGNOSTIC_DUPLICATE_KMP		49
770 #define	SADB_X_DIAGNOSTIC_DUPLICATE_KMC		50
771 
772 #define	SADB_X_DIAGNOSTIC_MISSING_NATT_LOC	51
773 #define	SADB_X_DIAGNOSTIC_MISSING_NATT_REM	52
774 #define	SADB_X_DIAGNOSTIC_DUPLICATE_NATT_LOC	53
775 #define	SADB_X_DIAGNOSTIC_DUPLICATE_NATT_REM	54
776 #define	SADB_X_DIAGNOSTIC_MALFORMED_NATT_LOC	55
777 #define	SADB_X_DIAGNOSTIC_MALFORMED_NATT_REM	56
778 #define	SADB_X_DIAGNOSTIC_DUPLICATE_NATT_PORTS	57
779 
780 #define	SADB_X_DIAGNOSTIC_MISSING_INNER_SRC	58
781 #define	SADB_X_DIAGNOSTIC_MISSING_INNER_DST	59
782 #define	SADB_X_DIAGNOSTIC_DUPLICATE_INNER_SRC	60
783 #define	SADB_X_DIAGNOSTIC_DUPLICATE_INNER_DST	61
784 #define	SADB_X_DIAGNOSTIC_MALFORMED_INNER_SRC	62
785 #define	SADB_X_DIAGNOSTIC_MALFORMED_INNER_DST	63
786 
787 #define	SADB_X_DIAGNOSTIC_PREFIX_INNER_SRC	64
788 #define	SADB_X_DIAGNOSTIC_PREFIX_INNER_DST	65
789 #define	SADB_X_DIAGNOSTIC_BAD_INNER_DST_AF	66
790 #define	SADB_X_DIAGNOSTIC_INNER_AF_MISMATCH	67
791 
792 #define	SADB_X_DIAGNOSTIC_BAD_NATT_REM_AF	68
793 #define	SADB_X_DIAGNOSTIC_BAD_NATT_LOC_AF	69
794 
795 #define	SADB_X_DIAGNOSTIC_PROTO_MISMATCH	70
796 #define	SADB_X_DIAGNOSTIC_INNER_PROTO_MISMATCH	71
797 
798 #define	SADB_X_DIAGNOSTIC_DUAL_PORT_SETS	72
799 
800 #define	SADB_X_DIAGNOSTIC_PAIR_INAPPROPRIATE	73
801 #define	SADB_X_DIAGNOSTIC_PAIR_ADD_MISMATCH	74
802 #define	SADB_X_DIAGNOSTIC_PAIR_ALREADY		75
803 #define	SADB_X_DIAGNOSTIC_PAIR_SA_NOTFOUND	76
804 #define	SADB_X_DIAGNOSTIC_BAD_SA_DIRECTION	77
805 
806 #define	SADB_X_DIAGNOSTIC_SA_NOTFOUND		78
807 #define	SADB_X_DIAGNOSTIC_SA_EXPIRED		79
808 #define	SADB_X_DIAGNOSTIC_BAD_CTX		80
809 #define	SADB_X_DIAGNOSTIC_INVALID_REPLAY	81
810 #define	SADB_X_DIAGNOSTIC_MISSING_LIFETIME	82
811 #define	SADB_X_DIAGNOSTIC_MAX			82
812 
813 /* Algorithm type for sadb_x_algdesc above... */
814 
815 #define	SADB_X_ALGTYPE_NONE		0
816 #define	SADB_X_ALGTYPE_AUTH		1
817 #define	SADB_X_ALGTYPE_CRYPT		2
818 #define	SADB_X_ALGTYPE_COMPRESS		3
819 
820 #define	SADB_X_ALGTYPE_MAX		3
821 
822 /* Key management protocol for sadb_x_kmc above... */
823 
824 #define	SADB_X_KMP_MANUAL	0
825 #define	SADB_X_KMP_IKE		1
826 #define	SADB_X_KMP_KINK		2
827 
828 #define	SADB_X_KMP_MAX		2
829 
830 /*
831  * Handy conversion macros.  Not part of the PF_KEY spec...
832  */
833 
834 #define	SADB_64TO8(x)	((x) << 3)
835 #define	SADB_8TO64(x)	((x) >> 3)
836 #define	SADB_8TO1(x)	((x) << 3)
837 #define	SADB_1TO8(x)	((x) >> 3)
838 
839 #ifdef	__cplusplus
840 }
841 #endif
842 
843 #endif	/* _NET_PFKEYV2_H */
844