1 /*        $NetBSD: in_pcb.h,v 1.76 2022/11/04 09:03:20 ozaki-r Exp $  */
2 
3 /*
4  * Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. Neither the name of the project nor the names of its contributors
16  *    may be used to endorse or promote products derived from this software
17  *    without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
30  */
31 
32 /*
33  * Copyright (c) 1982, 1986, 1990, 1993
34  *        The Regents of the University of California.  All rights reserved.
35  *
36  * Redistribution and use in source and binary forms, with or without
37  * modification, are permitted provided that the following conditions
38  * are met:
39  * 1. Redistributions of source code must retain the above copyright
40  *    notice, this list of conditions and the following disclaimer.
41  * 2. Redistributions in binary form must reproduce the above copyright
42  *    notice, this list of conditions and the following disclaimer in the
43  *    documentation and/or other materials provided with the distribution.
44  * 3. Neither the name of the University nor the names of its contributors
45  *    may be used to endorse or promote products derived from this software
46  *    without specific prior written permission.
47  *
48  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
49  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
50  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
51  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
52  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
53  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
54  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
55  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
56  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
57  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
58  * SUCH DAMAGE.
59  *
60  *        @(#)in_pcb.h        8.1 (Berkeley) 6/10/93
61  */
62 
63 #ifndef _NETINET_IN_PCB_H_
64 #define _NETINET_IN_PCB_H_
65 
66 #include <sys/types.h>
67 
68 #include <net/route.h>
69 
70 #include <netinet/in.h>
71 #include <netinet/ip.h>
72 #include <netinet/ip6.h>
73 
74 typedef int (*pcb_overudp_cb_t)(struct mbuf **, int, struct socket *,
75     struct sockaddr *, void *);
76 
77 struct ip_moptions;
78 struct mbuf;
79 struct icmp6_filter;
80 
81 /*
82  * Common structure pcb for internet protocol implementation.
83  * Here are stored pointers to local and foreign host table
84  * entries, local and foreign socket numbers, and pointers
85  * up (to a socket structure) and down (to a protocol-specific)
86  * control block.
87  */
88 
89 struct inpcb {
90           LIST_ENTRY(inpcb) inp_hash;
91           LIST_ENTRY(inpcb) inp_lhash;
92           TAILQ_ENTRY(inpcb) inp_queue;
93           int         inp_af;           /* address family - AF_INET or AF_INET6 */
94           void *      inp_ppcb;                   /* pointer to per-protocol pcb */
95           int         inp_state;                  /* bind/connect state */
96 #define   INP_ATTACHED                  0
97 #define   INP_BOUND           1
98 #define   INP_CONNECTED                 2
99           int       inp_portalgo;
100           struct      socket *inp_socket;         /* back pointer to socket */
101           struct      inpcbtable *inp_table;
102           struct      inpcbpolicy *inp_sp;        /* security policy */
103           struct route        inp_route;          /* placeholder for routing entry */
104           in_port_t inp_fport;          /* foreign port */
105           in_port_t inp_lport;          /* local port */
106           int                 inp_flags;          /* generic IP/datagram flags */
107           struct mbuf         *inp_options;       /* IP options */
108           bool                inp_bindportonsend;
109 
110           /* We still need it for IPv6 due to v4-mapped addresses */
111           struct ip_moptions *inp_moptions;       /* IPv4 multicast options */
112 
113           pcb_overudp_cb_t    inp_overudp_cb;
114           void                *inp_overudp_arg;
115 };
116 
117 struct in4pcb {
118           struct inpcb        in4p_pcb;
119           struct ip in4p_ip;
120           int                 in4p_errormtu;      /* MTU of last xmit status = EMSGSIZE */
121           uint8_t             in4p_ip_minttl;
122           struct in_addr      in4p_prefsrcip; /* preferred src IP when wild  */
123 };
124 
125 #define in4p_faddr(inpcb)     (((struct in4pcb *)(inpcb))->in4p_ip.ip_dst)
126 #define in4p_laddr(inpcb)     (((struct in4pcb *)(inpcb))->in4p_ip.ip_src)
127 #define const_in4p_faddr(inpcb)         (((const struct in4pcb *)(inpcb))->in4p_ip.ip_dst)
128 #define const_in4p_laddr(inpcb)         (((const struct in4pcb *)(inpcb))->in4p_ip.ip_src)
129 #define in4p_ip(inpcb)                  (((struct in4pcb *)(inpcb))->in4p_ip)
130 #define in4p_errormtu(inpcb)  (((struct in4pcb *)(inpcb))->in4p_errormtu)
131 #define in4p_ip_minttl(inpcb) (((struct in4pcb *)(inpcb))->in4p_ip_minttl)
132 #define in4p_prefsrcip(inpcb) (((struct in4pcb *)(inpcb))->in4p_prefsrcip)
133 
134 struct in6pcb {
135           struct inpcb        in6p_pcb;
136           struct ip6_hdr      in6p_ip6;
137           int                 in6p_hops;          /* default IPv6 hop limit */
138           int                 in6p_cksum;         /* IPV6_CHECKSUM setsockopt */
139           struct icmp6_filter *in6p_icmp6filt;
140           struct ip6_pktopts  *in6p_outputopts; /* IP6 options for outgoing packets */
141           struct ip6_moptions *in6p_moptions;     /* IPv6 multicast options */
142 };
143 
144 #define in6p_faddr(inpcb)     (((struct in6pcb *)(inpcb))->in6p_ip6.ip6_dst)
145 #define in6p_laddr(inpcb)     (((struct in6pcb *)(inpcb))->in6p_ip6.ip6_src)
146 #define const_in6p_faddr(inpcb)         (((const struct in6pcb *)(inpcb))->in6p_ip6.ip6_dst)
147 #define const_in6p_laddr(inpcb)         (((const struct in6pcb *)(inpcb))->in6p_ip6.ip6_src)
148 #define in6p_ip6(inpcb)                 (((struct in6pcb *)(inpcb))->in6p_ip6)
149 #define in6p_flowinfo(inpcb)  (((struct in6pcb *)(inpcb))->in6p_ip6.ip6_flow)
150 #define const_in6p_flowinfo(inpcb)      (((const struct in6pcb *)(inpcb))->in6p_ip6.ip6_flow)
151 #define in6p_hops6(inpcb)     (((struct in6pcb *)(inpcb))->in6p_hops)
152 #define in6p_cksum(inpcb)     (((struct in6pcb *)(inpcb))->in6p_cksum)
153 #define in6p_icmp6filt(inpcb) (((struct in6pcb *)(inpcb))->in6p_icmp6filt)
154 #define in6p_outputopts(inpcb)          (((struct in6pcb *)(inpcb))->in6p_outputopts)
155 #define in6p_moptions(inpcb)  (((struct in6pcb *)(inpcb))->in6p_moptions)
156 
157 LIST_HEAD(inpcbhead, inpcb);
158 
159 /* flags in inp_flags: */
160 #define   INP_RECVOPTS                  0x0001    /* receive incoming IP options */
161 #define   INP_RECVRETOPTS               0x0002    /* receive IP options for reply */
162 #define   INP_RECVDSTADDR               0x0004    /* receive IP dst address */
163 #define   INP_HDRINCL                   0x0008    /* user supplies entire IP header */
164 #define   INP_HIGHPORT                  0x0010    /* (unused; FreeBSD compat) */
165 #define   INP_LOWPORT                   0x0020    /* user wants "low" port binding */
166 #define   INP_ANONPORT                  0x0040    /* port chosen for user */
167 #define   INP_RECVIF                    0x0080    /* receive incoming interface */
168 /* XXX should move to an UDP control block */
169 #define INP_ESPINUDP                    0x0100    /* ESP over UDP for NAT-T */
170 #define INP_ESPINUDP_NON_IKE  0x0200    /* ESP over UDP for NAT-T */
171 #define INP_NOHEADER                    0x0400    /* Kernel removes IP header
172                                                    * before feeding a packet
173                                                    * to the raw socket user.
174                                                    * The socket user will
175                                                    * not supply an IP header.
176                                                    * Cancels INP_HDRINCL.
177                                                    */
178 #define   INP_RECVTTL                   0x0800    /* receive incoming IP TTL */
179 #define   INP_RECVPKTINFO               0x1000    /* receive IP dst if/addr */
180 #define   INP_BINDANY                   0x2000    /* allow bind to any address */
181 #define   INP_CONTROLOPTS               (INP_RECVOPTS|INP_RECVRETOPTS|INP_RECVDSTADDR|\
182                                         INP_RECVIF|INP_RECVTTL|INP_RECVPKTINFO)
183 
184 /*
185  * Flags for IPv6 in inp_flags
186  * We define KAME's original flags in higher 16 bits as much as possible
187  * for compatibility with *bsd*s.
188  */
189 #define IN6P_RECVOPTS                   0x00001000 /* receive incoming IP6 options */
190 #define IN6P_RECVRETOPTS      0x00002000 /* receive IP6 options for reply */
191 #define IN6P_RECVDSTADDR      0x00004000 /* receive IP6 dst address */
192 #define IN6P_IPV6_V6ONLY      0x00008000 /* restrict AF_INET6 socket for v6 */
193 #define IN6P_PKTINFO                    0x00010000 /* receive IP6 dst and I/F */
194 #define IN6P_HOPLIMIT                   0x00020000 /* receive hoplimit */
195 #define IN6P_HOPOPTS                    0x00040000 /* receive hop-by-hop options */
196 #define IN6P_DSTOPTS                    0x00080000 /* receive dst options after rthdr */
197 #define IN6P_RTHDR            0x00100000 /* receive routing header */
198 #define IN6P_RTHDRDSTOPTS     0x00200000 /* receive dstoptions before rthdr */
199 #define IN6P_TCLASS           0x00400000 /* traffic class */
200 #define IN6P_BINDANY                    0x00800000 /* allow bind to any address */
201 #define IN6P_HIGHPORT                   0x01000000 /* user wants "high" port binding */
202 #define IN6P_LOWPORT                    0x02000000 /* user wants "low" port binding */
203 #define IN6P_ANONPORT                   0x04000000 /* port chosen for user */
204 #define IN6P_FAITH            0x08000000 /* accept FAITH'ed connections */
205 /* XXX should move to an UDP control block */
206 #define IN6P_ESPINUDP                   INP_ESPINUDP /* ESP over UDP for NAT-T */
207 
208 #define IN6P_RFC2292                    0x40000000 /* RFC2292 */
209 #define IN6P_MTU              0x80000000 /* use minimum MTU */
210 
211 #define IN6P_CONTROLOPTS      (IN6P_PKTINFO|IN6P_HOPLIMIT|IN6P_HOPOPTS|\
212                                          IN6P_DSTOPTS|IN6P_RTHDR|IN6P_RTHDRDSTOPTS|\
213                                          IN6P_TCLASS|IN6P_RFC2292|\
214                                          IN6P_MTU)
215 
216 #define   sotoinpcb(so)                 ((struct inpcb *)(so)->so_pcb)
217 #define soaf(so)              (so->so_proto->pr_domain->dom_family)
218 #define   inp_lock(inp)                 solock((inp)->inp_socket)
219 #define   inp_unlock(inp)               sounlock((inp)->inp_socket)
220 #define   inp_locked(inp)               solocked((inp)->inp_socket)
221 
222 TAILQ_HEAD(inpcbqueue, inpcb);
223 
224 struct vestigial_hooks;
225 
226 /* It's still referenced by kvm users */
227 struct inpcbtable {
228           struct      inpcbqueue inpt_queue;
229           struct      inpcbhead *inpt_porthashtbl;
230           struct      inpcbhead *inpt_bindhashtbl;
231           struct      inpcbhead *inpt_connecthashtbl;
232           u_long      inpt_porthash;
233           u_long      inpt_bindhash;
234           u_long      inpt_connecthash;
235           in_port_t inpt_lastport;
236           in_port_t inpt_lastlow;
237 
238           struct vestigial_hooks *vestige;
239 };
240 #define inpt_lasthi inpt_lastport
241 
242 #ifdef _KERNEL
243 
244 #include <sys/kauth.h>
245 #include <sys/queue.h>
246 
247 struct lwp;
248 struct rtentry;
249 struct sockaddr_in;
250 struct socket;
251 struct vestigial_inpcb;
252 
253 void      inpcb_losing(struct inpcb *);
254 int       inpcb_create(struct socket *, void *);
255 int       inpcb_bindableaddr(const struct inpcb *, struct sockaddr_in *,
256     kauth_cred_t);
257 int       inpcb_bind(void *, struct sockaddr_in *, struct lwp *);
258 int       inpcb_connect(void *, struct sockaddr_in *, struct lwp *);
259 void      inpcb_destroy(void *);
260 void      inpcb_disconnect(void *);
261 void      inpcb_init(struct inpcbtable *, int, int);
262 struct inpcb *
263           inpcb_lookup_local(struct inpcbtable *,
264                                 struct in_addr, u_int, int, struct vestigial_inpcb *);
265 struct inpcb *
266           inpcb_lookup_bound(struct inpcbtable *,
267               struct in_addr, u_int);
268 struct inpcb *
269           inpcb_lookup(struct inpcbtable *,
270                                    struct in_addr, u_int, struct in_addr, u_int,
271                                    struct vestigial_inpcb *);
272 int       inpcb_notify(struct inpcbtable *, struct in_addr, u_int,
273               struct in_addr, u_int, int, void (*)(struct inpcb *, int));
274 void      inpcb_notifyall(struct inpcbtable *, struct in_addr, int,
275               void (*)(struct inpcb *, int));
276 void      inpcb_purgeif0(struct inpcbtable *, struct ifnet *);
277 void      inpcb_purgeif(struct inpcbtable *, struct ifnet *);
278 void      in_purgeifmcast(struct ip_moptions *, struct ifnet *);
279 void      inpcb_set_state(struct inpcb *, int);
280 void      inpcb_rtchange(struct inpcb *, int);
281 void      inpcb_fetch_peeraddr(struct inpcb *, struct sockaddr_in *);
282 void      inpcb_fetch_sockaddr(struct inpcb *, struct sockaddr_in *);
283 struct rtentry *
284           inpcb_rtentry(struct inpcb *);
285 void      inpcb_rtentry_unref(struct rtentry *, struct inpcb *);
286 
287 void      in6pcb_init(struct inpcbtable *, int, int);
288 int       in6pcb_bind(void *, struct sockaddr_in6 *, struct lwp *);
289 int       in6pcb_connect(void *, struct sockaddr_in6 *, struct lwp *);
290 void      in6pcb_destroy(struct inpcb *);
291 void      in6pcb_disconnect(struct inpcb *);
292 struct    inpcb *in6pcb_lookup_local(struct inpcbtable *, struct in6_addr *,
293                                            u_int, int, struct vestigial_inpcb *);
294 int       in6pcb_notify(struct inpcbtable *, const struct sockaddr *,
295           u_int, const struct sockaddr *, u_int, int, void *,
296           void (*)(struct inpcb *, int));
297 void      in6pcb_purgeif0(struct inpcbtable *, struct ifnet *);
298 void      in6pcb_purgeif(struct inpcbtable *, struct ifnet *);
299 void      in6pcb_set_state(struct inpcb *, int);
300 void      in6pcb_rtchange(struct inpcb *, int);
301 void      in6pcb_fetch_peeraddr(struct inpcb *, struct sockaddr_in6 *);
302 void      in6pcb_fetch_sockaddr(struct inpcb *, struct sockaddr_in6 *);
303 
304 /* in in6_src.c */
305 int       in6pcb_selecthlim(struct inpcb *, struct ifnet *);
306 int       in6pcb_selecthlim_rt(struct inpcb *);
307 int       in6pcb_set_port(struct sockaddr_in6 *, struct inpcb *, struct lwp *);
308 
309 extern struct rtentry *
310           in6pcb_rtentry(struct inpcb *);
311 extern void
312           in6pcb_rtentry_unref(struct rtentry *, struct inpcb *);
313 extern struct inpcb *in6pcb_lookup(struct inpcbtable *,
314                                                       const struct in6_addr *, u_int, const struct in6_addr *, u_int, int,
315                                                       struct vestigial_inpcb *);
316 extern struct inpcb *in6pcb_lookup_bound(struct inpcbtable *,
317           const struct in6_addr *, u_int, int);
318 
319 static inline void
inpcb_register_overudp_cb(struct inpcb * inp,pcb_overudp_cb_t cb,void * arg)320 inpcb_register_overudp_cb(struct inpcb *inp, pcb_overudp_cb_t cb, void *arg)
321 {
322 
323           inp->inp_overudp_cb = cb;
324           inp->inp_overudp_arg = arg;
325 }
326 
327 /* compute hash value for foreign and local in6_addr and port */
328 #define IN6_HASH(faddr, fport, laddr, lport)                          \
329           (((faddr)->s6_addr32[0] ^ (faddr)->s6_addr32[1] ^ \
330             (faddr)->s6_addr32[2] ^ (faddr)->s6_addr32[3] ^ \
331             (laddr)->s6_addr32[0] ^ (laddr)->s6_addr32[1] ^ \
332             (laddr)->s6_addr32[2] ^ (laddr)->s6_addr32[3])  \
333            + (fport) + (lport))
334 
335 // from in_pcb_hdr.h
336 struct vestigial_inpcb;
337 struct in6_addr;
338 
339 /* Hooks for vestigial pcb entries.
340  * If vestigial entries exist for a table (TCP only)
341  * the vestigial pointer is set.
342  */
343 typedef struct vestigial_hooks {
344           /* IPv4 hooks */
345           void      *(*init_ports4)(struct in_addr, u_int, int);
346           int       (*next_port4)(void *, struct vestigial_inpcb *);
347           int       (*lookup4)(struct in_addr, uint16_t,
348                                  struct in_addr, uint16_t,
349                                  struct vestigial_inpcb *);
350           /* IPv6 hooks */
351           void      *(*init_ports6)(const struct in6_addr*, u_int, int);
352           int       (*next_port6)(void *, struct vestigial_inpcb *);
353           int       (*lookup6)(const struct in6_addr *, uint16_t,
354                                  const struct in6_addr *, uint16_t,
355                                  struct vestigial_inpcb *);
356 } vestigial_hooks_t;
357 
358 #endif    /* _KERNEL */
359 
360 #endif    /* !_NETINET_IN_PCB_H_ */
361