xref: /csrg-svn/sys/net/route.h (revision 43058)
1 /*
2  * Copyright (c) 1980, 1986 Regents of the University of California.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms are permitted
6  * provided that the above copyright notice and this paragraph are
7  * duplicated in all such forms and that any documentation,
8  * advertising materials, and other materials related to such
9  * distribution and use acknowledge that the software was developed
10  * by the University of California, Berkeley.  The name of the
11  * University may not be used to endorse or promote products derived
12  * from this software without specific prior written permission.
13  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
14  * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
15  * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
16  *
17  *	@(#)route.h	7.9 (Berkeley) 06/08/90
18  */
19 
20 /*
21  * Kernel resident routing tables.
22  *
23  * The routing tables are initialized when interface addresses
24  * are set by making entries for all directly connected interfaces.
25  */
26 
27 /*
28  * A route consists of a destination address and a reference
29  * to a routing entry.  These are often held by protocols
30  * in their control blocks, e.g. inpcb.
31  */
32 struct route {
33 	struct	rtentry *ro_rt;
34 	struct	sockaddr ro_dst;
35 };
36 
37 /*
38  * These numbers are used by reliable protocols for determining
39  * retransmission behavior and are included in the routing structure.
40  */
41 struct rt_metrics {
42 	u_long	rmx_locks;	/* Kernel must leave these values alone */
43 	u_long	rmx_mtu;	/* MTU for this path */
44 	u_long	rmx_hopcount;	/* max hops expected */
45 	u_long	rmx_expire;	/* lifetime for route, e.g. redirect */
46 	u_long	rmx_recvpipe;	/* inbound delay-bandwith product */
47 	u_long	rmx_sendpipe;	/* outbound delay-bandwith product */
48 	u_long	rmx_ssthresh;	/* outbound gateway buffer limit */
49 	u_long	rmx_rtt;	/* estimated round trip time */
50 	u_long	rmx_rttvar;	/* estimated rtt variance */
51 };
52 
53 /*
54  * rmx_rtt and rmx_rttvar are stored as microseconds;
55  * RTTTOPRHZ(rtt) converts to a value suitable for use
56  * by a protocol slowtimo counter.
57  */
58 #define	RTM_RTTUNIT	1000000	/* units for rtt, rttvar, as units per sec */
59 #define	RTTTOPRHZ(r)	((r) / (RTM_RTTUNIT / PR_SLOWHZ))
60 
61 /*
62  * We distinguish between routes to hosts and routes to networks,
63  * preferring the former if available.  For each route we infer
64  * the interface to use from the gateway address supplied when
65  * the route was entered.  Routes that forward packets through
66  * gateways are marked so that the output routines know to address the
67  * gateway rather than the ultimate destination.
68  */
69 #include "radix.h"
70 struct rtentry {
71 	struct	radix_node rt_nodes[2];	/* tree glue, and other values */
72 #define	rt_key(r)	((struct sockaddr *)((r)->rt_nodes->rn_key))
73 #define	rt_mask(r)	((struct sockaddr *)((r)->rt_nodes->rn_mask))
74 	struct	sockaddr *rt_gateway;	/* value */
75 	short	rt_flags;		/* up/down?, host/net */
76 	short	rt_refcnt;		/* # held references */
77 	u_long	rt_use;			/* raw # packets forwarded */
78 	struct	ifnet *rt_ifp;		/* the answer: interface to use */
79 	struct	ifaddr *rt_ifa;		/* the answer: interface to use */
80 	struct	sockaddr *rt_genmask;	/* for generation of cloned routes */
81 	caddr_t	rt_llinfo;		/* pointer to link level info cache */
82 	struct	rt_metrics rt_rmx;	/* metrics used by rx'ing protocols */
83 };
84 
85 /*
86  * Following structure necessary for 4.3 compatibility;
87  * We should eventually move it to a compat file.
88  */
89 struct ortentry {
90 	u_long	rt_hash;		/* to speed lookups */
91 	struct	sockaddr rt_dst;	/* key */
92 	struct	sockaddr rt_gateway;	/* value */
93 	short	rt_flags;		/* up/down?, host/net */
94 	short	rt_refcnt;		/* # held references */
95 	u_long	rt_use;			/* raw # packets forwarded */
96 	struct	ifnet *rt_ifp;		/* the answer: interface to use */
97 };
98 
99 #define	RTF_UP		0x1		/* route useable */
100 #define	RTF_GATEWAY	0x2		/* destination is a gateway */
101 #define	RTF_HOST	0x4		/* host entry (net otherwise) */
102 #define	RTF_DYNAMIC	0x10		/* created dynamically (by redirect) */
103 #define	RTF_MODIFIED	0x20		/* modified dynamically (by redirect) */
104 #define RTF_DONE	0x40		/* message confirmed */
105 #define RTF_MASK	0x80		/* subnet mask present */
106 #define RTF_CLONING	0x100		/* generate new routes on use */
107 #define RTF_XRESOLVE	0x200		/* external daemon resolves name */
108 
109 
110 /*
111  * Routing statistics.
112  */
113 struct	rtstat {
114 	short	rts_badredirect;	/* bogus redirect calls */
115 	short	rts_dynamic;		/* routes created by redirects */
116 	short	rts_newgateway;		/* routes modified by redirects */
117 	short	rts_unreach;		/* lookups which failed */
118 	short	rts_wildcard;		/* lookups satisfied by a wildcard */
119 };
120 /*
121  * Structures for routing messages.
122  */
123 struct rt_msghdr {
124 	u_short	rtm_msglen;	/* to skip over non-understood messages */
125 	u_char	rtm_version;	/* future binary compatability */
126 	u_char	rtm_type;	/* message type */
127 	u_short	rtm_index;	/* index for associated ifp */
128 	pid_t	rtm_pid;	/* identify sender */
129 	int	rtm_addrs;	/* bitmask identifying sockaddrs in msg */
130 	int	rtm_seq;	/* for sender to identify action */
131 	int	rtm_errno;	/* why failed */
132 	int	rtm_flags;	/* flags, incl. kern & message, e.g. DONE */
133 	int	rtm_use;	/* from rtentry */
134 	u_long	rtm_inits;	/* which metrics we are initializing */
135 	struct	rt_metrics rtm_rmx; /* metrics themselves */
136 };
137 
138 struct route_cb {
139 	int	ip_count;
140 	int	ns_count;
141 	int	iso_count;
142 	int	any_count;
143 };
144 #define RTM_VERSION	2	/* Up the ante and ignore older versions */
145 
146 #define RTM_ADD		0x1	/* Add Route */
147 #define RTM_DELETE	0x2	/* Delete Route */
148 #define RTM_CHANGE	0x3	/* Change Metrics or flags */
149 #define RTM_GET		0x4	/* Report Metrics */
150 #define RTM_LOSING	0x5	/* Kernel Suspects Partitioning */
151 #define RTM_REDIRECT	0x6	/* Told to use different route */
152 #define RTM_MISS	0x7	/* Lookup failed on this address */
153 #define RTM_LOCK	0x8	/* fix specified metrics */
154 #define RTM_OLDADD	0x9	/* caused by SIOCADDRT */
155 #define RTM_OLDDEL	0xa	/* caused by SIOCDELRT */
156 #define RTM_RESOLVE	0xb	/* req to resolve dst to LL addr */
157 
158 #define RTV_MTU		0x1	/* init or lock _mtu */
159 #define RTV_HOPCOUNT	0x2	/* init or lock _hopcount */
160 #define RTV_EXPIRE	0x4	/* init or lock _hopcount */
161 #define RTV_RPIPE	0x8	/* init or lock _recvpipe */
162 #define RTV_SPIPE	0x10	/* init or lock _sendpipe */
163 #define RTV_SSTHRESH	0x20	/* init or lock _ssthresh */
164 #define RTV_RTT		0x40	/* init or lock _rtt */
165 #define RTV_RTTVAR	0x80	/* init or lock _rttvar */
166 
167 #define RTA_DST		0x1	/* destination sockaddr present */
168 #define RTA_GATEWAY	0x2	/* gateway sockaddr present */
169 #define RTA_NETMASK	0x4	/* netmask sockaddr present */
170 #define RTA_GENMASK	0x8	/* cloning mask sockaddr present */
171 #define RTA_IFP		0x10	/* interface name sockaddr present */
172 #define RTA_IFA		0x20	/* interface addr sockaddr present */
173 #define RTA_AUTHOR	0x40	/* sockaddr for author of redirect */
174 
175 #ifdef KERNEL
176 struct route_cb route_cb;
177 #endif
178 
179 #ifdef KERNEL
180 #define	RTFREE(rt) \
181 	if ((rt)->rt_refcnt <= 1) \
182 		rtfree(rt); \
183 	else \
184 		(rt)->rt_refcnt--;
185 
186 #ifdef	GATEWAY
187 #define	RTHASHSIZ	64
188 #else
189 #define	RTHASHSIZ	8
190 #endif
191 #if	(RTHASHSIZ & (RTHASHSIZ - 1)) == 0
192 #define RTHASHMOD(h)	((h) & (RTHASHSIZ - 1))
193 #else
194 #define RTHASHMOD(h)	((h) % RTHASHSIZ)
195 #endif
196 struct	mbuf *rthost[RTHASHSIZ];
197 struct	mbuf *rtnet[RTHASHSIZ];
198 struct	rtstat	rtstat;
199 struct	rtentry *rtalloc1();
200 #endif
201