Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
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 <jiri@mellanox.com>
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
20enum 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
115enum 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
122enum 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
140enum 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
147enum devlink_eswitch_mode {
148 DEVLINK_ESWITCH_MODE_LEGACY,
149 DEVLINK_ESWITCH_MODE_SWITCHDEV,
150};
151
152enum 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
159enum devlink_eswitch_encap_mode {
160 DEVLINK_ESWITCH_ENCAP_MODE_NONE,
161 DEVLINK_ESWITCH_ENCAP_MODE_BASIC,
162};
163
164enum 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
182enum 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
192enum devlink_param_fw_load_policy_value {
193 DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_DRIVER,
194 DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_FLASH,
195};
196
197enum 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 */
360enum 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 */
366enum devlink_dpipe_match_type {
367 DEVLINK_DPIPE_MATCH_TYPE_FIELD_EXACT,
368};
369
370/* Action type - specify the action type */
371enum devlink_dpipe_action_type {
372 DEVLINK_DPIPE_ACTION_TYPE_FIELD_MODIFY,
373};
374
375enum devlink_dpipe_field_ethernet_id {
376 DEVLINK_DPIPE_FIELD_ETHERNET_DST_MAC,
377};
378
379enum devlink_dpipe_field_ipv4_id {
380 DEVLINK_DPIPE_FIELD_IPV4_DST_IP,
381};
382
383enum devlink_dpipe_field_ipv6_id {
384 DEVLINK_DPIPE_FIELD_IPV6_DST_IP,
385};
386
387enum devlink_dpipe_header_id {
388 DEVLINK_DPIPE_HEADER_ETHERNET,
389 DEVLINK_DPIPE_HEADER_IPV4,
390 DEVLINK_DPIPE_HEADER_IPV6,
391};
392
393enum devlink_resource_unit {
394 DEVLINK_RESOURCE_UNIT_ENTRY,
395};
396
397#endif /* _UAPI_LINUX_DEVLINK_H_ */