[thirdparty/bird.git] / filter / data.h

/*
 *	BIRD Internet Routing Daemon -- Dynamic data structures
 *
 *	(c) 1999 Pavel Machek <pavel@ucw.cz>
 *	(c) 2018--2019 Maria Matejka <mq@jmq.cz>
 *
 *	Can be freely distributed and used under the terms of the GNU GPL.
 */

#ifndef _BIRD_FILTER_DATA_H_
#define _BIRD_FILTER_DATA_H_

#include "nest/bird.h"

/* Type numbers must be in 0..0xff range */
#define T_MASK 0xff

/* Internal types */
enum f_type {
/* Nothing. Simply nothing. */
  T_VOID = 0,

/* User visible types, which fit in int */
  T_INT = 0x10,
  T_BOOL = 0x11,
  T_PAIR = 0x12,  /*	Notice that pair is stored as integer: first << 16 | second */
  T_QUAD = 0x13,

/* Put enumerational types in 0x30..0x3f range */
  T_ENUM_LO = 0x30,
  T_ENUM_HI = 0x3f,

  T_ENUM_RTS = 0x30,
  T_ENUM_BGP_ORIGIN = 0x31,
  T_ENUM_SCOPE = 0x32,
  T_ENUM_RTC = 0x33,
  T_ENUM_RTD = 0x34,
  T_ENUM_ROA = 0x35,
  T_ENUM_NETTYPE = 0x36,
  T_ENUM_RA_PREFERENCE = 0x37,
  T_ENUM_AF = 0x38,

/* new enums go here */
  T_ENUM_EMPTY = 0x3f,	/* Special hack for atomic_aggr */

#define T_ENUM T_ENUM_LO ... T_ENUM_HI

/* Bigger ones */
  T_IP = 0x20,
  T_NET = 0x21,
  T_STRING = 0x22,
  T_PATH_MASK = 0x23,	/* mask for BGP path */
  T_PATH = 0x24,		/* BGP path */
  T_CLIST = 0x25,		/* Community list */
  T_EC = 0x26,		/* Extended community value, u64 */
  T_ECLIST = 0x27,		/* Extended community list */
  T_LC = 0x28,		/* Large community value, lcomm */
  T_LCLIST = 0x29,		/* Large community list */
  T_RD = 0x2a,		/* Route distinguisher for VPN addresses */
  T_PATH_MASK_ITEM = 0x2b,	/* Path mask item for path mask constructors */

  T_SET = 0x80,
  T_PREFIX_SET = 0x81,
} PACKED;

/* Filter value; size of this affects filter memory consumption */
struct f_val {
  enum f_type type;	/* T_*  */
  union {
    uint i;
    u64 ec;
    lcomm lc;
    ip_addr ip;
    const net_addr *net;
    const char *s;
    const struct f_tree *t;
    const struct f_trie *ti;
    const struct adata *ad;
    const struct f_path_mask *path_mask;
    struct f_path_mask_item pmi;
  } val;
};

/* Dynamic attribute definition (eattrs) */
struct f_dynamic_attr {
  u8 type;		/* EA type (EAF_*) */
  u8 bit;		/* For bitfield accessors */
  enum f_type f_type;	/* Filter type */
  uint ea_code;		/* EA code */
};

enum f_sa_code {
  SA_FROM = 1,
  SA_GW,
  SA_NET,
  SA_PROTO,
  SA_SOURCE,
  SA_SCOPE,
  SA_DEST,
  SA_IFNAME,
  SA_IFINDEX,
  SA_WEIGHT,
  SA_PREF,
  SA_GW_MPLS,
} PACKED;

/* Static attribute definition (members of struct rta) */
struct f_static_attr {
  enum f_type f_type;		/* Filter type */
  enum f_sa_code sa_code;	/* Static attribute id */
  int readonly:1;			/* Don't allow writing */
};

/* Filter l-value type */
enum f_lval_type {
  F_LVAL_VARIABLE,
  F_LVAL_PREFERENCE,
  F_LVAL_SA,
  F_LVAL_EA,
};

/* Filter l-value */
struct f_lval {
  enum f_lval_type type;
  union {
    struct symbol *sym;
    struct f_dynamic_attr da;
    struct f_static_attr sa;
  };
};

/* IP prefix range structure */
struct f_prefix {
  net_addr net;		/* The matching prefix must match this net */
  u8 lo, hi;		/* And its length must fit between lo and hi */
};

struct f_tree {
  struct f_tree *left, *right;
  struct f_val from, to;
  void *data;
};

#define TRIE_STEP		4
#define TRIE_STACK_LENGTH	33

struct f_trie_node4
{
  ip4_addr addr, mask, accept;
  u16 plen;
  u16 local;
  struct f_trie_node4 *c[1 << TRIE_STEP];
};

struct f_trie_node6
{
  ip6_addr addr, mask, accept;
  u16 plen;
  u16 local;
  struct f_trie_node6 *c[1 << TRIE_STEP];
};

struct f_trie_node
{
  union {
    struct f_trie_node4 v4;
    struct f_trie_node6 v6;
  };
};

struct f_trie
{
  linpool *lp;
  u8 zero;
  s8 ipv4;				/* -1 for undefined / empty */
  u16 data_size;			/* Additional data for each trie node */
  u32 prefix_count;			/* Works only for restricted tries (pxlen == l == h) */
  struct f_trie_node root;		/* Root trie node */
};

struct f_trie_walk_state
{
  u8 ipv4;
  u8 accept_length;			/* Current inter-node prefix position */
  u8 start_pos;				/* Initial prefix position in stack[0] */
  u8 local_pos;				/* Current intra-node prefix position */
  u8 stack_pos;				/* Current node in stack below */
  const struct f_trie_node *stack[TRIE_STACK_LENGTH];
};

struct f_tree *f_new_tree(void);
struct f_tree *build_tree(struct f_tree *);
const struct f_tree *find_tree(const struct f_tree *t, const struct f_val *val);
int same_tree(const struct f_tree *t0, const struct f_tree *t2);
int tree_node_count(const struct f_tree *t);
void tree_format(const struct f_tree *t, buffer *buf);
void tree_walk(const struct f_tree *t, void (*hook)(const struct f_tree *, void *), void *data);

struct f_trie *f_new_trie(linpool *lp, uint data_size);
void *trie_add_prefix(struct f_trie *t, const net_addr *n, uint l, uint h);
int trie_match_net(const struct f_trie *t, const net_addr *n);
int trie_match_longest_ip4(const struct f_trie *t, const net_addr_ip4 *net, net_addr_ip4 *dst, ip4_addr *found0);
int trie_match_longest_ip6(const struct f_trie *t, const net_addr_ip6 *net, net_addr_ip6 *dst, ip6_addr *found0);
void trie_walk_init(struct f_trie_walk_state *s, const struct f_trie *t, const net_addr *from);
int trie_walk_next(struct f_trie_walk_state *s, net_addr *net);
int trie_same(const struct f_trie *t1, const struct f_trie *t2);
void trie_format(const struct f_trie *t, buffer *buf);

static inline int
trie_match_next_longest_ip4(net_addr_ip4 *n, ip4_addr *found)
{
  while (n->pxlen)
  {
    n->pxlen--;
    ip4_clrbit(&n->prefix, n->pxlen);

    if (ip4_getbit(*found, n->pxlen))
      return 1;
  }

  return 0;
}

static inline int
trie_match_next_longest_ip6(net_addr_ip6 *n, ip6_addr *found)
{
  while (n->pxlen)
  {
    n->pxlen--;
    ip6_clrbit(&n->prefix, n->pxlen);

    if (ip6_getbit(*found, n->pxlen))
      return 1;
  }

  return 0;
}


#define TRIE_WALK_TO_ROOT_IP4(trie, net, dst) ({		\
  net_addr_ip4 dst;						\
  ip4_addr _found;						\
  for (int _n = trie_match_longest_ip4(trie, net, &dst, &_found); \
       _n;							\
       _n = trie_match_next_longest_ip4(&dst, &_found))

#define TRIE_WALK_TO_ROOT_IP6(trie, net, dst) ({		\
  net_addr_ip6 dst;						\
  ip6_addr _found;						\
  for (int _n = trie_match_longest_ip6(trie, net, &dst, &_found); \
       _n;							\
       _n = trie_match_next_longest_ip6(&dst, &_found))

#define TRIE_WALK_TO_ROOT_END })


#define TRIE_WALK(trie, net, from) ({				\
  net_addr net;							\
  struct f_trie_walk_state tws_;				\
  trie_walk_init(&tws_, trie, from);				\
  while (trie_walk_next(&tws_, &net))

#define TRIE_WALK_END })


#define F_CMP_ERROR 999

const char *f_type_name(enum f_type t);

enum f_type f_type_element_type(enum f_type t);

int val_same(const struct f_val *v1, const struct f_val *v2);
int val_compare(const struct f_val *v1, const struct f_val *v2);
void val_format(const struct f_val *v, buffer *buf);
char *val_format_str(struct linpool *lp, const struct f_val *v);
const char *val_dump(const struct f_val *v);

static inline int val_is_ip4(const struct f_val *v)
{ return (v->type == T_IP) && ipa_is_ip4(v->val.ip); }
int val_in_range(const struct f_val *v1, const struct f_val *v2);

int clist_set_type(const struct f_tree *set, struct f_val *v);
static inline int eclist_set_type(const struct f_tree *set)
{ return !set || set->from.type == T_EC; }
static inline int lclist_set_type(const struct f_tree *set)
{ return !set || set->from.type == T_LC; }
static inline int path_set_type(const struct f_tree *set)
{ return !set || set->from.type == T_INT; }

int clist_match_set(const struct adata *clist, const struct f_tree *set);
int eclist_match_set(const struct adata *list, const struct f_tree *set);
int lclist_match_set(const struct adata *list, const struct f_tree *set);

const struct adata *clist_filter(struct linpool *pool, const struct adata *list, const struct f_val *set, int pos);
const struct adata *eclist_filter(struct linpool *pool, const struct adata *list, const struct f_val *set, int pos);
const struct adata *lclist_filter(struct linpool *pool, const struct adata *list, const struct f_val *set, int pos);


/* Special undef value for paths and clists */
static inline int
undef_value(struct f_val v)
{
  return ((v.type == T_PATH) || (v.type == T_CLIST) ||
	  (v.type == T_ECLIST) || (v.type == T_LCLIST)) &&
    (v.val.ad == &null_adata);
}

extern const struct f_val f_const_empty_path, f_const_empty_clist, f_const_empty_eclist, f_const_empty_lclist, f_const_empty_prefix_set;

enum filter_return f_eval(const struct f_line *expr, struct linpool *tmp_pool, struct f_val *pres);

#endif
Commit	Line	Data
8bdb05ed	1	/*
4f082dfa	2	* BIRD Internet Routing Daemon -- Dynamic data structures
8bdb05ed MM	3	*
	4	* (c) 1999 Pavel Machek <pavel@ucw.cz>
	5	* (c) 2018--2019 Maria Matejka <mq@jmq.cz>
	6	*
	7	* Can be freely distributed and used under the terms of the GNU GPL.
	8	*/
	9
4f082dfa MM	10	#ifndef _BIRD_FILTER_DATA_H_
4f082dfa MM	11	#define _BIRD_FILTER_DATA_H_
8bdb05ed	12
4f082dfa	13	#include "nest/bird.h"
8bdb05ed MM	14
	15	/* Type numbers must be in 0..0xff range */
	16	#define T_MASK 0xff
	17
	18	/* Internal types */
	19	enum f_type {
96d757c1 JMM	20	/* Nothing. Simply nothing. */
96d757c1 JMM	21	T_VOID = 0,
8bdb05ed MM	22
	23	/* User visible types, which fit in int */
	24	T_INT = 0x10,
	25	T_BOOL = 0x11,
	26	T_PAIR = 0x12, /* Notice that pair is stored as integer: first << 16 \| second */
	27	T_QUAD = 0x13,
	28
	29	/* Put enumerational types in 0x30..0x3f range */
	30	T_ENUM_LO = 0x30,
	31	T_ENUM_HI = 0x3f,
	32
	33	T_ENUM_RTS = 0x30,
	34	T_ENUM_BGP_ORIGIN = 0x31,
	35	T_ENUM_SCOPE = 0x32,
	36	T_ENUM_RTC = 0x33,
	37	T_ENUM_RTD = 0x34,
	38	T_ENUM_ROA = 0x35,
	39	T_ENUM_NETTYPE = 0x36,
	40	T_ENUM_RA_PREFERENCE = 0x37,
0edf0c8c	41	T_ENUM_AF = 0x38,
8bdb05ed MM	42
	43	/* new enums go here */
	44	T_ENUM_EMPTY = 0x3f, /* Special hack for atomic_aggr */
	45
	46	#define T_ENUM T_ENUM_LO ... T_ENUM_HI
	47
	48	/* Bigger ones */
	49	T_IP = 0x20,
	50	T_NET = 0x21,
	51	T_STRING = 0x22,
	52	T_PATH_MASK = 0x23, /* mask for BGP path */
	53	T_PATH = 0x24, /* BGP path */
	54	T_CLIST = 0x25, /* Community list */
	55	T_EC = 0x26, /* Extended community value, u64 */
	56	T_ECLIST = 0x27, /* Extended community list */
	57	T_LC = 0x28, /* Large community value, lcomm */
	58	T_LCLIST = 0x29, /* Large community list */
	59	T_RD = 0x2a, /* Route distinguisher for VPN addresses */
	60	T_PATH_MASK_ITEM = 0x2b, /* Path mask item for path mask constructors */
	61
	62	T_SET = 0x80,
	63	T_PREFIX_SET = 0x81,
	64	} PACKED;
	65
	66	/* Filter value; size of this affects filter memory consumption */
	67	struct f_val {
	68	enum f_type type; /* T_* */
	69	union {
	70	uint i;
	71	u64 ec;
	72	lcomm lc;
	73	ip_addr ip;
	74	const net_addr *net;
fd9f0c06	75	const char *s;
8bdb05ed MM	76	const struct f_tree *t;
	77	const struct f_trie *ti;
	78	const struct adata *ad;
	79	const struct f_path_mask *path_mask;
	80	struct f_path_mask_item pmi;
	81	} val;
	82	};
	83
8bdb05ed MM	84	/* Dynamic attribute definition (eattrs) */
	85	struct f_dynamic_attr {
	86	u8 type; /* EA type (EAF_) /
	87	u8 bit; /* For bitfield accessors */
	88	enum f_type f_type; /* Filter type */
	89	uint ea_code; /* EA code */
	90	};
	91
	92	enum f_sa_code {
	93	SA_FROM = 1,
	94	SA_GW,
	95	SA_NET,
	96	SA_PROTO,
	97	SA_SOURCE,
	98	SA_SCOPE,
	99	SA_DEST,
	100	SA_IFNAME,
	101	SA_IFINDEX,
8cc5bb09	102	SA_WEIGHT,
eb937358	103	SA_PREF,
e5468d16	104	SA_GW_MPLS,
8bdb05ed MM	105	} PACKED;
	106
	107	/* Static attribute definition (members of struct rta) */
	108	struct f_static_attr {
	109	enum f_type f_type; /* Filter type */
	110	enum f_sa_code sa_code; /* Static attribute id */
	111	int readonly:1; /* Don't allow writing */
	112	};
	113
4f082dfa MM	114	/* Filter l-value type */
	115	enum f_lval_type {
	116	F_LVAL_VARIABLE,
	117	F_LVAL_PREFERENCE,
	118	F_LVAL_SA,
	119	F_LVAL_EA,
	120	};
	121
	122	/* Filter l-value */
	123	struct f_lval {
	124	enum f_lval_type type;
	125	union {
b40c0f02	126	struct symbol *sym;
4f082dfa MM	127	struct f_dynamic_attr da;
	128	struct f_static_attr sa;
	129	};
	130	};
	131
	132	/* IP prefix range structure */
	133	struct f_prefix {
	134	net_addr net; /* The matching prefix must match this net */
	135	u8 lo, hi; /* And its length must fit between lo and hi */
	136	};
	137
8bdb05ed MM	138	struct f_tree {
	139	struct f_tree left, right;
	140	struct f_val from, to;
	141	void *data;
	142	};
	143
062e69bf OZ	144	#define TRIE_STEP 4
062e69bf OZ	145	#define TRIE_STACK_LENGTH 33
13225f1d	146
27550028 OZ	147	struct f_trie_node4
	148	{
	149	ip4_addr addr, mask, accept;
13225f1d OZ	150	u16 plen;
	151	u16 local;
	152	struct f_trie_node4 *c[1 << TRIE_STEP];
27550028 OZ	153	};
	154
	155	struct f_trie_node6
8bdb05ed	156	{
27550028	157	ip6_addr addr, mask, accept;
13225f1d OZ	158	u16 plen;
	159	u16 local;
	160	struct f_trie_node6 *c[1 << TRIE_STEP];
27550028 OZ	161	};
	162
	163	struct f_trie_node
	164	{
	165	union {
	166	struct f_trie_node4 v4;
	167	struct f_trie_node6 v6;
	168	};
8bdb05ed MM	169	};
	170
	171	struct f_trie
	172	{
	173	linpool *lp;
27550028 OZ	174	u8 zero;
	175	s8 ipv4; /* -1 for undefined / empty */
	176	u16 data_size; /* Additional data for each trie node */
ba5aec94	177	u32 prefix_count; /* Works only for restricted tries (pxlen == l == h) */
27550028	178	struct f_trie_node root; /* Root trie node */
8bdb05ed MM	179	};
8bdb05ed MM	180
062e69bf OZ	181	struct f_trie_walk_state
	182	{
	183	u8 ipv4;
	184	u8 accept_length; /* Current inter-node prefix position */
	185	u8 start_pos; /* Initial prefix position in stack[0] */
	186	u8 local_pos; /* Current intra-node prefix position */
	187	u8 stack_pos; /* Current node in stack below */
	188	const struct f_trie_node *stack[TRIE_STACK_LENGTH];
	189	};
	190
8bdb05ed MM	191	struct f_tree *f_new_tree(void);
	192	struct f_tree build_tree(struct f_tree );
	193	const struct f_tree find_tree(const struct f_tree t, const struct f_val *val);
	194	int same_tree(const struct f_tree t0, const struct f_tree t2);
92a85655	195	int tree_node_count(const struct f_tree *t);
8bdb05ed	196	void tree_format(const struct f_tree t, buffer buf);
d06a875b	197	void tree_walk(const struct f_tree t, void (hook)(const struct f_tree , void ), void *data);
8bdb05ed	198
27550028	199	struct f_trie f_new_trie(linpool lp, uint data_size);
8bdb05ed MM	200	void trie_add_prefix(struct f_trie t, const net_addr *n, uint l, uint h);
8bdb05ed MM	201	int trie_match_net(const struct f_trie t, const net_addr n);
14fc24f3 OZ	202	int trie_match_longest_ip4(const struct f_trie t, const net_addr_ip4 net, net_addr_ip4 dst, ip4_addr found0);
14fc24f3 OZ	203	int trie_match_longest_ip6(const struct f_trie t, const net_addr_ip6 net, net_addr_ip6 dst, ip6_addr found0);
062e69bf OZ	204	void trie_walk_init(struct f_trie_walk_state s, const struct f_trie t, const net_addr *from);
062e69bf OZ	205	int trie_walk_next(struct f_trie_walk_state s, net_addr net);
8bdb05ed MM	206	int trie_same(const struct f_trie t1, const struct f_trie t2);
	207	void trie_format(const struct f_trie t, buffer buf);
	208
14fc24f3 OZ	209	static inline int
	210	trie_match_next_longest_ip4(net_addr_ip4 n, ip4_addr found)
	211	{
	212	while (n->pxlen)
	213	{
	214	n->pxlen--;
	215	ip4_clrbit(&n->prefix, n->pxlen);
	216
	217	if (ip4_getbit(*found, n->pxlen))
	218	return 1;
	219	}
	220
	221	return 0;
	222	}
	223
	224	static inline int
	225	trie_match_next_longest_ip6(net_addr_ip6 n, ip6_addr found)
	226	{
	227	while (n->pxlen)
	228	{
	229	n->pxlen--;
	230	ip6_clrbit(&n->prefix, n->pxlen);
	231
	232	if (ip6_getbit(*found, n->pxlen))
	233	return 1;
	234	}
	235
	236	return 0;
	237	}
	238
	239
	240	#define TRIE_WALK_TO_ROOT_IP4(trie, net, dst) ({ \
	241	net_addr_ip4 dst; \
	242	ip4_addr _found; \
	243	for (int _n = trie_match_longest_ip4(trie, net, &dst, &_found); \
	244	_n; \
	245	_n = trie_match_next_longest_ip4(&dst, &_found))
	246
	247	#define TRIE_WALK_TO_ROOT_IP6(trie, net, dst) ({ \
	248	net_addr_ip6 dst; \
	249	ip6_addr _found; \
	250	for (int _n = trie_match_longest_ip6(trie, net, &dst, &_found); \
	251	_n; \
	252	_n = trie_match_next_longest_ip6(&dst, &_found))
	253
	254	#define TRIE_WALK_TO_ROOT_END })
	255
	256
062e69bf OZ	257	#define TRIE_WALK(trie, net, from) ({ \
	258	net_addr net; \
	259	struct f_trie_walk_state tws_; \
	260	trie_walk_init(&tws_, trie, from); \
	261	while (trie_walk_next(&tws_, &net))
	262
	263	#define TRIE_WALK_END })
	264
14fc24f3	265
52893045 MM	266	#define F_CMP_ERROR 999
52893045 MM	267
87512e97 OZ	268	const char *f_type_name(enum f_type t);
87512e97 OZ	269
0e1fd7ea AZ	270	enum f_type f_type_element_type(enum f_type t);
0e1fd7ea AZ	271
52893045 MM	272	int val_same(const struct f_val v1, const struct f_val v2);
	273	int val_compare(const struct f_val v1, const struct f_val v2);
	274	void val_format(const struct f_val v, buffer buf);
b40c0f02	275	char val_format_str(struct linpool lp, const struct f_val *v);
52893045 MM	276	const char val_dump(const struct f_val v);
	277
	278	static inline int val_is_ip4(const struct f_val *v)
	279	{ return (v->type == T_IP) && ipa_is_ip4(v->val.ip); }
	280	int val_in_range(const struct f_val v1, const struct f_val v2);
	281
	282	int clist_set_type(const struct f_tree set, struct f_val v);
	283	static inline int eclist_set_type(const struct f_tree *set)
b2d6d294	284	{ return !set \|\| set->from.type == T_EC; }
52893045	285	static inline int lclist_set_type(const struct f_tree *set)
b2d6d294	286	{ return !set \|\| set->from.type == T_LC; }
8f3c6151	287	static inline int path_set_type(const struct f_tree *set)
b2d6d294	288	{ return !set \|\| set->from.type == T_INT; }
52893045	289
92a85655 OZ	290	int clist_match_set(const struct adata clist, const struct f_tree set);
	291	int eclist_match_set(const struct adata list, const struct f_tree set);
	292	int lclist_match_set(const struct adata list, const struct f_tree set);
	293
52893045 MM	294	const struct adata clist_filter(struct linpool pool, const struct adata list, const struct f_val set, int pos);
	295	const struct adata eclist_filter(struct linpool pool, const struct adata list, const struct f_val set, int pos);
	296	const struct adata lclist_filter(struct linpool pool, const struct adata list, const struct f_val set, int pos);
	297
	298
	299	/* Special undef value for paths and clists */
	300	static inline int
	301	undef_value(struct f_val v)
	302	{
	303	return ((v.type == T_PATH) \|\| (v.type == T_CLIST) \|\|
	304	(v.type == T_ECLIST) \|\| (v.type == T_LCLIST)) &&
	305	(v.val.ad == &null_adata);
	306	}
	307
b2d6d294	308	extern const struct f_val f_const_empty_path, f_const_empty_clist, f_const_empty_eclist, f_const_empty_lclist, f_const_empty_prefix_set;
8bdb05ed	309
52893045 MM	310	enum filter_return f_eval(const struct f_line expr, struct linpool tmp_pool, struct f_val *pres);
52893045 MM	311
8bdb05ed	312	#endif