xref: /freebsd/sys/netpfil/ipfw/ip_fw_private.h (revision 7cd2dcf07629713e5a3d60472cfe4701b705a167)
1 /*-
2  * Copyright (c) 2002-2009 Luigi Rizzo, Universita` di Pisa
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23  * SUCH DAMAGE.
24  *
25  * $FreeBSD$
26  */
27 
28 #ifndef _IPFW2_PRIVATE_H
29 #define _IPFW2_PRIVATE_H
30 
31 /*
32  * Internal constants and data structures used by ipfw components
33  * and not meant to be exported outside the kernel.
34  */
35 
36 #ifdef _KERNEL
37 
38 /*
39  * For platforms that do not have SYSCTL support, we wrap the
40  * SYSCTL_* into a function (one per file) to collect the values
41  * into an array at module initialization. The wrapping macros,
42  * SYSBEGIN() and SYSEND, are empty in the default case.
43  */
44 #ifndef SYSBEGIN
45 #define SYSBEGIN(x)
46 #endif
47 #ifndef SYSEND
48 #define SYSEND
49 #endif
50 
51 /* Return values from ipfw_chk() */
52 enum {
53 	IP_FW_PASS = 0,
54 	IP_FW_DENY,
55 	IP_FW_DIVERT,
56 	IP_FW_TEE,
57 	IP_FW_DUMMYNET,
58 	IP_FW_NETGRAPH,
59 	IP_FW_NGTEE,
60 	IP_FW_NAT,
61 	IP_FW_REASS,
62 };
63 
64 /*
65  * Structure for collecting parameters to dummynet for ip6_output forwarding
66  */
67 struct _ip6dn_args {
68        struct ip6_pktopts *opt_or;
69        struct route_in6 ro_or;
70        int flags_or;
71        struct ip6_moptions *im6o_or;
72        struct ifnet *origifp_or;
73        struct ifnet *ifp_or;
74        struct sockaddr_in6 dst_or;
75        u_long mtu_or;
76        struct route_in6 ro_pmtu_or;
77 };
78 
79 
80 /*
81  * Arguments for calling ipfw_chk() and dummynet_io(). We put them
82  * all into a structure because this way it is easier and more
83  * efficient to pass variables around and extend the interface.
84  */
85 struct ip_fw_args {
86 	struct mbuf	*m;		/* the mbuf chain		*/
87 	struct ifnet	*oif;		/* output interface		*/
88 	struct sockaddr_in *next_hop;	/* forward address		*/
89 	struct sockaddr_in6 *next_hop6; /* ipv6 forward address		*/
90 
91 	/*
92 	 * On return, it points to the matching rule.
93 	 * On entry, rule.slot > 0 means the info is valid and
94 	 * contains the starting rule for an ipfw search.
95 	 * If chain_id == chain->id && slot >0 then jump to that slot.
96 	 * Otherwise, we locate the first rule >= rulenum:rule_id
97 	 */
98 	struct ipfw_rule_ref rule;	/* match/restart info		*/
99 
100 	struct ether_header *eh;	/* for bridged packets		*/
101 
102 	struct ipfw_flow_id f_id;	/* grabbed from IP header	*/
103 	//uint32_t	cookie;		/* a cookie depending on rule action */
104 	struct inpcb	*inp;
105 
106 	struct _ip6dn_args	dummypar; /* dummynet->ip6_output */
107 	struct sockaddr_in hopstore;	/* store here if cannot use a pointer */
108 };
109 
110 MALLOC_DECLARE(M_IPFW);
111 
112 /*
113  * Hooks sometime need to know the direction of the packet
114  * (divert, dummynet, netgraph, ...)
115  * We use a generic definition here, with bit0-1 indicating the
116  * direction, bit 2 indicating layer2 or 3, bit 3-4 indicating the
117  * specific protocol
118  * indicating the protocol (if necessary)
119  */
120 enum {
121 	DIR_MASK =	0x3,
122 	DIR_OUT =	0,
123 	DIR_IN =	1,
124 	DIR_FWD =	2,
125 	DIR_DROP =	3,
126 	PROTO_LAYER2 =	0x4, /* set for layer 2 */
127 	/* PROTO_DEFAULT = 0, */
128 	PROTO_IPV4 =	0x08,
129 	PROTO_IPV6 =	0x10,
130 	PROTO_IFB =	0x0c, /* layer2 + ifbridge */
131    /*	PROTO_OLDBDG =	0x14, unused, old bridge */
132 };
133 
134 /* wrapper for freeing a packet, in case we need to do more work */
135 #ifndef FREE_PKT
136 #if defined(__linux__) || defined(_WIN32)
137 #define FREE_PKT(m)	netisr_dispatch(-1, m)
138 #else
139 #define FREE_PKT(m)	m_freem(m)
140 #endif
141 #endif /* !FREE_PKT */
142 
143 /*
144  * Function definitions.
145  */
146 
147 /* attach (arg = 1) or detach (arg = 0) hooks */
148 int ipfw_attach_hooks(int);
149 #ifdef NOTYET
150 void ipfw_nat_destroy(void);
151 #endif
152 
153 /* In ip_fw_log.c */
154 struct ip;
155 void ipfw_log_bpf(int);
156 void ipfw_log(struct ip_fw *f, u_int hlen, struct ip_fw_args *args,
157 	struct mbuf *m, struct ifnet *oif, u_short offset, uint32_t tablearg,
158 	struct ip *ip);
159 VNET_DECLARE(u_int64_t, norule_counter);
160 #define	V_norule_counter	VNET(norule_counter)
161 VNET_DECLARE(int, verbose_limit);
162 #define	V_verbose_limit		VNET(verbose_limit)
163 
164 /* In ip_fw_dynamic.c */
165 
166 enum { /* result for matching dynamic rules */
167 	MATCH_REVERSE = 0,
168 	MATCH_FORWARD,
169 	MATCH_NONE,
170 	MATCH_UNKNOWN,
171 };
172 
173 /*
174  * The lock for dynamic rules is only used once outside the file,
175  * and only to release the result of lookup_dyn_rule().
176  * Eventually we may implement it with a callback on the function.
177  */
178 void ipfw_dyn_unlock(void);
179 
180 struct tcphdr;
181 struct mbuf *ipfw_send_pkt(struct mbuf *, struct ipfw_flow_id *,
182     u_int32_t, u_int32_t, int);
183 int ipfw_install_state(struct ip_fw *rule, ipfw_insn_limit *cmd,
184     struct ip_fw_args *args, uint32_t tablearg);
185 ipfw_dyn_rule *ipfw_lookup_dyn_rule(struct ipfw_flow_id *pkt,
186 	int *match_direction, struct tcphdr *tcp);
187 void ipfw_remove_dyn_children(struct ip_fw *rule);
188 void ipfw_get_dynamic(char **bp, const char *ep);
189 
190 void ipfw_dyn_attach(void);	/* uma_zcreate .... */
191 void ipfw_dyn_detach(void);	/* uma_zdestroy ... */
192 void ipfw_dyn_init(void);	/* per-vnet initialization */
193 void ipfw_dyn_uninit(int);	/* per-vnet deinitialization */
194 int ipfw_dyn_len(void);
195 
196 /* common variables */
197 VNET_DECLARE(int, fw_one_pass);
198 #define	V_fw_one_pass		VNET(fw_one_pass)
199 
200 VNET_DECLARE(int, fw_verbose);
201 #define	V_fw_verbose		VNET(fw_verbose)
202 
203 VNET_DECLARE(struct ip_fw_chain, layer3_chain);
204 #define	V_layer3_chain		VNET(layer3_chain)
205 
206 VNET_DECLARE(u_int32_t, set_disable);
207 #define	V_set_disable		VNET(set_disable)
208 
209 VNET_DECLARE(int, autoinc_step);
210 #define V_autoinc_step		VNET(autoinc_step)
211 
212 VNET_DECLARE(unsigned int, fw_tables_max);
213 #define V_fw_tables_max		VNET(fw_tables_max)
214 
215 struct ip_fw_chain {
216 	struct ip_fw	*rules;		/* list of rules */
217 	struct ip_fw	*reap;		/* list of rules to reap */
218 	struct ip_fw	*default_rule;
219 	int		n_rules;	/* number of static rules */
220 	int		static_len;	/* total len of static rules */
221 	struct ip_fw	**map;		/* array of rule ptrs to ease lookup */
222 	LIST_HEAD(nat_list, cfg_nat) nat;       /* list of nat entries */
223 	struct radix_node_head **tables;	/* IPv4 tables */
224 	struct radix_node_head **xtables;	/* extended tables */
225 	uint8_t		*tabletype;	/* Array of table types */
226 #if defined( __linux__ ) || defined( _WIN32 )
227 	spinlock_t rwmtx;
228 	spinlock_t uh_lock;
229 #else
230 	struct rwlock	rwmtx;
231 	struct rwlock	uh_lock;	/* lock for upper half */
232 #endif
233 	uint32_t	id;		/* ruleset id */
234 	uint32_t	gencnt;		/* generation count */
235 };
236 
237 struct sockopt;	/* used by tcp_var.h */
238 
239 /*
240  * The lock is heavily used by ip_fw2.c (the main file) and ip_fw_nat.c
241  * so the variable and the macros must be here.
242  */
243 
244 #define	IPFW_LOCK_INIT(_chain) do {			\
245 	rw_init(&(_chain)->rwmtx, "IPFW static rules");	\
246 	rw_init(&(_chain)->uh_lock, "IPFW UH lock");	\
247 	} while (0)
248 
249 #define	IPFW_LOCK_DESTROY(_chain) do {			\
250 	rw_destroy(&(_chain)->rwmtx);			\
251 	rw_destroy(&(_chain)->uh_lock);			\
252 	} while (0)
253 
254 #define	IPFW_WLOCK_ASSERT(_chain)	rw_assert(&(_chain)->rwmtx, RA_WLOCKED)
255 
256 #define IPFW_RLOCK(p) rw_rlock(&(p)->rwmtx)
257 #define IPFW_RUNLOCK(p) rw_runlock(&(p)->rwmtx)
258 #define IPFW_WLOCK(p) rw_wlock(&(p)->rwmtx)
259 #define IPFW_WUNLOCK(p) rw_wunlock(&(p)->rwmtx)
260 
261 #define IPFW_UH_RLOCK(p) rw_rlock(&(p)->uh_lock)
262 #define IPFW_UH_RUNLOCK(p) rw_runlock(&(p)->uh_lock)
263 #define IPFW_UH_WLOCK(p) rw_wlock(&(p)->uh_lock)
264 #define IPFW_UH_WUNLOCK(p) rw_wunlock(&(p)->uh_lock)
265 
266 /* In ip_fw_sockopt.c */
267 int ipfw_find_rule(struct ip_fw_chain *chain, uint32_t key, uint32_t id);
268 int ipfw_add_rule(struct ip_fw_chain *chain, struct ip_fw *input_rule);
269 int ipfw_ctl(struct sockopt *sopt);
270 int ipfw_chk(struct ip_fw_args *args);
271 void ipfw_reap_rules(struct ip_fw *head);
272 
273 /* In ip_fw_table.c */
274 struct radix_node;
275 int ipfw_lookup_table(struct ip_fw_chain *ch, uint16_t tbl, in_addr_t addr,
276     uint32_t *val);
277 int ipfw_lookup_table_extended(struct ip_fw_chain *ch, uint16_t tbl, void *paddr,
278     uint32_t *val, int type);
279 int ipfw_init_tables(struct ip_fw_chain *ch);
280 void ipfw_destroy_tables(struct ip_fw_chain *ch);
281 int ipfw_flush_table(struct ip_fw_chain *ch, uint16_t tbl);
282 int ipfw_add_table_entry(struct ip_fw_chain *ch, uint16_t tbl, void *paddr,
283     uint8_t plen, uint8_t mlen, uint8_t type, uint32_t value);
284 int ipfw_del_table_entry(struct ip_fw_chain *ch, uint16_t tbl, void *paddr,
285     uint8_t plen, uint8_t mlen, uint8_t type);
286 int ipfw_count_table(struct ip_fw_chain *ch, uint32_t tbl, uint32_t *cnt);
287 int ipfw_dump_table_entry(struct radix_node *rn, void *arg);
288 int ipfw_dump_table(struct ip_fw_chain *ch, ipfw_table *tbl);
289 int ipfw_count_xtable(struct ip_fw_chain *ch, uint32_t tbl, uint32_t *cnt);
290 int ipfw_dump_xtable(struct ip_fw_chain *ch, ipfw_xtable *tbl);
291 int ipfw_resize_tables(struct ip_fw_chain *ch, unsigned int ntables);
292 
293 /* In ip_fw_nat.c -- XXX to be moved to ip_var.h */
294 
295 extern struct cfg_nat *(*lookup_nat_ptr)(struct nat_list *, int);
296 
297 typedef int ipfw_nat_t(struct ip_fw_args *, struct cfg_nat *, struct mbuf *);
298 typedef int ipfw_nat_cfg_t(struct sockopt *);
299 
300 extern ipfw_nat_t *ipfw_nat_ptr;
301 #define IPFW_NAT_LOADED (ipfw_nat_ptr != NULL)
302 
303 extern ipfw_nat_cfg_t *ipfw_nat_cfg_ptr;
304 extern ipfw_nat_cfg_t *ipfw_nat_del_ptr;
305 extern ipfw_nat_cfg_t *ipfw_nat_get_cfg_ptr;
306 extern ipfw_nat_cfg_t *ipfw_nat_get_log_ptr;
307 
308 #endif /* _KERNEL */
309 #endif /* _IPFW2_PRIVATE_H */
310