xref: /openbmc/linux/include/net/devlink.h (revision 4f139972b489f8bc2c821aa25ac65018d92af3f7)
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 };
272 
273 static inline void *devlink_priv(struct devlink *devlink)
274 {
275 	BUG_ON(!devlink);
276 	return &devlink->priv;
277 }
278 
279 static inline struct devlink *priv_to_devlink(void *priv)
280 {
281 	BUG_ON(!priv);
282 	return container_of(priv, struct devlink, priv);
283 }
284 
285 struct ib_device;
286 
287 #if IS_ENABLED(CONFIG_NET_DEVLINK)
288 
289 struct devlink *devlink_alloc(const struct devlink_ops *ops, size_t priv_size);
290 int devlink_register(struct devlink *devlink, struct device *dev);
291 void devlink_unregister(struct devlink *devlink);
292 void devlink_free(struct devlink *devlink);
293 int devlink_port_register(struct devlink *devlink,
294 			  struct devlink_port *devlink_port,
295 			  unsigned int port_index);
296 void devlink_port_unregister(struct devlink_port *devlink_port);
297 void devlink_port_type_eth_set(struct devlink_port *devlink_port,
298 			       struct net_device *netdev);
299 void devlink_port_type_ib_set(struct devlink_port *devlink_port,
300 			      struct ib_device *ibdev);
301 void devlink_port_type_clear(struct devlink_port *devlink_port);
302 void devlink_port_split_set(struct devlink_port *devlink_port,
303 			    u32 split_group);
304 int devlink_sb_register(struct devlink *devlink, unsigned int sb_index,
305 			u32 size, u16 ingress_pools_count,
306 			u16 egress_pools_count, u16 ingress_tc_count,
307 			u16 egress_tc_count);
308 void devlink_sb_unregister(struct devlink *devlink, unsigned int sb_index);
309 int devlink_dpipe_table_register(struct devlink *devlink,
310 				 const char *table_name,
311 				 struct devlink_dpipe_table_ops *table_ops,
312 				 void *priv, u64 size,
313 				 bool counter_control_extern);
314 void devlink_dpipe_table_unregister(struct devlink *devlink,
315 				    const char *table_name);
316 int devlink_dpipe_headers_register(struct devlink *devlink,
317 				   struct devlink_dpipe_headers *dpipe_headers);
318 void devlink_dpipe_headers_unregister(struct devlink *devlink);
319 bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
320 					 const char *table_name);
321 int devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx);
322 int devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
323 				   struct devlink_dpipe_entry *entry);
324 int devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx);
325 int devlink_dpipe_action_put(struct sk_buff *skb,
326 			     struct devlink_dpipe_action *action);
327 int devlink_dpipe_match_put(struct sk_buff *skb,
328 			    struct devlink_dpipe_match *match);
329 
330 #else
331 
332 static inline struct devlink *devlink_alloc(const struct devlink_ops *ops,
333 					    size_t priv_size)
334 {
335 	return kzalloc(sizeof(struct devlink) + priv_size, GFP_KERNEL);
336 }
337 
338 static inline int devlink_register(struct devlink *devlink, struct device *dev)
339 {
340 	return 0;
341 }
342 
343 static inline void devlink_unregister(struct devlink *devlink)
344 {
345 }
346 
347 static inline void devlink_free(struct devlink *devlink)
348 {
349 	kfree(devlink);
350 }
351 
352 static inline int devlink_port_register(struct devlink *devlink,
353 					struct devlink_port *devlink_port,
354 					unsigned int port_index)
355 {
356 	return 0;
357 }
358 
359 static inline void devlink_port_unregister(struct devlink_port *devlink_port)
360 {
361 }
362 
363 static inline void devlink_port_type_eth_set(struct devlink_port *devlink_port,
364 					     struct net_device *netdev)
365 {
366 }
367 
368 static inline void devlink_port_type_ib_set(struct devlink_port *devlink_port,
369 					    struct ib_device *ibdev)
370 {
371 }
372 
373 static inline void devlink_port_type_clear(struct devlink_port *devlink_port)
374 {
375 }
376 
377 static inline void devlink_port_split_set(struct devlink_port *devlink_port,
378 					  u32 split_group)
379 {
380 }
381 
382 static inline int devlink_sb_register(struct devlink *devlink,
383 				      unsigned int sb_index, u32 size,
384 				      u16 ingress_pools_count,
385 				      u16 egress_pools_count,
386 				      u16 ingress_tc_count,
387 				      u16 egress_tc_count)
388 {
389 	return 0;
390 }
391 
392 static inline void devlink_sb_unregister(struct devlink *devlink,
393 					 unsigned int sb_index)
394 {
395 }
396 
397 static inline int
398 devlink_dpipe_table_register(struct devlink *devlink,
399 			     const char *table_name,
400 			     struct devlink_dpipe_table_ops *table_ops,
401 			     void *priv, u64 size,
402 			     bool counter_control_extern)
403 {
404 	return 0;
405 }
406 
407 static inline void devlink_dpipe_table_unregister(struct devlink *devlink,
408 						  const char *table_name)
409 {
410 }
411 
412 static inline int devlink_dpipe_headers_register(struct devlink *devlink,
413 						 struct devlink_dpipe_headers *
414 						 dpipe_headers)
415 {
416 	return 0;
417 }
418 
419 static inline void devlink_dpipe_headers_unregister(struct devlink *devlink)
420 {
421 }
422 
423 static inline bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
424 						       const char *table_name)
425 {
426 	return false;
427 }
428 
429 static inline int
430 devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx)
431 {
432 	return 0;
433 }
434 
435 static inline int
436 devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
437 			       struct devlink_dpipe_entry *entry)
438 {
439 	return 0;
440 }
441 
442 static inline int
443 devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx)
444 {
445 	return 0;
446 }
447 
448 static inline int
449 devlink_dpipe_action_put(struct sk_buff *skb,
450 			 struct devlink_dpipe_action *action)
451 {
452 	return 0;
453 }
454 
455 static inline int
456 devlink_dpipe_match_put(struct sk_buff *skb,
457 			struct devlink_dpipe_match *match)
458 {
459 	return 0;
460 }
461 
462 #endif
463 
464 #endif /* _NET_DEVLINK_H_ */
465