xref: /linux-6.15/include/uapi/linux/devlink.h (revision a1cd4e43)
1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
2 /*
3  * include/uapi/linux/devlink.h - Network physical device Netlink interface
4  * Copyright (c) 2016 Mellanox Technologies. All rights reserved.
5  * Copyright (c) 2016 Jiri Pirko <[email protected]>
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  */
12 
13 #ifndef _UAPI_LINUX_DEVLINK_H_
14 #define _UAPI_LINUX_DEVLINK_H_
15 
16 #define DEVLINK_GENL_NAME "devlink"
17 #define DEVLINK_GENL_VERSION 0x1
18 #define DEVLINK_GENL_MCGRP_CONFIG_NAME "config"
19 
20 enum devlink_command {
21 	/* don't change the order or add anything between, this is ABI! */
22 	DEVLINK_CMD_UNSPEC,
23 
24 	DEVLINK_CMD_GET,		/* can dump */
25 	DEVLINK_CMD_SET,
26 	DEVLINK_CMD_NEW,
27 	DEVLINK_CMD_DEL,
28 
29 	DEVLINK_CMD_PORT_GET,		/* can dump */
30 	DEVLINK_CMD_PORT_SET,
31 	DEVLINK_CMD_PORT_NEW,
32 	DEVLINK_CMD_PORT_DEL,
33 
34 	DEVLINK_CMD_PORT_SPLIT,
35 	DEVLINK_CMD_PORT_UNSPLIT,
36 
37 	DEVLINK_CMD_SB_GET,		/* can dump */
38 	DEVLINK_CMD_SB_SET,
39 	DEVLINK_CMD_SB_NEW,
40 	DEVLINK_CMD_SB_DEL,
41 
42 	DEVLINK_CMD_SB_POOL_GET,	/* can dump */
43 	DEVLINK_CMD_SB_POOL_SET,
44 	DEVLINK_CMD_SB_POOL_NEW,
45 	DEVLINK_CMD_SB_POOL_DEL,
46 
47 	DEVLINK_CMD_SB_PORT_POOL_GET,	/* can dump */
48 	DEVLINK_CMD_SB_PORT_POOL_SET,
49 	DEVLINK_CMD_SB_PORT_POOL_NEW,
50 	DEVLINK_CMD_SB_PORT_POOL_DEL,
51 
52 	DEVLINK_CMD_SB_TC_POOL_BIND_GET,	/* can dump */
53 	DEVLINK_CMD_SB_TC_POOL_BIND_SET,
54 	DEVLINK_CMD_SB_TC_POOL_BIND_NEW,
55 	DEVLINK_CMD_SB_TC_POOL_BIND_DEL,
56 
57 	/* Shared buffer occupancy monitoring commands */
58 	DEVLINK_CMD_SB_OCC_SNAPSHOT,
59 	DEVLINK_CMD_SB_OCC_MAX_CLEAR,
60 
61 	DEVLINK_CMD_ESWITCH_GET,
62 #define DEVLINK_CMD_ESWITCH_MODE_GET /* obsolete, never use this! */ \
63 	DEVLINK_CMD_ESWITCH_GET
64 
65 	DEVLINK_CMD_ESWITCH_SET,
66 #define DEVLINK_CMD_ESWITCH_MODE_SET /* obsolete, never use this! */ \
67 	DEVLINK_CMD_ESWITCH_SET
68 
69 	DEVLINK_CMD_DPIPE_TABLE_GET,
70 	DEVLINK_CMD_DPIPE_ENTRIES_GET,
71 	DEVLINK_CMD_DPIPE_HEADERS_GET,
72 	DEVLINK_CMD_DPIPE_TABLE_COUNTERS_SET,
73 	DEVLINK_CMD_RESOURCE_SET,
74 	DEVLINK_CMD_RESOURCE_DUMP,
75 
76 	/* Hot driver reload, makes configuration changes take place. The
77 	 * devlink instance is not released during the process.
78 	 */
79 	DEVLINK_CMD_RELOAD,
80 
81 	DEVLINK_CMD_PARAM_GET,		/* can dump */
82 	DEVLINK_CMD_PARAM_SET,
83 	DEVLINK_CMD_PARAM_NEW,
84 	DEVLINK_CMD_PARAM_DEL,
85 
86 	DEVLINK_CMD_REGION_GET,
87 	DEVLINK_CMD_REGION_SET,
88 	DEVLINK_CMD_REGION_NEW,
89 	DEVLINK_CMD_REGION_DEL,
90 	DEVLINK_CMD_REGION_READ,
91 
92 	DEVLINK_CMD_PORT_PARAM_GET,	/* can dump */
93 	DEVLINK_CMD_PORT_PARAM_SET,
94 	DEVLINK_CMD_PORT_PARAM_NEW,
95 	DEVLINK_CMD_PORT_PARAM_DEL,
96 
97 	DEVLINK_CMD_INFO_GET,		/* can dump */
98 
99 	DEVLINK_CMD_HEALTH_REPORTER_GET,
100 	DEVLINK_CMD_HEALTH_REPORTER_SET,
101 	DEVLINK_CMD_HEALTH_REPORTER_RECOVER,
102 	DEVLINK_CMD_HEALTH_REPORTER_DIAGNOSE,
103 	DEVLINK_CMD_HEALTH_REPORTER_DUMP_GET,
104 	DEVLINK_CMD_HEALTH_REPORTER_DUMP_CLEAR,
105 
106 	DEVLINK_CMD_FLASH_UPDATE,
107 	DEVLINK_CMD_FLASH_UPDATE_END,		/* notification only */
108 	DEVLINK_CMD_FLASH_UPDATE_STATUS,	/* notification only */
109 
110 	/* add new commands above here */
111 	__DEVLINK_CMD_MAX,
112 	DEVLINK_CMD_MAX = __DEVLINK_CMD_MAX - 1
113 };
114 
115 enum devlink_port_type {
116 	DEVLINK_PORT_TYPE_NOTSET,
117 	DEVLINK_PORT_TYPE_AUTO,
118 	DEVLINK_PORT_TYPE_ETH,
119 	DEVLINK_PORT_TYPE_IB,
120 };
121 
122 enum devlink_sb_pool_type {
123 	DEVLINK_SB_POOL_TYPE_INGRESS,
124 	DEVLINK_SB_POOL_TYPE_EGRESS,
125 };
126 
127 /* static threshold - limiting the maximum number of bytes.
128  * dynamic threshold - limiting the maximum number of bytes
129  *   based on the currently available free space in the shared buffer pool.
130  *   In this mode, the maximum quota is calculated based
131  *   on the following formula:
132  *     max_quota = alpha / (1 + alpha) * Free_Buffer
133  *   While Free_Buffer is the amount of none-occupied buffer associated to
134  *   the relevant pool.
135  *   The value range which can be passed is 0-20 and serves
136  *   for computation of alpha by following formula:
137  *     alpha = 2 ^ (passed_value - 10)
138  */
139 
140 enum devlink_sb_threshold_type {
141 	DEVLINK_SB_THRESHOLD_TYPE_STATIC,
142 	DEVLINK_SB_THRESHOLD_TYPE_DYNAMIC,
143 };
144 
145 #define DEVLINK_SB_THRESHOLD_TO_ALPHA_MAX 20
146 
147 enum devlink_eswitch_mode {
148 	DEVLINK_ESWITCH_MODE_LEGACY,
149 	DEVLINK_ESWITCH_MODE_SWITCHDEV,
150 };
151 
152 enum devlink_eswitch_inline_mode {
153 	DEVLINK_ESWITCH_INLINE_MODE_NONE,
154 	DEVLINK_ESWITCH_INLINE_MODE_LINK,
155 	DEVLINK_ESWITCH_INLINE_MODE_NETWORK,
156 	DEVLINK_ESWITCH_INLINE_MODE_TRANSPORT,
157 };
158 
159 enum devlink_eswitch_encap_mode {
160 	DEVLINK_ESWITCH_ENCAP_MODE_NONE,
161 	DEVLINK_ESWITCH_ENCAP_MODE_BASIC,
162 };
163 
164 enum devlink_port_flavour {
165 	DEVLINK_PORT_FLAVOUR_PHYSICAL, /* Any kind of a port physically
166 					* facing the user.
167 					*/
168 	DEVLINK_PORT_FLAVOUR_CPU, /* CPU port */
169 	DEVLINK_PORT_FLAVOUR_DSA, /* Distributed switch architecture
170 				   * interconnect port.
171 				   */
172 	DEVLINK_PORT_FLAVOUR_PCI_PF, /* Represents eswitch port for
173 				      * the PCI PF. It is an internal
174 				      * port that faces the PCI PF.
175 				      */
176 	DEVLINK_PORT_FLAVOUR_PCI_VF, /* Represents eswitch port
177 				      * for the PCI VF. It is an internal
178 				      * port that faces the PCI VF.
179 				      */
180 };
181 
182 enum devlink_param_cmode {
183 	DEVLINK_PARAM_CMODE_RUNTIME,
184 	DEVLINK_PARAM_CMODE_DRIVERINIT,
185 	DEVLINK_PARAM_CMODE_PERMANENT,
186 
187 	/* Add new configuration modes above */
188 	__DEVLINK_PARAM_CMODE_MAX,
189 	DEVLINK_PARAM_CMODE_MAX = __DEVLINK_PARAM_CMODE_MAX - 1
190 };
191 
192 enum devlink_param_fw_load_policy_value {
193 	DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_DRIVER,
194 	DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_FLASH,
195 };
196 
197 enum devlink_attr {
198 	/* don't change the order or add anything between, this is ABI! */
199 	DEVLINK_ATTR_UNSPEC,
200 
201 	/* bus name + dev name together are a handle for devlink entity */
202 	DEVLINK_ATTR_BUS_NAME,			/* string */
203 	DEVLINK_ATTR_DEV_NAME,			/* string */
204 
205 	DEVLINK_ATTR_PORT_INDEX,		/* u32 */
206 	DEVLINK_ATTR_PORT_TYPE,			/* u16 */
207 	DEVLINK_ATTR_PORT_DESIRED_TYPE,		/* u16 */
208 	DEVLINK_ATTR_PORT_NETDEV_IFINDEX,	/* u32 */
209 	DEVLINK_ATTR_PORT_NETDEV_NAME,		/* string */
210 	DEVLINK_ATTR_PORT_IBDEV_NAME,		/* string */
211 	DEVLINK_ATTR_PORT_SPLIT_COUNT,		/* u32 */
212 	DEVLINK_ATTR_PORT_SPLIT_GROUP,		/* u32 */
213 	DEVLINK_ATTR_SB_INDEX,			/* u32 */
214 	DEVLINK_ATTR_SB_SIZE,			/* u32 */
215 	DEVLINK_ATTR_SB_INGRESS_POOL_COUNT,	/* u16 */
216 	DEVLINK_ATTR_SB_EGRESS_POOL_COUNT,	/* u16 */
217 	DEVLINK_ATTR_SB_INGRESS_TC_COUNT,	/* u16 */
218 	DEVLINK_ATTR_SB_EGRESS_TC_COUNT,	/* u16 */
219 	DEVLINK_ATTR_SB_POOL_INDEX,		/* u16 */
220 	DEVLINK_ATTR_SB_POOL_TYPE,		/* u8 */
221 	DEVLINK_ATTR_SB_POOL_SIZE,		/* u32 */
222 	DEVLINK_ATTR_SB_POOL_THRESHOLD_TYPE,	/* u8 */
223 	DEVLINK_ATTR_SB_THRESHOLD,		/* u32 */
224 	DEVLINK_ATTR_SB_TC_INDEX,		/* u16 */
225 	DEVLINK_ATTR_SB_OCC_CUR,		/* u32 */
226 	DEVLINK_ATTR_SB_OCC_MAX,		/* u32 */
227 	DEVLINK_ATTR_ESWITCH_MODE,		/* u16 */
228 	DEVLINK_ATTR_ESWITCH_INLINE_MODE,	/* u8 */
229 
230 	DEVLINK_ATTR_DPIPE_TABLES,		/* nested */
231 	DEVLINK_ATTR_DPIPE_TABLE,		/* nested */
232 	DEVLINK_ATTR_DPIPE_TABLE_NAME,		/* string */
233 	DEVLINK_ATTR_DPIPE_TABLE_SIZE,		/* u64 */
234 	DEVLINK_ATTR_DPIPE_TABLE_MATCHES,	/* nested */
235 	DEVLINK_ATTR_DPIPE_TABLE_ACTIONS,	/* nested */
236 	DEVLINK_ATTR_DPIPE_TABLE_COUNTERS_ENABLED,	/* u8 */
237 
238 	DEVLINK_ATTR_DPIPE_ENTRIES,		/* nested */
239 	DEVLINK_ATTR_DPIPE_ENTRY,		/* nested */
240 	DEVLINK_ATTR_DPIPE_ENTRY_INDEX,		/* u64 */
241 	DEVLINK_ATTR_DPIPE_ENTRY_MATCH_VALUES,	/* nested */
242 	DEVLINK_ATTR_DPIPE_ENTRY_ACTION_VALUES,	/* nested */
243 	DEVLINK_ATTR_DPIPE_ENTRY_COUNTER,	/* u64 */
244 
245 	DEVLINK_ATTR_DPIPE_MATCH,		/* nested */
246 	DEVLINK_ATTR_DPIPE_MATCH_VALUE,		/* nested */
247 	DEVLINK_ATTR_DPIPE_MATCH_TYPE,		/* u32 */
248 
249 	DEVLINK_ATTR_DPIPE_ACTION,		/* nested */
250 	DEVLINK_ATTR_DPIPE_ACTION_VALUE,	/* nested */
251 	DEVLINK_ATTR_DPIPE_ACTION_TYPE,		/* u32 */
252 
253 	DEVLINK_ATTR_DPIPE_VALUE,
254 	DEVLINK_ATTR_DPIPE_VALUE_MASK,
255 	DEVLINK_ATTR_DPIPE_VALUE_MAPPING,	/* u32 */
256 
257 	DEVLINK_ATTR_DPIPE_HEADERS,		/* nested */
258 	DEVLINK_ATTR_DPIPE_HEADER,		/* nested */
259 	DEVLINK_ATTR_DPIPE_HEADER_NAME,		/* string */
260 	DEVLINK_ATTR_DPIPE_HEADER_ID,		/* u32 */
261 	DEVLINK_ATTR_DPIPE_HEADER_FIELDS,	/* nested */
262 	DEVLINK_ATTR_DPIPE_HEADER_GLOBAL,	/* u8 */
263 	DEVLINK_ATTR_DPIPE_HEADER_INDEX,	/* u32 */
264 
265 	DEVLINK_ATTR_DPIPE_FIELD,		/* nested */
266 	DEVLINK_ATTR_DPIPE_FIELD_NAME,		/* string */
267 	DEVLINK_ATTR_DPIPE_FIELD_ID,		/* u32 */
268 	DEVLINK_ATTR_DPIPE_FIELD_BITWIDTH,	/* u32 */
269 	DEVLINK_ATTR_DPIPE_FIELD_MAPPING_TYPE,	/* u32 */
270 
271 	DEVLINK_ATTR_PAD,
272 
273 	DEVLINK_ATTR_ESWITCH_ENCAP_MODE,	/* u8 */
274 	DEVLINK_ATTR_RESOURCE_LIST,		/* nested */
275 	DEVLINK_ATTR_RESOURCE,			/* nested */
276 	DEVLINK_ATTR_RESOURCE_NAME,		/* string */
277 	DEVLINK_ATTR_RESOURCE_ID,		/* u64 */
278 	DEVLINK_ATTR_RESOURCE_SIZE,		/* u64 */
279 	DEVLINK_ATTR_RESOURCE_SIZE_NEW,		/* u64 */
280 	DEVLINK_ATTR_RESOURCE_SIZE_VALID,	/* u8 */
281 	DEVLINK_ATTR_RESOURCE_SIZE_MIN,		/* u64 */
282 	DEVLINK_ATTR_RESOURCE_SIZE_MAX,		/* u64 */
283 	DEVLINK_ATTR_RESOURCE_SIZE_GRAN,        /* u64 */
284 	DEVLINK_ATTR_RESOURCE_UNIT,		/* u8 */
285 	DEVLINK_ATTR_RESOURCE_OCC,		/* u64 */
286 	DEVLINK_ATTR_DPIPE_TABLE_RESOURCE_ID,	/* u64 */
287 	DEVLINK_ATTR_DPIPE_TABLE_RESOURCE_UNITS,/* u64 */
288 
289 	DEVLINK_ATTR_PORT_FLAVOUR,		/* u16 */
290 	DEVLINK_ATTR_PORT_NUMBER,		/* u32 */
291 	DEVLINK_ATTR_PORT_SPLIT_SUBPORT_NUMBER,	/* u32 */
292 
293 	DEVLINK_ATTR_PARAM,			/* nested */
294 	DEVLINK_ATTR_PARAM_NAME,		/* string */
295 	DEVLINK_ATTR_PARAM_GENERIC,		/* flag */
296 	DEVLINK_ATTR_PARAM_TYPE,		/* u8 */
297 	DEVLINK_ATTR_PARAM_VALUES_LIST,		/* nested */
298 	DEVLINK_ATTR_PARAM_VALUE,		/* nested */
299 	DEVLINK_ATTR_PARAM_VALUE_DATA,		/* dynamic */
300 	DEVLINK_ATTR_PARAM_VALUE_CMODE,		/* u8 */
301 
302 	DEVLINK_ATTR_REGION_NAME,               /* string */
303 	DEVLINK_ATTR_REGION_SIZE,               /* u64 */
304 	DEVLINK_ATTR_REGION_SNAPSHOTS,          /* nested */
305 	DEVLINK_ATTR_REGION_SNAPSHOT,           /* nested */
306 	DEVLINK_ATTR_REGION_SNAPSHOT_ID,        /* u32 */
307 
308 	DEVLINK_ATTR_REGION_CHUNKS,             /* nested */
309 	DEVLINK_ATTR_REGION_CHUNK,              /* nested */
310 	DEVLINK_ATTR_REGION_CHUNK_DATA,         /* binary */
311 	DEVLINK_ATTR_REGION_CHUNK_ADDR,         /* u64 */
312 	DEVLINK_ATTR_REGION_CHUNK_LEN,          /* u64 */
313 
314 	DEVLINK_ATTR_INFO_DRIVER_NAME,		/* string */
315 	DEVLINK_ATTR_INFO_SERIAL_NUMBER,	/* string */
316 	DEVLINK_ATTR_INFO_VERSION_FIXED,	/* nested */
317 	DEVLINK_ATTR_INFO_VERSION_RUNNING,	/* nested */
318 	DEVLINK_ATTR_INFO_VERSION_STORED,	/* nested */
319 	DEVLINK_ATTR_INFO_VERSION_NAME,		/* string */
320 	DEVLINK_ATTR_INFO_VERSION_VALUE,	/* string */
321 
322 	DEVLINK_ATTR_SB_POOL_CELL_SIZE,		/* u32 */
323 
324 	DEVLINK_ATTR_FMSG,			/* nested */
325 	DEVLINK_ATTR_FMSG_OBJ_NEST_START,	/* flag */
326 	DEVLINK_ATTR_FMSG_PAIR_NEST_START,	/* flag */
327 	DEVLINK_ATTR_FMSG_ARR_NEST_START,	/* flag */
328 	DEVLINK_ATTR_FMSG_NEST_END,		/* flag */
329 	DEVLINK_ATTR_FMSG_OBJ_NAME,		/* string */
330 	DEVLINK_ATTR_FMSG_OBJ_VALUE_TYPE,	/* u8 */
331 	DEVLINK_ATTR_FMSG_OBJ_VALUE_DATA,	/* dynamic */
332 
333 	DEVLINK_ATTR_HEALTH_REPORTER,			/* nested */
334 	DEVLINK_ATTR_HEALTH_REPORTER_NAME,		/* string */
335 	DEVLINK_ATTR_HEALTH_REPORTER_STATE,		/* u8 */
336 	DEVLINK_ATTR_HEALTH_REPORTER_ERR_COUNT,		/* u64 */
337 	DEVLINK_ATTR_HEALTH_REPORTER_RECOVER_COUNT,	/* u64 */
338 	DEVLINK_ATTR_HEALTH_REPORTER_DUMP_TS,		/* u64 */
339 	DEVLINK_ATTR_HEALTH_REPORTER_GRACEFUL_PERIOD,	/* u64 */
340 	DEVLINK_ATTR_HEALTH_REPORTER_AUTO_RECOVER,	/* u8 */
341 
342 	DEVLINK_ATTR_FLASH_UPDATE_FILE_NAME,	/* string */
343 	DEVLINK_ATTR_FLASH_UPDATE_COMPONENT,	/* string */
344 	DEVLINK_ATTR_FLASH_UPDATE_STATUS_MSG,	/* string */
345 	DEVLINK_ATTR_FLASH_UPDATE_STATUS_DONE,	/* u64 */
346 	DEVLINK_ATTR_FLASH_UPDATE_STATUS_TOTAL,	/* u64 */
347 
348 	DEVLINK_ATTR_PORT_PCI_PF_NUMBER,	/* u16 */
349 	DEVLINK_ATTR_PORT_PCI_VF_NUMBER,	/* u16 */
350 
351 	/* add new attributes above here, update the policy in devlink.c */
352 
353 	__DEVLINK_ATTR_MAX,
354 	DEVLINK_ATTR_MAX = __DEVLINK_ATTR_MAX - 1
355 };
356 
357 /* Mapping between internal resource described by the field and system
358  * structure
359  */
360 enum devlink_dpipe_field_mapping_type {
361 	DEVLINK_DPIPE_FIELD_MAPPING_TYPE_NONE,
362 	DEVLINK_DPIPE_FIELD_MAPPING_TYPE_IFINDEX,
363 };
364 
365 /* Match type - specify the type of the match */
366 enum devlink_dpipe_match_type {
367 	DEVLINK_DPIPE_MATCH_TYPE_FIELD_EXACT,
368 };
369 
370 /* Action type - specify the action type */
371 enum devlink_dpipe_action_type {
372 	DEVLINK_DPIPE_ACTION_TYPE_FIELD_MODIFY,
373 };
374 
375 enum devlink_dpipe_field_ethernet_id {
376 	DEVLINK_DPIPE_FIELD_ETHERNET_DST_MAC,
377 };
378 
379 enum devlink_dpipe_field_ipv4_id {
380 	DEVLINK_DPIPE_FIELD_IPV4_DST_IP,
381 };
382 
383 enum devlink_dpipe_field_ipv6_id {
384 	DEVLINK_DPIPE_FIELD_IPV6_DST_IP,
385 };
386 
387 enum devlink_dpipe_header_id {
388 	DEVLINK_DPIPE_HEADER_ETHERNET,
389 	DEVLINK_DPIPE_HEADER_IPV4,
390 	DEVLINK_DPIPE_HEADER_IPV6,
391 };
392 
393 enum devlink_resource_unit {
394 	DEVLINK_RESOURCE_UNIT_ENTRY,
395 };
396 
397 #endif /* _UAPI_LINUX_DEVLINK_H_ */
398