/* $NetBSD: npf_impl.h,v 1.69 2017/02/19 02:11:19 christos Exp $ */ /*- * Copyright (c) 2009-2014 The NetBSD Foundation, Inc. * All rights reserved. * * This material is based upon work partially supported by The * NetBSD Foundation under a contract with Mindaugas Rasiukevicius. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ /* * Private NPF structures and interfaces. * For internal use within NPF core only. */ #ifndef _NPF_IMPL_H_ #define _NPF_IMPL_H_ #if !defined(_KERNEL) && !defined(_NPF_STANDALONE) #error "Kernel-level header only" #endif #ifdef _KERNEL_OPT /* For INET/INET6 definitions. */ #include "opt_inet.h" #include "opt_inet6.h" #endif #ifdef _KERNEL #include #include #include #include #include #include #endif #include "npf.h" #include "npfkern.h" #ifdef _NPF_DEBUG #define NPF_PRINTF(x) printf x #else #define NPF_PRINTF(x) #endif /* * STRUCTURE DECLARATIONS. */ struct npf_ruleset; struct npf_rule; struct npf_rprocset; struct npf_nat; struct npf_conn; struct npf_config; typedef struct npf_ruleset npf_ruleset_t; typedef struct npf_rule npf_rule_t; typedef struct npf_nat npf_nat_t; typedef struct npf_rprocset npf_rprocset_t; typedef struct npf_alg npf_alg_t; typedef struct npf_natpolicy npf_natpolicy_t; typedef struct npf_conn npf_conn_t; typedef struct npf_config npf_config_t; struct npf_conndb; struct npf_table; struct npf_tableset; struct npf_algset; struct npf_ifmap; typedef struct npf_conndb npf_conndb_t; typedef struct npf_table npf_table_t; typedef struct npf_tableset npf_tableset_t; typedef struct npf_algset npf_algset_t; /* * DEFINITIONS. */ typedef void (*npf_workfunc_t)(npf_t *); /* * Some artificial limits. * Note: very unlikely to have many ALGs. */ #define NPF_MAX_RULES (1024 * 1024) #define NPF_MAX_TABLES 128 #define NPF_MAX_RPROCS 128 #define NPF_MAX_IFMAP 64 #define NPF_MAX_ALGS 4 #define NPF_MAX_WORKS 4 /* * CONNECTION STATE STRUCTURES */ #define NPF_FLOW_FORW 0 #define NPF_FLOW_BACK 1 typedef struct { uint32_t nst_end; uint32_t nst_maxend; uint32_t nst_maxwin; int nst_wscale; } npf_tcpstate_t; typedef struct { u_int nst_state; npf_tcpstate_t nst_tcpst[2]; } npf_state_t; /* * ALG FUNCTIONS. */ typedef struct { bool (*match)(npf_cache_t *, npf_nat_t *, int); bool (*translate)(npf_cache_t *, npf_nat_t *, bool); npf_conn_t * (*inspect)(npf_cache_t *, int); } npfa_funcs_t; /* * NBUF STRUCTURE. */ struct nbuf { struct mbuf * nb_mbuf0; struct mbuf * nb_mbuf; void * nb_nptr; const ifnet_t * nb_ifp; unsigned nb_ifid; int nb_flags; const npf_mbufops_t *nb_mops; }; /* * NPF INSTANCE (CONTEXT) STRUCTURE AND AUXILIARY OPERATIONS. */ struct npf { /* Active NPF configuration. */ kmutex_t config_lock; pserialize_t qsbr; npf_config_t * config; /* BPF byte-code context. */ bpf_ctx_t * bpfctx; const npf_mbufops_t * mbufops; /* * Connection tracking state: disabled (off) or enabled (on). * Connection tracking database, connection cache and the lock. */ volatile int conn_tracking; kmutex_t conn_lock; npf_conndb_t * conn_db; pool_cache_t conn_cache; /* ALGs. */ npf_algset_t * algset; /* Interface mapping. */ const npf_ifops_t * ifops; struct npf_ifmap * ifmap; unsigned ifmap_cnt; /* Associated worker thread. */ unsigned worker_id; void * worker_entry; /* List of extensions and its lock. */ LIST_HEAD(, npf_ext) ext_list; kmutex_t ext_lock; /* Statistics. */ percpu_t * stats_percpu; }; /* * INTERFACES. */ /* NPF config, statistics, etc. */ void npf_config_init(npf_t *); void npf_config_fini(npf_t *); void npf_config_enter(npf_t *); void npf_config_exit(npf_t *); void npf_config_sync(npf_t *); bool npf_config_locked_p(npf_t *); int npf_config_read_enter(void); void npf_config_read_exit(int s); void npf_config_load(npf_t *, npf_ruleset_t *, npf_tableset_t *, npf_ruleset_t *, npf_rprocset_t *, npf_conndb_t *, bool); npf_ruleset_t * npf_config_ruleset(npf_t *npf); npf_ruleset_t * npf_config_natset(npf_t *npf); npf_tableset_t *npf_config_tableset(npf_t *npf); npf_rprocset_t *npf_config_rprocs(npf_t *); bool npf_default_pass(npf_t *); int npf_worker_sysinit(unsigned); void npf_worker_sysfini(void); void npf_worker_signal(npf_t *); void npf_worker_register(npf_t *, npf_workfunc_t); void npf_worker_unregister(npf_t *, npf_workfunc_t); int npfctl_switch(void *); int npfctl_reload(u_long, void *); int npfctl_save(npf_t *, u_long, void *); int npfctl_load(npf_t *, u_long, void *); int npfctl_rule(npf_t *, u_long, void *); int npfctl_conn_lookup(npf_t *, u_long, void *); int npfctl_table(npf_t *, void *); void npf_stats_inc(npf_t *, npf_stats_t); void npf_stats_dec(npf_t *, npf_stats_t); void npf_ifmap_init(npf_t *, const npf_ifops_t *); void npf_ifmap_fini(npf_t *); u_int npf_ifmap_register(npf_t *, const char *); void npf_ifmap_flush(npf_t *); u_int npf_ifmap_getid(npf_t *, const ifnet_t *); const char * npf_ifmap_getname(npf_t *, const u_int); void npf_ifmap_copyname(npf_t *, u_int, char *, size_t); void npf_ifaddr_sync(npf_t *, ifnet_t *); void npf_ifaddr_flush(npf_t *, ifnet_t *); void npf_ifaddr_syncall(npf_t *); /* Packet filter hooks. */ int npf_pfil_register(bool); void npf_pfil_unregister(bool); bool npf_pfil_registered_p(void); /* Protocol helpers. */ int npf_cache_all(npf_cache_t *); void npf_recache(npf_cache_t *); bool npf_rwrip(const npf_cache_t *, u_int, const npf_addr_t *); bool npf_rwrport(const npf_cache_t *, u_int, const in_port_t); bool npf_rwrcksum(const npf_cache_t *, u_int, const npf_addr_t *, const in_port_t); int npf_napt_rwr(const npf_cache_t *, u_int, const npf_addr_t *, const in_addr_t); int npf_npt66_rwr(const npf_cache_t *, u_int, const npf_addr_t *, npf_netmask_t, uint16_t); uint16_t npf_fixup16_cksum(uint16_t, uint16_t, uint16_t); uint16_t npf_fixup32_cksum(uint16_t, uint32_t, uint32_t); uint16_t npf_addr_cksum(uint16_t, int, const npf_addr_t *, const npf_addr_t *); uint32_t npf_addr_mix(const int, const npf_addr_t *, const npf_addr_t *); int npf_addr_cmp(const npf_addr_t *, const npf_netmask_t, const npf_addr_t *, const npf_netmask_t, const int); void npf_addr_mask(const npf_addr_t *, const npf_netmask_t, const int, npf_addr_t *); int npf_tcpsaw(const npf_cache_t *, tcp_seq *, tcp_seq *, uint32_t *); bool npf_fetch_tcpopts(npf_cache_t *, uint16_t *, int *); bool npf_return_block(npf_cache_t *, const int); /* BPF interface. */ void npf_bpf_sysinit(void); void npf_bpf_sysfini(void); void npf_bpf_prepare(npf_cache_t *, bpf_args_t *, uint32_t *); int npf_bpf_filter(bpf_args_t *, const void *, bpfjit_func_t); void * npf_bpf_compile(void *, size_t); bool npf_bpf_validate(const void *, size_t); /* Tableset interface. */ void npf_tableset_sysinit(void); void npf_tableset_sysfini(void); npf_tableset_t *npf_tableset_create(u_int); void npf_tableset_destroy(npf_tableset_t *); int npf_tableset_insert(npf_tableset_t *, npf_table_t *); npf_table_t * npf_tableset_getbyname(npf_tableset_t *, const char *); npf_table_t * npf_tableset_getbyid(npf_tableset_t *, u_int); npf_table_t * npf_tableset_swap(npf_tableset_t *, npf_table_t *); void npf_tableset_reload(npf_t *, npf_tableset_t *, npf_tableset_t *); int npf_tableset_export(npf_t *, const npf_tableset_t *, prop_array_t); npf_table_t * npf_table_create(const char *, u_int, int, void *, size_t); void npf_table_destroy(npf_table_t *); u_int npf_table_getid(npf_table_t *); int npf_table_check(npf_tableset_t *, const char *, u_int, int); int npf_table_insert(npf_table_t *, const int, const npf_addr_t *, const npf_netmask_t); int npf_table_remove(npf_table_t *, const int, const npf_addr_t *, const npf_netmask_t); int npf_table_lookup(npf_table_t *, const int, const npf_addr_t *); int npf_table_list(npf_table_t *, void *, size_t); int npf_table_flush(npf_table_t *); /* Ruleset interface. */ npf_ruleset_t * npf_ruleset_create(size_t); void npf_ruleset_destroy(npf_ruleset_t *); void npf_ruleset_insert(npf_ruleset_t *, npf_rule_t *); void npf_ruleset_reload(npf_t *, npf_ruleset_t *, npf_ruleset_t *, bool); npf_rule_t * npf_ruleset_sharepm(npf_ruleset_t *, npf_natpolicy_t *); npf_natpolicy_t *npf_ruleset_findnat(npf_ruleset_t *, uint64_t); void npf_ruleset_freealg(npf_ruleset_t *, npf_alg_t *); int npf_ruleset_export(npf_t *, const npf_ruleset_t *, prop_array_t); int npf_ruleset_add(npf_ruleset_t *, const char *, npf_rule_t *); int npf_ruleset_remove(npf_ruleset_t *, const char *, uint64_t); int npf_ruleset_remkey(npf_ruleset_t *, const char *, const void *, size_t); prop_dictionary_t npf_ruleset_list(npf_t *, npf_ruleset_t *, const char *); int npf_ruleset_flush(npf_ruleset_t *, const char *); void npf_ruleset_gc(npf_ruleset_t *); npf_rule_t * npf_ruleset_inspect(npf_cache_t *, const npf_ruleset_t *, const int, const int); int npf_rule_conclude(const npf_rule_t *, npf_match_info_t *); /* Rule interface. */ npf_rule_t * npf_rule_alloc(npf_t *, prop_dictionary_t); void npf_rule_setcode(npf_rule_t *, int, void *, size_t); void npf_rule_setrproc(npf_rule_t *, npf_rproc_t *); void npf_rule_free(npf_rule_t *); uint64_t npf_rule_getid(const npf_rule_t *); npf_natpolicy_t *npf_rule_getnat(const npf_rule_t *); void npf_rule_setnat(npf_rule_t *, npf_natpolicy_t *); npf_rproc_t * npf_rule_getrproc(const npf_rule_t *); void npf_ext_init(npf_t *); void npf_ext_fini(npf_t *); int npf_ext_construct(npf_t *, const char *, npf_rproc_t *, prop_dictionary_t); npf_rprocset_t *npf_rprocset_create(void); void npf_rprocset_destroy(npf_rprocset_t *); npf_rproc_t * npf_rprocset_lookup(npf_rprocset_t *, const char *); void npf_rprocset_insert(npf_rprocset_t *, npf_rproc_t *); int npf_rprocset_export(const npf_rprocset_t *, prop_array_t); npf_rproc_t * npf_rproc_create(prop_dictionary_t); void npf_rproc_acquire(npf_rproc_t *); void npf_rproc_release(npf_rproc_t *); const char * npf_rproc_getname(const npf_rproc_t *); bool npf_rproc_run(npf_cache_t *, npf_rproc_t *, const npf_match_info_t *, int *); /* State handling. */ bool npf_state_init(npf_cache_t *, npf_state_t *); bool npf_state_inspect(npf_cache_t *, npf_state_t *, const bool); int npf_state_etime(const npf_state_t *, const int); void npf_state_destroy(npf_state_t *); bool npf_state_tcp(npf_cache_t *, npf_state_t *, int); int npf_state_tcp_timeout(const npf_state_t *); /* NAT. */ void npf_nat_sysinit(void); void npf_nat_sysfini(void); npf_natpolicy_t *npf_nat_newpolicy(npf_t *, prop_dictionary_t, npf_ruleset_t *); int npf_nat_policyexport(const npf_natpolicy_t *, prop_dictionary_t); void npf_nat_freepolicy(npf_natpolicy_t *); bool npf_nat_cmppolicy(npf_natpolicy_t *, npf_natpolicy_t *); bool npf_nat_sharepm(npf_natpolicy_t *, npf_natpolicy_t *); void npf_nat_setid(npf_natpolicy_t *, uint64_t); uint64_t npf_nat_getid(const npf_natpolicy_t *); void npf_nat_freealg(npf_natpolicy_t *, npf_alg_t *); int npf_do_nat(npf_cache_t *, npf_conn_t *, const int); void npf_nat_destroy(npf_nat_t *); void npf_nat_getorig(npf_nat_t *, npf_addr_t **, in_port_t *); void npf_nat_gettrans(npf_nat_t *, npf_addr_t **, in_port_t *); void npf_nat_setalg(npf_nat_t *, npf_alg_t *, uintptr_t); void npf_nat_export(prop_dictionary_t, npf_nat_t *); npf_nat_t * npf_nat_import(npf_t *, prop_dictionary_t, npf_ruleset_t *, npf_conn_t *); /* ALG interface. */ void npf_alg_init(npf_t *); void npf_alg_fini(npf_t *); npf_alg_t * npf_alg_register(npf_t *, const char *, const npfa_funcs_t *); int npf_alg_unregister(npf_t *, npf_alg_t *); npf_alg_t * npf_alg_construct(npf_t *, const char *); bool npf_alg_match(npf_cache_t *, npf_nat_t *, int); void npf_alg_exec(npf_cache_t *, npf_nat_t *, bool); npf_conn_t * npf_alg_conn(npf_cache_t *, int); prop_array_t npf_alg_export(npf_t *); /* Debugging routines. */ const char * npf_addr_dump(const npf_addr_t *, int); void npf_state_dump(const npf_state_t *); void npf_nat_dump(const npf_nat_t *); void npf_ruleset_dump(npf_t *, const char *); void npf_state_setsampler(void (*)(npf_state_t *, bool)); /* In-kernel routines. */ void npf_setkernctx(npf_t *); npf_t * npf_getkernctx(void); #ifdef __NetBSD__ #define pserialize_register(x) #define pserialize_checkpoint(x) #endif #endif /* _NPF_IMPL_H_ */