xref: /linux/include/net/ip_fib.h (revision bc05aa6e13a717e1abff6f863f7ba82b14556df4)
1 /*
2  * INET		An implementation of the TCP/IP protocol suite for the LINUX
3  *		operating system.  INET  is implemented using the  BSD Socket
4  *		interface as the means of communication with the user level.
5  *
6  *		Definitions for the Forwarding Information Base.
7  *
8  * Authors:	A.N.Kuznetsov, <kuznet@ms2.inr.ac.ru>
9  *
10  *		This program is free software; you can redistribute it and/or
11  *		modify it under the terms of the GNU General Public License
12  *		as published by the Free Software Foundation; either version
13  *		2 of the License, or (at your option) any later version.
14  */
15 
16 #ifndef _NET_IP_FIB_H
17 #define _NET_IP_FIB_H
18 
19 #include <net/flow.h>
20 #include <linux/seq_file.h>
21 #include <linux/rcupdate.h>
22 #include <net/fib_notifier.h>
23 #include <net/fib_rules.h>
24 #include <net/inetpeer.h>
25 #include <linux/percpu.h>
26 #include <linux/notifier.h>
27 #include <linux/refcount.h>
28 
29 struct fib_config {
30 	u8			fc_dst_len;
31 	u8			fc_tos;
32 	u8			fc_protocol;
33 	u8			fc_scope;
34 	u8			fc_type;
35 	/* 3 bytes unused */
36 	u32			fc_table;
37 	__be32			fc_dst;
38 	__be32			fc_gw;
39 	int			fc_oif;
40 	u32			fc_flags;
41 	u32			fc_priority;
42 	__be32			fc_prefsrc;
43 	struct nlattr		*fc_mx;
44 	struct rtnexthop	*fc_mp;
45 	int			fc_mx_len;
46 	int			fc_mp_len;
47 	u32			fc_flow;
48 	u32			fc_nlflags;
49 	struct nl_info		fc_nlinfo;
50 	struct nlattr		*fc_encap;
51 	u16			fc_encap_type;
52 };
53 
54 struct fib_info;
55 struct rtable;
56 
57 struct fib_nh_exception {
58 	struct fib_nh_exception __rcu	*fnhe_next;
59 	int				fnhe_genid;
60 	__be32				fnhe_daddr;
61 	u32				fnhe_pmtu;
62 	bool				fnhe_mtu_locked;
63 	__be32				fnhe_gw;
64 	unsigned long			fnhe_expires;
65 	struct rtable __rcu		*fnhe_rth_input;
66 	struct rtable __rcu		*fnhe_rth_output;
67 	unsigned long			fnhe_stamp;
68 	struct rcu_head			rcu;
69 };
70 
71 struct fnhe_hash_bucket {
72 	struct fib_nh_exception __rcu	*chain;
73 };
74 
75 #define FNHE_HASH_SHIFT		11
76 #define FNHE_HASH_SIZE		(1 << FNHE_HASH_SHIFT)
77 #define FNHE_RECLAIM_DEPTH	5
78 
79 struct fib_nh {
80 	struct net_device	*nh_dev;
81 	struct hlist_node	nh_hash;
82 	struct fib_info		*nh_parent;
83 	unsigned int		nh_flags;
84 	unsigned char		nh_scope;
85 #ifdef CONFIG_IP_ROUTE_MULTIPATH
86 	int			nh_weight;
87 	atomic_t		nh_upper_bound;
88 #endif
89 #ifdef CONFIG_IP_ROUTE_CLASSID
90 	__u32			nh_tclassid;
91 #endif
92 	int			nh_oif;
93 	__be32			nh_gw;
94 	__be32			nh_saddr;
95 	int			nh_saddr_genid;
96 	struct rtable __rcu * __percpu *nh_pcpu_rth_output;
97 	struct rtable __rcu	*nh_rth_input;
98 	struct fnhe_hash_bucket	__rcu *nh_exceptions;
99 	struct lwtunnel_state	*nh_lwtstate;
100 };
101 
102 /*
103  * This structure contains data shared by many of routes.
104  */
105 
106 struct fib_info {
107 	struct hlist_node	fib_hash;
108 	struct hlist_node	fib_lhash;
109 	struct net		*fib_net;
110 	int			fib_treeref;
111 	refcount_t		fib_clntref;
112 	unsigned int		fib_flags;
113 	unsigned char		fib_dead;
114 	unsigned char		fib_protocol;
115 	unsigned char		fib_scope;
116 	unsigned char		fib_type;
117 	__be32			fib_prefsrc;
118 	u32			fib_tb_id;
119 	u32			fib_priority;
120 	struct dst_metrics	*fib_metrics;
121 #define fib_mtu fib_metrics->metrics[RTAX_MTU-1]
122 #define fib_window fib_metrics->metrics[RTAX_WINDOW-1]
123 #define fib_rtt fib_metrics->metrics[RTAX_RTT-1]
124 #define fib_advmss fib_metrics->metrics[RTAX_ADVMSS-1]
125 	int			fib_nhs;
126 	struct rcu_head		rcu;
127 	struct fib_nh		fib_nh[0];
128 #define fib_dev		fib_nh[0].nh_dev
129 };
130 
131 
132 #ifdef CONFIG_IP_MULTIPLE_TABLES
133 struct fib_rule;
134 #endif
135 
136 struct fib_table;
137 struct fib_result {
138 	__be32		prefix;
139 	unsigned char	prefixlen;
140 	unsigned char	nh_sel;
141 	unsigned char	type;
142 	unsigned char	scope;
143 	u32		tclassid;
144 	struct fib_info *fi;
145 	struct fib_table *table;
146 	struct hlist_head *fa_head;
147 };
148 
149 struct fib_result_nl {
150 	__be32		fl_addr;   /* To be looked up*/
151 	u32		fl_mark;
152 	unsigned char	fl_tos;
153 	unsigned char   fl_scope;
154 	unsigned char   tb_id_in;
155 
156 	unsigned char   tb_id;      /* Results */
157 	unsigned char	prefixlen;
158 	unsigned char	nh_sel;
159 	unsigned char	type;
160 	unsigned char	scope;
161 	int             err;
162 };
163 
164 #ifdef CONFIG_IP_ROUTE_MULTIPATH
165 #define FIB_RES_NH(res)		((res).fi->fib_nh[(res).nh_sel])
166 #else /* CONFIG_IP_ROUTE_MULTIPATH */
167 #define FIB_RES_NH(res)		((res).fi->fib_nh[0])
168 #endif /* CONFIG_IP_ROUTE_MULTIPATH */
169 
170 #ifdef CONFIG_IP_MULTIPLE_TABLES
171 #define FIB_TABLE_HASHSZ 256
172 #else
173 #define FIB_TABLE_HASHSZ 2
174 #endif
175 
176 __be32 fib_info_update_nh_saddr(struct net *net, struct fib_nh *nh);
177 
178 #define FIB_RES_SADDR(net, res)				\
179 	((FIB_RES_NH(res).nh_saddr_genid ==		\
180 	  atomic_read(&(net)->ipv4.dev_addr_genid)) ?	\
181 	 FIB_RES_NH(res).nh_saddr :			\
182 	 fib_info_update_nh_saddr((net), &FIB_RES_NH(res)))
183 #define FIB_RES_GW(res)			(FIB_RES_NH(res).nh_gw)
184 #define FIB_RES_DEV(res)		(FIB_RES_NH(res).nh_dev)
185 #define FIB_RES_OIF(res)		(FIB_RES_NH(res).nh_oif)
186 
187 #define FIB_RES_PREFSRC(net, res)	((res).fi->fib_prefsrc ? : \
188 					 FIB_RES_SADDR(net, res))
189 
190 struct fib_entry_notifier_info {
191 	struct fib_notifier_info info; /* must be first */
192 	u32 dst;
193 	int dst_len;
194 	struct fib_info *fi;
195 	u8 tos;
196 	u8 type;
197 	u32 tb_id;
198 };
199 
200 struct fib_nh_notifier_info {
201 	struct fib_notifier_info info; /* must be first */
202 	struct fib_nh *fib_nh;
203 };
204 
205 int call_fib4_notifier(struct notifier_block *nb, struct net *net,
206 		       enum fib_event_type event_type,
207 		       struct fib_notifier_info *info);
208 int call_fib4_notifiers(struct net *net, enum fib_event_type event_type,
209 			struct fib_notifier_info *info);
210 
211 int __net_init fib4_notifier_init(struct net *net);
212 void __net_exit fib4_notifier_exit(struct net *net);
213 
214 void fib_notify(struct net *net, struct notifier_block *nb);
215 
216 struct fib_table {
217 	struct hlist_node	tb_hlist;
218 	u32			tb_id;
219 	int			tb_num_default;
220 	struct rcu_head		rcu;
221 	unsigned long 		*tb_data;
222 	unsigned long		__data[0];
223 };
224 
225 int fib_table_lookup(struct fib_table *tb, const struct flowi4 *flp,
226 		     struct fib_result *res, int fib_flags);
227 int fib_table_insert(struct net *, struct fib_table *, struct fib_config *,
228 		     struct netlink_ext_ack *extack);
229 int fib_table_delete(struct net *, struct fib_table *, struct fib_config *,
230 		     struct netlink_ext_ack *extack);
231 int fib_table_dump(struct fib_table *table, struct sk_buff *skb,
232 		   struct netlink_callback *cb);
233 int fib_table_flush(struct net *net, struct fib_table *table);
234 struct fib_table *fib_trie_unmerge(struct fib_table *main_tb);
235 void fib_table_flush_external(struct fib_table *table);
236 void fib_free_table(struct fib_table *tb);
237 
238 #ifndef CONFIG_IP_MULTIPLE_TABLES
239 
240 #define TABLE_LOCAL_INDEX	(RT_TABLE_LOCAL & (FIB_TABLE_HASHSZ - 1))
241 #define TABLE_MAIN_INDEX	(RT_TABLE_MAIN  & (FIB_TABLE_HASHSZ - 1))
242 
243 static inline struct fib_table *fib_get_table(struct net *net, u32 id)
244 {
245 	struct hlist_node *tb_hlist;
246 	struct hlist_head *ptr;
247 
248 	ptr = id == RT_TABLE_LOCAL ?
249 		&net->ipv4.fib_table_hash[TABLE_LOCAL_INDEX] :
250 		&net->ipv4.fib_table_hash[TABLE_MAIN_INDEX];
251 
252 	tb_hlist = rcu_dereference_rtnl(hlist_first_rcu(ptr));
253 
254 	return hlist_entry(tb_hlist, struct fib_table, tb_hlist);
255 }
256 
257 static inline struct fib_table *fib_new_table(struct net *net, u32 id)
258 {
259 	return fib_get_table(net, id);
260 }
261 
262 static inline int fib_lookup(struct net *net, const struct flowi4 *flp,
263 			     struct fib_result *res, unsigned int flags)
264 {
265 	struct fib_table *tb;
266 	int err = -ENETUNREACH;
267 
268 	rcu_read_lock();
269 
270 	tb = fib_get_table(net, RT_TABLE_MAIN);
271 	if (tb)
272 		err = fib_table_lookup(tb, flp, res, flags | FIB_LOOKUP_NOREF);
273 
274 	if (err == -EAGAIN)
275 		err = -ENETUNREACH;
276 
277 	rcu_read_unlock();
278 
279 	return err;
280 }
281 
282 static inline bool fib4_rule_default(const struct fib_rule *rule)
283 {
284 	return true;
285 }
286 
287 static inline int fib4_rules_dump(struct net *net, struct notifier_block *nb)
288 {
289 	return 0;
290 }
291 
292 static inline unsigned int fib4_rules_seq_read(struct net *net)
293 {
294 	return 0;
295 }
296 
297 #else /* CONFIG_IP_MULTIPLE_TABLES */
298 int __net_init fib4_rules_init(struct net *net);
299 void __net_exit fib4_rules_exit(struct net *net);
300 
301 struct fib_table *fib_new_table(struct net *net, u32 id);
302 struct fib_table *fib_get_table(struct net *net, u32 id);
303 
304 int __fib_lookup(struct net *net, struct flowi4 *flp,
305 		 struct fib_result *res, unsigned int flags);
306 
307 static inline int fib_lookup(struct net *net, struct flowi4 *flp,
308 			     struct fib_result *res, unsigned int flags)
309 {
310 	struct fib_table *tb;
311 	int err = -ENETUNREACH;
312 
313 	flags |= FIB_LOOKUP_NOREF;
314 	if (net->ipv4.fib_has_custom_rules)
315 		return __fib_lookup(net, flp, res, flags);
316 
317 	rcu_read_lock();
318 
319 	res->tclassid = 0;
320 
321 	tb = rcu_dereference_rtnl(net->ipv4.fib_main);
322 	if (tb)
323 		err = fib_table_lookup(tb, flp, res, flags);
324 
325 	if (!err)
326 		goto out;
327 
328 	tb = rcu_dereference_rtnl(net->ipv4.fib_default);
329 	if (tb)
330 		err = fib_table_lookup(tb, flp, res, flags);
331 
332 out:
333 	if (err == -EAGAIN)
334 		err = -ENETUNREACH;
335 
336 	rcu_read_unlock();
337 
338 	return err;
339 }
340 
341 bool fib4_rule_default(const struct fib_rule *rule);
342 int fib4_rules_dump(struct net *net, struct notifier_block *nb);
343 unsigned int fib4_rules_seq_read(struct net *net);
344 
345 #endif /* CONFIG_IP_MULTIPLE_TABLES */
346 
347 /* Exported by fib_frontend.c */
348 extern const struct nla_policy rtm_ipv4_policy[];
349 void ip_fib_init(void);
350 __be32 fib_compute_spec_dst(struct sk_buff *skb);
351 int fib_validate_source(struct sk_buff *skb, __be32 src, __be32 dst,
352 			u8 tos, int oif, struct net_device *dev,
353 			struct in_device *idev, u32 *itag);
354 #ifdef CONFIG_IP_ROUTE_CLASSID
355 static inline int fib_num_tclassid_users(struct net *net)
356 {
357 	return net->ipv4.fib_num_tclassid_users;
358 }
359 #else
360 static inline int fib_num_tclassid_users(struct net *net)
361 {
362 	return 0;
363 }
364 #endif
365 int fib_unmerge(struct net *net);
366 
367 /* Exported by fib_semantics.c */
368 int ip_fib_check_default(__be32 gw, struct net_device *dev);
369 int fib_sync_down_dev(struct net_device *dev, unsigned long event, bool force);
370 int fib_sync_down_addr(struct net_device *dev, __be32 local);
371 int fib_sync_up(struct net_device *dev, unsigned int nh_flags);
372 
373 #ifdef CONFIG_IP_ROUTE_MULTIPATH
374 int fib_multipath_hash(const struct fib_info *fi, const struct flowi4 *fl4,
375 		       const struct sk_buff *skb);
376 #endif
377 void fib_select_multipath(struct fib_result *res, int hash);
378 void fib_select_path(struct net *net, struct fib_result *res,
379 		     struct flowi4 *fl4, const struct sk_buff *skb);
380 
381 /* Exported by fib_trie.c */
382 void fib_trie_init(void);
383 struct fib_table *fib_trie_table(u32 id, struct fib_table *alias);
384 
385 static inline void fib_combine_itag(u32 *itag, const struct fib_result *res)
386 {
387 #ifdef CONFIG_IP_ROUTE_CLASSID
388 #ifdef CONFIG_IP_MULTIPLE_TABLES
389 	u32 rtag;
390 #endif
391 	*itag = FIB_RES_NH(*res).nh_tclassid<<16;
392 #ifdef CONFIG_IP_MULTIPLE_TABLES
393 	rtag = res->tclassid;
394 	if (*itag == 0)
395 		*itag = (rtag<<16);
396 	*itag |= (rtag>>16);
397 #endif
398 #endif
399 }
400 
401 void free_fib_info(struct fib_info *fi);
402 
403 static inline void fib_info_hold(struct fib_info *fi)
404 {
405 	refcount_inc(&fi->fib_clntref);
406 }
407 
408 static inline void fib_info_put(struct fib_info *fi)
409 {
410 	if (refcount_dec_and_test(&fi->fib_clntref))
411 		free_fib_info(fi);
412 }
413 
414 #ifdef CONFIG_PROC_FS
415 int __net_init fib_proc_init(struct net *net);
416 void __net_exit fib_proc_exit(struct net *net);
417 #else
418 static inline int fib_proc_init(struct net *net)
419 {
420 	return 0;
421 }
422 static inline void fib_proc_exit(struct net *net)
423 {
424 }
425 #endif
426 
427 #endif  /* _NET_FIB_H */
428