xref: /netbsd-src/lib/libnpf/npf.h (revision 2e2322c9c07009df921d11b1268f8506affbb8ba)
1 /*	$NetBSD: npf.h,v 1.30 2016/12/10 21:04:12 christos Exp $	*/
2 
3 /*-
4  * Copyright (c) 2011-2014 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This material is based upon work partially supported by The
8  * NetBSD Foundation under a contract with Mindaugas Rasiukevicius.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 #ifndef _NPF_LIB_H_
33 #define _NPF_LIB_H_
34 
35 #include <sys/types.h>
36 #include <net/npf.h>
37 
38 __BEGIN_DECLS
39 
40 struct nl_config;
41 struct nl_rule;
42 struct nl_rproc;
43 struct nl_table;
44 struct nl_ext;
45 
46 typedef struct nl_config	nl_config_t;
47 typedef struct nl_rule		nl_rule_t;
48 typedef struct nl_rproc		nl_rproc_t;
49 typedef struct nl_table		nl_table_t;
50 
51 typedef struct nl_rule		nl_nat_t;
52 
53 typedef struct nl_ext		nl_ext_t;
54 
55 typedef int (*npfext_initfunc_t)(void);
56 typedef nl_ext_t *(*npfext_consfunc_t)(const char *);
57 typedef int (*npfext_paramfunc_t)(nl_ext_t *, const char *, const char *);
58 
59 #ifdef _NPF_PRIVATE
60 
61 typedef struct {
62 	int		ne_id;
63 	char *		ne_source_file;
64 	u_int		ne_source_line;
65 	int		ne_ncode_error;
66 	int		ne_ncode_errat;
67 } nl_error_t;
68 
69 typedef void (*nl_rule_callback_t)(nl_rule_t *, unsigned);
70 typedef void (*nl_table_callback_t)(unsigned, int);
71 
72 #endif
73 
74 #define	NPF_MAX_TABLE_ID	(16)
75 
76 nl_config_t *	npf_config_create(void);
77 void		npf_config_destroy(nl_config_t *);
78 
79 int		npf_config_submit(nl_config_t *, int);
80 nl_config_t *	npf_config_retrieve(int, bool *, bool *);
81 nl_config_t *	npf_config_import(const char *);
82 int		npf_config_export(const nl_config_t *, const char *);
83 int		npf_config_flush(int);
84 
85 int		npf_ruleset_add(int, const char *, nl_rule_t *, uint64_t *);
86 int		npf_ruleset_remove(int, const char *, uint64_t);
87 int		npf_ruleset_remkey(int, const char *, const void *, size_t);
88 int		npf_ruleset_flush(int, const char *);
89 
90 nl_ext_t *	npf_ext_construct(const char *name);
91 void		npf_ext_param_u32(nl_ext_t *, const char *, uint32_t);
92 void		npf_ext_param_bool(nl_ext_t *, const char *, bool);
93 void		npf_ext_param_string(nl_ext_t *, const char *, const char *);
94 
95 nl_rule_t *	npf_rule_create(const char *, uint32_t, const char *);
96 int		npf_rule_setcode(nl_rule_t *, int, const void *, size_t);
97 int		npf_rule_setprio(nl_rule_t *, pri_t);
98 int		npf_rule_setproc(nl_rule_t *, const char *);
99 int		npf_rule_setkey(nl_rule_t *, const void *, size_t);
100 int		npf_rule_setinfo(nl_rule_t *, const void *, size_t);
101 bool		npf_rule_exists_p(nl_config_t *, const char *);
102 int		npf_rule_insert(nl_config_t *, nl_rule_t *, nl_rule_t *);
103 void *		npf_rule_export(nl_rule_t *, size_t *);
104 void		npf_rule_destroy(nl_rule_t *);
105 
106 nl_rproc_t *	npf_rproc_create(const char *);
107 int		npf_rproc_extcall(nl_rproc_t *, nl_ext_t *);
108 bool		npf_rproc_exists_p(nl_config_t *, const char *);
109 int		npf_rproc_insert(nl_config_t *, nl_rproc_t *);
110 
111 nl_nat_t *	npf_nat_create(int, u_int, const char *,
112 		    int, npf_addr_t *, npf_netmask_t, in_port_t);
113 int		npf_nat_insert(nl_config_t *, nl_nat_t *, pri_t);
114 int		npf_nat_lookup(int, int, npf_addr_t *[2], in_port_t [2], int, int);
115 
116 nl_table_t *	npf_table_create(const char *, u_int, int);
117 int		npf_table_add_entry(nl_table_t *, int,
118 		    const npf_addr_t *, const npf_netmask_t);
119 int		npf_table_setdata(nl_table_t *, const void *, size_t);
120 int		npf_table_insert(nl_config_t *, nl_table_t *);
121 void		npf_table_destroy(nl_table_t *);
122 
123 #ifdef _NPF_PRIVATE
124 
125 #include <ifaddrs.h>
126 
127 nl_rule_t *	npf_rule_iterate(nl_config_t *, unsigned *);
128 const char *	npf_rule_getname(nl_rule_t *);
129 uint32_t	npf_rule_getattr(nl_rule_t *);
130 const char *	npf_rule_getinterface(nl_rule_t *);
131 const void *	npf_rule_getinfo(nl_rule_t *, size_t *);
132 const char *	npf_rule_getproc(nl_rule_t *);
133 uint64_t	npf_rule_getid(nl_rule_t *);
134 const void *	npf_rule_getcode(nl_rule_t *, int *, size_t *);
135 
136 nl_table_t *	npf_table_iterate(nl_config_t *);
137 const char *	npf_table_getname(nl_table_t *);
138 unsigned	npf_table_getid(nl_table_t *);
139 int		npf_table_gettype(nl_table_t *);
140 
141 nl_nat_t *	npf_nat_iterate(nl_config_t *);
142 int		npf_nat_gettype(nl_nat_t *);
143 unsigned	npf_nat_getflags(nl_nat_t *);
144 void		npf_nat_getmap(nl_nat_t *, npf_addr_t *, size_t *, in_port_t *);
145 
146 int		npf_nat_setalgo(nl_nat_t *, u_int);
147 int		npf_nat_setnpt66(nl_nat_t *, uint16_t);
148 
149 nl_rproc_t *	npf_rproc_iterate(nl_config_t *);
150 const char *	npf_rproc_getname(nl_rproc_t *);
151 
152 void		_npf_config_error(nl_config_t *, nl_error_t *);
153 void		_npf_config_setsubmit(nl_config_t *, const char *);
154 int		_npf_ruleset_list(int, const char *, nl_config_t *);
155 void		_npf_debug_addif(nl_config_t *, const char *);
156 
157 /* The ALG interface is experimental */
158 int 		_npf_alg_load(nl_config_t *, const char *);
159 int		_npf_alg_unload(nl_config_t *, const char *);
160 
161 #endif
162 
163 __END_DECLS
164 
165 #endif	/* _NPF_LIB_H_ */
166