xref: /freebsd/sbin/pfctl/pfctl_parser.h (revision a7d631f69d3fa993c701d681850d42a750886298)
1 /*	$OpenBSD: pfctl_parser.h,v 1.86 2006/10/31 23:46:25 mcbride Exp $ */
2 
3 /*-
4  * SPDX-License-Identifier: BSD-2-Clause
5  *
6  * Copyright (c) 2001 Daniel Hartmeier
7  * All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  *
13  *    - Redistributions of source code must retain the above copyright
14  *      notice, this list of conditions and the following disclaimer.
15  *    - Redistributions in binary form must reproduce the above
16  *      copyright notice, this list of conditions and the following
17  *      disclaimer in the documentation and/or other materials provided
18  *      with the distribution.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
24  * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
27  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
28  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
30  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #ifndef _PFCTL_PARSER_H_
35 #define _PFCTL_PARSER_H_
36 
37 #include <libpfctl.h>
38 
39 #define PF_OSFP_FILE		"/etc/pf.os"
40 
41 #define PF_OPT_DISABLE		0x00001
42 #define PF_OPT_ENABLE		0x00002
43 #define PF_OPT_VERBOSE		0x00004
44 #define PF_OPT_NOACTION		0x00008
45 #define PF_OPT_QUIET		0x00010
46 #define PF_OPT_CLRRULECTRS	0x00020
47 #define PF_OPT_USEDNS		0x00040
48 #define PF_OPT_VERBOSE2		0x00080
49 #define PF_OPT_DUMMYACTION	0x00100
50 #define PF_OPT_DEBUG		0x00200
51 #define PF_OPT_SHOWALL		0x00400
52 #define PF_OPT_OPTIMIZE		0x00800
53 #define PF_OPT_NUMERIC		0x01000
54 #define PF_OPT_MERGE		0x02000
55 #define PF_OPT_RECURSE		0x04000
56 #define PF_OPT_KILLMATCH	0x08000
57 #define PF_OPT_NODNS		0x10000
58 
59 #define PF_NAT_PROXY_PORT_LOW	50001
60 #define PF_NAT_PROXY_PORT_HIGH	65535
61 
62 #define PF_OPTIMIZE_BASIC	0x0001
63 #define PF_OPTIMIZE_PROFILE	0x0002
64 
65 #define FCNT_NAMES { \
66 	"searches", \
67 	"inserts", \
68 	"removals", \
69 	NULL \
70 }
71 
72 struct pfr_buffer;	/* forward definition */
73 
74 
75 struct pfctl {
76 	int dev;
77 	struct pfctl_handle *h;
78 	int opts;
79 	int optimize;
80 	int loadopt;
81 	int asd;			/* anchor stack depth */
82 	int bn;				/* brace number */
83 	int tdirty;			/* kernel dirty */
84 #define PFCTL_ANCHOR_STACK_DEPTH 64
85 	struct pfctl_anchor *astack[PFCTL_ANCHOR_STACK_DEPTH];
86 	struct pfioc_pooladdr paddr;
87 	struct pfioc_altq *paltq;
88 	struct pfioc_queue *pqueue;
89 	struct pfr_buffer *trans;
90 	struct pfctl_anchor *anchor, *alast;
91 	int eth_nr;
92 	struct pfctl_eth_anchor *eanchor, *ealast;
93 	struct pfctl_eth_anchor *eastack[PFCTL_ANCHOR_STACK_DEPTH];
94 	u_int32_t eth_ticket;
95 	const char *ruleset;
96 
97 	/* 'set foo' options */
98 	u_int32_t	 timeout[PFTM_MAX];
99 	u_int32_t	 limit[PF_LIMIT_MAX];
100 	u_int32_t	 debug;
101 	u_int32_t	 hostid;
102 	u_int32_t	 reassemble;
103 	char		*ifname;
104 	bool		 keep_counters;
105 	u_int8_t	 syncookies;
106 	u_int8_t	 syncookieswat[2];	/* lowat, highwat, in % */
107 	u_int8_t	 syncookieswat_set;
108 
109 	u_int8_t	 timeout_set[PFTM_MAX];
110 	u_int8_t	 limit_set[PF_LIMIT_MAX];
111 	u_int8_t	 debug_set;
112 	u_int8_t	 hostid_set;
113 	u_int8_t	 ifname_set;
114 	u_int8_t	 reass_set;
115 };
116 
117 struct node_if {
118 	char			 ifname[IFNAMSIZ];
119 	u_int8_t		 not;
120 	u_int8_t		 dynamic; /* antispoof */
121 	u_int			 ifa_flags;
122 	struct node_if		*next;
123 	struct node_if		*tail;
124 };
125 
126 struct node_host {
127 	struct pf_addr_wrap	 addr;
128 	struct pf_addr		 bcast;
129 	struct pf_addr		 peer;
130 	sa_family_t		 af;
131 	u_int8_t		 not;
132 	u_int32_t		 ifindex;	/* link-local IPv6 addrs */
133 	char			*ifname;
134 	u_int			 ifa_flags;
135 	struct node_host	*next;
136 	struct node_host	*tail;
137 };
138 
139 void	freehostlist(struct node_host *);
140 
141 struct node_mac {
142 	u_int8_t	 mac[ETHER_ADDR_LEN];
143 	u_int8_t	 mask[ETHER_ADDR_LEN];
144 	bool		 neg;
145 	bool		 isset;
146 	struct node_mac	*next;
147 	struct node_mac	*tail;
148 };
149 
150 struct node_os {
151 	char			*os;
152 	pf_osfp_t		 fingerprint;
153 	struct node_os		*next;
154 	struct node_os		*tail;
155 };
156 
157 struct node_queue_bw {
158 	u_int64_t	bw_absolute;
159 	u_int16_t	bw_percent;
160 };
161 
162 struct node_hfsc_sc {
163 	struct node_queue_bw	m1;	/* slope of 1st segment; bps */
164 	u_int			d;	/* x-projection of m1; msec */
165 	struct node_queue_bw	m2;	/* slope of 2nd segment; bps */
166 	u_int8_t		used;
167 };
168 
169 struct node_hfsc_opts {
170 	struct node_hfsc_sc	realtime;
171 	struct node_hfsc_sc	linkshare;
172 	struct node_hfsc_sc	upperlimit;
173 	int			flags;
174 };
175 
176 struct node_fairq_sc {
177 	struct node_queue_bw	m1;	/* slope of 1st segment; bps */
178 	u_int			d;	/* x-projection of m1; msec */
179 	struct node_queue_bw	m2;	/* slope of 2nd segment; bps */
180 	u_int8_t		used;
181 };
182 
183 struct node_fairq_opts {
184 	struct node_fairq_sc	linkshare;
185 	struct node_queue_bw	hogs_bw;
186 	u_int			nbuckets;
187 	int			flags;
188 };
189 
190 struct node_queue_opt {
191 	int			 qtype;
192 	union {
193 		struct cbq_opts		cbq_opts;
194 		struct codel_opts	codel_opts;
195 		struct priq_opts	priq_opts;
196 		struct node_hfsc_opts	hfsc_opts;
197 		struct node_fairq_opts	fairq_opts;
198 	}			 data;
199 };
200 
201 #define QPRI_BITSET_SIZE	256
202 __BITSET_DEFINE(qpri_bitset, QPRI_BITSET_SIZE);
203 LIST_HEAD(gen_sc, segment);
204 
205 struct pfctl_altq {
206 	struct pf_altq	pa;
207 	struct {
208 		STAILQ_ENTRY(pfctl_altq)	link;
209 		u_int64_t			bwsum;
210 		struct qpri_bitset		qpris;
211 		int				children;
212 		int				root_classes;
213 		int				default_classes;
214 		struct gen_sc			lssc;
215 		struct gen_sc			rtsc;
216 	} meta;
217 };
218 
219 struct pfctl_watermarks {
220 	uint32_t	hi;
221 	uint32_t	lo;
222 };
223 
224 #ifdef __FreeBSD__
225 /*
226  * XXX
227  * Absolutely this is not correct location to define this.
228  * Should we use an another sperate header file?
229  */
230 #define	SIMPLEQ_HEAD			STAILQ_HEAD
231 #define	SIMPLEQ_HEAD_INITIALIZER	STAILQ_HEAD_INITIALIZER
232 #define	SIMPLEQ_ENTRY			STAILQ_ENTRY
233 #define	SIMPLEQ_FIRST			STAILQ_FIRST
234 #define	SIMPLEQ_END(head)		NULL
235 #define	SIMPLEQ_EMPTY			STAILQ_EMPTY
236 #define	SIMPLEQ_NEXT			STAILQ_NEXT
237 /*#define	SIMPLEQ_FOREACH			STAILQ_FOREACH*/
238 #define	SIMPLEQ_FOREACH(var, head, field)		\
239     for((var) = SIMPLEQ_FIRST(head);			\
240 	(var) != SIMPLEQ_END(head);			\
241 	(var) = SIMPLEQ_NEXT(var, field))
242 #define	SIMPLEQ_INIT			STAILQ_INIT
243 #define	SIMPLEQ_INSERT_HEAD		STAILQ_INSERT_HEAD
244 #define	SIMPLEQ_INSERT_TAIL		STAILQ_INSERT_TAIL
245 #define	SIMPLEQ_INSERT_AFTER		STAILQ_INSERT_AFTER
246 #define	SIMPLEQ_REMOVE_HEAD		STAILQ_REMOVE_HEAD
247 #endif
248 SIMPLEQ_HEAD(node_tinithead, node_tinit);
249 struct node_tinit {	/* table initializer */
250 	SIMPLEQ_ENTRY(node_tinit)	 entries;
251 	struct node_host		*host;
252 	char				*file;
253 };
254 
255 
256 /* optimizer created tables */
257 struct pf_opt_tbl {
258 	char			 pt_name[PF_TABLE_NAME_SIZE];
259 	int			 pt_rulecount;
260 	int			 pt_generated;
261 	uint32_t		 pt_refcnt;
262 	struct node_tinithead	 pt_nodes;
263 	struct pfr_buffer	*pt_buf;
264 };
265 #define PF_OPT_TABLE_PREFIX	"__automatic_"
266 
267 /* optimizer pf_rule container */
268 struct pf_opt_rule {
269 	struct pfctl_rule	 por_rule;
270 	struct pf_opt_tbl	*por_src_tbl;
271 	struct pf_opt_tbl	*por_dst_tbl;
272 	u_int64_t		 por_profile_count;
273 	TAILQ_ENTRY(pf_opt_rule) por_entry;
274 	TAILQ_ENTRY(pf_opt_rule) por_skip_entry[PF_SKIP_COUNT];
275 };
276 
277 TAILQ_HEAD(pf_opt_queue, pf_opt_rule);
278 
279 int	pfctl_rules(int, char *, int, int, char *, struct pfr_buffer *);
280 int	pfctl_optimize_ruleset(struct pfctl *, struct pfctl_ruleset *);
281 
282 void	pfctl_init_rule(struct pfctl_rule *r);
283 int	pfctl_append_rule(struct pfctl *, struct pfctl_rule *, const char *);
284 int	pfctl_append_eth_rule(struct pfctl *, struct pfctl_eth_rule *,
285 	    const char *);
286 int	pfctl_add_altq(struct pfctl *, struct pf_altq *);
287 int	pfctl_add_pool(struct pfctl *, struct pfctl_pool *, sa_family_t, int);
288 void	pfctl_move_pool(struct pfctl_pool *, struct pfctl_pool *);
289 void	pfctl_clear_pool(struct pfctl_pool *);
290 
291 int	pfctl_apply_timeout(struct pfctl *, const char *, int, int);
292 int	pfctl_set_reassembly(struct pfctl *, int, int);
293 int	pfctl_set_optimization(struct pfctl *, const char *);
294 int	pfctl_apply_limit(struct pfctl *, const char *, unsigned int);
295 int	pfctl_set_logif(struct pfctl *, char *);
296 void	pfctl_set_hostid(struct pfctl *, u_int32_t);
297 int	pfctl_do_set_debug(struct pfctl *, char *);
298 int	pfctl_set_interface_flags(struct pfctl *, char *, int, int);
299 int	pfctl_cfg_syncookies(struct pfctl *, uint8_t, struct pfctl_watermarks *);
300 
301 int	parse_config(char *, struct pfctl *);
302 int	parse_flags(char *);
303 int	pfctl_load_anchors(int, struct pfctl *, struct pfr_buffer *);
304 
305 void	print_pool(struct pfctl_pool *, u_int16_t, u_int16_t, sa_family_t, int);
306 void	print_src_node(struct pfctl_src_node *, int);
307 void	print_eth_rule(struct pfctl_eth_rule *, const char *, int);
308 void	print_rule(struct pfctl_rule *, const char *, int, int);
309 void	print_tabledef(const char *, int, int, struct node_tinithead *);
310 void	print_status(struct pfctl_status *, struct pfctl_syncookies *, int);
311 void	print_running(struct pfctl_status *);
312 
313 int	eval_pfaltq(struct pfctl *, struct pf_altq *, struct node_queue_bw *,
314 	    struct node_queue_opt *);
315 int	eval_pfqueue(struct pfctl *, struct pf_altq *, struct node_queue_bw *,
316 	    struct node_queue_opt *);
317 
318 void	 print_altq(const struct pf_altq *, unsigned, struct node_queue_bw *,
319 	    struct node_queue_opt *);
320 void	 print_queue(const struct pf_altq *, unsigned, struct node_queue_bw *,
321 	    int, struct node_queue_opt *);
322 
323 int	pfctl_define_table(char *, int, int, const char *, struct pfr_buffer *,
324 	    u_int32_t);
325 
326 void		 pfctl_clear_fingerprints(int, int);
327 int		 pfctl_file_fingerprints(int, int, const char *);
328 pf_osfp_t	 pfctl_get_fingerprint(const char *);
329 int		 pfctl_load_fingerprints(int, int);
330 char		*pfctl_lookup_fingerprint(pf_osfp_t, char *, size_t);
331 void		 pfctl_show_fingerprints(int);
332 
333 
334 struct icmptypeent {
335 	const char *name;
336 	u_int8_t type;
337 };
338 
339 struct icmpcodeent {
340 	const char *name;
341 	u_int8_t type;
342 	u_int8_t code;
343 };
344 
345 const struct icmptypeent *geticmptypebynumber(u_int8_t, sa_family_t);
346 const struct icmptypeent *geticmptypebyname(char *, sa_family_t);
347 const struct icmpcodeent *geticmpcodebynumber(u_int8_t, u_int8_t, sa_family_t);
348 const struct icmpcodeent *geticmpcodebyname(u_long, char *, sa_family_t);
349 
350 struct pf_timeout {
351 	const char	*name;
352 	int		 timeout;
353 };
354 
355 #define PFCTL_FLAG_FILTER	0x02
356 #define PFCTL_FLAG_NAT		0x04
357 #define PFCTL_FLAG_OPTION	0x08
358 #define PFCTL_FLAG_ALTQ		0x10
359 #define PFCTL_FLAG_TABLE	0x20
360 #define PFCTL_FLAG_ETH		0x40
361 
362 extern const struct pf_timeout pf_timeouts[];
363 
364 void			 set_ipmask(struct node_host *, u_int8_t);
365 int			 check_netmask(struct node_host *, sa_family_t);
366 int			 unmask(struct pf_addr *, sa_family_t);
367 struct node_host	*gen_dynnode(struct node_host *, sa_family_t);
368 void			 ifa_load(void);
369 unsigned int		 ifa_nametoindex(const char *);
370 char			*ifa_indextoname(unsigned int, char *);
371 int			 get_query_socket(void);
372 struct node_host	*ifa_exists(char *);
373 struct node_host	*ifa_grouplookup(char *ifa_name, int flags);
374 struct node_host	*ifa_lookup(char *, int);
375 struct node_host	*host(const char *, int);
376 
377 int			 append_addr(struct pfr_buffer *, char *, int, int);
378 int			 append_addr_host(struct pfr_buffer *,
379 			    struct node_host *, int, int);
380 
381 #endif /* _PFCTL_PARSER_H_ */
382