xref: /linux/include/linux/netfilter/x_tables.h (revision 4413e16d9d21673bb5048a2e542f1aaa00015c2e)
1 #ifndef _X_TABLES_H
2 #define _X_TABLES_H
3 #include <linux/kernel.h>
4 #include <linux/types.h>
5 
6 #define XT_FUNCTION_MAXNAMELEN 30
7 #define XT_EXTENSION_MAXNAMELEN 29
8 #define XT_TABLE_MAXNAMELEN 32
9 
10 struct xt_entry_match {
11 	union {
12 		struct {
13 			__u16 match_size;
14 
15 			/* Used by userspace */
16 			char name[XT_EXTENSION_MAXNAMELEN];
17 			__u8 revision;
18 		} user;
19 		struct {
20 			__u16 match_size;
21 
22 			/* Used inside the kernel */
23 			struct xt_match *match;
24 		} kernel;
25 
26 		/* Total length */
27 		__u16 match_size;
28 	} u;
29 
30 	unsigned char data[0];
31 };
32 
33 struct xt_entry_target {
34 	union {
35 		struct {
36 			__u16 target_size;
37 
38 			/* Used by userspace */
39 			char name[XT_EXTENSION_MAXNAMELEN];
40 			__u8 revision;
41 		} user;
42 		struct {
43 			__u16 target_size;
44 
45 			/* Used inside the kernel */
46 			struct xt_target *target;
47 		} kernel;
48 
49 		/* Total length */
50 		__u16 target_size;
51 	} u;
52 
53 	unsigned char data[0];
54 };
55 
56 #define XT_TARGET_INIT(__name, __size)					       \
57 {									       \
58 	.target.u.user = {						       \
59 		.target_size	= XT_ALIGN(__size),			       \
60 		.name		= __name,				       \
61 	},								       \
62 }
63 
64 struct xt_standard_target {
65 	struct xt_entry_target target;
66 	int verdict;
67 };
68 
69 struct xt_error_target {
70 	struct xt_entry_target target;
71 	char errorname[XT_FUNCTION_MAXNAMELEN];
72 };
73 
74 /* The argument to IPT_SO_GET_REVISION_*.  Returns highest revision
75  * kernel supports, if >= revision. */
76 struct xt_get_revision {
77 	char name[XT_EXTENSION_MAXNAMELEN];
78 	__u8 revision;
79 };
80 
81 /* CONTINUE verdict for targets */
82 #define XT_CONTINUE 0xFFFFFFFF
83 
84 /* For standard target */
85 #define XT_RETURN (-NF_REPEAT - 1)
86 
87 /* this is a dummy structure to find out the alignment requirement for a struct
88  * containing all the fundamental data types that are used in ipt_entry,
89  * ip6t_entry and arpt_entry.  This sucks, and it is a hack.  It will be my
90  * personal pleasure to remove it -HW
91  */
92 struct _xt_align {
93 	__u8 u8;
94 	__u16 u16;
95 	__u32 u32;
96 	__u64 u64;
97 };
98 
99 #define XT_ALIGN(s) __ALIGN_KERNEL((s), __alignof__(struct _xt_align))
100 
101 /* Standard return verdict, or do jump. */
102 #define XT_STANDARD_TARGET ""
103 /* Error verdict. */
104 #define XT_ERROR_TARGET "ERROR"
105 
106 #define SET_COUNTER(c,b,p) do { (c).bcnt = (b); (c).pcnt = (p); } while(0)
107 #define ADD_COUNTER(c,b,p) do { (c).bcnt += (b); (c).pcnt += (p); } while(0)
108 
109 struct xt_counters {
110 	__u64 pcnt, bcnt;			/* Packet and byte counters */
111 };
112 
113 /* The argument to IPT_SO_ADD_COUNTERS. */
114 struct xt_counters_info {
115 	/* Which table. */
116 	char name[XT_TABLE_MAXNAMELEN];
117 
118 	unsigned int num_counters;
119 
120 	/* The counters (actually `number' of these). */
121 	struct xt_counters counters[0];
122 };
123 
124 #define XT_INV_PROTO		0x40	/* Invert the sense of PROTO. */
125 
126 #ifndef __KERNEL__
127 /* fn returns 0 to continue iteration */
128 #define XT_MATCH_ITERATE(type, e, fn, args...)			\
129 ({								\
130 	unsigned int __i;					\
131 	int __ret = 0;						\
132 	struct xt_entry_match *__m;				\
133 								\
134 	for (__i = sizeof(type);				\
135 	     __i < (e)->target_offset;				\
136 	     __i += __m->u.match_size) {			\
137 		__m = (void *)e + __i;				\
138 								\
139 		__ret = fn(__m , ## args);			\
140 		if (__ret != 0)					\
141 			break;					\
142 	}							\
143 	__ret;							\
144 })
145 
146 /* fn returns 0 to continue iteration */
147 #define XT_ENTRY_ITERATE_CONTINUE(type, entries, size, n, fn, args...) \
148 ({								\
149 	unsigned int __i, __n;					\
150 	int __ret = 0;						\
151 	type *__entry;						\
152 								\
153 	for (__i = 0, __n = 0; __i < (size);			\
154 	     __i += __entry->next_offset, __n++) { 		\
155 		__entry = (void *)(entries) + __i;		\
156 		if (__n < n)					\
157 			continue;				\
158 								\
159 		__ret = fn(__entry , ## args);			\
160 		if (__ret != 0)					\
161 			break;					\
162 	}							\
163 	__ret;							\
164 })
165 
166 /* fn returns 0 to continue iteration */
167 #define XT_ENTRY_ITERATE(type, entries, size, fn, args...) \
168 	XT_ENTRY_ITERATE_CONTINUE(type, entries, size, 0, fn, args)
169 
170 #endif /* !__KERNEL__ */
171 
172 /* pos is normally a struct ipt_entry/ip6t_entry/etc. */
173 #define xt_entry_foreach(pos, ehead, esize) \
174 	for ((pos) = (typeof(pos))(ehead); \
175 	     (pos) < (typeof(pos))((char *)(ehead) + (esize)); \
176 	     (pos) = (typeof(pos))((char *)(pos) + (pos)->next_offset))
177 
178 /* can only be xt_entry_match, so no use of typeof here */
179 #define xt_ematch_foreach(pos, entry) \
180 	for ((pos) = (struct xt_entry_match *)entry->elems; \
181 	     (pos) < (struct xt_entry_match *)((char *)(entry) + \
182 	             (entry)->target_offset); \
183 	     (pos) = (struct xt_entry_match *)((char *)(pos) + \
184 	             (pos)->u.match_size))
185 
186 #ifdef __KERNEL__
187 
188 #include <linux/netdevice.h>
189 
190 /**
191  * struct xt_action_param - parameters for matches/targets
192  *
193  * @match:	the match extension
194  * @target:	the target extension
195  * @matchinfo:	per-match data
196  * @targetinfo:	per-target data
197  * @in:		input netdevice
198  * @out:	output netdevice
199  * @fragoff:	packet is a fragment, this is the data offset
200  * @thoff:	position of transport header relative to skb->data
201  * @hook:	hook number given packet came from
202  * @family:	Actual NFPROTO_* through which the function is invoked
203  * 		(helpful when match->family == NFPROTO_UNSPEC)
204  *
205  * Fields written to by extensions:
206  *
207  * @hotdrop:	drop packet if we had inspection problems
208  * Network namespace obtainable using dev_net(in/out)
209  */
210 struct xt_action_param {
211 	union {
212 		const struct xt_match *match;
213 		const struct xt_target *target;
214 	};
215 	union {
216 		const void *matchinfo, *targinfo;
217 	};
218 	const struct net_device *in, *out;
219 	int fragoff;
220 	unsigned int thoff;
221 	unsigned int hooknum;
222 	u_int8_t family;
223 	bool hotdrop;
224 };
225 
226 /**
227  * struct xt_mtchk_param - parameters for match extensions'
228  * checkentry functions
229  *
230  * @net:	network namespace through which the check was invoked
231  * @table:	table the rule is tried to be inserted into
232  * @entryinfo:	the family-specific rule data
233  * 		(struct ipt_ip, ip6t_ip, arpt_arp or (note) ebt_entry)
234  * @match:	struct xt_match through which this function was invoked
235  * @matchinfo:	per-match data
236  * @hook_mask:	via which hooks the new rule is reachable
237  * Other fields as above.
238  */
239 struct xt_mtchk_param {
240 	struct net *net;
241 	const char *table;
242 	const void *entryinfo;
243 	const struct xt_match *match;
244 	void *matchinfo;
245 	unsigned int hook_mask;
246 	u_int8_t family;
247 };
248 
249 /**
250  * struct xt_mdtor_param - match destructor parameters
251  * Fields as above.
252  */
253 struct xt_mtdtor_param {
254 	struct net *net;
255 	const struct xt_match *match;
256 	void *matchinfo;
257 	u_int8_t family;
258 };
259 
260 /**
261  * struct xt_tgchk_param - parameters for target extensions'
262  * checkentry functions
263  *
264  * @entryinfo:	the family-specific rule data
265  * 		(struct ipt_entry, ip6t_entry, arpt_entry, ebt_entry)
266  *
267  * Other fields see above.
268  */
269 struct xt_tgchk_param {
270 	struct net *net;
271 	const char *table;
272 	const void *entryinfo;
273 	const struct xt_target *target;
274 	void *targinfo;
275 	unsigned int hook_mask;
276 	u_int8_t family;
277 };
278 
279 /* Target destructor parameters */
280 struct xt_tgdtor_param {
281 	struct net *net;
282 	const struct xt_target *target;
283 	void *targinfo;
284 	u_int8_t family;
285 };
286 
287 struct xt_match {
288 	struct list_head list;
289 
290 	const char name[XT_EXTENSION_MAXNAMELEN];
291 	u_int8_t revision;
292 
293 	/* Return true or false: return FALSE and set *hotdrop = 1 to
294            force immediate packet drop. */
295 	/* Arguments changed since 2.6.9, as this must now handle
296 	   non-linear skb, using skb_header_pointer and
297 	   skb_ip_make_writable. */
298 	bool (*match)(const struct sk_buff *skb,
299 		      struct xt_action_param *);
300 
301 	/* Called when user tries to insert an entry of this type. */
302 	int (*checkentry)(const struct xt_mtchk_param *);
303 
304 	/* Called when entry of this type deleted. */
305 	void (*destroy)(const struct xt_mtdtor_param *);
306 #ifdef CONFIG_COMPAT
307 	/* Called when userspace align differs from kernel space one */
308 	void (*compat_from_user)(void *dst, const void *src);
309 	int (*compat_to_user)(void __user *dst, const void *src);
310 #endif
311 	/* Set this to THIS_MODULE if you are a module, otherwise NULL */
312 	struct module *me;
313 
314 	const char *table;
315 	unsigned int matchsize;
316 #ifdef CONFIG_COMPAT
317 	unsigned int compatsize;
318 #endif
319 	unsigned int hooks;
320 	unsigned short proto;
321 
322 	unsigned short family;
323 };
324 
325 /* Registration hooks for targets. */
326 struct xt_target {
327 	struct list_head list;
328 
329 	const char name[XT_EXTENSION_MAXNAMELEN];
330 	u_int8_t revision;
331 
332 	/* Returns verdict. Argument order changed since 2.6.9, as this
333 	   must now handle non-linear skbs, using skb_copy_bits and
334 	   skb_ip_make_writable. */
335 	unsigned int (*target)(struct sk_buff *skb,
336 			       const struct xt_action_param *);
337 
338 	/* Called when user tries to insert an entry of this type:
339            hook_mask is a bitmask of hooks from which it can be
340            called. */
341 	/* Should return 0 on success or an error code otherwise (-Exxxx). */
342 	int (*checkentry)(const struct xt_tgchk_param *);
343 
344 	/* Called when entry of this type deleted. */
345 	void (*destroy)(const struct xt_tgdtor_param *);
346 #ifdef CONFIG_COMPAT
347 	/* Called when userspace align differs from kernel space one */
348 	void (*compat_from_user)(void *dst, const void *src);
349 	int (*compat_to_user)(void __user *dst, const void *src);
350 #endif
351 	/* Set this to THIS_MODULE if you are a module, otherwise NULL */
352 	struct module *me;
353 
354 	const char *table;
355 	unsigned int targetsize;
356 #ifdef CONFIG_COMPAT
357 	unsigned int compatsize;
358 #endif
359 	unsigned int hooks;
360 	unsigned short proto;
361 
362 	unsigned short family;
363 };
364 
365 /* Furniture shopping... */
366 struct xt_table {
367 	struct list_head list;
368 
369 	/* What hooks you will enter on */
370 	unsigned int valid_hooks;
371 
372 	/* Man behind the curtain... */
373 	struct xt_table_info *private;
374 
375 	/* Set this to THIS_MODULE if you are a module, otherwise NULL */
376 	struct module *me;
377 
378 	u_int8_t af;		/* address/protocol family */
379 	int priority;		/* hook order */
380 
381 	/* A unique name... */
382 	const char name[XT_TABLE_MAXNAMELEN];
383 };
384 
385 #include <linux/netfilter_ipv4.h>
386 
387 /* The table itself */
388 struct xt_table_info {
389 	/* Size per table */
390 	unsigned int size;
391 	/* Number of entries: FIXME. --RR */
392 	unsigned int number;
393 	/* Initial number of entries. Needed for module usage count */
394 	unsigned int initial_entries;
395 
396 	/* Entry points and underflows */
397 	unsigned int hook_entry[NF_INET_NUMHOOKS];
398 	unsigned int underflow[NF_INET_NUMHOOKS];
399 
400 	/*
401 	 * Number of user chains. Since tables cannot have loops, at most
402 	 * @stacksize jumps (number of user chains) can possibly be made.
403 	 */
404 	unsigned int stacksize;
405 	unsigned int __percpu *stackptr;
406 	void ***jumpstack;
407 	/* ipt_entry tables: one per CPU */
408 	/* Note : this field MUST be the last one, see XT_TABLE_INFO_SZ */
409 	void *entries[1];
410 };
411 
412 #define XT_TABLE_INFO_SZ (offsetof(struct xt_table_info, entries) \
413 			  + nr_cpu_ids * sizeof(char *))
414 extern int xt_register_target(struct xt_target *target);
415 extern void xt_unregister_target(struct xt_target *target);
416 extern int xt_register_targets(struct xt_target *target, unsigned int n);
417 extern void xt_unregister_targets(struct xt_target *target, unsigned int n);
418 
419 extern int xt_register_match(struct xt_match *target);
420 extern void xt_unregister_match(struct xt_match *target);
421 extern int xt_register_matches(struct xt_match *match, unsigned int n);
422 extern void xt_unregister_matches(struct xt_match *match, unsigned int n);
423 
424 extern int xt_check_match(struct xt_mtchk_param *,
425 			  unsigned int size, u_int8_t proto, bool inv_proto);
426 extern int xt_check_target(struct xt_tgchk_param *,
427 			   unsigned int size, u_int8_t proto, bool inv_proto);
428 
429 extern struct xt_table *xt_register_table(struct net *net,
430 					  const struct xt_table *table,
431 					  struct xt_table_info *bootstrap,
432 					  struct xt_table_info *newinfo);
433 extern void *xt_unregister_table(struct xt_table *table);
434 
435 extern struct xt_table_info *xt_replace_table(struct xt_table *table,
436 					      unsigned int num_counters,
437 					      struct xt_table_info *newinfo,
438 					      int *error);
439 
440 extern struct xt_match *xt_find_match(u8 af, const char *name, u8 revision);
441 extern struct xt_target *xt_find_target(u8 af, const char *name, u8 revision);
442 extern struct xt_match *xt_request_find_match(u8 af, const char *name,
443 					      u8 revision);
444 extern struct xt_target *xt_request_find_target(u8 af, const char *name,
445 						u8 revision);
446 extern int xt_find_revision(u8 af, const char *name, u8 revision,
447 			    int target, int *err);
448 
449 extern struct xt_table *xt_find_table_lock(struct net *net, u_int8_t af,
450 					   const char *name);
451 extern void xt_table_unlock(struct xt_table *t);
452 
453 extern int xt_proto_init(struct net *net, u_int8_t af);
454 extern void xt_proto_fini(struct net *net, u_int8_t af);
455 
456 extern struct xt_table_info *xt_alloc_table_info(unsigned int size);
457 extern void xt_free_table_info(struct xt_table_info *info);
458 
459 /**
460  * xt_recseq - recursive seqcount for netfilter use
461  *
462  * Packet processing changes the seqcount only if no recursion happened
463  * get_counters() can use read_seqcount_begin()/read_seqcount_retry(),
464  * because we use the normal seqcount convention :
465  * Low order bit set to 1 if a writer is active.
466  */
467 DECLARE_PER_CPU(seqcount_t, xt_recseq);
468 
469 /**
470  * xt_write_recseq_begin - start of a write section
471  *
472  * Begin packet processing : all readers must wait the end
473  * 1) Must be called with preemption disabled
474  * 2) softirqs must be disabled too (or we should use this_cpu_add())
475  * Returns :
476  *  1 if no recursion on this cpu
477  *  0 if recursion detected
478  */
479 static inline unsigned int xt_write_recseq_begin(void)
480 {
481 	unsigned int addend;
482 
483 	/*
484 	 * Low order bit of sequence is set if we already
485 	 * called xt_write_recseq_begin().
486 	 */
487 	addend = (__this_cpu_read(xt_recseq.sequence) + 1) & 1;
488 
489 	/*
490 	 * This is kind of a write_seqcount_begin(), but addend is 0 or 1
491 	 * We dont check addend value to avoid a test and conditional jump,
492 	 * since addend is most likely 1
493 	 */
494 	__this_cpu_add(xt_recseq.sequence, addend);
495 	smp_wmb();
496 
497 	return addend;
498 }
499 
500 /**
501  * xt_write_recseq_end - end of a write section
502  * @addend: return value from previous xt_write_recseq_begin()
503  *
504  * End packet processing : all readers can proceed
505  * 1) Must be called with preemption disabled
506  * 2) softirqs must be disabled too (or we should use this_cpu_add())
507  */
508 static inline void xt_write_recseq_end(unsigned int addend)
509 {
510 	/* this is kind of a write_seqcount_end(), but addend is 0 or 1 */
511 	smp_wmb();
512 	__this_cpu_add(xt_recseq.sequence, addend);
513 }
514 
515 /*
516  * This helper is performance critical and must be inlined
517  */
518 static inline unsigned long ifname_compare_aligned(const char *_a,
519 						   const char *_b,
520 						   const char *_mask)
521 {
522 	const unsigned long *a = (const unsigned long *)_a;
523 	const unsigned long *b = (const unsigned long *)_b;
524 	const unsigned long *mask = (const unsigned long *)_mask;
525 	unsigned long ret;
526 
527 	ret = (a[0] ^ b[0]) & mask[0];
528 	if (IFNAMSIZ > sizeof(unsigned long))
529 		ret |= (a[1] ^ b[1]) & mask[1];
530 	if (IFNAMSIZ > 2 * sizeof(unsigned long))
531 		ret |= (a[2] ^ b[2]) & mask[2];
532 	if (IFNAMSIZ > 3 * sizeof(unsigned long))
533 		ret |= (a[3] ^ b[3]) & mask[3];
534 	BUILD_BUG_ON(IFNAMSIZ > 4 * sizeof(unsigned long));
535 	return ret;
536 }
537 
538 extern struct nf_hook_ops *xt_hook_link(const struct xt_table *, nf_hookfn *);
539 extern void xt_hook_unlink(const struct xt_table *, struct nf_hook_ops *);
540 
541 #ifdef CONFIG_COMPAT
542 #include <net/compat.h>
543 
544 struct compat_xt_entry_match {
545 	union {
546 		struct {
547 			u_int16_t match_size;
548 			char name[XT_FUNCTION_MAXNAMELEN - 1];
549 			u_int8_t revision;
550 		} user;
551 		struct {
552 			u_int16_t match_size;
553 			compat_uptr_t match;
554 		} kernel;
555 		u_int16_t match_size;
556 	} u;
557 	unsigned char data[0];
558 };
559 
560 struct compat_xt_entry_target {
561 	union {
562 		struct {
563 			u_int16_t target_size;
564 			char name[XT_FUNCTION_MAXNAMELEN - 1];
565 			u_int8_t revision;
566 		} user;
567 		struct {
568 			u_int16_t target_size;
569 			compat_uptr_t target;
570 		} kernel;
571 		u_int16_t target_size;
572 	} u;
573 	unsigned char data[0];
574 };
575 
576 /* FIXME: this works only on 32 bit tasks
577  * need to change whole approach in order to calculate align as function of
578  * current task alignment */
579 
580 struct compat_xt_counters {
581 	compat_u64 pcnt, bcnt;			/* Packet and byte counters */
582 };
583 
584 struct compat_xt_counters_info {
585 	char name[XT_TABLE_MAXNAMELEN];
586 	compat_uint_t num_counters;
587 	struct compat_xt_counters counters[0];
588 };
589 
590 struct _compat_xt_align {
591 	__u8 u8;
592 	__u16 u16;
593 	__u32 u32;
594 	compat_u64 u64;
595 };
596 
597 #define COMPAT_XT_ALIGN(s) __ALIGN_KERNEL((s), __alignof__(struct _compat_xt_align))
598 
599 extern void xt_compat_lock(u_int8_t af);
600 extern void xt_compat_unlock(u_int8_t af);
601 
602 extern int xt_compat_add_offset(u_int8_t af, unsigned int offset, int delta);
603 extern void xt_compat_flush_offsets(u_int8_t af);
604 extern void xt_compat_init_offsets(u_int8_t af, unsigned int number);
605 extern int xt_compat_calc_jump(u_int8_t af, unsigned int offset);
606 
607 extern int xt_compat_match_offset(const struct xt_match *match);
608 extern int xt_compat_match_from_user(struct xt_entry_match *m,
609 				     void **dstptr, unsigned int *size);
610 extern int xt_compat_match_to_user(const struct xt_entry_match *m,
611 				   void __user **dstptr, unsigned int *size);
612 
613 extern int xt_compat_target_offset(const struct xt_target *target);
614 extern void xt_compat_target_from_user(struct xt_entry_target *t,
615 				       void **dstptr, unsigned int *size);
616 extern int xt_compat_target_to_user(const struct xt_entry_target *t,
617 				    void __user **dstptr, unsigned int *size);
618 
619 #endif /* CONFIG_COMPAT */
620 #endif /* __KERNEL__ */
621 
622 #endif /* _X_TABLES_H */
623