2 * Zebra Policy Based Routing (PBR) Data structures and definitions
3 * These are public definitions referenced by multiple files.
4 * Copyright (C) 2018 Cumulus Networks, Inc.
6 * This file is part of FRR.
8 * FRR is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License as published by the
10 * Free Software Foundation; either version 2, or (at your option) any
13 * FRR is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with FRR; see the file COPYING. If not, write to the Free
20 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
39 struct zebra_pbr_rule
{
44 char ifname
[INTERFACE_NAMSIZ
];
49 #define IS_RULE_FILTERING_ON_SRC_IP(r) \
50 (r->rule.filter.filter_bm & PBR_FILTER_SRC_IP)
51 #define IS_RULE_FILTERING_ON_DST_IP(r) \
52 (r->rule.filter.filter_bm & PBR_FILTER_DST_IP)
53 #define IS_RULE_FILTERING_ON_SRC_PORT(r) \
54 (r->rule.filter.filter_bm & PBR_FILTER_SRC_PORT)
55 #define IS_RULE_FILTERING_ON_DST_PORT(r) \
56 (r->rule.filter.filter_bm & PBR_FILTER_DST_PORT)
57 #define IS_RULE_FILTERING_ON_FWMARK(r) \
58 (r->rule.filter.filter_bm & PBR_FILTER_FWMARK)
61 * An IPSet Entry Filter
63 * This is a filter mapped on ipset entries
65 struct zebra_pbr_ipset
{
67 * Originating zclient sock fd, so we can know who to send
76 /* type is encoded as uint32_t
77 * but value is an enum ipset_type
80 char ipset_name
[ZEBRA_IPSET_NAME_SIZE
];
84 * An IPSet Entry Filter
86 * This is a filter mapped on ipset entries
88 struct zebra_pbr_ipset_entry
{
90 * Originating zclient sock fd, so we can know who to send
100 /* udp/tcp src port or icmp type */
101 uint16_t src_port_min
;
102 uint16_t src_port_max
;
103 /* udp/tcp dst port or icmp code */
104 uint16_t dst_port_min
;
105 uint16_t dst_port_max
;
111 struct zebra_pbr_ipset
*backpointer
;
117 * This is a filter mapped on ipset entries
119 struct zebra_pbr_iptable
{
121 * Originating zclient sock fd, so we can know who to send
130 /* include ipset type
134 /* include which IP is to be filtered
142 uint16_t pkt_len_min
;
143 uint16_t pkt_len_max
;
145 uint16_t tcp_mask_flags
;
150 uint32_t nb_interface
;
152 struct list
*interface_name_list
;
154 char ipset_name
[ZEBRA_IPSET_NAME_SIZE
];
157 extern const struct message icmp_typecode_str
[];
159 const char *zebra_pbr_ipset_type2str(uint32_t type
);
161 void zebra_pbr_add_rule(struct zebra_pbr_rule
*rule
);
162 void zebra_pbr_del_rule(struct zebra_pbr_rule
*rule
);
163 void zebra_pbr_create_ipset(struct zebra_pbr_ipset
*ipset
);
164 void zebra_pbr_destroy_ipset(struct zebra_pbr_ipset
*ipset
);
165 struct zebra_pbr_ipset
*zebra_pbr_lookup_ipset_pername(char *ipsetname
);
166 void zebra_pbr_add_ipset_entry(struct zebra_pbr_ipset_entry
*ipset
);
167 void zebra_pbr_del_ipset_entry(struct zebra_pbr_ipset_entry
*ipset
);
169 void zebra_pbr_add_iptable(struct zebra_pbr_iptable
*iptable
);
170 void zebra_pbr_del_iptable(struct zebra_pbr_iptable
*iptable
);
173 * Install specified rule for a specific interface.
174 * It is possible that the user-defined sequence number and the one in the
175 * forwarding plane may not coincide, hence the API requires a separate
176 * rule priority - maps to preference/FRA_PRIORITY on Linux.
178 extern enum zebra_dplane_result
kernel_add_pbr_rule(struct zebra_pbr_rule
*rule
);
181 * Uninstall specified rule for a specific interface.
183 extern enum zebra_dplane_result
kernel_del_pbr_rule(struct zebra_pbr_rule
*rule
);
186 * Get to know existing PBR rules in the kernel - typically called at startup.
188 extern void kernel_read_pbr_rules(struct zebra_ns
*zns
);
191 * Handle success or failure of rule (un)install in the kernel.
193 extern void kernel_pbr_rule_add_del_status(struct zebra_pbr_rule
*rule
,
194 enum zebra_dplane_status res
);
197 * Handle success or failure of ipset kinds (un)install in the kernel.
199 extern void kernel_pbr_ipset_add_del_status(struct zebra_pbr_ipset
*ipset
,
200 enum zebra_dplane_status res
);
202 extern void kernel_pbr_ipset_entry_add_del_status(
203 struct zebra_pbr_ipset_entry
*ipset
,
204 enum zebra_dplane_status res
);
206 extern void kernel_pbr_iptable_add_del_status(struct zebra_pbr_iptable
*iptable
,
207 enum zebra_dplane_status res
);
210 * Handle rule delete notification from kernel.
212 extern int kernel_pbr_rule_del(struct zebra_pbr_rule
*rule
);
214 extern void zebra_pbr_rules_free(void *arg
);
215 extern uint32_t zebra_pbr_rules_hash_key(const void *arg
);
216 extern bool zebra_pbr_rules_hash_equal(const void *arg1
, const void *arg2
);
218 /* has operates on 32bit pointer
219 * and field is a string of 8bit
221 #define ZEBRA_IPSET_NAME_HASH_SIZE (ZEBRA_IPSET_NAME_SIZE / 4)
223 extern void zebra_pbr_ipset_free(void *arg
);
224 extern uint32_t zebra_pbr_ipset_hash_key(const void *arg
);
225 extern bool zebra_pbr_ipset_hash_equal(const void *arg1
, const void *arg2
);
227 extern void zebra_pbr_ipset_entry_free(void *arg
);
228 extern uint32_t zebra_pbr_ipset_entry_hash_key(const void *arg
);
229 extern bool zebra_pbr_ipset_entry_hash_equal(const void *arg1
,
232 extern void zebra_pbr_iptable_free(void *arg
);
233 extern uint32_t zebra_pbr_iptable_hash_key(const void *arg
);
234 extern bool zebra_pbr_iptable_hash_equal(const void *arg1
, const void *arg2
);
236 extern void zebra_pbr_init(void);
237 extern void zebra_pbr_show_ipset_list(struct vty
*vty
, char *ipsetname
);
238 extern void zebra_pbr_show_iptable(struct vty
*vty
, char *iptable
);
239 extern void zebra_pbr_iptable_update_interfacelist(struct stream
*s
,
240 struct zebra_pbr_iptable
*zpi
);
241 size_t zebra_pbr_tcpflags_snprintf(char *buffer
, size_t len
,
244 DECLARE_HOOK(zebra_pbr_ipset_entry_get_stat
,
245 (struct zebra_pbr_ipset_entry
*ipset
, uint64_t *pkts
,
247 (ipset
, pkts
, bytes
))
248 DECLARE_HOOK(zebra_pbr_iptable_get_stat
,
249 (struct zebra_pbr_iptable
*iptable
, uint64_t *pkts
,
251 (iptable
, pkts
, bytes
))
252 DECLARE_HOOK(zebra_pbr_iptable_update
,
253 (int cmd
, struct zebra_pbr_iptable
*iptable
), (cmd
, iptable
));
255 DECLARE_HOOK(zebra_pbr_ipset_entry_update
,
256 (int cmd
, struct zebra_pbr_ipset_entry
*ipset
), (cmd
, ipset
));
257 DECLARE_HOOK(zebra_pbr_ipset_update
,
258 (int cmd
, struct zebra_pbr_ipset
*ipset
), (cmd
, ipset
));
264 #endif /* _ZEBRA_PBR_H */