1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * include/net/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>
7 #ifndef _NET_DEVLINK_H_
8 #define _NET_DEVLINK_H_
10 #include <linux/device.h>
11 #include <linux/slab.h>
12 #include <linux/gfp.h>
13 #include <linux/list.h>
14 #include <linux/netdevice.h>
15 #include <linux/spinlock.h>
16 #include <linux/workqueue.h>
17 #include <linux/refcount.h>
18 #include <net/net_namespace.h>
19 #include <uapi/linux/devlink.h>
24 struct list_head list;
25 struct list_head port_list;
26 struct list_head sb_list;
27 struct list_head dpipe_table_list;
28 struct list_head resource_list;
29 struct list_head param_list;
30 struct list_head region_list;
32 struct list_head reporter_list;
33 struct mutex reporters_lock; /* protects reporter_list */
34 struct devlink_dpipe_headers *dpipe_headers;
35 struct list_head trap_list;
36 struct list_head trap_group_list;
37 const struct devlink_ops *ops;
43 char priv[0] __aligned(NETDEV_ALIGN);
46 struct devlink_port_phys_attrs {
47 u32 port_number; /* Same value as "split group".
48 * A physical port which is visible to the user
49 * for a given port flavour.
51 u32 split_subport_number;
54 struct devlink_port_pci_pf_attrs {
55 u16 pf; /* Associated PCI PF for this port. */
58 struct devlink_port_pci_vf_attrs {
59 u16 pf; /* Associated PCI PF for this port. */
60 u16 vf; /* Associated PCI VF for of the PCI PF for this port. */
63 struct devlink_port_attrs {
67 enum devlink_port_flavour flavour;
68 struct netdev_phys_item_id switch_id;
70 struct devlink_port_phys_attrs phys;
71 struct devlink_port_pci_pf_attrs pci_pf;
72 struct devlink_port_pci_vf_attrs pci_vf;
77 struct list_head list;
78 struct list_head param_list;
79 struct devlink *devlink;
82 spinlock_t type_lock; /* Protects type and type_dev
83 * pointer consistency.
85 enum devlink_port_type type;
86 enum devlink_port_type desired_type;
88 struct devlink_port_attrs attrs;
89 struct delayed_work type_warn_dw;
92 struct devlink_sb_pool_info {
93 enum devlink_sb_pool_type pool_type;
95 enum devlink_sb_threshold_type threshold_type;
100 * struct devlink_dpipe_field - dpipe field object
102 * @id: index inside the headers field array
103 * @bitwidth: bitwidth
104 * @mapping_type: mapping type
106 struct devlink_dpipe_field {
109 unsigned int bitwidth;
110 enum devlink_dpipe_field_mapping_type mapping_type;
114 * struct devlink_dpipe_header - dpipe header object
116 * @id: index, global/local detrmined by global bit
118 * @fields_count: number of fields
119 * @global: indicates if header is shared like most protocol header
122 struct devlink_dpipe_header {
125 struct devlink_dpipe_field *fields;
126 unsigned int fields_count;
131 * struct devlink_dpipe_match - represents match operation
132 * @type: type of match
133 * @header_index: header index (packets can have several headers of same
134 * type like in case of tunnels)
136 * @fieled_id: field index
138 struct devlink_dpipe_match {
139 enum devlink_dpipe_match_type type;
140 unsigned int header_index;
141 struct devlink_dpipe_header *header;
142 unsigned int field_id;
146 * struct devlink_dpipe_action - represents action operation
147 * @type: type of action
148 * @header_index: header index (packets can have several headers of same
149 * type like in case of tunnels)
151 * @fieled_id: field index
153 struct devlink_dpipe_action {
154 enum devlink_dpipe_action_type type;
155 unsigned int header_index;
156 struct devlink_dpipe_header *header;
157 unsigned int field_id;
161 * struct devlink_dpipe_value - represents value of match/action
164 * @mapping_value: in case the field has some mapping this value
165 * specified the mapping value
166 * @mapping_valid: specify if mapping value is valid
167 * @value_size: value size
171 struct devlink_dpipe_value {
173 struct devlink_dpipe_action *action;
174 struct devlink_dpipe_match *match;
176 unsigned int mapping_value;
178 unsigned int value_size;
184 * struct devlink_dpipe_entry - table entry object
185 * @index: index of the entry in the table
186 * @match_values: match values
187 * @matche_values_count: count of matches tuples
188 * @action_values: actions values
189 * @action_values_count: count of actions values
190 * @counter: value of counter
191 * @counter_valid: Specify if value is valid from hardware
193 struct devlink_dpipe_entry {
195 struct devlink_dpipe_value *match_values;
196 unsigned int match_values_count;
197 struct devlink_dpipe_value *action_values;
198 unsigned int action_values_count;
204 * struct devlink_dpipe_dump_ctx - context provided to driver in order
207 * @cmd: devlink command
209 * @nest: top attribute
212 struct devlink_dpipe_dump_ctx {
213 struct genl_info *info;
214 enum devlink_command cmd;
220 struct devlink_dpipe_table_ops;
223 * struct devlink_dpipe_table - table object
226 * @counters_enabled: indicates if counters are active
227 * @counter_control_extern: indicates if counter control is in dpipe or
229 * @resource_valid: Indicate that the resource id is valid
230 * @resource_id: relative resource this table is related to
231 * @resource_units: number of resource's unit consumed per table's entry
232 * @table_ops: table operations
235 struct devlink_dpipe_table {
237 struct list_head list;
239 bool counters_enabled;
240 bool counter_control_extern;
244 struct devlink_dpipe_table_ops *table_ops;
249 * struct devlink_dpipe_table_ops - dpipe_table ops
250 * @actions_dump - dumps all tables actions
251 * @matches_dump - dumps all tables matches
252 * @entries_dump - dumps all active entries in the table
253 * @counters_set_update - when changing the counter status hardware sync
254 * maybe needed to allocate/free counter related
256 * @size_get - get size
258 struct devlink_dpipe_table_ops {
259 int (*actions_dump)(void *priv, struct sk_buff *skb);
260 int (*matches_dump)(void *priv, struct sk_buff *skb);
261 int (*entries_dump)(void *priv, bool counters_enabled,
262 struct devlink_dpipe_dump_ctx *dump_ctx);
263 int (*counters_set_update)(void *priv, bool enable);
264 u64 (*size_get)(void *priv);
268 * struct devlink_dpipe_headers - dpipe headers
269 * @headers - header array can be shared (global bit) or driver specific
270 * @headers_count - count of headers
272 struct devlink_dpipe_headers {
273 struct devlink_dpipe_header **headers;
274 unsigned int headers_count;
278 * struct devlink_resource_size_params - resource's size parameters
279 * @size_min: minimum size which can be set
280 * @size_max: maximum size which can be set
281 * @size_granularity: size granularity
282 * @size_unit: resource's basic unit
284 struct devlink_resource_size_params {
287 u64 size_granularity;
288 enum devlink_resource_unit unit;
292 devlink_resource_size_params_init(struct devlink_resource_size_params *size_params,
293 u64 size_min, u64 size_max,
294 u64 size_granularity,
295 enum devlink_resource_unit unit)
297 size_params->size_min = size_min;
298 size_params->size_max = size_max;
299 size_params->size_granularity = size_granularity;
300 size_params->unit = unit;
303 typedef u64 devlink_resource_occ_get_t(void *priv);
306 * struct devlink_resource - devlink resource
307 * @name: name of the resource
308 * @id: id, per devlink instance
309 * @size: size of the resource
310 * @size_new: updated size of the resource, reload is needed
311 * @size_valid: valid in case the total size of the resource is valid
312 * including its children
313 * @parent: parent resource
314 * @size_params: size parameters
316 * @resource_list: list of child resources
318 struct devlink_resource {
324 struct devlink_resource *parent;
325 struct devlink_resource_size_params size_params;
326 struct list_head list;
327 struct list_head resource_list;
328 devlink_resource_occ_get_t *occ_get;
332 #define DEVLINK_RESOURCE_ID_PARENT_TOP 0
334 #define __DEVLINK_PARAM_MAX_STRING_VALUE 32
335 enum devlink_param_type {
336 DEVLINK_PARAM_TYPE_U8,
337 DEVLINK_PARAM_TYPE_U16,
338 DEVLINK_PARAM_TYPE_U32,
339 DEVLINK_PARAM_TYPE_STRING,
340 DEVLINK_PARAM_TYPE_BOOL,
343 union devlink_param_value {
347 char vstr[__DEVLINK_PARAM_MAX_STRING_VALUE];
351 struct devlink_param_gset_ctx {
352 union devlink_param_value val;
353 enum devlink_param_cmode cmode;
357 * struct devlink_param - devlink configuration parameter data
358 * @name: name of the parameter
359 * @generic: indicates if the parameter is generic or driver specific
360 * @type: parameter type
361 * @supported_cmodes: bitmap of supported configuration modes
362 * @get: get parameter value, used for runtime and permanent
363 * configuration modes
364 * @set: set parameter value, used for runtime and permanent
365 * configuration modes
366 * @validate: validate input value is applicable (within value range, etc.)
368 * This struct should be used by the driver to fill the data for
369 * a parameter it registers.
371 struct devlink_param {
375 enum devlink_param_type type;
376 unsigned long supported_cmodes;
377 int (*get)(struct devlink *devlink, u32 id,
378 struct devlink_param_gset_ctx *ctx);
379 int (*set)(struct devlink *devlink, u32 id,
380 struct devlink_param_gset_ctx *ctx);
381 int (*validate)(struct devlink *devlink, u32 id,
382 union devlink_param_value val,
383 struct netlink_ext_ack *extack);
386 struct devlink_param_item {
387 struct list_head list;
388 const struct devlink_param *param;
389 union devlink_param_value driverinit_value;
390 bool driverinit_value_valid;
394 enum devlink_param_generic_id {
395 DEVLINK_PARAM_GENERIC_ID_INT_ERR_RESET,
396 DEVLINK_PARAM_GENERIC_ID_MAX_MACS,
397 DEVLINK_PARAM_GENERIC_ID_ENABLE_SRIOV,
398 DEVLINK_PARAM_GENERIC_ID_REGION_SNAPSHOT,
399 DEVLINK_PARAM_GENERIC_ID_IGNORE_ARI,
400 DEVLINK_PARAM_GENERIC_ID_MSIX_VEC_PER_PF_MAX,
401 DEVLINK_PARAM_GENERIC_ID_MSIX_VEC_PER_PF_MIN,
402 DEVLINK_PARAM_GENERIC_ID_FW_LOAD_POLICY,
403 DEVLINK_PARAM_GENERIC_ID_RESET_DEV_ON_DRV_PROBE,
405 /* add new param generic ids above here*/
406 __DEVLINK_PARAM_GENERIC_ID_MAX,
407 DEVLINK_PARAM_GENERIC_ID_MAX = __DEVLINK_PARAM_GENERIC_ID_MAX - 1,
410 #define DEVLINK_PARAM_GENERIC_INT_ERR_RESET_NAME "internal_error_reset"
411 #define DEVLINK_PARAM_GENERIC_INT_ERR_RESET_TYPE DEVLINK_PARAM_TYPE_BOOL
413 #define DEVLINK_PARAM_GENERIC_MAX_MACS_NAME "max_macs"
414 #define DEVLINK_PARAM_GENERIC_MAX_MACS_TYPE DEVLINK_PARAM_TYPE_U32
416 #define DEVLINK_PARAM_GENERIC_ENABLE_SRIOV_NAME "enable_sriov"
417 #define DEVLINK_PARAM_GENERIC_ENABLE_SRIOV_TYPE DEVLINK_PARAM_TYPE_BOOL
419 #define DEVLINK_PARAM_GENERIC_REGION_SNAPSHOT_NAME "region_snapshot_enable"
420 #define DEVLINK_PARAM_GENERIC_REGION_SNAPSHOT_TYPE DEVLINK_PARAM_TYPE_BOOL
422 #define DEVLINK_PARAM_GENERIC_IGNORE_ARI_NAME "ignore_ari"
423 #define DEVLINK_PARAM_GENERIC_IGNORE_ARI_TYPE DEVLINK_PARAM_TYPE_BOOL
425 #define DEVLINK_PARAM_GENERIC_MSIX_VEC_PER_PF_MAX_NAME "msix_vec_per_pf_max"
426 #define DEVLINK_PARAM_GENERIC_MSIX_VEC_PER_PF_MAX_TYPE DEVLINK_PARAM_TYPE_U32
428 #define DEVLINK_PARAM_GENERIC_MSIX_VEC_PER_PF_MIN_NAME "msix_vec_per_pf_min"
429 #define DEVLINK_PARAM_GENERIC_MSIX_VEC_PER_PF_MIN_TYPE DEVLINK_PARAM_TYPE_U32
431 #define DEVLINK_PARAM_GENERIC_FW_LOAD_POLICY_NAME "fw_load_policy"
432 #define DEVLINK_PARAM_GENERIC_FW_LOAD_POLICY_TYPE DEVLINK_PARAM_TYPE_U8
434 #define DEVLINK_PARAM_GENERIC_RESET_DEV_ON_DRV_PROBE_NAME \
435 "reset_dev_on_drv_probe"
436 #define DEVLINK_PARAM_GENERIC_RESET_DEV_ON_DRV_PROBE_TYPE DEVLINK_PARAM_TYPE_U8
438 #define DEVLINK_PARAM_GENERIC(_id, _cmodes, _get, _set, _validate) \
440 .id = DEVLINK_PARAM_GENERIC_ID_##_id, \
441 .name = DEVLINK_PARAM_GENERIC_##_id##_NAME, \
442 .type = DEVLINK_PARAM_GENERIC_##_id##_TYPE, \
444 .supported_cmodes = _cmodes, \
447 .validate = _validate, \
450 #define DEVLINK_PARAM_DRIVER(_id, _name, _type, _cmodes, _get, _set, _validate) \
455 .supported_cmodes = _cmodes, \
458 .validate = _validate, \
461 /* Part number, identifier of board design */
462 #define DEVLINK_INFO_VERSION_GENERIC_BOARD_ID "board.id"
463 /* Revision of board design */
464 #define DEVLINK_INFO_VERSION_GENERIC_BOARD_REV "board.rev"
465 /* Maker of the board */
466 #define DEVLINK_INFO_VERSION_GENERIC_BOARD_MANUFACTURE "board.manufacture"
468 /* Part number, identifier of asic design */
469 #define DEVLINK_INFO_VERSION_GENERIC_ASIC_ID "asic.id"
470 /* Revision of asic design */
471 #define DEVLINK_INFO_VERSION_GENERIC_ASIC_REV "asic.rev"
473 /* Overall FW version */
474 #define DEVLINK_INFO_VERSION_GENERIC_FW "fw"
475 /* Control processor FW version */
476 #define DEVLINK_INFO_VERSION_GENERIC_FW_MGMT "fw.mgmt"
477 /* Data path microcode controlling high-speed packet processing */
478 #define DEVLINK_INFO_VERSION_GENERIC_FW_APP "fw.app"
479 /* UNDI software version */
480 #define DEVLINK_INFO_VERSION_GENERIC_FW_UNDI "fw.undi"
481 /* NCSI support/handler version */
482 #define DEVLINK_INFO_VERSION_GENERIC_FW_NCSI "fw.ncsi"
484 struct devlink_region;
485 struct devlink_info_req;
487 typedef void devlink_snapshot_data_dest_t(const void *data);
490 struct devlink_health_reporter;
492 enum devlink_health_reporter_state {
493 DEVLINK_HEALTH_REPORTER_STATE_HEALTHY,
494 DEVLINK_HEALTH_REPORTER_STATE_ERROR,
498 * struct devlink_health_reporter_ops - Reporter operations
499 * @name: reporter name
500 * @recover: callback to recover from reported error
501 * if priv_ctx is NULL, run a full recover
502 * @dump: callback to dump an object
503 * if priv_ctx is NULL, run a full dump
504 * @diagnose: callback to diagnose the current status
507 struct devlink_health_reporter_ops {
509 int (*recover)(struct devlink_health_reporter *reporter,
510 void *priv_ctx, struct netlink_ext_ack *extack);
511 int (*dump)(struct devlink_health_reporter *reporter,
512 struct devlink_fmsg *fmsg, void *priv_ctx,
513 struct netlink_ext_ack *extack);
514 int (*diagnose)(struct devlink_health_reporter *reporter,
515 struct devlink_fmsg *fmsg,
516 struct netlink_ext_ack *extack);
520 * struct devlink_trap_group - Immutable packet trap group attributes.
521 * @name: Trap group name.
522 * @id: Trap group identifier.
523 * @generic: Whether the trap group is generic or not.
525 * Describes immutable attributes of packet trap groups that drivers register
528 struct devlink_trap_group {
534 #define DEVLINK_TRAP_METADATA_TYPE_F_IN_PORT BIT(0)
537 * struct devlink_trap - Immutable packet trap attributes.
539 * @init_action: Initial trap action.
540 * @generic: Whether the trap is generic or not.
541 * @id: Trap identifier.
543 * @group: Immutable packet trap group attributes.
544 * @metadata_cap: Metadata types that can be provided by the trap.
546 * Describes immutable attributes of packet traps that drivers register with
549 struct devlink_trap {
550 enum devlink_trap_type type;
551 enum devlink_trap_action init_action;
555 struct devlink_trap_group group;
559 /* All traps must be documented in
560 * Documentation/networking/devlink-trap.rst
562 enum devlink_trap_generic_id {
563 DEVLINK_TRAP_GENERIC_ID_SMAC_MC,
564 DEVLINK_TRAP_GENERIC_ID_VLAN_TAG_MISMATCH,
565 DEVLINK_TRAP_GENERIC_ID_INGRESS_VLAN_FILTER,
566 DEVLINK_TRAP_GENERIC_ID_INGRESS_STP_FILTER,
567 DEVLINK_TRAP_GENERIC_ID_EMPTY_TX_LIST,
568 DEVLINK_TRAP_GENERIC_ID_PORT_LOOPBACK_FILTER,
569 DEVLINK_TRAP_GENERIC_ID_BLACKHOLE_ROUTE,
570 DEVLINK_TRAP_GENERIC_ID_TTL_ERROR,
571 DEVLINK_TRAP_GENERIC_ID_TAIL_DROP,
573 /* Add new generic trap IDs above */
574 __DEVLINK_TRAP_GENERIC_ID_MAX,
575 DEVLINK_TRAP_GENERIC_ID_MAX = __DEVLINK_TRAP_GENERIC_ID_MAX - 1,
578 /* All trap groups must be documented in
579 * Documentation/networking/devlink-trap.rst
581 enum devlink_trap_group_generic_id {
582 DEVLINK_TRAP_GROUP_GENERIC_ID_L2_DROPS,
583 DEVLINK_TRAP_GROUP_GENERIC_ID_L3_DROPS,
584 DEVLINK_TRAP_GROUP_GENERIC_ID_BUFFER_DROPS,
586 /* Add new generic trap group IDs above */
587 __DEVLINK_TRAP_GROUP_GENERIC_ID_MAX,
588 DEVLINK_TRAP_GROUP_GENERIC_ID_MAX =
589 __DEVLINK_TRAP_GROUP_GENERIC_ID_MAX - 1,
592 #define DEVLINK_TRAP_GENERIC_NAME_SMAC_MC \
593 "source_mac_is_multicast"
594 #define DEVLINK_TRAP_GENERIC_NAME_VLAN_TAG_MISMATCH \
596 #define DEVLINK_TRAP_GENERIC_NAME_INGRESS_VLAN_FILTER \
597 "ingress_vlan_filter"
598 #define DEVLINK_TRAP_GENERIC_NAME_INGRESS_STP_FILTER \
599 "ingress_spanning_tree_filter"
600 #define DEVLINK_TRAP_GENERIC_NAME_EMPTY_TX_LIST \
602 #define DEVLINK_TRAP_GENERIC_NAME_PORT_LOOPBACK_FILTER \
603 "port_loopback_filter"
604 #define DEVLINK_TRAP_GENERIC_NAME_BLACKHOLE_ROUTE \
606 #define DEVLINK_TRAP_GENERIC_NAME_TTL_ERROR \
607 "ttl_value_is_too_small"
608 #define DEVLINK_TRAP_GENERIC_NAME_TAIL_DROP \
611 #define DEVLINK_TRAP_GROUP_GENERIC_NAME_L2_DROPS \
613 #define DEVLINK_TRAP_GROUP_GENERIC_NAME_L3_DROPS \
615 #define DEVLINK_TRAP_GROUP_GENERIC_NAME_BUFFER_DROPS \
618 #define DEVLINK_TRAP_GENERIC(_type, _init_action, _id, _group, _metadata_cap) \
620 .type = DEVLINK_TRAP_TYPE_##_type, \
621 .init_action = DEVLINK_TRAP_ACTION_##_init_action, \
623 .id = DEVLINK_TRAP_GENERIC_ID_##_id, \
624 .name = DEVLINK_TRAP_GENERIC_NAME_##_id, \
626 .metadata_cap = _metadata_cap, \
629 #define DEVLINK_TRAP_DRIVER(_type, _init_action, _id, _name, _group, \
632 .type = DEVLINK_TRAP_TYPE_##_type, \
633 .init_action = DEVLINK_TRAP_ACTION_##_init_action, \
638 .metadata_cap = _metadata_cap, \
641 #define DEVLINK_TRAP_GROUP_GENERIC(_id) \
643 .name = DEVLINK_TRAP_GROUP_GENERIC_NAME_##_id, \
644 .id = DEVLINK_TRAP_GROUP_GENERIC_ID_##_id, \
649 int (*reload_down)(struct devlink *devlink, bool netns_change,
650 struct netlink_ext_ack *extack);
651 int (*reload_up)(struct devlink *devlink,
652 struct netlink_ext_ack *extack);
653 int (*port_type_set)(struct devlink_port *devlink_port,
654 enum devlink_port_type port_type);
655 int (*port_split)(struct devlink *devlink, unsigned int port_index,
656 unsigned int count, struct netlink_ext_ack *extack);
657 int (*port_unsplit)(struct devlink *devlink, unsigned int port_index,
658 struct netlink_ext_ack *extack);
659 int (*sb_pool_get)(struct devlink *devlink, unsigned int sb_index,
661 struct devlink_sb_pool_info *pool_info);
662 int (*sb_pool_set)(struct devlink *devlink, unsigned int sb_index,
663 u16 pool_index, u32 size,
664 enum devlink_sb_threshold_type threshold_type,
665 struct netlink_ext_ack *extack);
666 int (*sb_port_pool_get)(struct devlink_port *devlink_port,
667 unsigned int sb_index, u16 pool_index,
669 int (*sb_port_pool_set)(struct devlink_port *devlink_port,
670 unsigned int sb_index, u16 pool_index,
671 u32 threshold, struct netlink_ext_ack *extack);
672 int (*sb_tc_pool_bind_get)(struct devlink_port *devlink_port,
673 unsigned int sb_index,
675 enum devlink_sb_pool_type pool_type,
676 u16 *p_pool_index, u32 *p_threshold);
677 int (*sb_tc_pool_bind_set)(struct devlink_port *devlink_port,
678 unsigned int sb_index,
680 enum devlink_sb_pool_type pool_type,
681 u16 pool_index, u32 threshold,
682 struct netlink_ext_ack *extack);
683 int (*sb_occ_snapshot)(struct devlink *devlink,
684 unsigned int sb_index);
685 int (*sb_occ_max_clear)(struct devlink *devlink,
686 unsigned int sb_index);
687 int (*sb_occ_port_pool_get)(struct devlink_port *devlink_port,
688 unsigned int sb_index, u16 pool_index,
689 u32 *p_cur, u32 *p_max);
690 int (*sb_occ_tc_port_bind_get)(struct devlink_port *devlink_port,
691 unsigned int sb_index,
693 enum devlink_sb_pool_type pool_type,
694 u32 *p_cur, u32 *p_max);
696 int (*eswitch_mode_get)(struct devlink *devlink, u16 *p_mode);
697 int (*eswitch_mode_set)(struct devlink *devlink, u16 mode,
698 struct netlink_ext_ack *extack);
699 int (*eswitch_inline_mode_get)(struct devlink *devlink, u8 *p_inline_mode);
700 int (*eswitch_inline_mode_set)(struct devlink *devlink, u8 inline_mode,
701 struct netlink_ext_ack *extack);
702 int (*eswitch_encap_mode_get)(struct devlink *devlink,
703 enum devlink_eswitch_encap_mode *p_encap_mode);
704 int (*eswitch_encap_mode_set)(struct devlink *devlink,
705 enum devlink_eswitch_encap_mode encap_mode,
706 struct netlink_ext_ack *extack);
707 int (*info_get)(struct devlink *devlink, struct devlink_info_req *req,
708 struct netlink_ext_ack *extack);
709 int (*flash_update)(struct devlink *devlink, const char *file_name,
710 const char *component,
711 struct netlink_ext_ack *extack);
713 * @trap_init: Trap initialization function.
715 * Should be used by device drivers to initialize the trap in the
716 * underlying device. Drivers should also store the provided trap
717 * context, so that they could efficiently pass it to
718 * devlink_trap_report() when the trap is triggered.
720 int (*trap_init)(struct devlink *devlink,
721 const struct devlink_trap *trap, void *trap_ctx);
723 * @trap_fini: Trap de-initialization function.
725 * Should be used by device drivers to de-initialize the trap in the
728 void (*trap_fini)(struct devlink *devlink,
729 const struct devlink_trap *trap, void *trap_ctx);
731 * @trap_action_set: Trap action set function.
733 int (*trap_action_set)(struct devlink *devlink,
734 const struct devlink_trap *trap,
735 enum devlink_trap_action action);
737 * @trap_group_init: Trap group initialization function.
739 * Should be used by device drivers to initialize the trap group in the
742 int (*trap_group_init)(struct devlink *devlink,
743 const struct devlink_trap_group *group);
746 static inline void *devlink_priv(struct devlink *devlink)
749 return &devlink->priv;
752 static inline struct devlink *priv_to_devlink(void *priv)
755 return container_of(priv, struct devlink, priv);
758 static inline struct devlink_port *
759 netdev_to_devlink_port(struct net_device *dev)
761 if (dev->netdev_ops->ndo_get_devlink_port)
762 return dev->netdev_ops->ndo_get_devlink_port(dev);
766 static inline struct devlink *netdev_to_devlink(struct net_device *dev)
768 struct devlink_port *devlink_port = netdev_to_devlink_port(dev);
771 return devlink_port->devlink;
777 struct net *devlink_net(const struct devlink *devlink);
778 void devlink_net_set(struct devlink *devlink, struct net *net);
779 struct devlink *devlink_alloc(const struct devlink_ops *ops, size_t priv_size);
780 int devlink_register(struct devlink *devlink, struct device *dev);
781 void devlink_unregister(struct devlink *devlink);
782 void devlink_free(struct devlink *devlink);
783 int devlink_port_register(struct devlink *devlink,
784 struct devlink_port *devlink_port,
785 unsigned int port_index);
786 void devlink_port_unregister(struct devlink_port *devlink_port);
787 void devlink_port_type_eth_set(struct devlink_port *devlink_port,
788 struct net_device *netdev);
789 void devlink_port_type_ib_set(struct devlink_port *devlink_port,
790 struct ib_device *ibdev);
791 void devlink_port_type_clear(struct devlink_port *devlink_port);
792 void devlink_port_attrs_set(struct devlink_port *devlink_port,
793 enum devlink_port_flavour flavour,
794 u32 port_number, bool split,
795 u32 split_subport_number,
796 const unsigned char *switch_id,
797 unsigned char switch_id_len);
798 void devlink_port_attrs_pci_pf_set(struct devlink_port *devlink_port,
799 const unsigned char *switch_id,
800 unsigned char switch_id_len, u16 pf);
801 void devlink_port_attrs_pci_vf_set(struct devlink_port *devlink_port,
802 const unsigned char *switch_id,
803 unsigned char switch_id_len,
805 int devlink_sb_register(struct devlink *devlink, unsigned int sb_index,
806 u32 size, u16 ingress_pools_count,
807 u16 egress_pools_count, u16 ingress_tc_count,
808 u16 egress_tc_count);
809 void devlink_sb_unregister(struct devlink *devlink, unsigned int sb_index);
810 int devlink_dpipe_table_register(struct devlink *devlink,
811 const char *table_name,
812 struct devlink_dpipe_table_ops *table_ops,
813 void *priv, bool counter_control_extern);
814 void devlink_dpipe_table_unregister(struct devlink *devlink,
815 const char *table_name);
816 int devlink_dpipe_headers_register(struct devlink *devlink,
817 struct devlink_dpipe_headers *dpipe_headers);
818 void devlink_dpipe_headers_unregister(struct devlink *devlink);
819 bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
820 const char *table_name);
821 int devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx);
822 int devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
823 struct devlink_dpipe_entry *entry);
824 int devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx);
825 void devlink_dpipe_entry_clear(struct devlink_dpipe_entry *entry);
826 int devlink_dpipe_action_put(struct sk_buff *skb,
827 struct devlink_dpipe_action *action);
828 int devlink_dpipe_match_put(struct sk_buff *skb,
829 struct devlink_dpipe_match *match);
830 extern struct devlink_dpipe_header devlink_dpipe_header_ethernet;
831 extern struct devlink_dpipe_header devlink_dpipe_header_ipv4;
832 extern struct devlink_dpipe_header devlink_dpipe_header_ipv6;
834 int devlink_resource_register(struct devlink *devlink,
835 const char *resource_name,
838 u64 parent_resource_id,
839 const struct devlink_resource_size_params *size_params);
840 void devlink_resources_unregister(struct devlink *devlink,
841 struct devlink_resource *resource);
842 int devlink_resource_size_get(struct devlink *devlink,
844 u64 *p_resource_size);
845 int devlink_dpipe_table_resource_set(struct devlink *devlink,
846 const char *table_name, u64 resource_id,
848 void devlink_resource_occ_get_register(struct devlink *devlink,
850 devlink_resource_occ_get_t *occ_get,
852 void devlink_resource_occ_get_unregister(struct devlink *devlink,
854 int devlink_params_register(struct devlink *devlink,
855 const struct devlink_param *params,
856 size_t params_count);
857 void devlink_params_unregister(struct devlink *devlink,
858 const struct devlink_param *params,
859 size_t params_count);
860 void devlink_params_publish(struct devlink *devlink);
861 void devlink_params_unpublish(struct devlink *devlink);
862 int devlink_port_params_register(struct devlink_port *devlink_port,
863 const struct devlink_param *params,
864 size_t params_count);
865 void devlink_port_params_unregister(struct devlink_port *devlink_port,
866 const struct devlink_param *params,
867 size_t params_count);
868 int devlink_param_driverinit_value_get(struct devlink *devlink, u32 param_id,
869 union devlink_param_value *init_val);
870 int devlink_param_driverinit_value_set(struct devlink *devlink, u32 param_id,
871 union devlink_param_value init_val);
873 devlink_port_param_driverinit_value_get(struct devlink_port *devlink_port,
875 union devlink_param_value *init_val);
876 int devlink_port_param_driverinit_value_set(struct devlink_port *devlink_port,
878 union devlink_param_value init_val);
879 void devlink_param_value_changed(struct devlink *devlink, u32 param_id);
880 void devlink_port_param_value_changed(struct devlink_port *devlink_port,
882 void devlink_param_value_str_fill(union devlink_param_value *dst_val,
884 struct devlink_region *devlink_region_create(struct devlink *devlink,
885 const char *region_name,
886 u32 region_max_snapshots,
888 void devlink_region_destroy(struct devlink_region *region);
889 u32 devlink_region_shapshot_id_get(struct devlink *devlink);
890 int devlink_region_snapshot_create(struct devlink_region *region,
891 u8 *data, u32 snapshot_id,
892 devlink_snapshot_data_dest_t *data_destructor);
893 int devlink_info_serial_number_put(struct devlink_info_req *req,
895 int devlink_info_driver_name_put(struct devlink_info_req *req,
897 int devlink_info_version_fixed_put(struct devlink_info_req *req,
898 const char *version_name,
899 const char *version_value);
900 int devlink_info_version_stored_put(struct devlink_info_req *req,
901 const char *version_name,
902 const char *version_value);
903 int devlink_info_version_running_put(struct devlink_info_req *req,
904 const char *version_name,
905 const char *version_value);
907 int devlink_fmsg_obj_nest_start(struct devlink_fmsg *fmsg);
908 int devlink_fmsg_obj_nest_end(struct devlink_fmsg *fmsg);
910 int devlink_fmsg_pair_nest_start(struct devlink_fmsg *fmsg, const char *name);
911 int devlink_fmsg_pair_nest_end(struct devlink_fmsg *fmsg);
913 int devlink_fmsg_arr_pair_nest_start(struct devlink_fmsg *fmsg,
915 int devlink_fmsg_arr_pair_nest_end(struct devlink_fmsg *fmsg);
917 int devlink_fmsg_bool_put(struct devlink_fmsg *fmsg, bool value);
918 int devlink_fmsg_u8_put(struct devlink_fmsg *fmsg, u8 value);
919 int devlink_fmsg_u32_put(struct devlink_fmsg *fmsg, u32 value);
920 int devlink_fmsg_u64_put(struct devlink_fmsg *fmsg, u64 value);
921 int devlink_fmsg_string_put(struct devlink_fmsg *fmsg, const char *value);
922 int devlink_fmsg_binary_put(struct devlink_fmsg *fmsg, const void *value,
925 int devlink_fmsg_bool_pair_put(struct devlink_fmsg *fmsg, const char *name,
927 int devlink_fmsg_u8_pair_put(struct devlink_fmsg *fmsg, const char *name,
929 int devlink_fmsg_u32_pair_put(struct devlink_fmsg *fmsg, const char *name,
931 int devlink_fmsg_u64_pair_put(struct devlink_fmsg *fmsg, const char *name,
933 int devlink_fmsg_string_pair_put(struct devlink_fmsg *fmsg, const char *name,
935 int devlink_fmsg_binary_pair_put(struct devlink_fmsg *fmsg, const char *name,
936 const void *value, u16 value_len);
938 struct devlink_health_reporter *
939 devlink_health_reporter_create(struct devlink *devlink,
940 const struct devlink_health_reporter_ops *ops,
941 u64 graceful_period, bool auto_recover,
944 devlink_health_reporter_destroy(struct devlink_health_reporter *reporter);
947 devlink_health_reporter_priv(struct devlink_health_reporter *reporter);
948 int devlink_health_report(struct devlink_health_reporter *reporter,
949 const char *msg, void *priv_ctx);
951 devlink_health_reporter_state_update(struct devlink_health_reporter *reporter,
952 enum devlink_health_reporter_state state);
954 bool devlink_is_reload_failed(const struct devlink *devlink);
956 void devlink_flash_update_begin_notify(struct devlink *devlink);
957 void devlink_flash_update_end_notify(struct devlink *devlink);
958 void devlink_flash_update_status_notify(struct devlink *devlink,
959 const char *status_msg,
960 const char *component,
962 unsigned long total);
964 int devlink_traps_register(struct devlink *devlink,
965 const struct devlink_trap *traps,
966 size_t traps_count, void *priv);
967 void devlink_traps_unregister(struct devlink *devlink,
968 const struct devlink_trap *traps,
970 void devlink_trap_report(struct devlink *devlink,
971 struct sk_buff *skb, void *trap_ctx,
972 struct devlink_port *in_devlink_port);
973 void *devlink_trap_ctx_priv(void *trap_ctx);
975 #if IS_ENABLED(CONFIG_NET_DEVLINK)
977 void devlink_compat_running_version(struct net_device *dev,
978 char *buf, size_t len);
979 int devlink_compat_flash_update(struct net_device *dev, const char *file_name);
980 int devlink_compat_phys_port_name_get(struct net_device *dev,
981 char *name, size_t len);
982 int devlink_compat_switch_id_get(struct net_device *dev,
983 struct netdev_phys_item_id *ppid);
988 devlink_compat_running_version(struct net_device *dev, char *buf, size_t len)
993 devlink_compat_flash_update(struct net_device *dev, const char *file_name)
999 devlink_compat_phys_port_name_get(struct net_device *dev,
1000 char *name, size_t len)
1006 devlink_compat_switch_id_get(struct net_device *dev,
1007 struct netdev_phys_item_id *ppid)
1014 #endif /* _NET_DEVLINK_H_ */