xref: /freebsd/sys/netinet6/nd6.h (revision 1e413cf93298b5b97441a21d9a50fdcd0ee9945e)
1 /*-
2  * Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the project nor the names of its contributors
14  *    may be used to endorse or promote products derived from this software
15  *    without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  *	$KAME: nd6.h,v 1.76 2001/12/18 02:10:31 itojun Exp $
30  * $FreeBSD$
31  */
32 
33 #ifndef _NETINET6_ND6_H_
34 #define _NETINET6_ND6_H_
35 
36 /* see net/route.h, or net/if_inarp.h */
37 #ifndef RTF_ANNOUNCE
38 #define RTF_ANNOUNCE	RTF_PROTO2
39 #endif
40 
41 #include <sys/queue.h>
42 #include <sys/callout.h>
43 
44 struct	llinfo_nd6 {
45 	struct	llinfo_nd6 *ln_next;
46 	struct	llinfo_nd6 *ln_prev;
47 	struct	rtentry *ln_rt;
48 	struct	mbuf *ln_hold;	/* last packet until resolved/timeout */
49 	long	ln_asked;	/* number of queries already sent for this addr */
50 	u_long	ln_expire;	/* lifetime for NDP state transition */
51 	short	ln_state;	/* reachability state */
52 	short	ln_router;	/* 2^0: ND6 router bit */
53 	int	ln_byhint;	/* # of times we made it reachable by UL hint */
54 
55 	long	ln_ntick;
56 	struct callout ln_timer_ch;
57 };
58 
59 #define ND6_LLINFO_NOSTATE	-2
60 /*
61  * We don't need the WAITDELETE state any more, but we keep the definition
62  * in a comment line instead of removing it. This is necessary to avoid
63  * unintentionally reusing the value for another purpose, which might
64  * affect backward compatibility with old applications.
65  * (20000711 jinmei@kame.net)
66  */
67 /* #define ND6_LLINFO_WAITDELETE	-1 */
68 #define ND6_LLINFO_INCOMPLETE	0
69 #define ND6_LLINFO_REACHABLE	1
70 #define ND6_LLINFO_STALE	2
71 #define ND6_LLINFO_DELAY	3
72 #define ND6_LLINFO_PROBE	4
73 
74 #define ND6_IS_LLINFO_PROBREACH(n) ((n)->ln_state > ND6_LLINFO_INCOMPLETE)
75 #define ND6_LLINFO_PERMANENT(n) (((n)->ln_expire == 0) && ((n)->ln_state > ND6_LLINFO_INCOMPLETE))
76 
77 struct nd_ifinfo {
78 	u_int32_t linkmtu;		/* LinkMTU */
79 	u_int32_t maxmtu;		/* Upper bound of LinkMTU */
80 	u_int32_t basereachable;	/* BaseReachableTime */
81 	u_int32_t reachable;		/* Reachable Time */
82 	u_int32_t retrans;		/* Retrans Timer */
83 	u_int32_t flags;		/* Flags */
84 	int recalctm;			/* BaseReacable re-calculation timer */
85 	u_int8_t chlim;			/* CurHopLimit */
86 	u_int8_t initialized; /* Flag to see the entry is initialized */
87 	/* the following 3 members are for privacy extension for addrconf */
88 	u_int8_t randomseed0[8]; /* upper 64 bits of MD5 digest */
89 	u_int8_t randomseed1[8]; /* lower 64 bits (usually the EUI64 IFID) */
90 	u_int8_t randomid[8];	/* current random ID */
91 };
92 
93 #define ND6_IFF_PERFORMNUD	0x1
94 #define ND6_IFF_ACCEPT_RTADV	0x2
95 #define ND6_IFF_PREFER_SOURCE	0x4 /* XXX: not related to ND. */
96 #define ND6_IFF_IFDISABLED	0x8 /* IPv6 operation is disabled due to
97 				     * DAD failure.  (XXX: not ND-specific)
98 				     */
99 #define ND6_IFF_DONT_SET_IFROUTE	0x10
100 
101 #ifdef _KERNEL
102 #define ND_IFINFO(ifp) \
103 	(((struct in6_ifextra *)(ifp)->if_afdata[AF_INET6])->nd_ifinfo)
104 #define IN6_LINKMTU(ifp) \
105 	((ND_IFINFO(ifp)->linkmtu && ND_IFINFO(ifp)->linkmtu < (ifp)->if_mtu) \
106 	    ? ND_IFINFO(ifp)->linkmtu \
107 	    : ((ND_IFINFO(ifp)->maxmtu && ND_IFINFO(ifp)->maxmtu < (ifp)->if_mtu) \
108 		? ND_IFINFO(ifp)->maxmtu : (ifp)->if_mtu))
109 #endif
110 
111 struct in6_nbrinfo {
112 	char ifname[IFNAMSIZ];	/* if name, e.g. "en0" */
113 	struct in6_addr addr;	/* IPv6 address of the neighbor */
114 	long	asked;		/* number of queries already sent for this addr */
115 	int	isrouter;	/* if it acts as a router */
116 	int	state;		/* reachability state */
117 	int	expire;		/* lifetime for NDP state transition */
118 };
119 
120 #define DRLSTSIZ 10
121 #define PRLSTSIZ 10
122 struct	in6_drlist {
123 	char ifname[IFNAMSIZ];
124 	struct {
125 		struct	in6_addr rtaddr;
126 		u_char	flags;
127 		u_short	rtlifetime;
128 		u_long	expire;
129 		u_short if_index;
130 	} defrouter[DRLSTSIZ];
131 };
132 
133 struct	in6_defrouter {
134 	struct	sockaddr_in6 rtaddr;
135 	u_char	flags;
136 	u_short	rtlifetime;
137 	u_long	expire;
138 	u_short if_index;
139 };
140 
141 #ifdef _KERNEL
142 struct	in6_oprlist {
143 	char ifname[IFNAMSIZ];
144 	struct {
145 		struct	in6_addr prefix;
146 		struct prf_ra raflags;
147 		u_char	prefixlen;
148 		u_char	origin;
149 		u_long vltime;
150 		u_long pltime;
151 		u_long expire;
152 		u_short if_index;
153 		u_short advrtrs; /* number of advertisement routers */
154 		struct	in6_addr advrtr[DRLSTSIZ]; /* XXX: explicit limit */
155 	} prefix[PRLSTSIZ];
156 };
157 #endif
158 
159 struct	in6_prlist {
160 	char ifname[IFNAMSIZ];
161 	struct {
162 		struct	in6_addr prefix;
163 		struct prf_ra raflags;
164 		u_char	prefixlen;
165 		u_char	origin;
166 		u_int32_t vltime;
167 		u_int32_t pltime;
168 		time_t expire;
169 		u_short if_index;
170 		u_short advrtrs; /* number of advertisement routers */
171 		struct	in6_addr advrtr[DRLSTSIZ]; /* XXX: explicit limit */
172 	} prefix[PRLSTSIZ];
173 };
174 
175 struct in6_prefix {
176 	struct	sockaddr_in6 prefix;
177 	struct prf_ra raflags;
178 	u_char	prefixlen;
179 	u_char	origin;
180 	u_int32_t vltime;
181 	u_int32_t pltime;
182 	time_t expire;
183 	u_int32_t flags;
184 	int refcnt;
185 	u_short if_index;
186 	u_short advrtrs; /* number of advertisement routers */
187 	/* struct sockaddr_in6 advrtr[] */
188 };
189 
190 #ifdef _KERNEL
191 struct	in6_ondireq {
192 	char ifname[IFNAMSIZ];
193 	struct {
194 		u_int32_t linkmtu;	/* LinkMTU */
195 		u_int32_t maxmtu;	/* Upper bound of LinkMTU */
196 		u_int32_t basereachable; /* BaseReachableTime */
197 		u_int32_t reachable;	/* Reachable Time */
198 		u_int32_t retrans;	/* Retrans Timer */
199 		u_int32_t flags;	/* Flags */
200 		int recalctm;		/* BaseReacable re-calculation timer */
201 		u_int8_t chlim;		/* CurHopLimit */
202 		u_int8_t receivedra;
203 	} ndi;
204 };
205 #endif
206 
207 struct	in6_ndireq {
208 	char ifname[IFNAMSIZ];
209 	struct nd_ifinfo ndi;
210 };
211 
212 struct	in6_ndifreq {
213 	char ifname[IFNAMSIZ];
214 	u_long ifindex;
215 };
216 
217 /* Prefix status */
218 #define NDPRF_ONLINK		0x1
219 #define NDPRF_DETACHED		0x2
220 
221 /* protocol constants */
222 #define MAX_RTR_SOLICITATION_DELAY	1	/* 1sec */
223 #define RTR_SOLICITATION_INTERVAL	4	/* 4sec */
224 #define MAX_RTR_SOLICITATIONS		3
225 
226 #define ND6_INFINITE_LIFETIME		0xffffffff
227 
228 #ifdef _KERNEL
229 /* node constants */
230 #define MAX_REACHABLE_TIME		3600000	/* msec */
231 #define REACHABLE_TIME			30000	/* msec */
232 #define RETRANS_TIMER			1000	/* msec */
233 #define MIN_RANDOM_FACTOR		512	/* 1024 * 0.5 */
234 #define MAX_RANDOM_FACTOR		1536	/* 1024 * 1.5 */
235 #define DEF_TEMP_VALID_LIFETIME		604800	/* 1 week */
236 #define DEF_TEMP_PREFERRED_LIFETIME	86400	/* 1 day */
237 #define TEMPADDR_REGEN_ADVANCE		5	/* sec */
238 #define MAX_TEMP_DESYNC_FACTOR		600	/* 10 min */
239 #define ND_COMPUTE_RTIME(x) \
240 		(((MIN_RANDOM_FACTOR * (x >> 10)) + (arc4random() & \
241 		((MAX_RANDOM_FACTOR - MIN_RANDOM_FACTOR) * (x >> 10)))) /1000)
242 
243 TAILQ_HEAD(nd_drhead, nd_defrouter);
244 struct	nd_defrouter {
245 	TAILQ_ENTRY(nd_defrouter) dr_entry;
246 	struct	in6_addr rtaddr;
247 	u_char	flags;		/* flags on RA message */
248 	u_short	rtlifetime;
249 	u_long	expire;
250 	struct  ifnet *ifp;
251 	int	installed;	/* is installed into kernel routing table */
252 };
253 
254 struct nd_prefixctl {
255 	struct ifnet *ndpr_ifp;
256 
257 	/* prefix */
258 	struct sockaddr_in6 ndpr_prefix;
259 	u_char	ndpr_plen;
260 
261 	u_int32_t ndpr_vltime;	/* advertised valid lifetime */
262 	u_int32_t ndpr_pltime;	/* advertised preferred lifetime */
263 
264 	struct prf_ra ndpr_flags;
265 };
266 
267 
268 struct nd_prefix {
269 	struct ifnet *ndpr_ifp;
270 	LIST_ENTRY(nd_prefix) ndpr_entry;
271 	struct sockaddr_in6 ndpr_prefix;	/* prefix */
272 	struct in6_addr ndpr_mask; /* netmask derived from the prefix */
273 
274 	u_int32_t ndpr_vltime;	/* advertised valid lifetime */
275 	u_int32_t ndpr_pltime;	/* advertised preferred lifetime */
276 
277 	time_t ndpr_expire;	/* expiration time of the prefix */
278 	time_t ndpr_preferred;	/* preferred time of the prefix */
279 	time_t ndpr_lastupdate; /* reception time of last advertisement */
280 
281 	struct prf_ra ndpr_flags;
282 	u_int32_t ndpr_stateflags; /* actual state flags */
283 	/* list of routers that advertise the prefix: */
284 	LIST_HEAD(pr_rtrhead, nd_pfxrouter) ndpr_advrtrs;
285 	u_char	ndpr_plen;
286 	int	ndpr_refcnt;	/* reference couter from addresses */
287 };
288 
289 #define ndpr_next		ndpr_entry.le_next
290 
291 #define ndpr_raf		ndpr_flags
292 #define ndpr_raf_onlink		ndpr_flags.onlink
293 #define ndpr_raf_auto		ndpr_flags.autonomous
294 #define ndpr_raf_router		ndpr_flags.router
295 
296 /*
297  * Message format for use in obtaining information about prefixes
298  * from inet6 sysctl function
299  */
300 struct inet6_ndpr_msghdr {
301 	u_short	inpm_msglen;	/* to skip over non-understood messages */
302 	u_char	inpm_version;	/* future binary compatibility */
303 	u_char	inpm_type;	/* message type */
304 	struct in6_addr inpm_prefix;
305 	u_long	prm_vltim;
306 	u_long	prm_pltime;
307 	u_long	prm_expire;
308 	u_long	prm_preferred;
309 	struct in6_prflags prm_flags;
310 	u_short	prm_index;	/* index for associated ifp */
311 	u_char	prm_plen;	/* length of prefix in bits */
312 };
313 
314 #define prm_raf_onlink		prm_flags.prf_ra.onlink
315 #define prm_raf_auto		prm_flags.prf_ra.autonomous
316 
317 #define prm_statef_onlink	prm_flags.prf_state.onlink
318 
319 #define prm_rrf_decrvalid	prm_flags.prf_rr.decrvalid
320 #define prm_rrf_decrprefd	prm_flags.prf_rr.decrprefd
321 
322 struct nd_pfxrouter {
323 	LIST_ENTRY(nd_pfxrouter) pfr_entry;
324 #define pfr_next pfr_entry.le_next
325 	struct nd_defrouter *router;
326 };
327 
328 LIST_HEAD(nd_prhead, nd_prefix);
329 
330 /* nd6.c */
331 extern int nd6_prune;
332 extern int nd6_delay;
333 extern int nd6_umaxtries;
334 extern int nd6_mmaxtries;
335 extern int nd6_useloopback;
336 extern int nd6_maxnudhint;
337 extern int nd6_gctimer;
338 extern struct llinfo_nd6 llinfo_nd6;
339 extern struct nd_drhead nd_defrouter;
340 extern struct nd_prhead nd_prefix;
341 extern int nd6_debug;
342 
343 #define nd6log(x)	do { if (nd6_debug) log x; } while (/*CONSTCOND*/ 0)
344 
345 extern struct callout nd6_timer_ch;
346 
347 /* nd6_rtr.c */
348 extern int nd6_defifindex;
349 extern int ip6_desync_factor;	/* seconds */
350 extern u_int32_t ip6_temp_preferred_lifetime; /* seconds */
351 extern u_int32_t ip6_temp_valid_lifetime; /* seconds */
352 extern int ip6_temp_regen_advance; /* seconds */
353 
354 union nd_opts {
355 	struct nd_opt_hdr *nd_opt_array[8];	/* max = target address list */
356 	struct {
357 		struct nd_opt_hdr *zero;
358 		struct nd_opt_hdr *src_lladdr;
359 		struct nd_opt_hdr *tgt_lladdr;
360 		struct nd_opt_prefix_info *pi_beg; /* multiple opts, start */
361 		struct nd_opt_rd_hdr *rh;
362 		struct nd_opt_mtu *mtu;
363 		struct nd_opt_hdr *search;	/* multiple opts */
364 		struct nd_opt_hdr *last;	/* multiple opts */
365 		int done;
366 		struct nd_opt_prefix_info *pi_end;/* multiple opts, end */
367 	} nd_opt_each;
368 };
369 #define nd_opts_src_lladdr	nd_opt_each.src_lladdr
370 #define nd_opts_tgt_lladdr	nd_opt_each.tgt_lladdr
371 #define nd_opts_pi		nd_opt_each.pi_beg
372 #define nd_opts_pi_end		nd_opt_each.pi_end
373 #define nd_opts_rh		nd_opt_each.rh
374 #define nd_opts_mtu		nd_opt_each.mtu
375 #define nd_opts_search		nd_opt_each.search
376 #define nd_opts_last		nd_opt_each.last
377 #define nd_opts_done		nd_opt_each.done
378 
379 /* XXX: need nd6_var.h?? */
380 /* nd6.c */
381 void nd6_init __P((void));
382 struct nd_ifinfo *nd6_ifattach __P((struct ifnet *));
383 void nd6_ifdetach __P((struct nd_ifinfo *));
384 int nd6_is_addr_neighbor __P((struct sockaddr_in6 *, struct ifnet *));
385 void nd6_option_init __P((void *, int, union nd_opts *));
386 struct nd_opt_hdr *nd6_option __P((union nd_opts *));
387 int nd6_options __P((union nd_opts *));
388 struct	rtentry *nd6_lookup __P((struct in6_addr *, int, struct ifnet *));
389 void nd6_setmtu __P((struct ifnet *));
390 void nd6_llinfo_settimer __P((struct llinfo_nd6 *, long));
391 void nd6_timer __P((void *));
392 void nd6_purge __P((struct ifnet *));
393 void nd6_nud_hint __P((struct rtentry *, struct in6_addr *, int));
394 int nd6_resolve __P((struct ifnet *, struct rtentry *, struct mbuf *,
395 	struct sockaddr *, u_char *));
396 void nd6_rtrequest __P((int, struct rtentry *, struct rt_addrinfo *));
397 int nd6_ioctl __P((u_long, caddr_t, struct ifnet *));
398 struct rtentry *nd6_cache_lladdr __P((struct ifnet *, struct in6_addr *,
399 	char *, int, int, int));
400 int nd6_output __P((struct ifnet *, struct ifnet *, struct mbuf *,
401 	struct sockaddr_in6 *, struct rtentry *));
402 int nd6_need_cache __P((struct ifnet *));
403 int nd6_storelladdr __P((struct ifnet *, struct rtentry *, struct mbuf *,
404 	struct sockaddr *, u_char *));
405 
406 /* nd6_nbr.c */
407 void nd6_na_input __P((struct mbuf *, int, int));
408 void nd6_na_output __P((struct ifnet *, const struct in6_addr *,
409 	const struct in6_addr *, u_long, int, struct sockaddr *));
410 void nd6_ns_input __P((struct mbuf *, int, int));
411 void nd6_ns_output __P((struct ifnet *, const struct in6_addr *,
412 	const struct in6_addr *, struct llinfo_nd6 *, int));
413 caddr_t nd6_ifptomac __P((struct ifnet *));
414 void nd6_dad_start __P((struct ifaddr *, int));
415 void nd6_dad_stop __P((struct ifaddr *));
416 void nd6_dad_duplicated __P((struct ifaddr *));
417 
418 /* nd6_rtr.c */
419 void nd6_rs_input __P((struct mbuf *, int, int));
420 void nd6_ra_input __P((struct mbuf *, int, int));
421 void prelist_del __P((struct nd_prefix *));
422 void defrouter_addreq __P((struct nd_defrouter *));
423 void defrouter_reset __P((void));
424 void defrouter_select __P((void));
425 void defrtrlist_del __P((struct nd_defrouter *));
426 void prelist_remove __P((struct nd_prefix *));
427 int nd6_prelist_add __P((struct nd_prefixctl *, struct nd_defrouter *,
428 	struct nd_prefix **));
429 int nd6_prefix_onlink __P((struct nd_prefix *));
430 int nd6_prefix_offlink __P((struct nd_prefix *));
431 void pfxlist_onlink_check __P((void));
432 struct nd_defrouter *defrouter_lookup __P((struct in6_addr *, struct ifnet *));
433 struct nd_prefix *nd6_prefix_lookup __P((struct nd_prefixctl *));
434 void rt6_flush __P((struct in6_addr *, struct ifnet *));
435 int nd6_setdefaultiface __P((int));
436 int in6_tmpifadd __P((const struct in6_ifaddr *, int, int));
437 
438 #endif /* _KERNEL */
439 
440 #endif /* _NETINET6_ND6_H_ */
441