]>
Commit | Line | Data |
---|---|---|
1c79356b | 1 | /* |
d9a64523 | 2 | * Copyright (c) 1999-2018 Apple Inc. All rights reserved. |
5d5c5d0d | 3 | * |
2d21ac55 | 4 | * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ |
6d2010ae | 5 | * |
2d21ac55 A |
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. | |
6d2010ae | 14 | * |
2d21ac55 A |
15 | * Please obtain a copy of the License at |
16 | * http://www.opensource.apple.com/apsl/ and read it before using this file. | |
6d2010ae | 17 | * |
2d21ac55 A |
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 | |
8f6c56a5 A |
20 | * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, |
21 | * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, | |
2d21ac55 A |
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. | |
6d2010ae | 25 | * |
2d21ac55 | 26 | * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ |
1c79356b A |
27 | */ |
28 | /* Copyright (c) 1998, 1999 Apple Computer, Inc. All Rights Reserved */ | |
29 | /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */ | |
6d2010ae | 30 | /* |
1c79356b A |
31 | * Mach Operating System |
32 | * Copyright (c) 1987 Carnegie-Mellon University | |
33 | * All rights reserved. The CMU software License Agreement specifies | |
34 | * the terms and conditions for use and redistribution. | |
35 | */ | |
36 | /* | |
37 | * Copyright (c) 1994 NeXT Computer, Inc. All rights reserved. | |
38 | * | |
39 | * Copyright (c) 1982, 1986, 1988 Regents of the University of California. | |
40 | * All rights reserved. | |
41 | * | |
42 | * Redistribution and use in source and binary forms, with or without | |
43 | * modification, are permitted provided that the following conditions | |
44 | * are met: | |
45 | * 1. Redistributions of source code must retain the above copyright | |
46 | * notice, this list of conditions and the following disclaimer. | |
47 | * 2. Redistributions in binary form must reproduce the above copyright | |
48 | * notice, this list of conditions and the following disclaimer in the | |
49 | * documentation and/or other materials provided with the distribution. | |
50 | * 3. All advertising materials mentioning features or use of this software | |
51 | * must display the following acknowledgement: | |
52 | * This product includes software developed by the University of | |
53 | * California, Berkeley and its contributors. | |
54 | * 4. Neither the name of the University nor the names of its contributors | |
55 | * may be used to endorse or promote products derived from this software | |
56 | * without specific prior written permission. | |
57 | * | |
58 | * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
59 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
60 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
61 | * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
62 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
63 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
64 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
65 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
66 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
67 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
68 | * SUCH DAMAGE. | |
69 | * | |
70 | * @(#)mbuf.h 8.3 (Berkeley) 1/21/94 | |
1c79356b | 71 | */ |
2d21ac55 A |
72 | /* |
73 | * NOTICE: This file was modified by SPARTA, Inc. in 2005 to introduce | |
74 | * support for mandatory and extensible security protections. This notice | |
75 | * is included in support of clause 2.2 (b) of the Apple Public License, | |
76 | * Version 2.0. | |
77 | */ | |
1c79356b A |
78 | |
79 | #ifndef _SYS_MBUF_H_ | |
80 | #define _SYS_MBUF_H_ | |
81 | ||
9bccf70c | 82 | #include <sys/appleapiopts.h> |
d9a64523 | 83 | #include <sys/cdefs.h> |
5ba3f43e A |
84 | #include <sys/_types/_u_int32_t.h> /* u_int32_t */ |
85 | #include <sys/_types/_u_int64_t.h> /* u_int64_t */ | |
86 | #include <sys/_types/_u_short.h> /* u_short */ | |
91447636 | 87 | |
d9a64523 A |
88 | #ifdef KERNEL |
89 | #include <sys/kpi_mbuf.h> | |
90 | #endif | |
91447636 | 91 | |
d9a64523 | 92 | #ifdef XNU_KERNEL_PRIVATE |
1c79356b | 93 | #include <sys/lock.h> |
91447636 | 94 | #include <sys/queue.h> |
39236c6e | 95 | #include <machine/endian.h> |
1c79356b A |
96 | /* |
97 | * Mbufs are of a single size, MSIZE (machine/param.h), which | |
98 | * includes overhead. An mbuf may add a single "mbuf cluster" of size | |
6d2010ae A |
99 | * MCLBYTES/MBIGCLBYTES/M16KCLBYTES (also in machine/param.h), which has |
100 | * no additional overhead and is used instead of the internal data area; | |
101 | * this is done when at least MINCLSIZE of data must be stored. | |
b0d623f7 | 102 | */ |
b0d623f7 A |
103 | |
104 | /* | |
105 | * The following _MLEN and _MHLEN macros are private to xnu. Private code | |
106 | * that are outside of xnu must use the mbuf_get_{mlen,mhlen} routines since | |
107 | * the sizes of the structures are dependent upon specific xnu configs. | |
108 | */ | |
109 | #define _MLEN (MSIZE - sizeof(struct m_hdr)) /* normal data len */ | |
110 | #define _MHLEN (_MLEN - sizeof(struct pkthdr)) /* data len w/pkthdr */ | |
1c79356b | 111 | |
3e170ce0 A |
112 | #define NMBPGSHIFT (PAGE_SHIFT - MSIZESHIFT) |
113 | #define NMBPG (1 << NMBPGSHIFT) /* # of mbufs per page */ | |
1c79356b | 114 | |
3e170ce0 A |
115 | #define NCLPGSHIFT (PAGE_SHIFT - MCLSHIFT) |
116 | #define NCLPG (1 << NCLPGSHIFT) /* # of cl per page */ | |
6d2010ae | 117 | |
3e170ce0 A |
118 | #define NBCLPGSHIFT (PAGE_SHIFT - MBIGCLSHIFT) |
119 | #define NBCLPG (1 << NBCLPGSHIFT) /* # of big cl per page */ | |
120 | ||
121 | #define NMBPCLSHIFT (MCLSHIFT - MSIZESHIFT) | |
6d2010ae A |
122 | #define NMBPCL (1 << NMBPCLSHIFT) /* # of mbufs per cl */ |
123 | ||
3e170ce0 | 124 | #define NCLPJCLSHIFT (M16KCLSHIFT - MCLSHIFT) |
6d2010ae | 125 | #define NCLPJCL (1 << NCLPJCLSHIFT) /* # of cl per jumbo cl */ |
1c79356b | 126 | |
3e170ce0 A |
127 | #define NCLPBGSHIFT (MBIGCLSHIFT - MCLSHIFT) |
128 | #define NCLPBG (1 << NCLPBGSHIFT) /* # of cl per big cl */ | |
129 | ||
130 | #define NMBPBGSHIFT (MBIGCLSHIFT - MSIZESHIFT) | |
131 | #define NMBPBG (1 << NMBPBGSHIFT) /* # of mbufs per big cl */ | |
132 | ||
1c79356b A |
133 | /* |
134 | * Macros for type conversion | |
135 | * mtod(m,t) - convert mbuf pointer to data pointer of correct type | |
5ba3f43e | 136 | * mtodo(m, o) -- Same as above but with offset 'o' into data. |
1c79356b | 137 | * dtom(x) - convert data pointer within mbuf to mbuf pointer (XXX) |
1c79356b | 138 | */ |
6d2010ae | 139 | #define mtod(m, t) ((t)m_mtod(m)) |
5ba3f43e | 140 | #define mtodo(m, o) ((void *)(mtod(m, uint8_t *) + (o))) |
6d2010ae | 141 | #define dtom(x) m_dtom(x) |
1c79356b A |
142 | |
143 | /* header at beginning of each mbuf: */ | |
144 | struct m_hdr { | |
39236c6e A |
145 | struct mbuf *mh_next; /* next buffer in chain */ |
146 | struct mbuf *mh_nextpkt; /* next chain in queue/record */ | |
147 | caddr_t mh_data; /* location of data */ | |
148 | int32_t mh_len; /* amount of data in this mbuf */ | |
149 | u_int16_t mh_type; /* type of data in this mbuf */ | |
150 | u_int16_t mh_flags; /* flags; see below */ | |
5ba3f43e A |
151 | #if __arm__ && (__BIGGEST_ALIGNMENT__ > 4) |
152 | /* This is needed because of how _MLEN is defined and used. Ideally, _MLEN | |
153 | * should be defined using the offsetof(struct mbuf, M_dat), since there is | |
154 | * no guarantee that mbuf.M_dat will start where mbuf.m_hdr ends. The compiler | |
155 | * may (and does in the armv7k case) insert padding between m_hdr and M_dat in | |
156 | * mbuf. We cannot easily use offsetof, however, since _MLEN is referenced | |
157 | * in the definition of mbuf. | |
158 | */ | |
159 | } __attribute__((aligned(8))); | |
160 | #else | |
1c79356b | 161 | }; |
5ba3f43e | 162 | #endif |
1c79356b | 163 | |
91447636 A |
164 | /* |
165 | * Packet tag structure (see below for details). | |
166 | */ | |
167 | struct m_tag { | |
6d2010ae A |
168 | u_int64_t m_tag_cookie; /* Error checking */ |
169 | #ifndef __LP64__ | |
170 | u_int32_t pad; /* For structure alignment */ | |
171 | #endif /* !__LP64__ */ | |
91447636 | 172 | SLIST_ENTRY(m_tag) m_tag_link; /* List of packet tags */ |
6d2010ae A |
173 | u_int16_t m_tag_type; /* Module specific type */ |
174 | u_int16_t m_tag_len; /* Length of data */ | |
175 | u_int32_t m_tag_id; /* Module ID */ | |
176 | }; | |
177 | ||
6d2010ae | 178 | #define M_TAG_ALIGN(len) \ |
316670eb | 179 | (P2ROUNDUP(len, sizeof (u_int64_t)) + sizeof (struct m_tag)) |
6d2010ae A |
180 | |
181 | #define M_TAG_VALID_PATTERN 0xfeedfacefeedfaceULL | |
182 | #define M_TAG_FREE_PATTERN 0xdeadbeefdeadbeefULL | |
183 | ||
316670eb A |
184 | /* |
185 | * Packet tag header structure (at the top of mbuf). Pointers are | |
186 | * 32-bit in ILP32; m_tag needs 64-bit alignment, hence padded. | |
187 | */ | |
6d2010ae | 188 | struct m_taghdr { |
316670eb A |
189 | #ifndef __LP64__ |
190 | u_int32_t pad; /* For structure alignment */ | |
191 | #endif /* !__LP64__ */ | |
6d2010ae | 192 | u_int64_t refcnt; /* Number of tags in this mbuf */ |
91447636 A |
193 | }; |
194 | ||
39236c6e A |
195 | /* |
196 | * Driver auxiliary metadata tag (KERNEL_TAG_TYPE_DRVAUX). | |
197 | */ | |
198 | struct m_drvaux_tag { | |
199 | u_int32_t da_family; /* IFNET_FAMILY values */ | |
200 | u_int32_t da_subfamily; /* IFNET_SUBFAMILY values */ | |
201 | u_int32_t da_reserved; /* for future */ | |
202 | u_int32_t da_length; /* length of following data */ | |
203 | }; | |
316670eb | 204 | |
39236c6e A |
205 | /* Values for pftag_flags (16-bit wide) */ |
206 | #define PF_TAG_GENERATED 0x1 /* pkt generated by PF */ | |
207 | #define PF_TAG_FRAGCACHE 0x2 | |
208 | #define PF_TAG_TRANSLATE_LOCALHOST 0x4 | |
209 | #if PF_ECN | |
210 | #define PF_TAG_HDR_INET 0x8 /* hdr points to IPv4 */ | |
211 | #define PF_TAG_HDR_INET6 0x10 /* hdr points to IPv6 */ | |
212 | #endif /* PF_ECN */ | |
213 | /* | |
214 | * PF mbuf tag | |
215 | */ | |
316670eb | 216 | struct pf_mtag { |
39236c6e A |
217 | u_int16_t pftag_flags; /* PF_TAG flags */ |
218 | u_int16_t pftag_rtableid; /* alternate routing table id */ | |
219 | u_int16_t pftag_tag; | |
220 | u_int16_t pftag_routed; | |
39236c6e | 221 | #if PF_ECN |
316670eb | 222 | void *pftag_hdr; /* saved hdr pos in mbuf, for ECN */ |
39236c6e A |
223 | #endif /* PF_ECN */ |
224 | }; | |
225 | ||
226 | /* | |
227 | * TCP mbuf tag | |
228 | */ | |
229 | struct tcp_pktinfo { | |
316670eb A |
230 | union { |
231 | struct { | |
39236c6e | 232 | u_int32_t segsz; /* segment size (actual MSS) */ |
39037602 | 233 | u_int32_t start_seq; /* start seq of this packet */ |
d9a64523 A |
234 | pid_t pid; |
235 | pid_t e_pid; | |
39236c6e A |
236 | } __tx; |
237 | struct { | |
238 | u_int16_t lro_pktlen; /* max seg size encountered */ | |
239 | u_int8_t lro_npkts; /* # of coalesced TCP pkts */ | |
240 | u_int8_t lro_timediff; /* time spent in LRO */ | |
241 | } __rx; | |
242 | } __offload; | |
243 | union { | |
244 | u_int32_t pri; /* send msg priority */ | |
245 | u_int32_t seq; /* recv msg sequence # */ | |
246 | } __msgattr; | |
247 | #define tso_segsz proto_mtag.__pr_u.tcp.tm_tcp.__offload.__tx.segsz | |
39037602 | 248 | #define tx_start_seq proto_mtag.__pr_u.tcp.tm_tcp.__offload.__tx.start_seq |
d9a64523 A |
249 | #define tx_tcp_pid proto_mtag.__pr_u.tcp.tm_tcp.__offload.__tx.pid |
250 | #define tx_tcp_e_pid proto_mtag.__pr_u.tcp.tm_tcp.__offload.__tx.e_pid | |
39236c6e A |
251 | #define lro_pktlen proto_mtag.__pr_u.tcp.tm_tcp.__offload.__rx.lro_pktlen |
252 | #define lro_npkts proto_mtag.__pr_u.tcp.tm_tcp.__offload.__rx.lro_npkts | |
253 | #define lro_elapsed proto_mtag.__pr_u.tcp.tm_tcp.__offload.__rx.lro_timediff | |
254 | #define msg_pri proto_mtag.__pr_u.tcp.tm_tcp.__msgattr.pri | |
255 | #define msg_seq proto_mtag.__pr_u.tcp.tm_tcp.__msgattr.seq | |
316670eb A |
256 | }; |
257 | ||
39236c6e A |
258 | /* |
259 | * MPTCP mbuf tag | |
260 | */ | |
261 | struct mptcp_pktinfo { | |
262 | u_int64_t mtpi_dsn; /* MPTCP Data Sequence Number */ | |
39037602 | 263 | u_int32_t mtpi_rel_seq; /* Relative Seq Number */ |
5ba3f43e A |
264 | u_int16_t mtpi_length; /* Length of mapping */ |
265 | u_int16_t mtpi_csum; | |
39236c6e | 266 | #define mp_dsn proto_mtag.__pr_u.tcp.tm_mptcp.mtpi_dsn |
39037602 A |
267 | #define mp_rseq proto_mtag.__pr_u.tcp.tm_mptcp.mtpi_rel_seq |
268 | #define mp_rlen proto_mtag.__pr_u.tcp.tm_mptcp.mtpi_length | |
5ba3f43e | 269 | #define mp_csum proto_mtag.__pr_u.tcp.tm_mptcp.mtpi_csum |
39236c6e A |
270 | }; |
271 | ||
272 | /* | |
273 | * TCP specific mbuf tag. Note that the current implementation uses | |
274 | * MPTCP metadata strictly between MPTCP and the TCP subflow layers, | |
275 | * hence tm_tcp and tm_mptcp are mutually exclusive. This also means | |
276 | * that TCP messages functionality is currently incompatible with MPTCP. | |
277 | */ | |
316670eb | 278 | struct tcp_mtag { |
39236c6e A |
279 | union { |
280 | struct tcp_pktinfo tm_tcp; /* TCP and below */ | |
281 | struct mptcp_pktinfo tm_mptcp; /* MPTCP-TCP only */ | |
282 | }; | |
283 | }; | |
284 | ||
d9a64523 A |
285 | struct udp_mtag { |
286 | pid_t _pid; | |
287 | pid_t _e_pid; | |
288 | #define tx_udp_pid proto_mtag.__pr_u.udp._pid | |
289 | #define tx_udp_e_pid proto_mtag.__pr_u.udp._e_pid | |
290 | }; | |
291 | ||
292 | struct rawip_mtag { | |
293 | pid_t _pid; | |
294 | pid_t _e_pid; | |
295 | #define tx_rawip_pid proto_mtag.__pr_u.rawip._pid | |
296 | #define tx_rawip_e_pid proto_mtag.__pr_u.rawip._e_pid | |
297 | }; | |
298 | ||
39037602 A |
299 | struct driver_mtag_ { |
300 | uintptr_t _drv_tx_compl_arg; | |
301 | uintptr_t _drv_tx_compl_data; | |
302 | kern_return_t _drv_tx_status; | |
303 | uint16_t _drv_flowid; | |
304 | #define drv_tx_compl_arg builtin_mtag._drv_mtag._drv_tx_compl_arg | |
305 | #define drv_tx_compl_data builtin_mtag._drv_mtag._drv_tx_compl_data | |
306 | #define drv_tx_status builtin_mtag._drv_mtag._drv_tx_status | |
307 | #define drv_flowid builtin_mtag._drv_mtag._drv_flowid | |
308 | }; | |
309 | ||
39236c6e A |
310 | /* |
311 | * Protocol specific mbuf tag (at most one protocol metadata per mbuf). | |
312 | * | |
313 | * Care must be taken to ensure that they are mutually exclusive, e.g. | |
314 | * IPSec policy ID implies no TCP segment offload (which is fine given | |
315 | * that the former is used on the virtual ipsec interface that does | |
316 | * not advertise the TSO capability.) | |
317 | */ | |
39037602 | 318 | struct proto_mtag_ { |
39236c6e A |
319 | union { |
320 | struct tcp_mtag tcp; /* TCP specific */ | |
d9a64523 A |
321 | struct udp_mtag udp; /* UDP specific */ |
322 | struct rawip_mtag rawip; /* raw IPv4/IPv6 specific */ | |
39236c6e A |
323 | } __pr_u; |
324 | }; | |
325 | ||
fe8ab488 A |
326 | /* |
327 | * NECP specific mbuf tag. | |
328 | */ | |
39037602 | 329 | struct necp_mtag_ { |
3e170ce0 | 330 | u_int32_t necp_policy_id; |
d9a64523 | 331 | u_int32_t necp_skip_policy_id; |
3e170ce0 | 332 | u_int32_t necp_route_rule_id; |
d9a64523 A |
333 | u_int16_t necp_last_interface_index; |
334 | u_int16_t necp_app_id; | |
39037602 A |
335 | }; |
336 | ||
337 | union builtin_mtag { | |
338 | struct { | |
339 | struct proto_mtag_ _proto_mtag; /* built-in protocol-specific tag */ | |
340 | struct pf_mtag _pf_mtag; /* built-in PF tag */ | |
341 | struct necp_mtag_ _necp_mtag; /* built-in NECP tag */ | |
342 | } _net_mtag; | |
343 | struct driver_mtag_ _drv_mtag; | |
344 | #define necp_mtag builtin_mtag._net_mtag._necp_mtag | |
345 | #define proto_mtag builtin_mtag._net_mtag._proto_mtag | |
346 | #define driver_mtag builtin_mtag._drv_mtag | |
fe8ab488 A |
347 | }; |
348 | ||
39236c6e A |
349 | /* |
350 | * Record/packet header in first mbuf of chain; valid only if M_PKTHDR set. | |
351 | */ | |
39037602 A |
352 | struct pkthdr { |
353 | struct ifnet *rcvif; /* rcv interface */ | |
1c79356b | 354 | /* variables for ip and tcp reassembly */ |
39236c6e A |
355 | void *pkt_hdr; /* pointer to packet header */ |
356 | int32_t len; /* total packet length */ | |
6d2010ae A |
357 | /* variables for hardware checksum */ |
358 | /* Note: csum_flags is used for hardware checksum and VLAN */ | |
39236c6e A |
359 | u_int32_t csum_flags; /* flags regarding checksum */ |
360 | union { | |
361 | struct { | |
362 | u_int16_t val; /* checksum value */ | |
363 | u_int16_t start; /* checksum start offset */ | |
364 | } _csum_rx; | |
365 | #define csum_rx_val _csum_rx.val | |
366 | #define csum_rx_start _csum_rx.start | |
367 | struct { | |
368 | u_int16_t start; /* checksum start offset */ | |
369 | u_int16_t stuff; /* checksum stuff offset */ | |
370 | } _csum_tx; | |
371 | #define csum_tx_start _csum_tx.start | |
372 | #define csum_tx_stuff _csum_tx.stuff | |
d9a64523 A |
373 | /* |
374 | * Generic data field used by csum routines. | |
375 | * It gets used differently in different contexts. | |
376 | */ | |
377 | u_int32_t csum_data; | |
39236c6e A |
378 | }; |
379 | u_int16_t vlan_tag; /* VLAN tag, host byte order */ | |
380 | /* | |
381 | * Packet classifier info | |
382 | * | |
383 | * PKTF_FLOW_ID set means valid flow ID. A non-zero flow ID value | |
384 | * means the packet has been classified by one of the flow sources. | |
385 | * It is also a prerequisite for flow control advisory, which is | |
386 | * enabled by additionally setting PKTF_FLOW_ADV. | |
387 | * | |
388 | * The protocol value is a best-effort representation of the payload. | |
389 | * It is opportunistically updated and used only for optimization. | |
390 | * It is not a substitute for parsing the protocol header(s); use it | |
391 | * only as a hint. | |
392 | * | |
393 | * If PKTF_IFAINFO is set, pkt_ifainfo contains one or both of the | |
394 | * indices of interfaces which own the source and/or destination | |
395 | * addresses of the packet. For the local/loopback case (PKTF_LOOP), | |
396 | * both should be valid, and thus allows for the receiving end to | |
397 | * quickly determine the actual interfaces used by the the addresses; | |
398 | * they may not necessarily be the same or refer to the loopback | |
399 | * interface. Otherwise, in the non-local/loopback case, the indices | |
400 | * are opportunistically set, and because of that only one may be set | |
401 | * (0 means the index has not been determined.) In addition, the | |
402 | * interface address flags are also recorded. This allows us to avoid | |
403 | * storing the corresponding {in,in6}_ifaddr in an mbuf tag. Ideally | |
404 | * this would be a superset of {ia,ia6}_flags, but the namespaces are | |
405 | * overlapping at present, so we'll need a new set of values in future | |
406 | * to achieve this. For now, we will just rely on the address family | |
407 | * related code paths examining this mbuf to interpret the flags. | |
408 | */ | |
409 | u_int8_t pkt_proto; /* IPPROTO value */ | |
410 | u_int8_t pkt_flowsrc; /* FLOWSRC values */ | |
411 | u_int32_t pkt_flowid; /* flow ID */ | |
412 | u_int32_t pkt_flags; /* PKTF flags (see below) */ | |
413 | u_int32_t pkt_svc; /* MBUF_SVC value */ | |
39037602 A |
414 | |
415 | u_int32_t pkt_compl_context; /* Packet completion context */ | |
416 | ||
39236c6e A |
417 | union { |
418 | struct { | |
419 | u_int16_t src; /* ifindex of src addr i/f */ | |
420 | u_int16_t src_flags; /* src PKT_IFAIFF flags */ | |
421 | u_int16_t dst; /* ifindex of dst addr i/f */ | |
422 | u_int16_t dst_flags; /* dst PKT_IFAIFF flags */ | |
423 | } _pkt_iaif; | |
424 | #define src_ifindex _pkt_iaif.src | |
425 | #define src_iff _pkt_iaif.src_flags | |
426 | #define dst_ifindex _pkt_iaif.dst | |
427 | #define dst_iff _pkt_iaif.dst_flags | |
428 | u_int64_t pkt_ifainfo; /* data field used by ifainfo */ | |
39037602 A |
429 | struct { |
430 | u_int32_t if_data; /* bytes in interface queue */ | |
431 | u_int32_t sndbuf_data; /* bytes in socket buffer */ | |
432 | } _pkt_bsr; /* Buffer status report used by cellular interface */ | |
433 | #define bufstatus_if _pkt_bsr.if_data | |
434 | #define bufstatus_sndbuf _pkt_bsr.sndbuf_data | |
39236c6e | 435 | }; |
39037602 | 436 | u_int64_t pkt_timestamp; /* enqueue time */ |
3e170ce0 | 437 | |
39236c6e A |
438 | /* |
439 | * Tags (external and built-in) | |
440 | */ | |
441 | SLIST_HEAD(packet_tags, m_tag) tags; /* list of external tags */ | |
39037602 | 442 | union builtin_mtag builtin_mtag; |
39236c6e A |
443 | /* |
444 | * Module private scratch space (32-bit aligned), currently 16-bytes | |
39037602 | 445 | * large. Anything stored here is not guaranteed to survive across |
5ba3f43e A |
446 | * modules. The AQM layer (outbound) uses all 16-bytes for both |
447 | * packet scheduling and flow advisory information. | |
39236c6e A |
448 | */ |
449 | struct { | |
450 | union { | |
451 | u_int8_t __mpriv8[16]; | |
452 | u_int16_t __mpriv16[8]; | |
453 | struct { | |
454 | union { | |
455 | u_int8_t __val8[4]; | |
456 | u_int16_t __val16[2]; | |
457 | u_int32_t __val32; | |
458 | } __mpriv32_u; | |
459 | } __mpriv32[4]; | |
460 | u_int64_t __mpriv64[2]; | |
461 | } __mpriv_u; | |
462 | } pkt_mpriv __attribute__((aligned(4))); | |
5ba3f43e A |
463 | #define pkt_mpriv_hash pkt_mpriv.__mpriv_u.__mpriv32[0].__mpriv32_u.__val32 |
464 | #define pkt_mpriv_flags pkt_mpriv.__mpriv_u.__mpriv32[1].__mpriv32_u.__val32 | |
465 | #define pkt_mpriv_srcid pkt_mpriv.__mpriv_u.__mpriv32[2].__mpriv32_u.__val32 | |
466 | #define pkt_mpriv_fidx pkt_mpriv.__mpriv_u.__mpriv32[3].__mpriv32_u.__val32 | |
467 | ||
39236c6e | 468 | u_int32_t redzone; /* red zone */ |
39037602 | 469 | u_int32_t pkt_compl_callbacks; /* Packet completion callbacks */ |
1c79356b A |
470 | }; |
471 | ||
39236c6e A |
472 | /* |
473 | * Flow data source type. A data source module is responsible for generating | |
474 | * a unique flow ID and associating it to each data flow as pkt_flowid. | |
475 | * This is required for flow control/advisory, as it allows the output queue | |
476 | * to identify the data source object and inform that it can resume its | |
477 | * transmission (in the event it was flow controlled.) | |
478 | */ | |
479 | #define FLOWSRC_INPCB 1 /* flow ID generated by INPCB */ | |
480 | #define FLOWSRC_IFNET 2 /* flow ID generated by interface */ | |
481 | #define FLOWSRC_PF 3 /* flow ID generated by PF */ | |
39037602 | 482 | #define FLOWSRC_CHANNEL 4 /* flow ID generated by channel */ |
39236c6e A |
483 | |
484 | /* | |
485 | * Packet flags. Unlike m_flags, all packet flags are copied along when | |
486 | * copying m_pkthdr, i.e. no equivalent of M_COPYFLAGS here. These flags | |
487 | * (and other classifier info) will be cleared during DLIL input. | |
488 | * | |
489 | * Some notes about M_LOOP and PKTF_LOOP: | |
490 | * | |
491 | * - M_LOOP flag is overloaded, and its use is discouraged. Historically, | |
492 | * that flag was used by the KAME implementation for allowing certain | |
493 | * certain exceptions to be made in the IP6_EXTHDR_CHECK() logic; this | |
494 | * was originally meant to be set as the packet is looped back to the | |
495 | * system, and in some circumstances temporarily set in ip6_output(). | |
496 | * Over time, this flag was used by the pre-output routines to indicate | |
497 | * to the DLIL frameout and output routines, that the packet may be | |
498 | * looped back to the system under the right conditions. In addition, | |
499 | * this is an mbuf flag rather than an mbuf packet header flag. | |
500 | * | |
501 | * - PKTF_LOOP is an mbuf packet header flag, which is set if and only | |
502 | * if the packet was looped back to the system. This flag should be | |
503 | * used instead for newer code. | |
504 | */ | |
505 | #define PKTF_FLOW_ID 0x1 /* pkt has valid flowid value */ | |
506 | #define PKTF_FLOW_ADV 0x2 /* pkt triggers local flow advisory */ | |
507 | #define PKTF_FLOW_LOCALSRC 0x4 /* pkt is locally originated */ | |
508 | #define PKTF_FLOW_RAWSOCK 0x8 /* pkt locally generated by raw sock */ | |
509 | #define PKTF_PRIO_PRIVILEGED 0x10 /* packet priority is privileged */ | |
510 | #define PKTF_PROXY_DST 0x20 /* processed but not locally destined */ | |
511 | #define PKTF_INET_RESOLVE 0x40 /* IPv4 resolver packet */ | |
512 | #define PKTF_INET6_RESOLVE 0x80 /* IPv6 resolver packet */ | |
513 | #define PKTF_RESOLVE_RTR 0x100 /* pkt is for resolving router */ | |
514 | #define PKTF_SW_LRO_PKT 0x200 /* pkt is a large coalesced pkt */ | |
515 | #define PKTF_SW_LRO_DID_CSUM 0x400 /* IP and TCP checksums done by LRO */ | |
516 | #define PKTF_MPTCP 0x800 /* TCP with MPTCP metadata */ | |
517 | #define PKTF_MPSO 0x1000 /* MPTCP socket meta data */ | |
518 | #define PKTF_LOOP 0x2000 /* loopbacked packet */ | |
519 | #define PKTF_IFAINFO 0x4000 /* pkt has valid interface addr info */ | |
520 | #define PKTF_SO_BACKGROUND 0x8000 /* data is from background source */ | |
521 | #define PKTF_FORWARDED 0x10000 /* pkt was forwarded from another i/f */ | |
fe8ab488 A |
522 | #define PKTF_PRIV_GUARDED 0x20000 /* pkt_mpriv area guard enabled */ |
523 | #define PKTF_KEEPALIVE 0x40000 /* pkt is kernel-generated keepalive */ | |
3e170ce0 A |
524 | #define PKTF_SO_REALTIME 0x80000 /* data is realtime traffic */ |
525 | #define PKTF_VALID_UNSENT_DATA 0x100000 /* unsent data is valid */ | |
526 | #define PKTF_TCP_REXMT 0x200000 /* packet is TCP retransmission */ | |
39037602 A |
527 | #define PKTF_REASSEMBLED 0x400000 /* Packet was reassembled */ |
528 | #define PKTF_TX_COMPL_TS_REQ 0x800000 /* tx completion timestamp requested */ | |
5ba3f43e | 529 | #define PKTF_TS_VALID 0x1000000 /* pkt timestamp is valid */ |
39037602 A |
530 | #define PKTF_DRIVER_MTAG 0x2000000 /* driver mbuf tags fields inited */ |
531 | #define PKTF_NEW_FLOW 0x4000000 /* Data from a new flow */ | |
532 | #define PKTF_START_SEQ 0x8000000 /* valid start sequence */ | |
533 | #define PKTF_LAST_PKT 0x10000000 /* last packet in the flow */ | |
5ba3f43e | 534 | #define PKTF_MPTCP_REINJ 0x20000000 /* Packet has been reinjected for MPTCP */ |
5c9f4661 | 535 | #define PKTF_MPTCP_DFIN 0x40000000 /* Packet is a data-fin */ |
a39ff7e2 | 536 | #define PKTF_HBH_CHKED 0x80000000 /* HBH option is checked */ |
3e170ce0 | 537 | |
39236c6e A |
538 | /* flags related to flow control/advisory and identification */ |
539 | #define PKTF_FLOW_MASK \ | |
540 | (PKTF_FLOW_ID | PKTF_FLOW_ADV | PKTF_FLOW_LOCALSRC | PKTF_FLOW_RAWSOCK) | |
541 | ||
542 | /* | |
543 | * Description of external storage mapped into mbuf, valid only if M_EXT set. | |
544 | */ | |
813fb2f6 | 545 | typedef void (*m_ext_free_func_t)(caddr_t, u_int, caddr_t); |
1c79356b A |
546 | struct m_ext { |
547 | caddr_t ext_buf; /* start of buffer */ | |
813fb2f6 | 548 | m_ext_free_func_t ext_free; /* free routine if not the usual */ |
1c79356b A |
549 | u_int ext_size; /* size of buffer, for ext_free */ |
550 | caddr_t ext_arg; /* additional ext_free argument */ | |
2d21ac55 | 551 | struct ext_ref { |
39037602 A |
552 | struct mbuf *paired; |
553 | u_int16_t minref; | |
554 | u_int16_t refcnt; | |
555 | u_int16_t prefcnt; | |
556 | u_int16_t flags; | |
557 | u_int32_t priv; | |
813fb2f6 | 558 | uintptr_t ext_token; |
2d21ac55 | 559 | } *ext_refflags; |
1c79356b A |
560 | }; |
561 | ||
b0d623f7 A |
562 | /* define m_ext to a type since it gets redefined below */ |
563 | typedef struct m_ext _m_ext_t; | |
564 | ||
39236c6e A |
565 | /* |
566 | * The mbuf object | |
567 | */ | |
1c79356b | 568 | struct mbuf { |
39037602 | 569 | struct m_hdr m_hdr; |
1c79356b A |
570 | union { |
571 | struct { | |
39037602 | 572 | struct pkthdr MH_pkthdr; /* M_PKTHDR set */ |
1c79356b | 573 | union { |
39037602 | 574 | struct m_ext MH_ext; /* M_EXT set */ |
b0d623f7 | 575 | char MH_databuf[_MHLEN]; |
1c79356b A |
576 | } MH_dat; |
577 | } MH; | |
b0d623f7 | 578 | char M_databuf[_MLEN]; /* !M_PKTHDR, !M_EXT */ |
1c79356b A |
579 | } M_dat; |
580 | }; | |
581 | ||
582 | #define m_next m_hdr.mh_next | |
583 | #define m_len m_hdr.mh_len | |
584 | #define m_data m_hdr.mh_data | |
585 | #define m_type m_hdr.mh_type | |
586 | #define m_flags m_hdr.mh_flags | |
587 | #define m_nextpkt m_hdr.mh_nextpkt | |
588 | #define m_act m_nextpkt | |
589 | #define m_pkthdr M_dat.MH.MH_pkthdr | |
590 | #define m_ext M_dat.MH.MH_dat.MH_ext | |
591 | #define m_pktdat M_dat.MH.MH_dat.MH_databuf | |
592 | #define m_dat M_dat.M_databuf | |
316670eb | 593 | #define m_pktlen(_m) ((_m)->m_pkthdr.len) |
39037602 | 594 | #define m_pftag(_m) (&(_m)->m_pkthdr.builtin_mtag._net_mtag._pf_mtag) |
1c79356b | 595 | |
6d2010ae | 596 | /* mbuf flags (private) */ |
1c79356b A |
597 | #define M_EXT 0x0001 /* has associated external storage */ |
598 | #define M_PKTHDR 0x0002 /* start of record */ | |
599 | #define M_EOR 0x0004 /* end of record */ | |
600 | #define M_PROTO1 0x0008 /* protocol-specific */ | |
9bccf70c A |
601 | #define M_PROTO2 0x0010 /* protocol-specific */ |
602 | #define M_PROTO3 0x0020 /* protocol-specific */ | |
39236c6e | 603 | #define M_LOOP 0x0040 /* packet is looped back (also see PKTF_LOOP) */ |
9bccf70c | 604 | #define M_PROTO5 0x0080 /* protocol-specific */ |
1c79356b | 605 | |
6d2010ae | 606 | /* mbuf pkthdr flags, also in m_flags (private) */ |
1c79356b A |
607 | #define M_BCAST 0x0100 /* send/received as link-level broadcast */ |
608 | #define M_MCAST 0x0200 /* send/received as link-level multicast */ | |
9bccf70c A |
609 | #define M_FRAG 0x0400 /* packet is a fragment of a larger packet */ |
610 | #define M_FIRSTFRAG 0x0800 /* packet is first fragment */ | |
611 | #define M_LASTFRAG 0x1000 /* packet is last fragment */ | |
91447636 | 612 | #define M_PROMISC 0x2000 /* packet is promiscuous (shouldn't go to stack) */ |
6d2010ae A |
613 | #define M_HASFCS 0x4000 /* packet has FCS */ |
614 | #define M_TAGHDR 0x8000 /* m_tag hdr structure at top of mbuf data */ | |
615 | ||
616 | /* | |
617 | * Flags to purge when crossing layers. | |
618 | */ | |
619 | #define M_PROTOFLAGS \ | |
620 | (M_PROTO1|M_PROTO2|M_PROTO3|M_PROTO5) | |
1c79356b A |
621 | |
622 | /* flags copied when copying m_pkthdr */ | |
6d2010ae A |
623 | #define M_COPYFLAGS \ |
624 | (M_PKTHDR|M_EOR|M_PROTO1|M_PROTO2|M_PROTO3 | \ | |
625 | M_LOOP|M_PROTO5|M_BCAST|M_MCAST|M_FRAG | \ | |
626 | M_FIRSTFRAG|M_LASTFRAG|M_PROMISC|M_HASFCS) | |
627 | ||
316670eb | 628 | /* flags indicating hw checksum support and sw checksum requirements */ |
6d2010ae A |
629 | #define CSUM_IP 0x0001 /* will csum IP */ |
630 | #define CSUM_TCP 0x0002 /* will csum TCP */ | |
631 | #define CSUM_UDP 0x0004 /* will csum UDP */ | |
632 | #define CSUM_IP_FRAGS 0x0008 /* will csum IP fragments */ | |
633 | #define CSUM_FRAGMENT 0x0010 /* will do IP fragmentation */ | |
634 | #define CSUM_TCPIPV6 0x0020 /* will csum TCP for IPv6 */ | |
635 | #define CSUM_UDPIPV6 0x0040 /* will csum UDP for IPv6 */ | |
636 | #define CSUM_FRAGMENT_IPV6 0x0080 /* will do IPv6 fragmentation */ | |
637 | ||
638 | #define CSUM_IP_CHECKED 0x0100 /* did csum IP */ | |
639 | #define CSUM_IP_VALID 0x0200 /* ... the csum is valid */ | |
640 | #define CSUM_DATA_VALID 0x0400 /* csum_data field is valid */ | |
641 | #define CSUM_PSEUDO_HDR 0x0800 /* csum_data has pseudo hdr */ | |
39236c6e | 642 | #define CSUM_PARTIAL 0x1000 /* simple Sum16 computation */ |
5ba3f43e | 643 | #define CSUM_ZERO_INVERT 0x2000 /* invert 0 to -0 (0xffff) */ |
6d2010ae A |
644 | |
645 | #define CSUM_DELAY_DATA (CSUM_TCP | CSUM_UDP) | |
646 | #define CSUM_DELAY_IP (CSUM_IP) /* IPv4 only: no IPv6 IP cksum */ | |
647 | #define CSUM_DELAY_IPV6_DATA (CSUM_TCPIPV6 | CSUM_UDPIPV6) | |
648 | #define CSUM_DATA_IPV6_VALID CSUM_DATA_VALID /* csum_data field is valid */ | |
39236c6e A |
649 | |
650 | #define CSUM_TX_FLAGS \ | |
651 | (CSUM_DELAY_IP | CSUM_DELAY_DATA | CSUM_DELAY_IPV6_DATA | \ | |
5ba3f43e | 652 | CSUM_DATA_VALID | CSUM_PARTIAL | CSUM_ZERO_INVERT) |
39236c6e A |
653 | |
654 | #define CSUM_RX_FLAGS \ | |
655 | (CSUM_IP_CHECKED | CSUM_IP_VALID | CSUM_PSEUDO_HDR | \ | |
656 | CSUM_DATA_VALID | CSUM_PARTIAL) | |
657 | ||
4a249263 A |
658 | /* |
659 | * Note: see also IF_HWASSIST_CSUM defined in <net/if_var.h> | |
660 | */ | |
4a249263 A |
661 | |
662 | /* VLAN tag present */ | |
6d2010ae | 663 | #define CSUM_VLAN_TAG_VALID 0x10000 /* vlan_tag field is valid */ |
b0d623f7 A |
664 | |
665 | /* TCP Segment Offloading requested on this mbuf */ | |
6d2010ae A |
666 | #define CSUM_TSO_IPV4 0x100000 /* This mbuf needs to be segmented by the NIC */ |
667 | #define CSUM_TSO_IPV6 0x200000 /* This mbuf needs to be segmented by the NIC */ | |
316670eb | 668 | |
39236c6e A |
669 | #define TSO_IPV4_OK(_ifp, _m) \ |
670 | (((_ifp)->if_hwassist & IFNET_TSO_IPV4) && \ | |
671 | ((_m)->m_pkthdr.csum_flags & CSUM_TSO_IPV4)) \ | |
672 | ||
673 | #define TSO_IPV4_NOTOK(_ifp, _m) \ | |
674 | (!((_ifp)->if_hwassist & IFNET_TSO_IPV4) && \ | |
675 | ((_m)->m_pkthdr.csum_flags & CSUM_TSO_IPV4)) \ | |
676 | ||
677 | #define TSO_IPV6_OK(_ifp, _m) \ | |
678 | (((_ifp)->if_hwassist & IFNET_TSO_IPV6) && \ | |
679 | ((_m)->m_pkthdr.csum_flags & CSUM_TSO_IPV6)) \ | |
680 | ||
681 | #define TSO_IPV6_NOTOK(_ifp, _m) \ | |
682 | (!((_ifp)->if_hwassist & IFNET_TSO_IPV6) && \ | |
683 | ((_m)->m_pkthdr.csum_flags & CSUM_TSO_IPV6)) \ | |
684 | ||
6d2010ae | 685 | #endif /* XNU_KERNEL_PRIVATE */ |
1c79356b A |
686 | |
687 | /* mbuf types */ | |
688 | #define MT_FREE 0 /* should be on free list */ | |
689 | #define MT_DATA 1 /* dynamic (data) allocation */ | |
690 | #define MT_HEADER 2 /* packet header */ | |
691 | #define MT_SOCKET 3 /* socket structure */ | |
692 | #define MT_PCB 4 /* protocol control block */ | |
693 | #define MT_RTABLE 5 /* routing tables */ | |
694 | #define MT_HTABLE 6 /* IMP host tables */ | |
695 | #define MT_ATABLE 7 /* address resolution tables */ | |
696 | #define MT_SONAME 8 /* socket name */ | |
697 | #define MT_SOOPTS 10 /* socket options */ | |
698 | #define MT_FTABLE 11 /* fragment reassembly header */ | |
699 | #define MT_RIGHTS 12 /* access rights */ | |
700 | #define MT_IFADDR 13 /* interface address */ | |
6d2010ae A |
701 | #define MT_CONTROL 14 /* extra-data protocol message */ |
702 | #define MT_OOBDATA 15 /* expedited data */ | |
703 | #define MT_TAG 16 /* volatile metadata associated to pkts */ | |
704 | #define MT_MAX 32 /* enough? */ | |
1c79356b | 705 | |
6d2010ae | 706 | #ifdef XNU_KERNEL_PRIVATE |
1c79356b A |
707 | /* |
708 | * mbuf allocation/deallocation macros: | |
709 | * | |
710 | * MGET(struct mbuf *m, int how, int type) | |
711 | * allocates an mbuf and initializes it to contain internal data. | |
712 | * | |
713 | * MGETHDR(struct mbuf *m, int how, int type) | |
714 | * allocates an mbuf and initializes it to contain a packet header | |
715 | * and internal data. | |
716 | */ | |
717 | ||
e3027f41 | 718 | #if 1 |
6d2010ae | 719 | #define MCHECK(m) m_mcheck(m) |
1c79356b | 720 | #else |
6d2010ae | 721 | #define MCHECK(m) |
1c79356b A |
722 | #endif |
723 | ||
9bccf70c A |
724 | #define MGET(m, how, type) ((m) = m_get((how), (type))) |
725 | ||
726 | #define MGETHDR(m, how, type) ((m) = m_gethdr((how), (type))) | |
1c79356b A |
727 | |
728 | /* | |
729 | * Mbuf cluster macros. | |
730 | * MCLALLOC(caddr_t p, int how) allocates an mbuf cluster. | |
731 | * MCLGET adds such clusters to a normal mbuf; | |
732 | * the flag M_EXT is set upon success. | |
733 | * MCLFREE releases a reference to a cluster allocated by MCLALLOC, | |
734 | * freeing the cluster if the reference count has reached 0. | |
735 | * | |
736 | * Normal mbuf clusters are normally treated as character arrays | |
737 | * after allocation, but use the first word of the buffer as a free list | |
738 | * pointer while on the free list. | |
739 | */ | |
740 | union mcluster { | |
741 | union mcluster *mcl_next; | |
742 | char mcl_buf[MCLBYTES]; | |
743 | }; | |
744 | ||
9bccf70c A |
745 | #define MCLALLOC(p, how) ((p) = m_mclalloc(how)) |
746 | ||
6d2010ae | 747 | #define MCLFREE(p) m_mclfree(p) |
9bccf70c | 748 | |
6d2010ae | 749 | #define MCLGET(m, how) ((m) = m_mclget(m, how)) |
9bccf70c | 750 | |
91447636 A |
751 | /* |
752 | * Mbuf big cluster | |
753 | */ | |
91447636 A |
754 | union mbigcluster { |
755 | union mbigcluster *mbc_next; | |
6d2010ae | 756 | char mbc_buf[MBIGCLBYTES]; |
91447636 A |
757 | }; |
758 | ||
6d2010ae A |
759 | /* |
760 | * Mbuf jumbo cluster | |
761 | */ | |
2d21ac55 A |
762 | union m16kcluster { |
763 | union m16kcluster *m16kcl_next; | |
764 | char m16kcl_buf[M16KCLBYTES]; | |
765 | }; | |
91447636 | 766 | |
6d2010ae | 767 | #define MCLHASREFERENCE(m) m_mclhasreference(m) |
1c79356b A |
768 | |
769 | /* | |
770 | * MFREE(struct mbuf *m, struct mbuf *n) | |
771 | * Free a single mbuf and associated external storage. | |
772 | * Place the successor, if any, in n. | |
773 | */ | |
774 | ||
9bccf70c | 775 | #define MFREE(m, n) ((n) = m_free(m)) |
1c79356b A |
776 | |
777 | /* | |
778 | * Copy mbuf pkthdr from from to to. | |
779 | * from must have M_PKTHDR set, and to must be empty. | |
780 | * aux pointer will be moved to `to'. | |
781 | */ | |
9bccf70c | 782 | #define M_COPY_PKTHDR(to, from) m_copy_pkthdr(to, from) |
1c79356b | 783 | |
316670eb A |
784 | #define M_COPY_PFTAG(to, from) m_copy_pftag(to, from) |
785 | ||
39236c6e A |
786 | #define M_COPY_CLASSIFIER(to, from) m_copy_classifier(to, from) |
787 | ||
1c79356b | 788 | /* |
d9a64523 A |
789 | * Evaluate TRUE if it's safe to write to the mbuf m's data region (this can |
790 | * be both the local data payload, or an external buffer area, depending on | |
791 | * whether M_EXT is set). | |
1c79356b | 792 | */ |
d9a64523 | 793 | #define M_WRITABLE(m) (((m)->m_flags & M_EXT) == 0 || !MCLHASREFERENCE(m)) |
6d2010ae | 794 | |
1c79356b | 795 | /* |
d9a64523 A |
796 | * These macros are mapped to the appropriate KPIs, so that private code |
797 | * can be simply recompiled in order to be forward-compatible with future | |
798 | * changes toward the struture sizes. | |
799 | */ | |
800 | #define MLEN mbuf_get_mlen() /* normal mbuf data len */ | |
801 | #define MHLEN mbuf_get_mhlen() /* data len in an mbuf w/pkthdr */ | |
802 | #define MINCLSIZE mbuf_get_minclsize() /* cluster usage threshold */ | |
803 | /* | |
804 | * Return the address of the start of the buffer associated with an mbuf, | |
805 | * handling external storage, packet-header mbufs, and regular data mbufs. | |
1c79356b | 806 | */ |
d9a64523 A |
807 | #define M_START(m) \ |
808 | (((m)->m_flags & M_EXT) ? (m)->m_ext.ext_buf : \ | |
809 | ((m)->m_flags & M_PKTHDR) ? &(m)->m_pktdat[0] : \ | |
810 | &(m)->m_dat[0]) | |
1c79356b A |
811 | |
812 | /* | |
d9a64523 A |
813 | * Return the size of the buffer associated with an mbuf, handling external |
814 | * storage, packet-header mbufs, and regular data mbufs. | |
1c79356b | 815 | */ |
d9a64523 A |
816 | #define M_SIZE(m) \ |
817 | (((m)->m_flags & M_EXT) ? (m)->m_ext.ext_size : \ | |
818 | ((m)->m_flags & M_PKTHDR) ? MHLEN : \ | |
819 | MLEN) | |
820 | ||
821 | #define M_ALIGN(m, len) m_align(m, len) | |
822 | #define MH_ALIGN(m, len) m_align(m, len) | |
823 | #define MEXT_ALIGN(m, len) m_align(m, len) | |
824 | ||
825 | /* | |
826 | * Compute the amount of space available before the current start of data in | |
827 | * an mbuf. | |
828 | * | |
829 | * The M_WRITABLE() is a temporary, conservative safety measure: the burden | |
830 | * of checking writability of the mbuf data area rests solely with the caller. | |
831 | */ | |
832 | #define M_LEADINGSPACE(m) \ | |
833 | (M_WRITABLE(m) ? ((m)->m_data - M_START(m)) : 0) | |
1c79356b A |
834 | |
835 | /* | |
d9a64523 A |
836 | * Compute the amount of space available after the end of data in an mbuf. |
837 | * | |
838 | * The M_WRITABLE() is a temporary, conservative safety measure: the burden | |
839 | * of checking writability of the mbuf data area rests solely with the caller. | |
1c79356b | 840 | */ |
d9a64523 A |
841 | #define M_TRAILINGSPACE(m) \ |
842 | (M_WRITABLE(m) ? \ | |
843 | ((M_START(m) + M_SIZE(m)) - ((m)->m_data + (m)->m_len)) : 0) | |
1c79356b A |
844 | |
845 | /* | |
846 | * Arrange to prepend space of size plen to mbuf m. | |
847 | * If a new mbuf must be allocated, how specifies whether to wait. | |
848 | * If how is M_DONTWAIT and allocation fails, the original mbuf chain | |
849 | * is freed and m is set to NULL. | |
850 | */ | |
3e170ce0 A |
851 | #define M_PREPEND(m, plen, how, align) \ |
852 | ((m) = m_prepend_2((m), (plen), (how), (align))) | |
1c79356b A |
853 | |
854 | /* change mbuf to new type */ | |
6d2010ae | 855 | #define MCHTYPE(m, t) m_mchtype(m, t) |
1c79356b A |
856 | |
857 | /* compatiblity with 4.3 */ | |
6d2010ae | 858 | #define m_copy(m, o, l) m_copym((m), (o), (l), M_DONTWAIT) |
1c79356b | 859 | |
b0d623f7 | 860 | #define MBSHIFT 20 /* 1MB */ |
6d2010ae | 861 | #define MBSIZE (1 << MBSHIFT) |
b0d623f7 | 862 | #define GBSHIFT 30 /* 1GB */ |
6d2010ae | 863 | #define GBSIZE (1 << GBSHIFT) |
c910b4d9 | 864 | |
6d2010ae A |
865 | /* |
866 | * M_STRUCT_GET ensures that intermediate protocol header (from "off" to | |
316670eb | 867 | * "off+len") is located in single mbuf, on contiguous memory region. |
6d2010ae A |
868 | * The pointer to the region will be returned to pointer variable "val", |
869 | * with type "typ". | |
870 | * | |
871 | * M_STRUCT_GET0 does the same, except that it aligns the structure at | |
872 | * very top of mbuf. GET0 is likely to make memory copy than GET. | |
873 | */ | |
874 | #define M_STRUCT_GET(val, typ, m, off, len) \ | |
875 | do { \ | |
876 | struct mbuf *t; \ | |
877 | int tmp; \ | |
878 | \ | |
879 | if ((m)->m_len >= (off) + (len)) { \ | |
880 | (val) = (typ)(mtod((m), caddr_t) + (off)); \ | |
881 | } else { \ | |
882 | t = m_pulldown((m), (off), (len), &tmp); \ | |
883 | if (t != NULL) { \ | |
884 | if (t->m_len < tmp + (len)) \ | |
885 | panic("m_pulldown malfunction"); \ | |
886 | (val) = (typ)(mtod(t, caddr_t) + tmp); \ | |
887 | } else { \ | |
888 | (val) = (typ)NULL; \ | |
889 | (m) = NULL; \ | |
890 | } \ | |
891 | } \ | |
892 | } while (0) | |
893 | ||
894 | #define M_STRUCT_GET0(val, typ, m, off, len) \ | |
895 | do { \ | |
896 | struct mbuf *t; \ | |
897 | \ | |
316670eb A |
898 | if ((off) == 0 && ((m)->m_len >= (len))) { \ |
899 | (val) = (typ)(void *)mtod(m, caddr_t); \ | |
6d2010ae A |
900 | } else { \ |
901 | t = m_pulldown((m), (off), (len), NULL); \ | |
902 | if (t != NULL) { \ | |
903 | if (t->m_len < (len)) \ | |
904 | panic("m_pulldown malfunction"); \ | |
316670eb | 905 | (val) = (typ)(void *)mtod(t, caddr_t); \ |
6d2010ae A |
906 | } else { \ |
907 | (val) = (typ)NULL; \ | |
908 | (m) = NULL; \ | |
909 | } \ | |
910 | } \ | |
911 | } while (0) | |
912 | ||
913 | #define MBUF_INPUT_CHECK(m, rcvif) \ | |
914 | do { \ | |
915 | if (!(m->m_flags & MBUF_PKTHDR) || \ | |
916 | m->m_len < 0 || \ | |
917 | m->m_len > ((njcl > 0) ? njclbytes : MBIGCLBYTES) || \ | |
918 | m->m_type == MT_FREE || \ | |
919 | ((m->m_flags & M_EXT) != 0 && m->m_ext.ext_buf == NULL)) { \ | |
316670eb | 920 | panic_plain("Failed mbuf validity check: mbuf %p len %d " \ |
39236c6e | 921 | "type %d flags 0x%x data %p rcvif %s ifflags 0x%x", \ |
6d2010ae A |
922 | m, m->m_len, m->m_type, m->m_flags, \ |
923 | ((m->m_flags & M_EXT) ? m->m_ext.ext_buf : m->m_data), \ | |
39236c6e | 924 | if_name(rcvif), \ |
6d2010ae A |
925 | (rcvif->if_flags & 0xffff)); \ |
926 | } \ | |
927 | } while (0) | |
928 | ||
316670eb A |
929 | /* |
930 | * Simple mbuf queueing system | |
931 | * | |
932 | * This is basically a SIMPLEQ adapted to mbuf use (i.e. using | |
933 | * m_nextpkt instead of field.sqe_next). | |
934 | * | |
935 | * m_next is ignored, so queueing chains of mbufs is possible | |
936 | */ | |
937 | #define MBUFQ_HEAD(name) \ | |
938 | struct name { \ | |
939 | struct mbuf *mq_first; /* first packet */ \ | |
940 | struct mbuf **mq_last; /* addr of last next packet */ \ | |
941 | } | |
942 | ||
943 | #define MBUFQ_INIT(q) do { \ | |
944 | MBUFQ_FIRST(q) = NULL; \ | |
945 | (q)->mq_last = &MBUFQ_FIRST(q); \ | |
946 | } while (0) | |
947 | ||
948 | #define MBUFQ_PREPEND(q, m) do { \ | |
949 | if ((MBUFQ_NEXT(m) = MBUFQ_FIRST(q)) == NULL) \ | |
950 | (q)->mq_last = &MBUFQ_NEXT(m); \ | |
951 | MBUFQ_FIRST(q) = (m); \ | |
952 | } while (0) | |
953 | ||
954 | #define MBUFQ_ENQUEUE(q, m) do { \ | |
955 | MBUFQ_NEXT(m) = NULL; \ | |
956 | *(q)->mq_last = (m); \ | |
957 | (q)->mq_last = &MBUFQ_NEXT(m); \ | |
958 | } while (0) | |
959 | ||
960 | #define MBUFQ_ENQUEUE_MULTI(q, m, n) do { \ | |
961 | MBUFQ_NEXT(n) = NULL; \ | |
962 | *(q)->mq_last = (m); \ | |
963 | (q)->mq_last = &MBUFQ_NEXT(n); \ | |
964 | } while (0) | |
965 | ||
966 | #define MBUFQ_DEQUEUE(q, m) do { \ | |
967 | if (((m) = MBUFQ_FIRST(q)) != NULL) { \ | |
968 | if ((MBUFQ_FIRST(q) = MBUFQ_NEXT(m)) == NULL) \ | |
969 | (q)->mq_last = &MBUFQ_FIRST(q); \ | |
970 | else \ | |
971 | MBUFQ_NEXT(m) = NULL; \ | |
972 | } \ | |
973 | } while (0) | |
974 | ||
975 | #define MBUFQ_REMOVE(q, m) do { \ | |
976 | if (MBUFQ_FIRST(q) == (m)) { \ | |
977 | MBUFQ_DEQUEUE(q, m); \ | |
978 | } else { \ | |
979 | struct mbuf *_m = MBUFQ_FIRST(q); \ | |
980 | while (MBUFQ_NEXT(_m) != (m)) \ | |
981 | _m = MBUFQ_NEXT(_m); \ | |
982 | if ((MBUFQ_NEXT(_m) = \ | |
983 | MBUFQ_NEXT(MBUFQ_NEXT(_m))) == NULL) \ | |
984 | (q)->mq_last = &MBUFQ_NEXT(_m); \ | |
985 | } \ | |
986 | } while (0) | |
987 | ||
988 | #define MBUFQ_DRAIN(q) do { \ | |
989 | struct mbuf *__m0; \ | |
990 | while ((__m0 = MBUFQ_FIRST(q)) != NULL) { \ | |
991 | MBUFQ_FIRST(q) = MBUFQ_NEXT(__m0); \ | |
992 | MBUFQ_NEXT(__m0) = NULL; \ | |
993 | m_freem(__m0); \ | |
994 | } \ | |
995 | (q)->mq_last = &MBUFQ_FIRST(q); \ | |
996 | } while (0) | |
997 | ||
998 | #define MBUFQ_FOREACH(m, q) \ | |
999 | for ((m) = MBUFQ_FIRST(q); \ | |
1000 | (m); \ | |
1001 | (m) = MBUFQ_NEXT(m)) | |
1002 | ||
1003 | #define MBUFQ_FOREACH_SAFE(m, q, tvar) \ | |
1004 | for ((m) = MBUFQ_FIRST(q); \ | |
1005 | (m) && ((tvar) = MBUFQ_NEXT(m), 1); \ | |
1006 | (m) = (tvar)) | |
1007 | ||
1008 | #define MBUFQ_EMPTY(q) ((q)->mq_first == NULL) | |
1009 | #define MBUFQ_FIRST(q) ((q)->mq_first) | |
1010 | #define MBUFQ_NEXT(m) ((m)->m_nextpkt) | |
39037602 A |
1011 | /* |
1012 | * mq_last is initialized to point to mq_first, so check if they're | |
1013 | * equal and return NULL when the list is empty. Otherwise, we need | |
1014 | * to subtract the offset of MBUQ_NEXT (i.e. m_nextpkt field) to get | |
1015 | * to the base mbuf address to return to caller. | |
1016 | */ | |
1017 | #define MBUFQ_LAST(head) \ | |
1018 | (((head)->mq_last == &MBUFQ_FIRST(head)) ? NULL : \ | |
1019 | ((struct mbuf *)(void *)((char *)(head)->mq_last - \ | |
1020 | (size_t)(&MBUFQ_NEXT((struct mbuf *)0))))) | |
316670eb A |
1021 | |
1022 | #define max_linkhdr P2ROUNDUP(_max_linkhdr, sizeof (u_int32_t)) | |
1023 | #define max_protohdr P2ROUNDUP(_max_protohdr, sizeof (u_int32_t)) | |
6d2010ae | 1024 | #endif /* XNU_KERNEL_PRIVATE */ |
91447636 | 1025 | |
1c79356b | 1026 | /* |
2d21ac55 | 1027 | * Mbuf statistics (legacy). |
1c79356b A |
1028 | */ |
1029 | struct mbstat { | |
2d21ac55 A |
1030 | u_int32_t m_mbufs; /* mbufs obtained from page pool */ |
1031 | u_int32_t m_clusters; /* clusters obtained from page pool */ | |
1032 | u_int32_t m_spare; /* spare field */ | |
1033 | u_int32_t m_clfree; /* free clusters */ | |
1034 | u_int32_t m_drops; /* times failed to find space */ | |
1035 | u_int32_t m_wait; /* times waited for space */ | |
1036 | u_int32_t m_drain; /* times drained protocols for space */ | |
1037 | u_short m_mtypes[256]; /* type specific mbuf allocations */ | |
1038 | u_int32_t m_mcfail; /* times m_copym failed */ | |
1039 | u_int32_t m_mpfail; /* times m_pullup failed */ | |
1040 | u_int32_t m_msize; /* length of an mbuf */ | |
1041 | u_int32_t m_mclbytes; /* length of an mbuf cluster */ | |
1042 | u_int32_t m_minclsize; /* min length of data to allocate a cluster */ | |
1043 | u_int32_t m_mlen; /* length of data in an mbuf */ | |
1044 | u_int32_t m_mhlen; /* length of data in a header mbuf */ | |
1045 | u_int32_t m_bigclusters; /* clusters obtained from page pool */ | |
1046 | u_int32_t m_bigclfree; /* free clusters */ | |
1047 | u_int32_t m_bigmclbytes; /* length of an mbuf cluster */ | |
91447636 A |
1048 | }; |
1049 | ||
1050 | /* Compatibillity with 10.3 */ | |
1051 | struct ombstat { | |
2d21ac55 A |
1052 | u_int32_t m_mbufs; /* mbufs obtained from page pool */ |
1053 | u_int32_t m_clusters; /* clusters obtained from page pool */ | |
1054 | u_int32_t m_spare; /* spare field */ | |
1055 | u_int32_t m_clfree; /* free clusters */ | |
1056 | u_int32_t m_drops; /* times failed to find space */ | |
1057 | u_int32_t m_wait; /* times waited for space */ | |
1058 | u_int32_t m_drain; /* times drained protocols for space */ | |
1059 | u_short m_mtypes[256]; /* type specific mbuf allocations */ | |
1060 | u_int32_t m_mcfail; /* times m_copym failed */ | |
1061 | u_int32_t m_mpfail; /* times m_pullup failed */ | |
1062 | u_int32_t m_msize; /* length of an mbuf */ | |
1063 | u_int32_t m_mclbytes; /* length of an mbuf cluster */ | |
1064 | u_int32_t m_minclsize; /* min length of data to allocate a cluster */ | |
1065 | u_int32_t m_mlen; /* length of data in an mbuf */ | |
1066 | u_int32_t m_mhlen; /* length of data in a header mbuf */ | |
1c79356b A |
1067 | }; |
1068 | ||
1069 | /* | |
2d21ac55 | 1070 | * mbuf class statistics. |
1c79356b | 1071 | */ |
2d21ac55 A |
1072 | #define MAX_MBUF_CNAME 15 |
1073 | ||
6d2010ae | 1074 | #if defined(XNU_KERNEL_PRIVATE) |
b0d623f7 A |
1075 | /* For backwards compatibility with 32-bit userland process */ |
1076 | struct omb_class_stat { | |
1077 | char mbcl_cname[MAX_MBUF_CNAME + 1]; /* class name */ | |
1078 | u_int32_t mbcl_size; /* buffer size */ | |
1079 | u_int32_t mbcl_total; /* # of buffers created */ | |
1080 | u_int32_t mbcl_active; /* # of active buffers */ | |
1081 | u_int32_t mbcl_infree; /* # of available buffers */ | |
1082 | u_int32_t mbcl_slab_cnt; /* # of available slabs */ | |
1083 | u_int64_t mbcl_alloc_cnt; /* # of times alloc is called */ | |
1084 | u_int64_t mbcl_free_cnt; /* # of times free is called */ | |
1085 | u_int64_t mbcl_notified; /* # of notified wakeups */ | |
1086 | u_int64_t mbcl_purge_cnt; /* # of purges so far */ | |
1087 | u_int64_t mbcl_fail_cnt; /* # of allocation failures */ | |
1088 | u_int32_t mbcl_ctotal; /* total only for this class */ | |
fe8ab488 | 1089 | u_int32_t mbcl_release_cnt; /* amount of memory returned */ |
b0d623f7 A |
1090 | /* |
1091 | * Cache layer statistics | |
1092 | */ | |
1093 | u_int32_t mbcl_mc_state; /* cache state (see below) */ | |
1094 | u_int32_t mbcl_mc_cached; /* # of cached buffers */ | |
1095 | u_int32_t mbcl_mc_waiter_cnt; /* # waiters on the cache */ | |
1096 | u_int32_t mbcl_mc_wretry_cnt; /* # of wait retries */ | |
1097 | u_int32_t mbcl_mc_nwretry_cnt; /* # of no-wait retry attempts */ | |
1098 | u_int64_t mbcl_reserved[4]; /* for future use */ | |
1099 | } __attribute__((__packed__)); | |
6d2010ae | 1100 | #endif /* XNU_KERNEL_PRIVATE */ |
b0d623f7 | 1101 | |
2d21ac55 A |
1102 | typedef struct mb_class_stat { |
1103 | char mbcl_cname[MAX_MBUF_CNAME + 1]; /* class name */ | |
1104 | u_int32_t mbcl_size; /* buffer size */ | |
1105 | u_int32_t mbcl_total; /* # of buffers created */ | |
1106 | u_int32_t mbcl_active; /* # of active buffers */ | |
1107 | u_int32_t mbcl_infree; /* # of available buffers */ | |
1108 | u_int32_t mbcl_slab_cnt; /* # of available slabs */ | |
b0d623f7 A |
1109 | #if defined(KERNEL) || defined(__LP64__) |
1110 | u_int32_t mbcl_pad; /* padding */ | |
1111 | #endif /* KERNEL || __LP64__ */ | |
2d21ac55 A |
1112 | u_int64_t mbcl_alloc_cnt; /* # of times alloc is called */ |
1113 | u_int64_t mbcl_free_cnt; /* # of times free is called */ | |
1114 | u_int64_t mbcl_notified; /* # of notified wakeups */ | |
1115 | u_int64_t mbcl_purge_cnt; /* # of purges so far */ | |
1116 | u_int64_t mbcl_fail_cnt; /* # of allocation failures */ | |
1117 | u_int32_t mbcl_ctotal; /* total only for this class */ | |
fe8ab488 | 1118 | u_int32_t mbcl_release_cnt; /* amount of memory returned */ |
2d21ac55 A |
1119 | /* |
1120 | * Cache layer statistics | |
1121 | */ | |
1122 | u_int32_t mbcl_mc_state; /* cache state (see below) */ | |
1123 | u_int32_t mbcl_mc_cached; /* # of cached buffers */ | |
1124 | u_int32_t mbcl_mc_waiter_cnt; /* # waiters on the cache */ | |
1125 | u_int32_t mbcl_mc_wretry_cnt; /* # of wait retries */ | |
1126 | u_int32_t mbcl_mc_nwretry_cnt; /* # of no-wait retry attempts */ | |
fe8ab488 A |
1127 | u_int32_t mbcl_peak_reported; /* last usage peak reported */ |
1128 | u_int32_t mbcl_reserved[7]; /* for future use */ | |
2d21ac55 A |
1129 | } mb_class_stat_t; |
1130 | ||
1131 | #define MCS_DISABLED 0 /* cache is permanently disabled */ | |
1132 | #define MCS_ONLINE 1 /* cache is online */ | |
1133 | #define MCS_PURGING 2 /* cache is being purged */ | |
1134 | #define MCS_OFFLINE 3 /* cache is offline (resizing) */ | |
1135 | ||
6d2010ae | 1136 | #if defined(XNU_KERNEL_PRIVATE) |
b0d623f7 A |
1137 | /* For backwards compatibility with 32-bit userland process */ |
1138 | struct omb_stat { | |
1139 | u_int32_t mbs_cnt; /* number of classes */ | |
1140 | struct omb_class_stat mbs_class[1]; /* class array */ | |
1141 | } __attribute__((__packed__)); | |
6d2010ae | 1142 | #endif /* XNU_KERNEL_PRIVATE */ |
b0d623f7 | 1143 | |
2d21ac55 A |
1144 | typedef struct mb_stat { |
1145 | u_int32_t mbs_cnt; /* number of classes */ | |
b0d623f7 A |
1146 | #if defined(KERNEL) || defined(__LP64__) |
1147 | u_int32_t mbs_pad; /* padding */ | |
1148 | #endif /* KERNEL || __LP64__ */ | |
2d21ac55 A |
1149 | mb_class_stat_t mbs_class[1]; /* class array */ |
1150 | } mb_stat_t; | |
1151 | ||
6d2010ae A |
1152 | #ifdef PRIVATE |
1153 | #define MLEAK_STACK_DEPTH 16 /* Max PC stack depth */ | |
1154 | ||
1155 | typedef struct mleak_trace_stat { | |
1156 | u_int64_t mltr_collisions; | |
1157 | u_int64_t mltr_hitcount; | |
1158 | u_int64_t mltr_allocs; | |
1159 | u_int64_t mltr_depth; | |
1160 | u_int64_t mltr_addr[MLEAK_STACK_DEPTH]; | |
1161 | } mleak_trace_stat_t; | |
1162 | ||
1163 | typedef struct mleak_stat { | |
1164 | u_int32_t ml_isaddr64; /* 64-bit KVA? */ | |
1165 | u_int32_t ml_cnt; /* number of traces */ | |
1166 | mleak_trace_stat_t ml_trace[1]; /* trace array */ | |
1167 | } mleak_stat_t; | |
1168 | ||
1169 | struct mleak_table { | |
1170 | u_int32_t mleak_capture; /* sampling capture counter */ | |
1171 | u_int32_t mleak_sample_factor; /* sample factor */ | |
1172 | ||
1173 | /* Times two active records want to occupy the same spot */ | |
1174 | u_int64_t alloc_collisions; | |
1175 | u_int64_t trace_collisions; | |
1176 | ||
1177 | /* Times new record lands on spot previously occupied by freed alloc */ | |
1178 | u_int64_t alloc_overwrites; | |
1179 | u_int64_t trace_overwrites; | |
1180 | ||
1181 | /* Times a new alloc or trace is put into the hash table */ | |
1182 | u_int64_t alloc_recorded; | |
1183 | u_int64_t trace_recorded; | |
1184 | ||
1185 | /* Total number of outstanding allocs */ | |
1186 | u_int64_t outstanding_allocs; | |
1187 | ||
1188 | /* Times mleak_log returned false because couldn't acquire the lock */ | |
1189 | u_int64_t total_conflicts; | |
1190 | }; | |
1191 | #endif /* PRIVATE */ | |
1192 | ||
2d21ac55 | 1193 | #ifdef KERNEL_PRIVATE |
6d2010ae | 1194 | __BEGIN_DECLS |
1c79356b | 1195 | |
6d2010ae A |
1196 | /* |
1197 | * Exported (private) | |
1198 | */ | |
1199 | ||
1200 | extern struct mbstat mbstat; /* statistics */ | |
1201 | ||
1202 | __END_DECLS | |
1203 | #endif /* KERNEL_PRIVATE */ | |
1c79356b | 1204 | |
6d2010ae | 1205 | #ifdef XNU_KERNEL_PRIVATE |
91447636 | 1206 | __BEGIN_DECLS |
6d2010ae A |
1207 | |
1208 | /* | |
1209 | * Not exported (xnu private) | |
1210 | */ | |
1211 | ||
1212 | /* flags to m_get/MGET */ | |
1213 | /* Need to include malloc.h to get right options for malloc */ | |
1214 | #include <sys/malloc.h> | |
1215 | ||
1216 | struct mbuf; | |
1217 | ||
1218 | /* length to m_copy to copy all */ | |
1219 | #define M_COPYALL 1000000000 | |
1220 | ||
1221 | #define M_DONTWAIT M_NOWAIT | |
1222 | #define M_WAIT M_WAITOK | |
1223 | ||
39236c6e A |
1224 | /* modes for m_copym and variants */ |
1225 | #define M_COPYM_NOOP_HDR 0 /* don't copy/move pkthdr contents */ | |
1226 | #define M_COPYM_COPY_HDR 1 /* copy pkthdr from old to new */ | |
1227 | #define M_COPYM_MOVE_HDR 2 /* move pkthdr from old to new */ | |
fe8ab488 A |
1228 | #define M_COPYM_MUST_COPY_HDR 3 /* MUST copy pkthdr from old to new */ |
1229 | #define M_COPYM_MUST_MOVE_HDR 4 /* MUST move pkthdr from old to new */ | |
39236c6e | 1230 | |
6d2010ae | 1231 | extern void m_freem(struct mbuf *); |
39236c6e | 1232 | extern u_int64_t mcl_to_paddr(char *); |
6d2010ae A |
1233 | extern void m_adj(struct mbuf *, int); |
1234 | extern void m_cat(struct mbuf *, struct mbuf *); | |
1235 | extern void m_copydata(struct mbuf *, int, int, void *); | |
1236 | extern struct mbuf *m_copym(struct mbuf *, int, int, int); | |
39236c6e | 1237 | extern struct mbuf *m_copym_mode(struct mbuf *, int, int, int, uint32_t); |
6d2010ae A |
1238 | extern struct mbuf *m_get(int, int); |
1239 | extern struct mbuf *m_gethdr(int, int); | |
1240 | extern struct mbuf *m_getpacket(void); | |
1241 | extern struct mbuf *m_getpackets(int, int, int); | |
1242 | extern struct mbuf *m_mclget(struct mbuf *, int); | |
1243 | extern void *m_mtod(struct mbuf *); | |
3e170ce0 | 1244 | extern struct mbuf *m_prepend_2(struct mbuf *, int, int, int); |
6d2010ae A |
1245 | extern struct mbuf *m_pullup(struct mbuf *, int); |
1246 | extern struct mbuf *m_split(struct mbuf *, int, int); | |
1247 | extern void m_mclfree(caddr_t p); | |
1248 | ||
316670eb A |
1249 | /* |
1250 | * On platforms which require strict alignment (currently for anything but | |
1251 | * i386 or x86_64), this macro checks whether the data pointer of an mbuf | |
1252 | * is 32-bit aligned (this is the expected minimum alignment for protocol | |
1253 | * headers), and assert otherwise. | |
1254 | */ | |
1255 | #if defined(__i386__) || defined(__x86_64__) | |
1256 | #define MBUF_STRICT_DATA_ALIGNMENT_CHECK_32(_m) | |
1257 | #else /* !__i386__ && !__x86_64__ */ | |
1258 | #define MBUF_STRICT_DATA_ALIGNMENT_CHECK_32(_m) do { \ | |
1259 | if (!IS_P2ALIGNED((_m)->m_data, sizeof (u_int32_t))) { \ | |
1260 | if (((_m)->m_flags & M_PKTHDR) && \ | |
1261 | (_m)->m_pkthdr.rcvif != NULL) { \ | |
1262 | panic_plain("\n%s: mbuf %p data ptr %p is not " \ | |
39236c6e | 1263 | "32-bit aligned [%s: alignerrs=%lld]\n", \ |
316670eb | 1264 | __func__, (_m), (_m)->m_data, \ |
39236c6e | 1265 | if_name((_m)->m_pkthdr.rcvif), \ |
316670eb A |
1266 | (_m)->m_pkthdr.rcvif->if_alignerrs); \ |
1267 | } else { \ | |
1268 | panic_plain("\n%s: mbuf %p data ptr %p is not " \ | |
1269 | "32-bit aligned\n", \ | |
1270 | __func__, (_m), (_m)->m_data); \ | |
1271 | } \ | |
1272 | } \ | |
1273 | } while (0) | |
1274 | #endif /* !__i386__ && !__x86_64__ */ | |
1275 | ||
1276 | /* Maximum number of MBUF_SC values (excluding MBUF_SC_UNSPEC) */ | |
1277 | #define MBUF_SC_MAX_CLASSES 10 | |
1278 | ||
1279 | /* | |
1280 | * These conversion macros rely on the corresponding MBUF_SC and | |
1281 | * MBUF_TC values in order to establish the following mapping: | |
1282 | * | |
1283 | * MBUF_SC_BK_SYS ] ==> MBUF_TC_BK | |
1284 | * MBUF_SC_BK ] | |
1285 | * | |
1286 | * MBUF_SC_BE ] ==> MBUF_TC_BE | |
1287 | * MBUF_SC_RD ] | |
1288 | * MBUF_SC_OAM ] | |
1289 | * | |
1290 | * MBUF_SC_AV ] ==> MBUF_TC_VI | |
1291 | * MBUF_SC_RV ] | |
1292 | * MBUF_SC_VI ] | |
d9a64523 | 1293 | * MBUF_SC_SIG ] |
316670eb A |
1294 | * |
1295 | * MBUF_SC_VO ] ==> MBUF_TC_VO | |
1296 | * MBUF_SC_CTL ] | |
1297 | * | |
1298 | * The values assigned to each service class allows for a fast mapping to | |
1299 | * the corresponding MBUF_TC traffic class values, as well as to retrieve the | |
1300 | * assigned index; therefore care must be taken when comparing against these | |
1301 | * values. Use the corresponding class and index macros to retrieve the | |
1302 | * corresponding portion, and never assume that a higher class corresponds | |
1303 | * to a higher index. | |
1304 | */ | |
1305 | #define MBUF_SCVAL(x) ((x) & 0xffff) | |
1306 | #define MBUF_SCIDX(x) ((((x) >> 16) & 0xff) >> 3) | |
1307 | #define MBUF_SC2TC(_sc) (MBUF_SCVAL(_sc) >> 7) | |
1308 | #define MBUF_TC2SCVAL(_tc) ((_tc) << 7) | |
1309 | #define IS_MBUF_SC_BACKGROUND(_sc) (((_sc) == MBUF_SC_BK_SYS) || \ | |
1310 | ((_sc) == MBUF_SC_BK)) | |
3e170ce0 A |
1311 | #define IS_MBUF_SC_REALTIME(_sc) ((_sc) >= MBUF_SC_AV && (_sc) <= MBUF_SC_VO) |
1312 | #define IS_MBUF_SC_BESTEFFORT(_sc) ((_sc) == MBUF_SC_BE || \ | |
1313 | (_sc) == MBUF_SC_RD || (_sc) == MBUF_SC_OAM) | |
316670eb A |
1314 | |
1315 | #define SCIDX_BK_SYS MBUF_SCIDX(MBUF_SC_BK_SYS) | |
1316 | #define SCIDX_BK MBUF_SCIDX(MBUF_SC_BK) | |
1317 | #define SCIDX_BE MBUF_SCIDX(MBUF_SC_BE) | |
1318 | #define SCIDX_RD MBUF_SCIDX(MBUF_SC_RD) | |
1319 | #define SCIDX_OAM MBUF_SCIDX(MBUF_SC_OAM) | |
1320 | #define SCIDX_AV MBUF_SCIDX(MBUF_SC_AV) | |
1321 | #define SCIDX_RV MBUF_SCIDX(MBUF_SC_RV) | |
1322 | #define SCIDX_VI MBUF_SCIDX(MBUF_SC_VI) | |
d9a64523 | 1323 | #define SCIDX_SIG MBUF_SCIDX(MBUF_SC_SIG) |
316670eb A |
1324 | #define SCIDX_VO MBUF_SCIDX(MBUF_SC_VO) |
1325 | #define SCIDX_CTL MBUF_SCIDX(MBUF_SC_CTL) | |
1326 | ||
1327 | #define SCVAL_BK_SYS MBUF_SCVAL(MBUF_SC_BK_SYS) | |
1328 | #define SCVAL_BK MBUF_SCVAL(MBUF_SC_BK) | |
1329 | #define SCVAL_BE MBUF_SCVAL(MBUF_SC_BE) | |
1330 | #define SCVAL_RD MBUF_SCVAL(MBUF_SC_RD) | |
1331 | #define SCVAL_OAM MBUF_SCVAL(MBUF_SC_OAM) | |
1332 | #define SCVAL_AV MBUF_SCVAL(MBUF_SC_AV) | |
1333 | #define SCVAL_RV MBUF_SCVAL(MBUF_SC_RV) | |
1334 | #define SCVAL_VI MBUF_SCVAL(MBUF_SC_VI) | |
d9a64523 | 1335 | #define SCVAL_SIG MBUF_SCVAL(MBUF_SC_SIG) |
316670eb A |
1336 | #define SCVAL_VO MBUF_SCVAL(MBUF_SC_VO) |
1337 | #define SCVAL_CTL MBUF_SCVAL(MBUF_SC_CTL) | |
1338 | ||
1339 | #define MBUF_VALID_SC(c) \ | |
1340 | (c == MBUF_SC_BK_SYS || c == MBUF_SC_BK || c == MBUF_SC_BE || \ | |
1341 | c == MBUF_SC_RD || c == MBUF_SC_OAM || c == MBUF_SC_AV || \ | |
d9a64523 A |
1342 | c == MBUF_SC_RV || c == MBUF_SC_VI || c == MBUF_SC_SIG || \ |
1343 | c == MBUF_SC_VO || c == MBUF_SC_CTL) | |
316670eb A |
1344 | |
1345 | #define MBUF_VALID_SCIDX(c) \ | |
1346 | (c == SCIDX_BK_SYS || c == SCIDX_BK || c == SCIDX_BE || \ | |
1347 | c == SCIDX_RD || c == SCIDX_OAM || c == SCIDX_AV || \ | |
d9a64523 A |
1348 | c == SCIDX_RV || c == SCIDX_VI || c == SCIDX_SIG || \ |
1349 | c == SCIDX_VO || c == SCIDX_CTL) | |
316670eb A |
1350 | |
1351 | #define MBUF_VALID_SCVAL(c) \ | |
1352 | (c == SCVAL_BK_SYS || c == SCVAL_BK || c == SCVAL_BE || \ | |
1353 | c == SCVAL_RD || c == SCVAL_OAM || c == SCVAL_AV || \ | |
d9a64523 A |
1354 | c == SCVAL_RV || c == SCVAL_VI || c == SCVAL_SIG || \ |
1355 | c == SCVAL_VO || SCVAL_CTL) | |
316670eb | 1356 | |
3e170ce0 A |
1357 | extern unsigned char *mbutl; /* start VA of mbuf pool */ |
1358 | extern unsigned char *embutl; /* end VA of mbuf pool */ | |
39236c6e A |
1359 | extern unsigned int nmbclusters; /* number of mapped clusters */ |
1360 | extern int njcl; /* # of jumbo clusters */ | |
1361 | extern int njclbytes; /* size of a jumbo cluster */ | |
1362 | extern int max_hdr; /* largest link+protocol header */ | |
1363 | extern int max_datalen; /* MHLEN - max_hdr */ | |
6d2010ae | 1364 | |
316670eb | 1365 | /* Use max_linkhdr instead of _max_linkhdr */ |
39236c6e | 1366 | extern int _max_linkhdr; /* largest link-level header */ |
316670eb A |
1367 | |
1368 | /* Use max_protohdr instead of _max_protohdr */ | |
39236c6e | 1369 | extern int _max_protohdr; /* largest protocol header */ |
316670eb | 1370 | |
6d2010ae | 1371 | __private_extern__ unsigned int mbuf_default_ncl(int, u_int64_t); |
2d21ac55 A |
1372 | __private_extern__ void mbinit(void); |
1373 | __private_extern__ struct mbuf *m_clattach(struct mbuf *, int, caddr_t, | |
39037602 | 1374 | void (*)(caddr_t, u_int, caddr_t), u_int, caddr_t, int, int); |
2d21ac55 A |
1375 | __private_extern__ caddr_t m_bigalloc(int); |
1376 | __private_extern__ void m_bigfree(caddr_t, u_int, caddr_t); | |
1377 | __private_extern__ struct mbuf *m_mbigget(struct mbuf *, int); | |
1378 | __private_extern__ caddr_t m_16kalloc(int); | |
1379 | __private_extern__ void m_16kfree(caddr_t, u_int, caddr_t); | |
1380 | __private_extern__ struct mbuf *m_m16kget(struct mbuf *, int); | |
39236c6e | 1381 | __private_extern__ int m_reinit(struct mbuf *, int); |
6d2010ae A |
1382 | __private_extern__ struct mbuf *m_free(struct mbuf *); |
1383 | __private_extern__ struct mbuf *m_getclr(int, int); | |
1384 | __private_extern__ struct mbuf *m_getptr(struct mbuf *, int, int *); | |
1385 | __private_extern__ unsigned int m_length(struct mbuf *); | |
316670eb A |
1386 | __private_extern__ unsigned int m_length2(struct mbuf *, struct mbuf **); |
1387 | __private_extern__ unsigned int m_fixhdr(struct mbuf *); | |
1388 | __private_extern__ struct mbuf *m_defrag(struct mbuf *, int); | |
1389 | __private_extern__ struct mbuf *m_defrag_offset(struct mbuf *, u_int32_t, int); | |
6d2010ae A |
1390 | __private_extern__ struct mbuf *m_prepend(struct mbuf *, int, int); |
1391 | __private_extern__ struct mbuf *m_copyup(struct mbuf *, int, int); | |
1392 | __private_extern__ struct mbuf *m_retry(int, int); | |
1393 | __private_extern__ struct mbuf *m_retryhdr(int, int); | |
1394 | __private_extern__ int m_freem_list(struct mbuf *); | |
1395 | __private_extern__ int m_append(struct mbuf *, int, caddr_t); | |
1396 | __private_extern__ struct mbuf *m_last(struct mbuf *); | |
1397 | __private_extern__ struct mbuf *m_devget(char *, int, int, struct ifnet *, | |
1398 | void (*)(const void *, void *, size_t)); | |
1399 | __private_extern__ struct mbuf *m_pulldown(struct mbuf *, int, int, int *); | |
1400 | ||
1401 | __private_extern__ struct mbuf *m_getcl(int, int, int); | |
1402 | __private_extern__ caddr_t m_mclalloc(int); | |
1403 | __private_extern__ int m_mclhasreference(struct mbuf *); | |
1404 | __private_extern__ void m_copy_pkthdr(struct mbuf *, struct mbuf *); | |
316670eb | 1405 | __private_extern__ void m_copy_pftag(struct mbuf *, struct mbuf *); |
39236c6e | 1406 | __private_extern__ void m_copy_classifier(struct mbuf *, struct mbuf *); |
6d2010ae A |
1407 | |
1408 | __private_extern__ struct mbuf *m_dtom(void *); | |
1409 | __private_extern__ int m_mtocl(void *); | |
1410 | __private_extern__ union mcluster *m_cltom(int); | |
1411 | ||
d9a64523 | 1412 | __private_extern__ void m_align(struct mbuf *, int); |
6d2010ae A |
1413 | |
1414 | __private_extern__ struct mbuf *m_normalize(struct mbuf *m); | |
1415 | __private_extern__ void m_mchtype(struct mbuf *m, int t); | |
1416 | __private_extern__ void m_mcheck(struct mbuf *); | |
1417 | ||
1418 | __private_extern__ void m_copyback(struct mbuf *, int, int, const void *); | |
1419 | __private_extern__ struct mbuf *m_copyback_cow(struct mbuf *, int, int, | |
1420 | const void *, int); | |
1421 | __private_extern__ int m_makewritable(struct mbuf **, int, int, int); | |
1422 | __private_extern__ struct mbuf *m_dup(struct mbuf *m, int how); | |
1423 | __private_extern__ struct mbuf *m_copym_with_hdrs(struct mbuf *, int, int, int, | |
39236c6e | 1424 | struct mbuf **, int *, uint32_t); |
6d2010ae A |
1425 | __private_extern__ struct mbuf *m_getpackethdrs(int, int); |
1426 | __private_extern__ struct mbuf *m_getpacket_how(int); | |
1427 | __private_extern__ struct mbuf *m_getpackets_internal(unsigned int *, int, | |
1428 | int, int, size_t); | |
1429 | __private_extern__ struct mbuf *m_allocpacket_internal(unsigned int *, size_t, | |
1430 | unsigned int *, int, int, size_t); | |
9bccf70c | 1431 | |
39037602 A |
1432 | __private_extern__ int m_ext_set_prop(struct mbuf *, uint32_t, uint32_t); |
1433 | __private_extern__ uint32_t m_ext_get_prop(struct mbuf *); | |
1434 | __private_extern__ int m_ext_paired_is_active(struct mbuf *); | |
1435 | __private_extern__ void m_ext_paired_activate(struct mbuf *); | |
1436 | ||
d9a64523 | 1437 | __private_extern__ void mbuf_drain(boolean_t); |
fe8ab488 | 1438 | |
91447636 | 1439 | /* |
6d2010ae A |
1440 | * Packets may have annotations attached by affixing a list of "packet |
1441 | * tags" to the pkthdr structure. Packet tags are dynamically allocated | |
1442 | * semi-opaque data structures that have a fixed header (struct m_tag) | |
1443 | * that specifies the size of the memory block and an <id,type> pair that | |
1444 | * identifies it. The id identifies the module and the type identifies the | |
1445 | * type of data for that module. The id of zero is reserved for the kernel. | |
1446 | * | |
1447 | * Note that the packet tag returned by m_tag_allocate has the default | |
1448 | * memory alignment implemented by malloc. To reference private data one | |
1449 | * can use a construct like: | |
1450 | * | |
1451 | * struct m_tag *mtag = m_tag_allocate(...); | |
1452 | * struct foo *p = (struct foo *)(mtag+1); | |
1453 | * | |
1454 | * if the alignment of struct m_tag is sufficient for referencing members | |
1455 | * of struct foo. Otherwise it is necessary to embed struct m_tag within | |
1456 | * the private data structure to insure proper alignment; e.g. | |
1457 | * | |
1458 | * struct foo { | |
1459 | * struct m_tag tag; | |
1460 | * ... | |
1461 | * }; | |
1462 | * struct foo *p = (struct foo *) m_tag_allocate(...); | |
1463 | * struct m_tag *mtag = &p->tag; | |
91447636 A |
1464 | */ |
1465 | ||
6d2010ae | 1466 | #define KERNEL_MODULE_TAG_ID 0 |
91447636 A |
1467 | |
1468 | enum { | |
1469 | KERNEL_TAG_TYPE_NONE = 0, | |
1470 | KERNEL_TAG_TYPE_DUMMYNET = 1, | |
1471 | KERNEL_TAG_TYPE_DIVERT = 2, | |
1472 | KERNEL_TAG_TYPE_IPFORWARD = 3, | |
2d21ac55 A |
1473 | KERNEL_TAG_TYPE_IPFILT = 4, |
1474 | KERNEL_TAG_TYPE_MACLABEL = 5, | |
1475 | KERNEL_TAG_TYPE_MAC_POLICY_LABEL = 6, | |
1476 | KERNEL_TAG_TYPE_ENCAP = 8, | |
1477 | KERNEL_TAG_TYPE_INET6 = 9, | |
b0d623f7 | 1478 | KERNEL_TAG_TYPE_IPSEC = 10, |
fe8ab488 | 1479 | KERNEL_TAG_TYPE_DRVAUX = 11, |
d9a64523 | 1480 | KERNEL_TAG_TYPE_CFIL_UDP = 13, |
91447636 A |
1481 | }; |
1482 | ||
91447636 | 1483 | /* Packet tag routines */ |
6d2010ae A |
1484 | __private_extern__ struct m_tag *m_tag_alloc(u_int32_t, u_int16_t, int, int); |
1485 | __private_extern__ struct m_tag *m_tag_create(u_int32_t, u_int16_t, int, int, | |
1486 | struct mbuf *); | |
1487 | __private_extern__ void m_tag_free(struct m_tag *); | |
1488 | __private_extern__ void m_tag_prepend(struct mbuf *, struct m_tag *); | |
1489 | __private_extern__ void m_tag_unlink(struct mbuf *, struct m_tag *); | |
1490 | __private_extern__ void m_tag_delete(struct mbuf *, struct m_tag *); | |
1491 | __private_extern__ void m_tag_delete_chain(struct mbuf *, struct m_tag *); | |
1492 | __private_extern__ struct m_tag *m_tag_locate(struct mbuf *, u_int32_t, | |
1493 | u_int16_t, struct m_tag *); | |
1494 | __private_extern__ struct m_tag *m_tag_copy(struct m_tag *, int); | |
1495 | __private_extern__ int m_tag_copy_chain(struct mbuf *, struct mbuf *, int); | |
39236c6e | 1496 | __private_extern__ void m_tag_init(struct mbuf *, int); |
6d2010ae A |
1497 | __private_extern__ struct m_tag *m_tag_first(struct mbuf *); |
1498 | __private_extern__ struct m_tag *m_tag_next(struct mbuf *, struct m_tag *); | |
1499 | ||
39236c6e A |
1500 | __private_extern__ void m_scratch_init(struct mbuf *); |
1501 | __private_extern__ u_int32_t m_scratch_get(struct mbuf *, u_int8_t **); | |
1502 | ||
1503 | __private_extern__ void m_classifier_init(struct mbuf *, uint32_t); | |
1504 | ||
316670eb A |
1505 | __private_extern__ int m_set_service_class(struct mbuf *, mbuf_svc_class_t); |
1506 | __private_extern__ mbuf_svc_class_t m_get_service_class(struct mbuf *); | |
1507 | __private_extern__ mbuf_svc_class_t m_service_class_from_idx(u_int32_t); | |
1508 | __private_extern__ mbuf_svc_class_t m_service_class_from_val(u_int32_t); | |
1509 | __private_extern__ int m_set_traffic_class(struct mbuf *, mbuf_traffic_class_t); | |
1510 | __private_extern__ mbuf_traffic_class_t m_get_traffic_class(struct mbuf *); | |
1511 | ||
39236c6e A |
1512 | #define ADDCARRY(_x) do { \ |
1513 | while (((_x) >> 16) != 0) \ | |
1514 | (_x) = ((_x) >> 16) + ((_x) & 0xffff); \ | |
1515 | } while (0) | |
1516 | ||
1517 | __private_extern__ u_int16_t m_adj_sum16(struct mbuf *, u_int32_t, | |
5ba3f43e | 1518 | u_int32_t, u_int32_t, u_int32_t); |
39236c6e A |
1519 | __private_extern__ u_int16_t m_sum16(struct mbuf *, u_int32_t, u_int32_t); |
1520 | ||
5ba3f43e A |
1521 | __private_extern__ void m_set_ext(struct mbuf *, struct ext_ref *, |
1522 | m_ext_free_func_t, caddr_t); | |
813fb2f6 A |
1523 | __private_extern__ struct ext_ref *m_get_rfa(struct mbuf *); |
1524 | __private_extern__ m_ext_free_func_t m_get_ext_free(struct mbuf *); | |
1525 | __private_extern__ caddr_t m_get_ext_arg(struct mbuf *); | |
1526 | ||
d9a64523 A |
1527 | __private_extern__ void m_do_tx_compl_callback(struct mbuf *, struct ifnet *); |
1528 | __private_extern__ mbuf_tx_compl_func m_get_tx_compl_callback(u_int32_t); | |
39037602 | 1529 | |
316670eb A |
1530 | __END_DECLS |
1531 | #endif /* XNU_KERNEL_PRIVATE */ | |
1c79356b | 1532 | #endif /* !_SYS_MBUF_H_ */ |