1 /*        $NetBSD: in_var.h,v 1.103 2022/11/19 08:00:51 yamt Exp $    */
2 
3 /*-
4  * Copyright (c) 1998 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Public Access Networks Corporation ("Panix").  It was developed under
9  * contract to Panix by Eric Haszlakiewicz and Thor Lancelot Simon.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 /*
34  * Copyright (c) 1985, 1986, 1993
35  *        The Regents of the University of California.  All rights reserved.
36  *
37  * Redistribution and use in source and binary forms, with or without
38  * modification, are permitted provided that the following conditions
39  * are met:
40  * 1. Redistributions of source code must retain the above copyright
41  *    notice, this list of conditions and the following disclaimer.
42  * 2. Redistributions in binary form must reproduce the above copyright
43  *    notice, this list of conditions and the following disclaimer in the
44  *    documentation and/or other materials provided with the distribution.
45  * 3. Neither the name of the University nor the names of its contributors
46  *    may be used to endorse or promote products derived from this software
47  *    without specific prior written permission.
48  *
49  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
50  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
51  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
52  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
53  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
54  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
55  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
56  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
57  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
58  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
59  * SUCH DAMAGE.
60  *
61  *        @(#)in_var.h        8.2 (Berkeley) 1/9/95
62  */
63 
64 #ifndef _NETINET_IN_VAR_H_
65 #define _NETINET_IN_VAR_H_
66 
67 #include <sys/queue.h>
68 
69 #define IN_IFF_TENTATIVE      0x01      /* tentative address */
70 #define IN_IFF_DUPLICATED     0x02      /* DAD detected duplicate */
71 #define IN_IFF_DETACHED                 0x04      /* may be detached from the link */
72 #define IN_IFF_TRYTENTATIVE   0x08      /* intent to try DAD */
73 
74 #define IN_IFFBITS \
75     "\020\1TENTATIVE\2DUPLICATED\3DETACHED\4TRYTENTATIVE"
76 
77 /* do not input/output */
78 #define IN_IFF_NOTREADY \
79     (IN_IFF_TRYTENTATIVE | IN_IFF_TENTATIVE | IN_IFF_DUPLICATED)
80 
81 /*
82  * Interface address, Internet version.  One of these structures
83  * is allocated for each interface with an Internet address.
84  * The ifaddr structure contains the protocol-independent part
85  * of the structure and is assumed to be first.
86  */
87 struct in_ifaddr {
88           struct    ifaddr ia_ifa;                /* protocol-independent info */
89 #define   ia_ifp              ia_ifa.ifa_ifp
90 #define ia_flags    ia_ifa.ifa_flags
91                                                   /* ia_{,sub}net{,mask} in host order */
92           u_int32_t ia_net;             /* network number of interface */
93           u_int32_t ia_netmask;                   /* mask of net part */
94           u_int32_t ia_subnet;                    /* subnet number, including net */
95           u_int32_t ia_subnetmask;      /* mask of subnet part */
96           struct    in_addr ia_netbroadcast; /* to recognize net broadcasts */
97           LIST_ENTRY(in_ifaddr) ia_hash;          /* entry in bucket of inet addresses */
98           TAILQ_ENTRY(in_ifaddr) ia_list;         /* list of internet addresses */
99           struct    sockaddr_in ia_addr;          /* reserve space for interface name */
100           struct    sockaddr_in ia_dstaddr;       /* reserve space for broadcast addr */
101 #define   ia_broadaddr        ia_dstaddr
102           struct    sockaddr_in ia_sockmask; /* reserve space for general netmask */
103           LIST_HEAD(, in_multi) ia_multiaddrs; /* list of multicast addresses */
104           struct    in_multi *ia_allhosts;        /* multicast address record for
105                                                      the allhosts multicast group */
106           uint16_t ia_idsalt;           /* ip_id salt for this ia */
107           int       ia4_flags;                    /* address flags */
108           void      (*ia_dad_start) (struct ifaddr *);      /* DAD start function */
109           void      (*ia_dad_stop) (struct ifaddr *);       /* DAD stop function */
110           time_t    ia_dad_defended;    /* last time of DAD defence */
111 
112 #ifdef _KERNEL
113           struct pslist_entry ia_hash_pslist_entry;
114           struct pslist_entry ia_pslist_entry;
115 #endif
116 };
117 
118 struct in_nbrinfo {
119           char ifname[IFNAMSIZ];        /* if name, e.g. "en0" */
120           struct in_addr addr;          /* IPv4 address of the neighbor */
121           long      asked;              /* number of queries already sent for this addr */
122           int       state;              /* reachability state */
123           int       expire;             /* lifetime for NDP state transition */
124 };
125 
126 #ifdef _KERNEL
127 static __inline void
ia4_acquire(struct in_ifaddr * ia,struct psref * psref)128 ia4_acquire(struct in_ifaddr *ia, struct psref *psref)
129 {
130 
131           KASSERT(ia != NULL);
132           ifa_acquire(&ia->ia_ifa, psref);
133 }
134 
135 static __inline void
ia4_release(struct in_ifaddr * ia,struct psref * psref)136 ia4_release(struct in_ifaddr *ia, struct psref *psref)
137 {
138 
139           if (ia == NULL)
140                     return;
141           ifa_release(&ia->ia_ifa, psref);
142 }
143 #endif
144 
145 struct    in_aliasreq {
146           char      ifra_name[IFNAMSIZ];                    /* if name, e.g. "en0" */
147           struct    sockaddr_in ifra_addr;
148           struct    sockaddr_in ifra_dstaddr;
149 #define   ifra_broadaddr      ifra_dstaddr
150           struct    sockaddr_in ifra_mask;
151 };
152 
153 /*
154  * Given a pointer to an in_ifaddr (ifaddr),
155  * return a pointer to the addr as a sockaddr_in.
156  */
157 #define   IA_SIN(ia) (&(((struct in_ifaddr *)(ia))->ia_addr))
158 
159 #ifdef _KERNEL
160 
161 /* Note: 61, 127, 251, 509, 1021, 2039 are good. */
162 #ifndef IN_IFADDR_HASH_SIZE
163 #define IN_IFADDR_HASH_SIZE   509
164 #endif
165 
166 /*
167  * This is a bit unconventional, and wastes a little bit of space, but
168  * because we want a very even hash function we don't use & in_ifaddrhash
169  * here, but rather % the hash size, which should obviously be prime.
170  */
171 
172 #define   IN_IFADDR_HASH(x) in_ifaddrhashtbl[(u_long)(x) % IN_IFADDR_HASH_SIZE]
173 
174 LIST_HEAD(in_ifaddrhashhead, in_ifaddr);          /* Type of the hash head */
175 TAILQ_HEAD(in_ifaddrhead, in_ifaddr);             /* Type of the list head */
176 
177 extern    u_long in_ifaddrhash;                             /* size of hash table - 1 */
178 extern  struct in_ifaddrhashhead *in_ifaddrhashtbl;         /* Hash table head */
179 extern  struct in_ifaddrhead in_ifaddrhead;                 /* List head (in ip_input) */
180 
181 extern pserialize_t in_ifaddrhash_psz;
182 extern struct pslist_head *in_ifaddrhashtbl_pslist;
183 extern u_long in_ifaddrhash_pslist;
184 extern struct pslist_head in_ifaddrhead_pslist;
185 
186 #define IN_IFADDR_HASH_PSLIST(x)                                                \
187           in_ifaddrhashtbl_pslist[(u_long)(x) % IN_IFADDR_HASH_SIZE]
188 
189 #define IN_ADDRHASH_READER_FOREACH(__ia, __addr)                      \
190           PSLIST_READER_FOREACH((__ia), &IN_IFADDR_HASH_PSLIST(__addr),         \
191               struct in_ifaddr, ia_hash_pslist_entry)
192 #define IN_ADDRHASH_WRITER_INSERT_HEAD(__ia)                                    \
193           PSLIST_WRITER_INSERT_HEAD(                                            \
194               &IN_IFADDR_HASH_PSLIST((__ia)->ia_addr.sin_addr.s_addr),          \
195               (__ia), ia_hash_pslist_entry)
196 #define IN_ADDRHASH_WRITER_REMOVE(__ia)                                         \
197           PSLIST_WRITER_REMOVE((__ia), ia_hash_pslist_entry)
198 #define IN_ADDRHASH_ENTRY_INIT(__ia)                                            \
199           PSLIST_ENTRY_INIT((__ia), ia_hash_pslist_entry);
200 #define IN_ADDRHASH_ENTRY_DESTROY(__ia)                                         \
201           PSLIST_ENTRY_DESTROY((__ia), ia_hash_pslist_entry);
202 #define IN_ADDRHASH_READER_NEXT(__ia)                                           \
203           PSLIST_READER_NEXT((__ia), struct in_ifaddr, ia_hash_pslist_entry)
204 
205 #define IN_ADDRLIST_ENTRY_INIT(__ia)                                            \
206           PSLIST_ENTRY_INIT((__ia), ia_pslist_entry)
207 #define IN_ADDRLIST_ENTRY_DESTROY(__ia)                                         \
208           PSLIST_ENTRY_DESTROY((__ia), ia_pslist_entry);
209 #define IN_ADDRLIST_READER_EMPTY()                                              \
210           (PSLIST_READER_FIRST(&in_ifaddrhead_pslist, struct in_ifaddr,         \
211                                ia_pslist_entry) == NULL)
212 #define IN_ADDRLIST_READER_FIRST()                                              \
213           PSLIST_READER_FIRST(&in_ifaddrhead_pslist, struct in_ifaddr,          \
214                               ia_pslist_entry)
215 #define IN_ADDRLIST_READER_NEXT(__ia)                                           \
216           PSLIST_READER_NEXT((__ia), struct in_ifaddr, ia_pslist_entry)
217 #define IN_ADDRLIST_READER_FOREACH(__ia)                                        \
218           PSLIST_READER_FOREACH((__ia), &in_ifaddrhead_pslist,                  \
219                                 struct in_ifaddr, ia_pslist_entry)
220 #define IN_ADDRLIST_WRITER_INSERT_HEAD(__ia)                                    \
221           PSLIST_WRITER_INSERT_HEAD(&in_ifaddrhead_pslist, (__ia),    \
222               ia_pslist_entry)
223 #define IN_ADDRLIST_WRITER_REMOVE(__ia)                                         \
224           PSLIST_WRITER_REMOVE((__ia), ia_pslist_entry)
225 #define IN_ADDRLIST_WRITER_FOREACH(__ia)                                        \
226           PSLIST_WRITER_FOREACH((__ia), &in_ifaddrhead_pslist,                  \
227                                 struct in_ifaddr, ia_pslist_entry)
228 #define IN_ADDRLIST_WRITER_FIRST()                                              \
229           PSLIST_WRITER_FIRST(&in_ifaddrhead_pslist, struct in_ifaddr,          \
230                               ia_pslist_entry)
231 #define IN_ADDRLIST_WRITER_NEXT(__ia)                                           \
232           PSLIST_WRITER_NEXT((__ia), struct in_ifaddr, ia_pslist_entry)
233 #define IN_ADDRLIST_WRITER_INSERT_AFTER(__ia, __new)                            \
234           PSLIST_WRITER_INSERT_AFTER((__ia), (__new), ia_pslist_entry)
235 #define IN_ADDRLIST_WRITER_EMPTY()                                              \
236           (PSLIST_WRITER_FIRST(&in_ifaddrhead_pslist, struct in_ifaddr,         \
237               ia_pslist_entry) == NULL)
238 #define IN_ADDRLIST_WRITER_INSERT_TAIL(__new)                                   \
239           do {                                                                            \
240                     if (IN_ADDRLIST_WRITER_EMPTY()) {                           \
241                               IN_ADDRLIST_WRITER_INSERT_HEAD((__new));          \
242                     } else {                                                    \
243                               struct in_ifaddr *__ia;                                     \
244                               IN_ADDRLIST_WRITER_FOREACH(__ia) {                \
245                                         if (IN_ADDRLIST_WRITER_NEXT(__ia) == NULL) { \
246                                                   IN_ADDRLIST_WRITER_INSERT_AFTER(__ia,\
247                                                       (__new));                           \
248                                                   break;                                  \
249                                         }                                                 \
250                               }                                                           \
251                     }                                                                     \
252           } while (0)
253 
254 extern    const     int       inetctlerrmap[];
255 
256 /*
257  * Find whether an internet address (in_addr) belongs to one
258  * of our interfaces (in_ifaddr).  NULL if the address isn't ours.
259  */
260 static __inline struct in_ifaddr *
in_get_ia(struct in_addr addr)261 in_get_ia(struct in_addr addr)
262 {
263           struct in_ifaddr *ia;
264 
265           IN_ADDRHASH_READER_FOREACH(ia, addr.s_addr) {
266                     if (in_hosteq(ia->ia_addr.sin_addr, addr))
267                               break;
268           }
269 
270           return ia;
271 }
272 
273 static __inline struct in_ifaddr *
in_get_ia_psref(struct in_addr addr,struct psref * psref)274 in_get_ia_psref(struct in_addr addr, struct psref *psref)
275 {
276           struct in_ifaddr *ia;
277           int s;
278 
279           s = pserialize_read_enter();
280           ia = in_get_ia(addr);
281           if (ia != NULL)
282                     ia4_acquire(ia, psref);
283           pserialize_read_exit(s);
284 
285           return ia;
286 }
287 
288 /*
289  * Find whether an internet address (in_addr) belongs to a specified
290  * interface.  NULL if the address isn't ours.
291  */
292 static __inline struct in_ifaddr *
in_get_ia_on_iface(struct in_addr addr,struct ifnet * ifp)293 in_get_ia_on_iface(struct in_addr addr, struct ifnet *ifp)
294 {
295           struct in_ifaddr *ia;
296 
297           IN_ADDRHASH_READER_FOREACH(ia, addr.s_addr) {
298                     if (in_hosteq(ia->ia_addr.sin_addr, addr) &&
299                         ia->ia_ifp == ifp)
300                               break;
301           }
302 
303           return ia;
304 }
305 
306 static __inline struct in_ifaddr *
in_get_ia_on_iface_psref(struct in_addr addr,struct ifnet * ifp,struct psref * psref)307 in_get_ia_on_iface_psref(struct in_addr addr, struct ifnet *ifp, struct psref *psref)
308 {
309           struct in_ifaddr *ia;
310           int s;
311 
312           s = pserialize_read_enter();
313           ia = in_get_ia_on_iface(addr, ifp);
314           if (ia != NULL)
315                     ia4_acquire(ia, psref);
316           pserialize_read_exit(s);
317 
318           return ia;
319 }
320 
321 /*
322  * Find an internet address structure (in_ifaddr) corresponding
323  * to a given interface (ifnet structure).
324  */
325 static __inline struct in_ifaddr *
in_get_ia_from_ifp(struct ifnet * ifp)326 in_get_ia_from_ifp(struct ifnet *ifp)
327 {
328           struct ifaddr *ifa;
329 
330           IFADDR_READER_FOREACH(ifa, ifp) {
331                     if (ifa->ifa_addr->sa_family == AF_INET)
332                               break;
333           }
334 
335           return ifatoia(ifa);
336 }
337 
338 static __inline struct in_ifaddr *
in_get_ia_from_ifp_psref(struct ifnet * ifp,struct psref * psref)339 in_get_ia_from_ifp_psref(struct ifnet *ifp, struct psref *psref)
340 {
341           struct in_ifaddr *ia;
342           int s;
343 
344           s = pserialize_read_enter();
345           ia = in_get_ia_from_ifp(ifp);
346           if (ia != NULL)
347                     ia4_acquire(ia, psref);
348           pserialize_read_exit(s);
349 
350           return ia;
351 }
352 
353 #include <netinet/in_selsrc.h>
354 /*
355  * IPv4 per-interface state.
356  */
357 struct in_ifinfo {
358           struct lltable                *ii_llt;  /* ARP state */
359           struct in_ifsysctl  *ii_selsrc;
360 #ifdef MBUFTRACE
361           struct mowner                 ii_mowner;
362 #endif
363 };
364 
365 #endif /* _KERNEL */
366 
367 /*
368  * Internet multicast address structure.  There is one of these for each IP
369  * multicast group to which this host belongs on a given network interface.
370  * They are kept in a linked list, rooted in the interface's in_ifaddr
371  * structure.
372  */
373 struct router_info;
374 
375 struct in_multi {
376           LIST_ENTRY(in_multi) inm_list;          /* list of multicast addresses */
377           struct    router_info *inm_rti;         /* router version info */
378           struct    ifnet *inm_ifp;               /* back pointer to ifnet */
379           struct    in_addr inm_addr;   /* IP multicast address */
380           u_int     inm_refcount;                 /* no. membership claims by sockets */
381           u_int     inm_timer;                    /* IGMP membership report timer */
382           u_int     inm_state;                    /* state of membership */
383 };
384 
385 #ifdef _KERNEL
386 
387 #include <net/pktqueue.h>
388 #include <sys/cprng.h>
389 
390 extern pktqueue_t *ip_pktq;
391 
392 extern int ip_dad_count;                /* Duplicate Address Detection probes */
393 
394 static inline bool
ip_dad_enabled(void)395 ip_dad_enabled(void)
396 {
397 #if NARP > 0
398           return ip_dad_count > 0;
399 #else
400           return false;
401 #endif
402 }
403 
404 #if defined(INET) && NARP > 0
405 extern int arp_debug;
406 #define ARPLOGADDR(a) IN_PRINT(_ipbuf, a)
407 #define ARPLOG(level, fmt, args...)                                             \
408           do {                                                                            \
409                     char _ipbuf[INET_ADDRSTRLEN];                               \
410                     (void)_ipbuf;                                                         \
411                     if (arp_debug)                                                        \
412                               log(level, "%s: " fmt, __func__, ##args);         \
413           } while (/*CONSTCOND*/0)
414 #else
415 #define ARPLOG(level, fmt, args...)
416 #endif
417 
418 /*
419  * Structure used by functions below to remember position when stepping
420  * through all of the in_multi records.
421  */
422 struct in_multistep {
423           int i_n;
424           struct in_multi *i_inm;
425 };
426 
427 bool in_multi_group(struct in_addr, struct ifnet *, int);
428 struct in_multi *in_first_multi(struct in_multistep *);
429 struct in_multi *in_next_multi(struct in_multistep *);
430 struct in_multi *in_lookup_multi(struct in_addr, struct ifnet *);
431 struct in_multi *in_addmulti(struct in_addr *, struct ifnet *);
432 void in_delmulti(struct in_multi *);
433 
434 void in_multi_lock(int);
435 void in_multi_unlock(void);
436 int in_multi_lock_held(void);
437 
438 struct ifaddr;
439 
440 int       in_ifinit(struct ifnet *, struct in_ifaddr *,
441     const struct sockaddr_in *, const struct sockaddr_in *, int);
442 void      in_savemkludge(struct in_ifaddr *);
443 void      in_restoremkludge(struct in_ifaddr *, struct ifnet *);
444 void      in_purgemkludge(struct ifnet *);
445 void      in_setmaxmtu(void);
446 int       in_control(struct socket *, u_long, void *, struct ifnet *);
447 void      in_purgeaddr(struct ifaddr *);
448 void      in_purgeif(struct ifnet *);
449 void      in_addrhash_insert(struct in_ifaddr *);
450 void      in_addrhash_remove(struct in_ifaddr *);
451 int       ipflow_fastforward(struct mbuf *);
452 
453 extern uint16_t               ip_id;
454 extern int                    ip_do_randomid;
455 
456 static __inline uint16_t
ip_randomid(void)457 ip_randomid(void)
458 {
459 
460           uint16_t id = (uint16_t)cprng_fast32();
461           return id ? id : 1;
462 }
463 
464 /*
465  * ip_newid_range: "allocate" num contiguous IP IDs.
466  *
467  * => Return the first ID.
468  */
469 static __inline uint16_t
ip_newid_range(const struct in_ifaddr * ia,u_int num)470 ip_newid_range(const struct in_ifaddr *ia, u_int num)
471 {
472           uint16_t id;
473 
474           if (ip_do_randomid) {
475                     /* XXX ignore num */
476                     return ip_randomid();
477           }
478 
479           /* Never allow an IP ID of 0 (detect wrap). */
480           if ((uint16_t)(ip_id + num) < ip_id) {
481                     ip_id = 1;
482           }
483           id = htons(ip_id);
484           ip_id += num;
485           return id;
486 }
487 
488 static __inline uint16_t
ip_newid(const struct in_ifaddr * ia)489 ip_newid(const struct in_ifaddr *ia)
490 {
491 
492           return ip_newid_range(ia, 1);
493 }
494 
495 #ifdef SYSCTLFN_PROTO
496 int       sysctl_inpcblist(SYSCTLFN_PROTO);
497 #endif
498 
499 #define LLTABLE(ifp)          \
500           ((struct in_ifinfo *)(ifp)->if_afdata[AF_INET])->ii_llt
501 
502 #endif    /* !_KERNEL */
503 
504 /* INET6 stuff */
505 #include <netinet6/in6_var.h>
506 
507 #endif /* !_NETINET_IN_VAR_H_ */
508