freebsd-dev/sys/netkey/key.h

/*----------------------------------------------------------------------
 * key.h :     Declarations and Definitions for Key Engine for BSD.
 *
 * Copyright 1995 by Bao Phan, Randall Atkinson, & Dan McDonald,
 * All Rights Reserved.  All rights have been assigned to the US
 * Naval Research Laboratory (NRL).  The NRL Copyright Notice and
 * License Agreement governs distribution and use of this software.
 *
 * Patents are pending on this technology.  NRL grants a license
 * to use this technology at no cost under the terms below with
 * the additional requirement that software, hardware, and
 * documentation relating to use of this technology must include
 * the note that:
 *    	This product includes technology developed at and
 *      licensed from the Information Technology Division,
 *	US Naval Research Laboratory.
 *
 ----------------------------------------------------------------------*/
/*----------------------------------------------------------------------
#	@(#)COPYRIGHT	1.1a (NRL) 17 August 1995

COPYRIGHT NOTICE

All of the documentation and software included in this software
distribution from the US Naval Research Laboratory (NRL) are
copyrighted by their respective developers.

This software and documentation were developed at NRL by various
people.  Those developers have each copyrighted the portions that they
developed at NRL and have assigned All Rights for those portions to
NRL.  Outside the USA, NRL also has copyright on the software
developed at NRL. The affected files all contain specific copyright
notices and those notices must be retained in any derived work.

NRL LICENSE

NRL grants permission for redistribution and use in source and binary
forms, with or without modification, of the software and documentation
created at NRL provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software
   must display the following acknowledgement:

	This product includes software developed at the Information
	Technology Division, US Naval Research Laboratory.

4. Neither the name of the NRL nor the names of its contributors
   may be used to endorse or promote products derived from this software
   without specific prior written permission.

THE SOFTWARE PROVIDED BY NRL IS PROVIDED BY NRL AND CONTRIBUTORS ``AS
IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL NRL OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation
are those of the authors and should not be interpreted as representing
official policies, either expressed or implied, of the US Naval
Research Laboratory (NRL).

----------------------------------------------------------------------*/

#ifndef _netkey_key_h
#define	_netkey_key_h	1

/*
 * PF_KEY messages
 */

#define KEY_ADD		1
#define KEY_DELETE	2
#define KEY_UPDATE	3
#define KEY_GET		4
#define KEY_ACQUIRE	5
#define KEY_GETSPI	6
#define KEY_REGISTER	7
#define KEY_EXPIRE	8
#define KEY_DUMP	9
#define KEY_FLUSH	10

#define KEY_VERSION	1
#define POLICY_VERSION	1

#define SECURITY_TYPE_NONE	0

#define KEY_TYPE_AH	1
#define KEY_TYPE_ESP	2
#define KEY_TYPE_RSVP	3
#define KEY_TYPE_OSPF	4
#define KEY_TYPE_RIPV2	5
#define KEY_TYPE_MIPV4	6
#define KEY_TYPE_MIPV6	7
#define KEY_TYPE_MAX	7

/*
 * Security association state
 */

#define K_USED		0x1	/* Key used/not used */
#define K_UNIQUE	0x2	/* Key unique/reusable */
#define K_LARVAL	0x4	/* SPI assigned, but sa incomplete */
#define K_ZOMBIE	0x8	/* sa expired but still useable */
#define K_DEAD		0x10	/* sa marked for deletion, ready for reaping */
#define K_INBOUND	0x20	/* sa for inbound packets, ie. dst=myhost */
#define K_OUTBOUND	0x40	/* sa for outbound packets, ie. src=myhost */


#ifndef MAX_SOCKADDR_SZ
#ifdef INET6
#define MAX_SOCKADDR_SZ (sizeof(struct sockaddr_in6))
#else /* INET6 */
#define MAX_SOCKADDR_SZ (sizeof(struct sockaddr_in))
#endif /* INET6 */
#endif /* MAX_SOCKADDR_SZ */

#ifndef MAX_KEY_SZ
#define MAX_KEY_SZ 16
#endif /* MAX_KEY_SZ */

#ifndef MAX_IV_SZ
#define MAX_IV_SZ 16
#endif /* MAX_IV_SZ */

/* Security association data for IP Security */
struct key_secassoc {
	u_int8_t	len;		/* Length of the data (for radix) */
	u_int8_t	type;		/* Type of association */
	u_int8_t	vers;		/* Version of association (AH/ESP) */
	u_int8_t	state;		/* State of the association */
	u_int8_t	label;		/* Sensitivity label (unused) */
	u_int32_t	spi;		/* SPI */
	u_int8_t	keylen;		/* Key length */
	u_int8_t	ekeylen;	/* Extra key length */
	u_int8_t	ivlen;		/* Initialization vector length */
	u_int8_t	algorithm;	/* Algorithm switch index */
	u_int8_t	lifetype;	/* Type of lifetime */
	caddr_t		iv;		/* Initialization vector */
	caddr_t		key;		/* Key */
	caddr_t		ekey;		/* Extra key */
	u_int32_t	lifetime1;	/* Lifetime value 1 */
	u_int32_t	lifetime2;	/* Lifetime value 2 */
	struct sockaddr	*src;		/* Source host address */
	struct sockaddr	*dst;		/* Destination host address */
	struct sockaddr	*from;		/* Originator of association */

	int		antireplay;	/*anti replay flag*/
	u_int32_t	sequence;	/*send: sequence number*/
	u_int32_t	replayright;	/*receive: replay window, right*/
	u_int64_t	replaywindow;	/*receive: replay window*/
};

/*
 * Structure for key message header. PF_KEY message consists of key_msghdr
 * followed by src struct sockaddr, dest struct sockaddr, from struct
 * sockaddr, key, and iv. Assumes size of key message header less than MHLEN.
 */

struct key_msghdr {
	u_short		key_msglen;	/* length of message including
					 * src/dst/from/key/iv */
	u_char		key_msgvers;	/* key version number */
	u_char		key_msgtype;	/* key message type, eg. KEY_ADD */
	pid_t		key_pid;	/* process id of message sender */
	int		key_seq;	/* message sequence number */
	int		key_errno;	/* error code */
	u_int8_t	type;		/* type of security association */
	u_int8_t	vers;		/* version of sassoc (AH/ESP) */
	u_int8_t	state;		/* state of security association */
	u_int8_t	label;		/* sensitivity level */
	u_int8_t	pad;		/* padding for allignment */
	u_int32_t	spi;		/* spi value */
	u_int8_t	keylen;		/* key length */
	u_int8_t	ekeylen;	/* extra key length */
	u_int8_t	ivlen;		/* iv length */
	u_int8_t	algorithm;	/* algorithm identifier */
	u_int8_t	lifetype;	/* type of lifetime */
	u_int32_t	lifetime1;	/* lifetime value 1 */
	u_int32_t	lifetime2;	/* lifetime value 2 */

	int		antireplay;	/* anti replay flag */
};

struct key_msgdata {
	struct sockaddr	*src;	/* source host address */
	struct sockaddr	*dst;	/* destination host address */
	struct sockaddr	*from;	/* originator of security association */
	caddr_t		iv;	/* initialization vector */
	caddr_t		key;	/* key */
	caddr_t		ekey;	/* extra key */
	int		ivlen;	/* key length */
	int		keylen;	/* iv length */
	int		ekeylen; /* extra key length */
};

struct policy_msghdr {
	u_short	policy_msglen;	/* message length */
	u_char	policy_msgvers;	/* message version */
	u_char	policy_msgtype;	/* message type */
	int	policy_seq;	/* message sequence number */
	int	policy_errno;	/* error code */
};

/*
 * Key engine table structures
 */

struct socketlist {
	struct socket *socket;		/* pointer to socket */
	struct socketlist *next;	/* next */
};

struct key_tblnode {
	int	alloc_count;		/* number of sockets allocated to
					 * secassoc */
	int	ref_count;		/* number of sockets referencing
					 * secassoc */
	struct socketlist *solist;	/* list of sockets allocated to
					 * secassoc */
	struct key_secassoc *secassoc;	/* security association */
	struct key_tblnode *next;	/* next node */
};

struct key_allocnode {
	struct key_tblnode *keynode;
	struct key_allocnode *next;
};

struct key_so2spinode {
	struct socket *socket;		/* socket pointer */
	struct key_tblnode *keynode;	/* pointer to tblnode containing
					 * secassoc */
	/* info for socket  */
	struct key_so2spinode *next;
};

struct key_registry {
	u_int8_t type;		/* secassoc type that key mgnt. daemon can
				 * acquire */
	struct socket *socket;	/* key management daemon socket pointer */
	struct key_registry *next;
};

struct key_acquirelist {
	u_int8_t type;		/* secassoc type to acquire */
	struct sockaddr *target; /* destination address of secassoc */
	u_int32_t count;	/* number of acquire messages sent */
	u_long expiretime;	/* expiration time for acquire message */
	struct key_acquirelist *next;
};

struct keyso_cb {
	int ip4_count;
#ifdef INET6
	int ip6_count;
#endif /*INET6*/
	int any_count;	/* Sum of above counters */
};

#ifdef KERNEL
extern int key_secassoc2msghdr __P((struct key_secassoc *, struct key_msghdr *,
				struct key_msgdata *));
extern int key_msghdr2secassoc __P((struct key_secassoc *, struct key_msghdr *,
				struct key_msgdata *));
extern int key_inittables __P((void));
extern void key_sodelete __P((struct socket *, int));
extern int key_add __P((struct key_secassoc *));
extern int key_delete __P((struct key_secassoc *));
extern int key_get __P((u_int, struct sockaddr *, struct sockaddr *,
			u_int32_t, struct key_secassoc **));
extern void key_flush __P((void));
extern int key_dump __P((struct socket *));
extern int key_getspi __P((u_int, u_int, struct sockaddr *, struct sockaddr *,
			u_int32_t, u_int32_t, u_int32_t *));
extern int key_update __P((struct key_secassoc *));
extern int key_register __P((struct socket *, u_int));
extern void key_unregister __P((struct socket *, u_int, int));
extern int key_acquire __P((u_int, struct sockaddr *, struct sockaddr *));
extern int getassocbyspi __P((u_int, struct sockaddr *, struct sockaddr *,
			u_int32_t, struct key_tblnode **));
extern int getassocbysocket __P((u_int, struct sockaddr *, struct sockaddr *, 
			  struct socket *, u_int, struct key_tblnode **));
extern void key_free __P((struct key_tblnode *));
extern int key_parse __P((struct key_msghdr ** km, struct socket * so,
			int *));
#endif /* KERNEL */

#endif /* _netkey_key_h */