xref: /xnu-11417.121.6/tests/net_test_lib.h (revision a1e26a70f38d1d7daa7b49b258e2f8538ad81650)
1*a1e26a70SApple OSS Distributions /*
2*a1e26a70SApple OSS Distributions  * Copyright (c) 2023-2024 Apple Inc. All rights reserved.
3*a1e26a70SApple OSS Distributions  *
4*a1e26a70SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5*a1e26a70SApple OSS Distributions  *
6*a1e26a70SApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
7*a1e26a70SApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
8*a1e26a70SApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
9*a1e26a70SApple OSS Distributions  * compliance with the License. The rights granted to you under the License
10*a1e26a70SApple OSS Distributions  * may not be used to create, or enable the creation or redistribution of,
11*a1e26a70SApple OSS Distributions  * unlawful or unlicensed copies of an Apple operating system, or to
12*a1e26a70SApple OSS Distributions  * circumvent, violate, or enable the circumvention or violation of, any
13*a1e26a70SApple OSS Distributions  * terms of an Apple operating system software license agreement.
14*a1e26a70SApple OSS Distributions  *
15*a1e26a70SApple OSS Distributions  * Please obtain a copy of the License at
16*a1e26a70SApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17*a1e26a70SApple OSS Distributions  *
18*a1e26a70SApple OSS Distributions  * The Original Code and all software distributed under the License are
19*a1e26a70SApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20*a1e26a70SApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21*a1e26a70SApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22*a1e26a70SApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23*a1e26a70SApple OSS Distributions  * Please see the License for the specific language governing rights and
24*a1e26a70SApple OSS Distributions  * limitations under the License.
25*a1e26a70SApple OSS Distributions  *
26*a1e26a70SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27*a1e26a70SApple OSS Distributions  */
28*a1e26a70SApple OSS Distributions 
29*a1e26a70SApple OSS Distributions 
30*a1e26a70SApple OSS Distributions #ifndef __net_test_lib_h__
31*a1e26a70SApple OSS Distributions #define __net_test_lib_h__
32*a1e26a70SApple OSS Distributions 
33*a1e26a70SApple OSS Distributions #include <darwintest.h>
34*a1e26a70SApple OSS Distributions #include <stdio.h>
35*a1e26a70SApple OSS Distributions #include <unistd.h>
36*a1e26a70SApple OSS Distributions #include <stddef.h>
37*a1e26a70SApple OSS Distributions #include <stdbool.h>
38*a1e26a70SApple OSS Distributions #include <stdlib.h>
39*a1e26a70SApple OSS Distributions #include <string.h>
40*a1e26a70SApple OSS Distributions #include <sys/socket.h>
41*a1e26a70SApple OSS Distributions #include <arpa/inet.h>
42*a1e26a70SApple OSS Distributions #include <sys/event.h>
43*a1e26a70SApple OSS Distributions #include <net/if.h>
44*a1e26a70SApple OSS Distributions #include <netinet/in.h>
45*a1e26a70SApple OSS Distributions #include <netinet6/in6_var.h>
46*a1e26a70SApple OSS Distributions #include <netinet6/nd6.h>
47*a1e26a70SApple OSS Distributions #include <netinet/in.h>
48*a1e26a70SApple OSS Distributions #include <netinet/ip.h>
49*a1e26a70SApple OSS Distributions #include <netinet/udp.h>
50*a1e26a70SApple OSS Distributions #include <netinet/bootp.h>
51*a1e26a70SApple OSS Distributions #include <netinet/tcp.h>
52*a1e26a70SApple OSS Distributions #include <netinet/if_ether.h>
53*a1e26a70SApple OSS Distributions #include <netinet/ip6.h>
54*a1e26a70SApple OSS Distributions #include <netinet/icmp6.h>
55*a1e26a70SApple OSS Distributions #include <net/if_arp.h>
56*a1e26a70SApple OSS Distributions #include <net/bpf.h>
57*a1e26a70SApple OSS Distributions #include <net/if_bridgevar.h>
58*a1e26a70SApple OSS Distributions #include <net/if_fake_var.h>
59*a1e26a70SApple OSS Distributions #include <sys/ioctl.h>
60*a1e26a70SApple OSS Distributions #include <sys/types.h>
61*a1e26a70SApple OSS Distributions #include <sys/stat.h>
62*a1e26a70SApple OSS Distributions #include <errno.h>
63*a1e26a70SApple OSS Distributions #include <pthread.h>
64*a1e26a70SApple OSS Distributions #include <stdbool.h>
65*a1e26a70SApple OSS Distributions #include <TargetConditionals.h>
66*a1e26a70SApple OSS Distributions #include <darwintest_utils.h>
67*a1e26a70SApple OSS Distributions #include "inet_transfer.h"
68*a1e26a70SApple OSS Distributions #include "bpflib.h"
69*a1e26a70SApple OSS Distributions #include "in_cksum.h"
70*a1e26a70SApple OSS Distributions 
71*a1e26a70SApple OSS Distributions extern bool G_debug;
72*a1e26a70SApple OSS Distributions 
73*a1e26a70SApple OSS Distributions /*
74*a1e26a70SApple OSS Distributions  * network_interface routines
75*a1e26a70SApple OSS Distributions  */
76*a1e26a70SApple OSS Distributions typedef char if_name_t[IFNAMSIZ];
77*a1e26a70SApple OSS Distributions 
78*a1e26a70SApple OSS Distributions typedef struct {
79*a1e26a70SApple OSS Distributions 	if_name_t               if_name;
80*a1e26a70SApple OSS Distributions 	u_short                 if_index;
81*a1e26a70SApple OSS Distributions 	struct in_addr          ip;
82*a1e26a70SApple OSS Distributions 	struct in6_addr         ip6;
83*a1e26a70SApple OSS Distributions } network_interface, *network_interface_t;
84*a1e26a70SApple OSS Distributions 
85*a1e26a70SApple OSS Distributions typedef struct {
86*a1e26a70SApple OSS Distributions 	network_interface       one;
87*a1e26a70SApple OSS Distributions 	network_interface       two;
88*a1e26a70SApple OSS Distributions } network_interface_pair, *network_interface_pair_t;
89*a1e26a70SApple OSS Distributions 
90*a1e26a70SApple OSS Distributions typedef struct {
91*a1e26a70SApple OSS Distributions 	u_int                   count;
92*a1e26a70SApple OSS Distributions 	network_interface_pair  list[1];
93*a1e26a70SApple OSS Distributions } network_interface_pair_list, * network_interface_pair_list_t;
94*a1e26a70SApple OSS Distributions 
95*a1e26a70SApple OSS Distributions extern void
96*a1e26a70SApple OSS Distributions network_interface_create(network_interface_t if_p, const if_name_t name);
97*a1e26a70SApple OSS Distributions 
98*a1e26a70SApple OSS Distributions extern void
99*a1e26a70SApple OSS Distributions network_interface_destroy(network_interface_t if_p);
100*a1e26a70SApple OSS Distributions 
101*a1e26a70SApple OSS Distributions extern network_interface_pair_list_t
102*a1e26a70SApple OSS Distributions network_interface_pair_list_alloc(u_int n);
103*a1e26a70SApple OSS Distributions 
104*a1e26a70SApple OSS Distributions extern void
105*a1e26a70SApple OSS Distributions network_interface_pair_list_destroy(network_interface_pair_list_t list);
106*a1e26a70SApple OSS Distributions 
107*a1e26a70SApple OSS Distributions #define DHCP_PAYLOAD_MIN        sizeof(struct bootp)
108*a1e26a70SApple OSS Distributions #define DHCP_FLAGS_BROADCAST    ((u_short)0x8000)
109*a1e26a70SApple OSS Distributions 
110*a1e26a70SApple OSS Distributions #define FETH_NAME       "feth"
111*a1e26a70SApple OSS Distributions #define VLAN_NAME       "vlan"
112*a1e26a70SApple OSS Distributions #define BOND_NAME       "bond"
113*a1e26a70SApple OSS Distributions #define BRIDGE_NAME     "bridge"
114*a1e26a70SApple OSS Distributions #define BRIDGE200       BRIDGE_NAME "200"
115*a1e26a70SApple OSS Distributions #define FETH0           FETH_NAME "0"
116*a1e26a70SApple OSS Distributions 
117*a1e26a70SApple OSS Distributions extern struct in_addr inet_class_c_subnet_mask;
118*a1e26a70SApple OSS Distributions 
119*a1e26a70SApple OSS Distributions typedef union {
120*a1e26a70SApple OSS Distributions 	char            bytes[DHCP_PAYLOAD_MIN];
121*a1e26a70SApple OSS Distributions 	/* force 4-byte alignment */
122*a1e26a70SApple OSS Distributions 	uint32_t        words[DHCP_PAYLOAD_MIN / sizeof(uint32_t)];
123*a1e26a70SApple OSS Distributions } dhcp_min_payload, *dhcp_min_payload_t;
124*a1e26a70SApple OSS Distributions 
125*a1e26a70SApple OSS Distributions #define ETHER_PKT_LEN           (ETHER_HDR_LEN + ETHERMTU)
126*a1e26a70SApple OSS Distributions typedef union {
127*a1e26a70SApple OSS Distributions 	char            bytes[ETHER_PKT_LEN];
128*a1e26a70SApple OSS Distributions 	/* force 4-byte aligment */
129*a1e26a70SApple OSS Distributions 	uint32_t        words[ETHER_PKT_LEN / sizeof(uint32_t)];
130*a1e26a70SApple OSS Distributions } ether_packet, *ether_packet_t;
131*a1e26a70SApple OSS Distributions 
132*a1e26a70SApple OSS Distributions typedef struct {
133*a1e26a70SApple OSS Distributions 	struct ip       ip;
134*a1e26a70SApple OSS Distributions 	struct udphdr   udp;
135*a1e26a70SApple OSS Distributions } ip_udp_header_t;
136*a1e26a70SApple OSS Distributions 
137*a1e26a70SApple OSS Distributions typedef struct {
138*a1e26a70SApple OSS Distributions 	struct in_addr  src_ip;
139*a1e26a70SApple OSS Distributions 	struct in_addr  dst_ip;
140*a1e26a70SApple OSS Distributions 	char            zero;
141*a1e26a70SApple OSS Distributions 	char            proto;
142*a1e26a70SApple OSS Distributions 	unsigned short  length;
143*a1e26a70SApple OSS Distributions } udp_pseudo_hdr_t;
144*a1e26a70SApple OSS Distributions 
145*a1e26a70SApple OSS Distributions typedef struct {
146*a1e26a70SApple OSS Distributions 	struct ip       ip;
147*a1e26a70SApple OSS Distributions 	struct tcphdr   tcp;
148*a1e26a70SApple OSS Distributions } ip_tcp_header_t;
149*a1e26a70SApple OSS Distributions 
150*a1e26a70SApple OSS Distributions typedef union {
151*a1e26a70SApple OSS Distributions 	ip_udp_header_t udp;
152*a1e26a70SApple OSS Distributions 	ip_tcp_header_t tcp;
153*a1e26a70SApple OSS Distributions } ip_udp_tcp_header_u;
154*a1e26a70SApple OSS Distributions 
155*a1e26a70SApple OSS Distributions typedef struct {
156*a1e26a70SApple OSS Distributions 	struct in_addr  src_ip;
157*a1e26a70SApple OSS Distributions 	struct in_addr  dst_ip;
158*a1e26a70SApple OSS Distributions 	char            zero;
159*a1e26a70SApple OSS Distributions 	char            proto;
160*a1e26a70SApple OSS Distributions 	unsigned short  length;
161*a1e26a70SApple OSS Distributions } tcp_pseudo_hdr_t;
162*a1e26a70SApple OSS Distributions 
163*a1e26a70SApple OSS Distributions typedef struct {
164*a1e26a70SApple OSS Distributions 	struct ip6_hdr  ip6;
165*a1e26a70SApple OSS Distributions 	struct udphdr   udp;
166*a1e26a70SApple OSS Distributions } ip6_udp_header_t;
167*a1e26a70SApple OSS Distributions 
168*a1e26a70SApple OSS Distributions typedef struct {
169*a1e26a70SApple OSS Distributions 	struct in6_addr src_ip;
170*a1e26a70SApple OSS Distributions 	struct in6_addr dst_ip;
171*a1e26a70SApple OSS Distributions 	char            zero;
172*a1e26a70SApple OSS Distributions 	char            proto;
173*a1e26a70SApple OSS Distributions 	unsigned short  length;
174*a1e26a70SApple OSS Distributions } udp6_pseudo_hdr_t;
175*a1e26a70SApple OSS Distributions 
176*a1e26a70SApple OSS Distributions extern ether_addr_t ether_broadcast;
177*a1e26a70SApple OSS Distributions 
178*a1e26a70SApple OSS Distributions extern int inet_dgram_socket_get(void);
179*a1e26a70SApple OSS Distributions void inet_dgram_socket_close(void);
180*a1e26a70SApple OSS Distributions 
181*a1e26a70SApple OSS Distributions extern int inet6_dgram_socket_get(void);
182*a1e26a70SApple OSS Distributions void inet6_dgram_socket_close(void);
183*a1e26a70SApple OSS Distributions 
184*a1e26a70SApple OSS Distributions extern int ifnet_create(const char * ifname);
185*a1e26a70SApple OSS Distributions 
186*a1e26a70SApple OSS Distributions extern int ifnet_create_2(char * ifname, size_t len);
187*a1e26a70SApple OSS Distributions 
188*a1e26a70SApple OSS Distributions extern int ifnet_destroy(const char * ifname, bool fail_on_error);
189*a1e26a70SApple OSS Distributions 
190*a1e26a70SApple OSS Distributions extern void ifnet_get_lladdr(const char * ifname, ether_addr_t * eaddr);
191*a1e26a70SApple OSS Distributions 
192*a1e26a70SApple OSS Distributions extern void ifnet_attach_ip(char * name);
193*a1e26a70SApple OSS Distributions 
194*a1e26a70SApple OSS Distributions extern void ifnet_start_ipv6(const char * ifname);
195*a1e26a70SApple OSS Distributions 
196*a1e26a70SApple OSS Distributions extern int ifnet_set_lladdr(const char * ifname, ether_addr_t * eaddr);
197*a1e26a70SApple OSS Distributions 
198*a1e26a70SApple OSS Distributions extern int ifnet_set_flags(const char * ifname,
199*a1e26a70SApple OSS Distributions     uint16_t flags_set, uint16_t flags_clear);
200*a1e26a70SApple OSS Distributions 
201*a1e26a70SApple OSS Distributions extern void ifnet_add_ip_address(char *ifname, struct in_addr addr,
202*a1e26a70SApple OSS Distributions     struct in_addr mask);
203*a1e26a70SApple OSS Distributions 
204*a1e26a70SApple OSS Distributions extern int ifnet_set_mtu(const char * ifname, int mtu);
205*a1e26a70SApple OSS Distributions 
206*a1e26a70SApple OSS Distributions extern int siocdrvspec(const char * ifname,
207*a1e26a70SApple OSS Distributions     u_long op, void *arg, size_t argsize, bool set);
208*a1e26a70SApple OSS Distributions 
209*a1e26a70SApple OSS Distributions extern void fake_set_peer(const char * feth, const char * feth_peer);
210*a1e26a70SApple OSS Distributions 
211*a1e26a70SApple OSS Distributions extern void siocsifvlan(const char * vlan, const char * phys, uint16_t tag);
212*a1e26a70SApple OSS Distributions 
213*a1e26a70SApple OSS Distributions extern void route_add_inet_scoped_subnet(char * ifname, u_short if_index,
214*a1e26a70SApple OSS Distributions     struct in_addr ifa, struct in_addr mask);
215*a1e26a70SApple OSS Distributions 
216*a1e26a70SApple OSS Distributions extern u_int ethernet_udp4_frame_populate(void * buf, size_t buf_len,
217*a1e26a70SApple OSS Distributions     const ether_addr_t * src,
218*a1e26a70SApple OSS Distributions     struct in_addr src_ip,
219*a1e26a70SApple OSS Distributions     uint16_t src_port,
220*a1e26a70SApple OSS Distributions     const ether_addr_t * dst,
221*a1e26a70SApple OSS Distributions     struct in_addr dst_ip,
222*a1e26a70SApple OSS Distributions     uint16_t dst_port,
223*a1e26a70SApple OSS Distributions     const void * data, u_int data_len);
224*a1e26a70SApple OSS Distributions 
225*a1e26a70SApple OSS Distributions extern u_int
226*a1e26a70SApple OSS Distributions ethernet_udp6_frame_populate(void * buf, size_t buf_len,
227*a1e26a70SApple OSS Distributions     const ether_addr_t * src,
228*a1e26a70SApple OSS Distributions     struct in6_addr *src_ip,
229*a1e26a70SApple OSS Distributions     uint16_t src_port,
230*a1e26a70SApple OSS Distributions     const ether_addr_t * dst,
231*a1e26a70SApple OSS Distributions     struct in6_addr * dst_ip,
232*a1e26a70SApple OSS Distributions     uint16_t dst_port,
233*a1e26a70SApple OSS Distributions     const void * data, u_int data_len);
234*a1e26a70SApple OSS Distributions 
235*a1e26a70SApple OSS Distributions 
236*a1e26a70SApple OSS Distributions extern u_int make_dhcp_payload(dhcp_min_payload_t payload, ether_addr_t *eaddr);
237*a1e26a70SApple OSS Distributions 
238*a1e26a70SApple OSS Distributions extern bool has_ipv4_default_route(void);
239*a1e26a70SApple OSS Distributions 
240*a1e26a70SApple OSS Distributions extern bool has_ipv6_default_route(void);
241*a1e26a70SApple OSS Distributions 
242*a1e26a70SApple OSS Distributions extern int bridge_add_member(const char * bridge, const char * member);
243*a1e26a70SApple OSS Distributions 
244*a1e26a70SApple OSS Distributions #endif /* __net_test_lib_h__ */
245