xref: /openbmc/linux/include/net/devlink.h (revision 256ac037)
1 /*
2  * include/net/devlink.h - Network physical device Netlink interface
3  * Copyright (c) 2016 Mellanox Technologies. All rights reserved.
4  * Copyright (c) 2016 Jiri Pirko <jiri@mellanox.com>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  */
11 #ifndef _NET_DEVLINK_H_
12 #define _NET_DEVLINK_H_
13 
14 #include <linux/device.h>
15 #include <linux/slab.h>
16 #include <linux/gfp.h>
17 #include <linux/list.h>
18 #include <linux/netdevice.h>
19 #include <net/net_namespace.h>
20 #include <uapi/linux/devlink.h>
21 
22 struct devlink_ops;
23 
24 struct devlink {
25 	struct list_head list;
26 	struct list_head port_list;
27 	struct list_head sb_list;
28 	struct list_head dpipe_table_list;
29 	struct devlink_dpipe_headers *dpipe_headers;
30 	const struct devlink_ops *ops;
31 	struct device *dev;
32 	possible_net_t _net;
33 	char priv[0] __aligned(NETDEV_ALIGN);
34 };
35 
36 struct devlink_port {
37 	struct list_head list;
38 	struct devlink *devlink;
39 	unsigned index;
40 	bool registered;
41 	enum devlink_port_type type;
42 	enum devlink_port_type desired_type;
43 	void *type_dev;
44 	bool split;
45 	u32 split_group;
46 };
47 
48 struct devlink_sb_pool_info {
49 	enum devlink_sb_pool_type pool_type;
50 	u32 size;
51 	enum devlink_sb_threshold_type threshold_type;
52 };
53 
54 /**
55  * struct devlink_dpipe_field - dpipe field object
56  * @name: field name
57  * @id: index inside the headers field array
58  * @bitwidth: bitwidth
59  * @mapping_type: mapping type
60  */
61 struct devlink_dpipe_field {
62 	const char *name;
63 	unsigned int id;
64 	unsigned int bitwidth;
65 	enum devlink_dpipe_field_mapping_type mapping_type;
66 };
67 
68 /**
69  * struct devlink_dpipe_header - dpipe header object
70  * @name: header name
71  * @id: index, global/local detrmined by global bit
72  * @fields: fields
73  * @fields_count: number of fields
74  * @global: indicates if header is shared like most protocol header
75  *	    or driver specific
76  */
77 struct devlink_dpipe_header {
78 	const char *name;
79 	unsigned int id;
80 	struct devlink_dpipe_field *fields;
81 	unsigned int fields_count;
82 	bool global;
83 };
84 
85 /**
86  * struct devlink_dpipe_match - represents match operation
87  * @type: type of match
88  * @header_index: header index (packets can have several headers of same
89  *		  type like in case of tunnels)
90  * @header: header
91  * @fieled_id: field index
92  */
93 struct devlink_dpipe_match {
94 	enum devlink_dpipe_match_type type;
95 	unsigned int header_index;
96 	struct devlink_dpipe_header *header;
97 	unsigned int field_id;
98 };
99 
100 /**
101  * struct devlink_dpipe_action - represents action operation
102  * @type: type of action
103  * @header_index: header index (packets can have several headers of same
104  *		  type like in case of tunnels)
105  * @header: header
106  * @fieled_id: field index
107  */
108 struct devlink_dpipe_action {
109 	enum devlink_dpipe_action_type type;
110 	unsigned int header_index;
111 	struct devlink_dpipe_header *header;
112 	unsigned int field_id;
113 };
114 
115 /**
116  * struct devlink_dpipe_value - represents value of match/action
117  * @action: action
118  * @match: match
119  * @mapping_value: in case the field has some mapping this value
120  *                 specified the mapping value
121  * @mapping_valid: specify if mapping value is valid
122  * @value_size: value size
123  * @value: value
124  * @mask: bit mask
125  */
126 struct devlink_dpipe_value {
127 	union {
128 		struct devlink_dpipe_action *action;
129 		struct devlink_dpipe_match *match;
130 	};
131 	unsigned int mapping_value;
132 	bool mapping_valid;
133 	unsigned int value_size;
134 	void *value;
135 	void *mask;
136 };
137 
138 /**
139  * struct devlink_dpipe_entry - table entry object
140  * @index: index of the entry in the table
141  * @match_values: match values
142  * @matche_values_count: count of matches tuples
143  * @action_values: actions values
144  * @action_values_count: count of actions values
145  * @counter: value of counter
146  * @counter_valid: Specify if value is valid from hardware
147  */
148 struct devlink_dpipe_entry {
149 	u64 index;
150 	struct devlink_dpipe_value *match_values;
151 	unsigned int match_values_count;
152 	struct devlink_dpipe_value *action_values;
153 	unsigned int action_values_count;
154 	u64 counter;
155 	bool counter_valid;
156 };
157 
158 /**
159  * struct devlink_dpipe_dump_ctx - context provided to driver in order
160  *				   to dump
161  * @info: info
162  * @cmd: devlink command
163  * @skb: skb
164  * @nest: top attribute
165  * @hdr: hdr
166  */
167 struct devlink_dpipe_dump_ctx {
168 	struct genl_info *info;
169 	enum devlink_command cmd;
170 	struct sk_buff *skb;
171 	struct nlattr *nest;
172 	void *hdr;
173 };
174 
175 struct devlink_dpipe_table_ops;
176 
177 /**
178  * struct devlink_dpipe_table - table object
179  * @priv: private
180  * @name: table name
181  * @size: maximum number of entries
182  * @counters_enabled: indicates if counters are active
183  * @counter_control_extern: indicates if counter control is in dpipe or
184  *			    external tool
185  * @table_ops: table operations
186  * @rcu: rcu
187  */
188 struct devlink_dpipe_table {
189 	void *priv;
190 	struct list_head list;
191 	const char *name;
192 	u64 size;
193 	bool counters_enabled;
194 	bool counter_control_extern;
195 	struct devlink_dpipe_table_ops *table_ops;
196 	struct rcu_head rcu;
197 };
198 
199 /**
200  * struct devlink_dpipe_table_ops - dpipe_table ops
201  * @actions_dump - dumps all tables actions
202  * @matches_dump - dumps all tables matches
203  * @entries_dump - dumps all active entries in the table
204  * @counters_set_update - when changing the counter status hardware sync
205  *			  maybe needed to allocate/free counter related
206  *			  resources
207  */
208 struct devlink_dpipe_table_ops {
209 	int (*actions_dump)(void *priv, struct sk_buff *skb);
210 	int (*matches_dump)(void *priv, struct sk_buff *skb);
211 	int (*entries_dump)(void *priv, bool counters_enabled,
212 			    struct devlink_dpipe_dump_ctx *dump_ctx);
213 	int (*counters_set_update)(void *priv, bool enable);
214 };
215 
216 /**
217  * struct devlink_dpipe_headers - dpipe headers
218  * @headers - header array can be shared (global bit) or driver specific
219  * @headers_count - count of headers
220  */
221 struct devlink_dpipe_headers {
222 	struct devlink_dpipe_header **headers;
223 	unsigned int headers_count;
224 };
225 
226 struct devlink_ops {
227 	int (*port_type_set)(struct devlink_port *devlink_port,
228 			     enum devlink_port_type port_type);
229 	int (*port_split)(struct devlink *devlink, unsigned int port_index,
230 			  unsigned int count);
231 	int (*port_unsplit)(struct devlink *devlink, unsigned int port_index);
232 	int (*sb_pool_get)(struct devlink *devlink, unsigned int sb_index,
233 			   u16 pool_index,
234 			   struct devlink_sb_pool_info *pool_info);
235 	int (*sb_pool_set)(struct devlink *devlink, unsigned int sb_index,
236 			   u16 pool_index, u32 size,
237 			   enum devlink_sb_threshold_type threshold_type);
238 	int (*sb_port_pool_get)(struct devlink_port *devlink_port,
239 				unsigned int sb_index, u16 pool_index,
240 				u32 *p_threshold);
241 	int (*sb_port_pool_set)(struct devlink_port *devlink_port,
242 				unsigned int sb_index, u16 pool_index,
243 				u32 threshold);
244 	int (*sb_tc_pool_bind_get)(struct devlink_port *devlink_port,
245 				   unsigned int sb_index,
246 				   u16 tc_index,
247 				   enum devlink_sb_pool_type pool_type,
248 				   u16 *p_pool_index, u32 *p_threshold);
249 	int (*sb_tc_pool_bind_set)(struct devlink_port *devlink_port,
250 				   unsigned int sb_index,
251 				   u16 tc_index,
252 				   enum devlink_sb_pool_type pool_type,
253 				   u16 pool_index, u32 threshold);
254 	int (*sb_occ_snapshot)(struct devlink *devlink,
255 			       unsigned int sb_index);
256 	int (*sb_occ_max_clear)(struct devlink *devlink,
257 				unsigned int sb_index);
258 	int (*sb_occ_port_pool_get)(struct devlink_port *devlink_port,
259 				    unsigned int sb_index, u16 pool_index,
260 				    u32 *p_cur, u32 *p_max);
261 	int (*sb_occ_tc_port_bind_get)(struct devlink_port *devlink_port,
262 				       unsigned int sb_index,
263 				       u16 tc_index,
264 				       enum devlink_sb_pool_type pool_type,
265 				       u32 *p_cur, u32 *p_max);
266 
267 	int (*eswitch_mode_get)(struct devlink *devlink, u16 *p_mode);
268 	int (*eswitch_mode_set)(struct devlink *devlink, u16 mode);
269 	int (*eswitch_inline_mode_get)(struct devlink *devlink, u8 *p_inline_mode);
270 	int (*eswitch_inline_mode_set)(struct devlink *devlink, u8 inline_mode);
271 	int (*eswitch_encap_mode_get)(struct devlink *devlink, u8 *p_encap_mode);
272 	int (*eswitch_encap_mode_set)(struct devlink *devlink, u8 encap_mode);
273 };
274 
275 static inline void *devlink_priv(struct devlink *devlink)
276 {
277 	BUG_ON(!devlink);
278 	return &devlink->priv;
279 }
280 
281 static inline struct devlink *priv_to_devlink(void *priv)
282 {
283 	BUG_ON(!priv);
284 	return container_of(priv, struct devlink, priv);
285 }
286 
287 struct ib_device;
288 
289 #if IS_ENABLED(CONFIG_NET_DEVLINK)
290 
291 struct devlink *devlink_alloc(const struct devlink_ops *ops, size_t priv_size);
292 int devlink_register(struct devlink *devlink, struct device *dev);
293 void devlink_unregister(struct devlink *devlink);
294 void devlink_free(struct devlink *devlink);
295 int devlink_port_register(struct devlink *devlink,
296 			  struct devlink_port *devlink_port,
297 			  unsigned int port_index);
298 void devlink_port_unregister(struct devlink_port *devlink_port);
299 void devlink_port_type_eth_set(struct devlink_port *devlink_port,
300 			       struct net_device *netdev);
301 void devlink_port_type_ib_set(struct devlink_port *devlink_port,
302 			      struct ib_device *ibdev);
303 void devlink_port_type_clear(struct devlink_port *devlink_port);
304 void devlink_port_split_set(struct devlink_port *devlink_port,
305 			    u32 split_group);
306 int devlink_sb_register(struct devlink *devlink, unsigned int sb_index,
307 			u32 size, u16 ingress_pools_count,
308 			u16 egress_pools_count, u16 ingress_tc_count,
309 			u16 egress_tc_count);
310 void devlink_sb_unregister(struct devlink *devlink, unsigned int sb_index);
311 int devlink_dpipe_table_register(struct devlink *devlink,
312 				 const char *table_name,
313 				 struct devlink_dpipe_table_ops *table_ops,
314 				 void *priv, u64 size,
315 				 bool counter_control_extern);
316 void devlink_dpipe_table_unregister(struct devlink *devlink,
317 				    const char *table_name);
318 int devlink_dpipe_headers_register(struct devlink *devlink,
319 				   struct devlink_dpipe_headers *dpipe_headers);
320 void devlink_dpipe_headers_unregister(struct devlink *devlink);
321 bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
322 					 const char *table_name);
323 int devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx);
324 int devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
325 				   struct devlink_dpipe_entry *entry);
326 int devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx);
327 int devlink_dpipe_action_put(struct sk_buff *skb,
328 			     struct devlink_dpipe_action *action);
329 int devlink_dpipe_match_put(struct sk_buff *skb,
330 			    struct devlink_dpipe_match *match);
331 
332 #else
333 
334 static inline struct devlink *devlink_alloc(const struct devlink_ops *ops,
335 					    size_t priv_size)
336 {
337 	return kzalloc(sizeof(struct devlink) + priv_size, GFP_KERNEL);
338 }
339 
340 static inline int devlink_register(struct devlink *devlink, struct device *dev)
341 {
342 	return 0;
343 }
344 
345 static inline void devlink_unregister(struct devlink *devlink)
346 {
347 }
348 
349 static inline void devlink_free(struct devlink *devlink)
350 {
351 	kfree(devlink);
352 }
353 
354 static inline int devlink_port_register(struct devlink *devlink,
355 					struct devlink_port *devlink_port,
356 					unsigned int port_index)
357 {
358 	return 0;
359 }
360 
361 static inline void devlink_port_unregister(struct devlink_port *devlink_port)
362 {
363 }
364 
365 static inline void devlink_port_type_eth_set(struct devlink_port *devlink_port,
366 					     struct net_device *netdev)
367 {
368 }
369 
370 static inline void devlink_port_type_ib_set(struct devlink_port *devlink_port,
371 					    struct ib_device *ibdev)
372 {
373 }
374 
375 static inline void devlink_port_type_clear(struct devlink_port *devlink_port)
376 {
377 }
378 
379 static inline void devlink_port_split_set(struct devlink_port *devlink_port,
380 					  u32 split_group)
381 {
382 }
383 
384 static inline int devlink_sb_register(struct devlink *devlink,
385 				      unsigned int sb_index, u32 size,
386 				      u16 ingress_pools_count,
387 				      u16 egress_pools_count,
388 				      u16 ingress_tc_count,
389 				      u16 egress_tc_count)
390 {
391 	return 0;
392 }
393 
394 static inline void devlink_sb_unregister(struct devlink *devlink,
395 					 unsigned int sb_index)
396 {
397 }
398 
399 static inline int
400 devlink_dpipe_table_register(struct devlink *devlink,
401 			     const char *table_name,
402 			     struct devlink_dpipe_table_ops *table_ops,
403 			     void *priv, u64 size,
404 			     bool counter_control_extern)
405 {
406 	return 0;
407 }
408 
409 static inline void devlink_dpipe_table_unregister(struct devlink *devlink,
410 						  const char *table_name)
411 {
412 }
413 
414 static inline int devlink_dpipe_headers_register(struct devlink *devlink,
415 						 struct devlink_dpipe_headers *
416 						 dpipe_headers)
417 {
418 	return 0;
419 }
420 
421 static inline void devlink_dpipe_headers_unregister(struct devlink *devlink)
422 {
423 }
424 
425 static inline bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
426 						       const char *table_name)
427 {
428 	return false;
429 }
430 
431 static inline int
432 devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx)
433 {
434 	return 0;
435 }
436 
437 static inline int
438 devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
439 			       struct devlink_dpipe_entry *entry)
440 {
441 	return 0;
442 }
443 
444 static inline int
445 devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx)
446 {
447 	return 0;
448 }
449 
450 static inline int
451 devlink_dpipe_action_put(struct sk_buff *skb,
452 			 struct devlink_dpipe_action *action)
453 {
454 	return 0;
455 }
456 
457 static inline int
458 devlink_dpipe_match_put(struct sk_buff *skb,
459 			struct devlink_dpipe_match *match)
460 {
461 	return 0;
462 }
463 
464 #endif
465 
466 #endif /* _NET_DEVLINK_H_ */
467