2 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
29 * Copyright (c) 1982, 1986, 1990, 1993
30 * The Regents of the University of California. All rights reserved.
32 * Redistribution and use in source and binary forms, with or without
33 * modification, are permitted provided that the following conditions
35 * 1. Redistributions of source code must retain the above copyright
36 * notice, this list of conditions and the following disclaimer.
37 * 2. Redistributions in binary form must reproduce the above copyright
38 * notice, this list of conditions and the following disclaimer in the
39 * documentation and/or other materials provided with the distribution.
40 * 3. All advertising materials mentioning features or use of this software
41 * must display the following acknowledgement:
42 * This product includes software developed by the University of
43 * California, Berkeley and its contributors.
44 * 4. 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.
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
60 * @(#)in_pcb.h 8.1 (Berkeley) 6/10/93
61 * $FreeBSD: src/sys/netinet/in_pcb.h,v 1.32.2.4 2001/08/13 16:26:17 ume Exp $
64 #ifndef _NETINET_IN_PCB_H_
65 #define _NETINET_IN_PCB_H_
66 #include <sys/appleapiopts.h>
68 #include <sys/types.h>
69 #include <sys/queue.h>
72 #include <kern/locks.h>
74 #endif /* KERNEL_PRIVATE */
76 #include <netinet6/ipsec.h> /* for IPSEC */
80 #define in6pcb inpcb /* for KAME src sync over BSD*'s */
81 #define in6p_sp inp_sp /* for KAME src sync over BSD*'s */
84 * Common structure pcb for internet protocol implementation.
85 * Here are stored pointers to local and foreign host table
86 * entries, local and foreign socket numbers, and pointers
87 * up (to a socket structure) and down (to a protocol-specific)
90 LIST_HEAD(inpcbhead
, inpcb
);
91 LIST_HEAD(inpcbporthead
, inpcbport
);
92 #endif /* KERNEL_PRIVATE */
93 typedef u_quad_t inp_gen_t
;
96 * PCB with AF_INET6 null bind'ed laddr can receive AF_INET input packet.
97 * So, AF_INET6 null laddr is also used as AF_INET null laddr,
98 * by utilize following structure. (At last, same as INRIA)
100 struct in_addr_4in6
{
101 u_int32_t ia46_pad32
[3];
102 struct in_addr ia46_addr4
;
105 #ifdef KERNEL_PRIVATE
107 * NB: the zone allocator is type-stable EXCEPT FOR THE FIRST TWO LONGS
108 * of the structure. Therefore, it is important that the members in
109 * that position not contain any information which is required to be
115 LIST_ENTRY(inpcb
) inp_hash
; /* hash list */
116 int inp_wantcnt
; /* pcb wanted count. protected by pcb list lock */
117 int inp_state
; /* state of this pcb, in use, recycled, ready for recycling... */
118 u_short inp_fport
; /* foreign port */
119 u_short inp_lport
; /* local port */
120 LIST_ENTRY(inpcb
) inp_list
; /* list for all PCBs of this proto */
121 caddr_t inp_ppcb
; /* pointer to per-protocol pcb */
122 struct inpcbinfo
*inp_pcbinfo
; /* PCB list info */
123 struct socket
*inp_socket
; /* back pointer to socket */
124 u_char nat_owner
; /* Used to NAT TCP/UDP traffic */
125 u_long nat_cookie
; /* Cookie stored and returned to NAT */
126 LIST_ENTRY(inpcb
) inp_portlist
; /* list for this PCB's local port */
127 struct inpcbport
*inp_phd
; /* head of this list */
128 inp_gen_t inp_gencnt
; /* generation count of this instance */
129 int inp_flags
; /* generic IP/datagram flags */
132 u_char inp_vflag
; /* INP_IPV4 or INP_IPV6 */
134 u_char inp_ip_ttl
; /* time to live proto */
135 u_char inp_ip_p
; /* protocol proto */
136 /* protocol dependent part */
138 /* foreign host table entry */
139 struct in_addr_4in6 inp46_foreign
;
140 struct in6_addr inp6_foreign
;
143 /* local host table entry */
144 struct in_addr_4in6 inp46_local
;
145 struct in6_addr inp6_local
;
148 /* placeholder for routing entry */
149 struct route inp4_route
;
150 struct route_in6 inp6_route
;
153 /* type of service proto */
156 struct mbuf
*inp4_options
;
157 /* IP multicast options */
158 struct ip_moptions
*inp4_moptions
;
162 struct mbuf
*inp6_options
;
164 u_int8_t unused_uint8_1
;
165 ushort unused_uint16_1
;
166 /* IP6 options for outgoing packets */
167 struct ip6_pktopts
*inp6_outputopts
;
168 /* IP multicast options */
169 struct ip6_moptions
*inp6_moptions
;
170 /* ICMPv6 code type filter */
171 struct icmp6_filter
*inp6_icmp6filt
;
172 /* IPV6_CHECKSUM setsockopt */
174 u_short inp6_ifindex
;
178 int hash_element
; /* Array index of pcb's hash list */
179 caddr_t inp_saved_ppcb
; /* place to save pointer while cached */
180 struct inpcbpolicy
*inp_sp
;
181 #ifdef _KERN_LOCKS_H_
182 lck_mtx_t
*inpcb_mtx
; /* inpcb per-socket mutex */
186 u_long reserved
[2]; /* For future use */
189 #endif /* KERNEL_PRIVATE */
192 * The range of the generation count, as used in this implementation,
193 * is 9e19. We would have to create 300 billion connections per
194 * second for this number to roll over in a year. This seems sufficiently
195 * unlikely that we simply don't concern ourselves with that possibility.
199 * Interface exported to userland by various protocols which use
200 * inpcbs. Hack alert -- only define if struct xsocket is in scope.
204 * This is a copy of the inpcb as it shipped in Panther. This structure
205 * is filled out in a copy function. This allows the inpcb to change
206 * without breaking userland tools.
208 * CAUTION: Many fields may not be filled out. Fewer may be filled out
209 * in the future. Code defensively.
211 #ifdef KERNEL_PRIVATE
212 struct inpcb_compat
{
223 #endif /* KERNEL_PRIVATE */
224 LIST_ENTRY(inpcb
) inp_hash
; /* hash list */
225 struct in_addr reserved1
; /* APPLE reserved: inp_faddr defined in protcol indep. part */
226 struct in_addr reserved2
; /* APPLE reserved */
227 u_short inp_fport
; /* foreign port */
228 u_short inp_lport
; /* local port */
229 LIST_ENTRY(inpcb
) inp_list
; /* list for all PCBs of this proto */
230 caddr_t inp_ppcb
; /* pointer to per-protocol pcb */
231 struct inpcbinfo
*inp_pcbinfo
; /* PCB list info */
232 void* inp_socket
; /* back pointer to socket */
233 u_char nat_owner
; /* Used to NAT TCP/UDP traffic */
234 u_long nat_cookie
; /* Cookie stored and returned to NAT */
235 LIST_ENTRY(inpcb
) inp_portlist
; /* list for this PCB's local port */
236 struct inpcbport
*inp_phd
; /* head of this list */
237 inp_gen_t inp_gencnt
; /* generation count of this instance */
238 int inp_flags
; /* generic IP/datagram flags */
243 u_char inp_ip_ttl
; /* time to live proto */
244 u_char inp_ip_p
; /* protocol proto */
245 /* protocol dependent part */
247 /* foreign host table entry */
248 struct in_addr_4in6 inp46_foreign
;
249 struct in6_addr inp6_foreign
;
252 /* local host table entry */
253 struct in_addr_4in6 inp46_local
;
254 struct in6_addr inp6_local
;
257 /* placeholder for routing entry */
258 u_char inp4_route
[20];
259 u_char inp6_route
[32];
262 /* type of service proto */
265 struct mbuf
*inp4_options
;
266 /* IP multicast options */
267 struct ip_moptions
*inp4_moptions
;
272 struct mbuf
*inp6_options
;
274 u_int8_t unused_uint8_1
;
275 ushort unused_uint16_1
;
276 /* IP6 options for outgoing packets */
277 struct ip6_pktopts
*inp6_outputopts
;
278 /* IP multicast options */
279 struct ip6_moptions
*inp6_moptions
;
280 /* ICMPv6 code type filter */
281 struct icmp6_filter
*inp6_icmp6filt
;
282 /* IPV6_CHECKSUM setsockopt */
284 u_short inp6_ifindex
;
288 int hash_element
; /* Array index of pcb's hash list */
289 caddr_t inp_saved_ppcb
; /* place to save pointer while cached */
290 struct inpcbpolicy
*inp_sp
;
291 u_long reserved
[3]; /* For future use */
295 size_t xi_len
; /* length of this structure */
296 #ifdef KERNEL_PRIVATE
297 struct inpcb_compat xi_inp
;
301 struct xsocket xi_socket
;
302 u_quad_t xi_alignment_hack
;
306 size_t xig_len
; /* length of this structure */
307 u_int xig_count
; /* number of PCBs at this time */
308 inp_gen_t xig_gen
; /* generation count at this time */
309 so_gen_t xig_sogen
; /* socket generation count at this time */
313 * These defines are for use with the inpcb.
317 #define inp_faddr inp_dependfaddr.inp46_foreign.ia46_addr4
318 #define inp_laddr inp_dependladdr.inp46_local.ia46_addr4
319 #define inp_route inp_dependroute.inp4_route
320 #define inp_ip_tos inp_depend4.inp4_ip_tos
321 #define inp_options inp_depend4.inp4_options
322 #define inp_moptions inp_depend4.inp4_moptions
323 #define in6p_faddr inp_dependfaddr.inp6_foreign
324 #define in6p_laddr inp_dependladdr.inp6_local
325 #define in6p_route inp_dependroute.inp6_route
326 #define in6p_ip6_hlim inp_depend6.inp6_hlim
327 #define in6p_hops inp_depend6.inp6_hops /* default hop limit */
328 #define in6p_ip6_nxt inp_ip_p
329 #define in6p_flowinfo inp_flow
330 #define in6p_vflag inp_vflag
331 #define in6p_options inp_depend6.inp6_options
332 #define in6p_outputopts inp_depend6.inp6_outputopts
333 #define in6p_moptions inp_depend6.inp6_moptions
334 #define in6p_icmp6filt inp_depend6.inp6_icmp6filt
335 #define in6p_cksum inp_depend6.inp6_cksum
336 #define inp6_ifindex inp_depend6.inp6_ifindex
337 #define in6p_flags inp_flags /* for KAME src sync over BSD*'s */
338 #define in6p_socket inp_socket /* for KAME src sync over BSD*'s */
339 #define in6p_lport inp_lport /* for KAME src sync over BSD*'s */
340 #define in6p_fport inp_fport /* for KAME src sync over BSD*'s */
341 #define in6p_ppcb inp_ppcb /* for KAME src sync over BSD*'s */
342 #define in6p_state inp_state
343 #define in6p_wantcnt inp_wantcnt
345 #ifdef KERNEL_PRIVATE
347 LIST_ENTRY(inpcbport
) phd_hash
;
348 struct inpcbhead phd_pcblist
;
352 struct inpcbinfo
{ /* XXX documentation, prefixes */
353 struct inpcbhead
*hashbase
;
355 u_long hashsize
; /* in elements */
358 struct inpcbporthead
*porthashbase
;
360 struct inpcbhead
*listhead
;
364 void *ipi_zone
; /* zone to allocate pcbs from */
365 u_int ipi_count
; /* number of pcbs in this list */
366 u_quad_t ipi_gencnt
; /* current generation count */
369 struct socket nat_dummy_socket
; /* fake socket for NAT pcb backpointer */
370 struct inpcb
*nat_dummy_pcb
; /* fake pcb for finding NAT mutex */
372 #ifdef _KERN_LOCKS_H_
373 lck_attr_t
*mtx_attr
; /* mutex attributes */
374 lck_grp_t
*mtx_grp
; /* mutex group definition */
375 lck_grp_attr_t
*mtx_grp_attr
; /* mutex group attributes */
376 lck_rw_t
*mtx
; /* global mutex for the pcblist*/
378 void *mtx_attr
; /* mutex attributes */
379 void *mtx_grp
; /* mutex group definition */
380 void *mtx_grp_attr
; /* mutex group attributes */
381 void *mtx
; /* global mutex for the pcblist*/
386 #define INP_PCBHASH(faddr, lport, fport, mask) \
387 (((faddr) ^ ((faddr) >> 16) ^ ntohs((lport) ^ (fport))) & (mask))
388 #define INP_PCBPORTHASH(lport, mask) \
389 (ntohs((lport)) & (mask))
391 #endif /* KERNEL_PRIVATE */
393 /* flags in inp_flags: */
394 #define INP_RECVOPTS 0x01 /* receive incoming IP options */
395 #define INP_RECVRETOPTS 0x02 /* receive IP options for reply */
396 #define INP_RECVDSTADDR 0x04 /* receive IP dst address */
397 #define INP_HDRINCL 0x08 /* user supplies entire IP header */
398 #define INP_HIGHPORT 0x10 /* user wants "high" port binding */
399 #define INP_LOWPORT 0x20 /* user wants "low" port binding */
400 #define INP_ANONPORT 0x40 /* port chosen for user */
401 #define INP_RECVIF 0x80 /* receive incoming interface */
402 #define INP_MTUDISC 0x100 /* user can do MTU discovery */
404 #define INP_STRIPHDR 0x200 /* Strip headers in raw_ip, for OT support */
406 #define INP_FAITH 0x400 /* accept FAITH'ed connections */
407 #define INP_INADDR_ANY 0x800 /* local address wasn't specified */
409 #define INP_RECVTTL 0x1000
411 #define IN6P_IPV6_V6ONLY 0x008000 /* restrict AF_INET6 socket for v6 */
413 #define IN6P_PKTINFO 0x010000 /* receive IP6 dst and I/F */
414 #define IN6P_HOPLIMIT 0x020000 /* receive hoplimit */
415 #define IN6P_HOPOPTS 0x040000 /* receive hop-by-hop options */
416 #define IN6P_DSTOPTS 0x080000 /* receive dst options after rthdr */
417 #define IN6P_RTHDR 0x100000 /* receive routing header */
418 #define IN6P_RTHDRDSTOPTS 0x200000 /* receive dstoptions before rthdr */
419 #define IN6P_AUTOFLOWLABEL 0x800000 /* attach flowlabel automatically */
420 #define IN6P_BINDV6ONLY 0x10000000 /* do not grab IPv4 traffic */
422 #ifdef KERNEL_PRIVATE
423 #define INP_CONTROLOPTS (INP_RECVOPTS|INP_RECVRETOPTS|INP_RECVDSTADDR|\
425 IN6P_PKTINFO|IN6P_HOPLIMIT|IN6P_HOPOPTS|\
426 IN6P_DSTOPTS|IN6P_RTHDR|IN6P_RTHDRDSTOPTS|\
427 IN6P_AUTOFLOWLABEL|INP_RECVTTL)
428 #define INP_UNMAPPABLEOPTS (IN6P_HOPOPTS|IN6P_DSTOPTS|IN6P_RTHDR|\
431 /* for KAME src sync over BSD*'s */
432 #define IN6P_HIGHPORT INP_HIGHPORT
433 #define IN6P_LOWPORT INP_LOWPORT
434 #define IN6P_ANONPORT INP_ANONPORT
435 #define IN6P_RECVIF INP_RECVIF
436 #define IN6P_MTUDISC INP_MTUDISC
437 #define IN6P_FAITH INP_FAITH
438 #define IN6P_CONTROLOPTS INP_CONTROLOPTS
440 * socket AF version is {newer than,or include}
441 * actual datagram AF version
444 #define INPLOOKUP_WILDCARD 1
446 #define INPCB_ALL_OWNERS 0xff
447 #define INPCB_NO_OWNER 0x0
448 #define INPCB_OWNED_BY_X 0x80
449 #define INPCB_MAX_IDS 7
450 #endif /* __APPLE__ */
452 #define sotoinpcb(so) ((struct inpcb *)(so)->so_pcb)
453 #define sotoin6pcb(so) sotoinpcb(so) /* for KAME src sync over BSD*'s */
455 #define INP_SOCKAF(so) so->so_proto->pr_domain->dom_family
457 #define INP_CHECK_SOCKAF(so, af) (INP_SOCKAF(so) == af)
460 extern int ipport_lowfirstauto
;
461 extern int ipport_lowlastauto
;
462 extern int ipport_firstauto
;
463 extern int ipport_lastauto
;
464 extern int ipport_hifirstauto
;
465 extern int ipport_hilastauto
;
467 #define INPCB_STATE_INUSE 0x1 /* freshly allocated PCB, it's in use */
468 #define INPCB_STATE_CACHED 0x2 /* this pcb is sitting in a a cache */
469 #define INPCB_STATE_DEAD 0x3 /* should treat as gone, will be garbage collected and freed */
471 #define WNT_STOPUSING 0xffff /* marked as ready to be garbaged collected, should be treated as not found */
472 #define WNT_ACQUIRE 0x1 /* that pcb is being acquired, do not recycle this time */
473 #define WNT_RELEASE 0x2 /* release acquired mode, can be garbage collected when wantcnt is null */
476 void in_pcbpurgeif0(struct inpcb
*, struct ifnet
*);
477 void in_losing(struct inpcb
*);
478 void in_rtchange(struct inpcb
*, int);
479 int in_pcballoc(struct socket
*, struct inpcbinfo
*, struct proc
*);
480 int in_pcbbind(struct inpcb
*, struct sockaddr
*, struct proc
*);
481 int in_pcbconnect(struct inpcb
*, struct sockaddr
*, struct proc
*);
482 void in_pcbdetach(struct inpcb
*);
483 void in_pcbdispose (struct inpcb
*);
484 void in_pcbdisconnect(struct inpcb
*);
485 int in_pcbinshash(struct inpcb
*, int);
486 int in_pcbladdr(struct inpcb
*, struct sockaddr
*, struct sockaddr_in
**);
488 in_pcblookup_local(struct inpcbinfo
*, struct in_addr
, u_int
, int);
490 in_pcblookup_hash(struct inpcbinfo
*,
491 struct in_addr
, u_int
, struct in_addr
, u_int
,
492 int, struct ifnet
*);
493 void in_pcbnotifyall(struct inpcbinfo
*, struct in_addr
,
494 int, void (*)(struct inpcb
*, int));
495 void in_pcbrehash(struct inpcb
*);
496 int in_setpeeraddr(struct socket
*so
, struct sockaddr
**nam
);
497 int in_setsockaddr(struct socket
*so
, struct sockaddr
**nam
);
498 int in_pcb_checkstate(struct inpcb
*pcb
, int mode
, int locked
);
501 in_pcb_grab_port (struct inpcbinfo
*pcbinfo
,
503 struct in_addr laddr
,
505 struct in_addr faddr
,
511 in_pcb_letgo_port(struct inpcbinfo
*pcbinfo
,
512 struct in_addr laddr
,
514 struct in_addr faddr
,
515 u_short fport
, u_char owner_id
);
518 in_pcb_get_owner(struct inpcbinfo
*pcbinfo
,
519 struct in_addr laddr
,
521 struct in_addr faddr
,
525 void in_pcb_nat_init(struct inpcbinfo
*pcbinfo
, int afamily
, int pfamily
,
529 in_pcb_new_share_client(struct inpcbinfo
*pcbinfo
, u_char
*owner_id
);
532 in_pcb_rem_share_client(struct inpcbinfo
*pcbinfo
, u_char owner_id
);
534 void in_pcbremlists(struct inpcb
*inp
);
535 int in_pcb_ckeckstate(struct inpcb
*, int, int);
536 void inpcb_to_compat(struct inpcb
*inp
, struct inpcb_compat
*inp_compat
);
539 #endif /* KERNEL_PRIVATE */
541 #endif /* !_NETINET_IN_PCB_H_ */