Linux Audio

Check our new training course

Loading...
v5.4
   1/* SPDX-License-Identifier: GPL-2.0-or-later */
   2/*
   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>
   6 */
   7#ifndef _NET_DEVLINK_H_
   8#define _NET_DEVLINK_H_
   9
  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>
 
 
  20
  21struct devlink_ops;
  22
  23struct devlink {
  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;
  31	u32 snapshot_id;
  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;
  38	struct device *dev;
  39	possible_net_t _net;
  40	struct mutex lock;
  41	u8 reload_failed:1,
  42	   reload_enabled:1;
  43	char priv[0] __aligned(NETDEV_ALIGN);
  44};
  45
  46struct 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.
  50			  */
  51	u32 split_subport_number;
  52};
  53
 
 
 
 
 
 
  54struct devlink_port_pci_pf_attrs {
  55	u16 pf;	/* Associated PCI PF for this port. */
 
 
  56};
  57
 
 
 
 
 
 
 
  58struct 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. */
 
 
  61};
  62
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  63struct devlink_port_attrs {
  64	u8 set:1,
  65	   split:1,
  66	   switch_port:1;
  67	enum devlink_port_flavour flavour;
  68	struct netdev_phys_item_id switch_id;
  69	union {
  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;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  73	};
 
 
 
  74};
  75
  76struct devlink_port {
  77	struct list_head list;
  78	struct list_head param_list;
  79	struct devlink *devlink;
  80	unsigned int index;
  81	bool registered;
  82	spinlock_t type_lock; /* Protects type and type_dev
  83			       * pointer consistency.
  84			       */
  85	enum devlink_port_type type;
  86	enum devlink_port_type desired_type;
  87	void *type_dev;
 
 
 
 
 
 
 
 
 
  88	struct devlink_port_attrs attrs;
 
 
 
 
  89	struct delayed_work type_warn_dw;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  90};
  91
  92struct devlink_sb_pool_info {
  93	enum devlink_sb_pool_type pool_type;
  94	u32 size;
  95	enum devlink_sb_threshold_type threshold_type;
  96	u32 cell_size;
  97};
  98
  99/**
 100 * struct devlink_dpipe_field - dpipe field object
 101 * @name: field name
 102 * @id: index inside the headers field array
 103 * @bitwidth: bitwidth
 104 * @mapping_type: mapping type
 105 */
 106struct devlink_dpipe_field {
 107	const char *name;
 108	unsigned int id;
 109	unsigned int bitwidth;
 110	enum devlink_dpipe_field_mapping_type mapping_type;
 111};
 112
 113/**
 114 * struct devlink_dpipe_header - dpipe header object
 115 * @name: header name
 116 * @id: index, global/local detrmined by global bit
 117 * @fields: fields
 118 * @fields_count: number of fields
 119 * @global: indicates if header is shared like most protocol header
 120 *	    or driver specific
 121 */
 122struct devlink_dpipe_header {
 123	const char *name;
 124	unsigned int id;
 125	struct devlink_dpipe_field *fields;
 126	unsigned int fields_count;
 127	bool global;
 128};
 129
 130/**
 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)
 135 * @header: header
 136 * @fieled_id: field index
 137 */
 138struct 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;
 143};
 144
 145/**
 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)
 150 * @header: header
 151 * @fieled_id: field index
 152 */
 153struct 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;
 158};
 159
 160/**
 161 * struct devlink_dpipe_value - represents value of match/action
 162 * @action: action
 163 * @match: match
 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
 168 * @value: value
 169 * @mask: bit mask
 170 */
 171struct devlink_dpipe_value {
 172	union {
 173		struct devlink_dpipe_action *action;
 174		struct devlink_dpipe_match *match;
 175	};
 176	unsigned int mapping_value;
 177	bool mapping_valid;
 178	unsigned int value_size;
 179	void *value;
 180	void *mask;
 181};
 182
 183/**
 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
 192 */
 193struct devlink_dpipe_entry {
 194	u64 index;
 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;
 199	u64 counter;
 200	bool counter_valid;
 201};
 202
 203/**
 204 * struct devlink_dpipe_dump_ctx - context provided to driver in order
 205 *				   to dump
 206 * @info: info
 207 * @cmd: devlink command
 208 * @skb: skb
 209 * @nest: top attribute
 210 * @hdr: hdr
 211 */
 212struct devlink_dpipe_dump_ctx {
 213	struct genl_info *info;
 214	enum devlink_command cmd;
 215	struct sk_buff *skb;
 216	struct nlattr *nest;
 217	void *hdr;
 218};
 219
 220struct devlink_dpipe_table_ops;
 221
 222/**
 223 * struct devlink_dpipe_table - table object
 224 * @priv: private
 225 * @name: table name
 226 * @counters_enabled: indicates if counters are active
 227 * @counter_control_extern: indicates if counter control is in dpipe or
 228 *			    external tool
 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
 233 * @rcu: rcu
 234 */
 235struct devlink_dpipe_table {
 236	void *priv;
 237	struct list_head list;
 238	const char *name;
 239	bool counters_enabled;
 240	bool counter_control_extern;
 241	bool resource_valid;
 242	u64 resource_id;
 243	u64 resource_units;
 244	struct devlink_dpipe_table_ops *table_ops;
 245	struct rcu_head rcu;
 246};
 247
 248/**
 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
 255 *			  resources
 256 * @size_get - get size
 257 */
 258struct 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);
 265};
 266
 267/**
 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
 271 */
 272struct devlink_dpipe_headers {
 273	struct devlink_dpipe_header **headers;
 274	unsigned int headers_count;
 275};
 276
 277/**
 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
 283 */
 284struct devlink_resource_size_params {
 285	u64 size_min;
 286	u64 size_max;
 287	u64 size_granularity;
 288	enum devlink_resource_unit unit;
 289};
 290
 291static inline void
 292devlink_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)
 296{
 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;
 301}
 302
 303typedef u64 devlink_resource_occ_get_t(void *priv);
 304
 305/**
 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
 315 * @list: parent list
 316 * @resource_list: list of child resources
 317 */
 318struct devlink_resource {
 319	const char *name;
 320	u64 id;
 321	u64 size;
 322	u64 size_new;
 323	bool size_valid;
 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;
 329	void *occ_get_priv;
 330};
 331
 332#define DEVLINK_RESOURCE_ID_PARENT_TOP 0
 333
 
 
 334#define __DEVLINK_PARAM_MAX_STRING_VALUE 32
 335enum 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,
 341};
 342
 343union devlink_param_value {
 344	u8 vu8;
 345	u16 vu16;
 346	u32 vu32;
 347	char vstr[__DEVLINK_PARAM_MAX_STRING_VALUE];
 348	bool vbool;
 349};
 350
 351struct devlink_param_gset_ctx {
 352	union devlink_param_value val;
 353	enum devlink_param_cmode cmode;
 354};
 355
 356/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 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.)
 367 *
 368 * This struct should be used by the driver to fill the data for
 369 * a parameter it registers.
 370 */
 371struct devlink_param {
 372	u32 id;
 373	const char *name;
 374	bool generic;
 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);
 384};
 385
 386struct 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;
 391	bool published;
 392};
 393
 394enum 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,
 
 
 
 
 
 
 
 
 404
 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,
 408};
 409
 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
 412
 413#define DEVLINK_PARAM_GENERIC_MAX_MACS_NAME "max_macs"
 414#define DEVLINK_PARAM_GENERIC_MAX_MACS_TYPE DEVLINK_PARAM_TYPE_U32
 415
 416#define DEVLINK_PARAM_GENERIC_ENABLE_SRIOV_NAME "enable_sriov"
 417#define DEVLINK_PARAM_GENERIC_ENABLE_SRIOV_TYPE DEVLINK_PARAM_TYPE_BOOL
 418
 419#define DEVLINK_PARAM_GENERIC_REGION_SNAPSHOT_NAME "region_snapshot_enable"
 420#define DEVLINK_PARAM_GENERIC_REGION_SNAPSHOT_TYPE DEVLINK_PARAM_TYPE_BOOL
 421
 422#define DEVLINK_PARAM_GENERIC_IGNORE_ARI_NAME "ignore_ari"
 423#define DEVLINK_PARAM_GENERIC_IGNORE_ARI_TYPE DEVLINK_PARAM_TYPE_BOOL
 424
 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
 427
 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
 430
 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
 433
 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
 437
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 438#define DEVLINK_PARAM_GENERIC(_id, _cmodes, _get, _set, _validate)	\
 439{									\
 440	.id = DEVLINK_PARAM_GENERIC_ID_##_id,				\
 441	.name = DEVLINK_PARAM_GENERIC_##_id##_NAME,			\
 442	.type = DEVLINK_PARAM_GENERIC_##_id##_TYPE,			\
 443	.generic = true,						\
 444	.supported_cmodes = _cmodes,					\
 445	.get = _get,							\
 446	.set = _set,							\
 447	.validate = _validate,						\
 448}
 449
 450#define DEVLINK_PARAM_DRIVER(_id, _name, _type, _cmodes, _get, _set, _validate)	\
 451{									\
 452	.id = _id,							\
 453	.name = _name,							\
 454	.type = _type,							\
 455	.supported_cmodes = _cmodes,					\
 456	.get = _get,							\
 457	.set = _set,							\
 458	.validate = _validate,						\
 459}
 460
 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"
 467
 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"
 472
 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"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 483
 484struct devlink_region;
 485struct devlink_info_req;
 486
 487typedef void devlink_snapshot_data_dest_t(const void *data);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 488
 489struct devlink_fmsg;
 490struct devlink_health_reporter;
 491
 492enum devlink_health_reporter_state {
 493	DEVLINK_HEALTH_REPORTER_STATE_HEALTHY,
 494	DEVLINK_HEALTH_REPORTER_STATE_ERROR,
 495};
 496
 497/**
 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
 
 505 */
 506
 507struct devlink_health_reporter_ops {
 508	char *name;
 509	int (*recover)(struct devlink_health_reporter *reporter,
 510		       void *priv_ctx);
 511	int (*dump)(struct devlink_health_reporter *reporter,
 512		    struct devlink_fmsg *fmsg, void *priv_ctx);
 
 513	int (*diagnose)(struct devlink_health_reporter *reporter,
 514			struct devlink_fmsg *fmsg);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 515};
 516
 517/**
 518 * struct devlink_trap_group - Immutable packet trap group attributes.
 519 * @name: Trap group name.
 520 * @id: Trap group identifier.
 521 * @generic: Whether the trap group is generic or not.
 
 522 *
 523 * Describes immutable attributes of packet trap groups that drivers register
 524 * with devlink.
 525 */
 526struct devlink_trap_group {
 527	const char *name;
 528	u16 id;
 529	bool generic;
 
 530};
 531
 532#define DEVLINK_TRAP_METADATA_TYPE_F_IN_PORT	BIT(0)
 
 533
 534/**
 535 * struct devlink_trap - Immutable packet trap attributes.
 536 * @type: Trap type.
 537 * @init_action: Initial trap action.
 538 * @generic: Whether the trap is generic or not.
 539 * @id: Trap identifier.
 540 * @name: Trap name.
 541 * @group: Immutable packet trap group attributes.
 542 * @metadata_cap: Metadata types that can be provided by the trap.
 543 *
 544 * Describes immutable attributes of packet traps that drivers register with
 545 * devlink.
 546 */
 547struct devlink_trap {
 548	enum devlink_trap_type type;
 549	enum devlink_trap_action init_action;
 550	bool generic;
 551	u16 id;
 552	const char *name;
 553	struct devlink_trap_group group;
 554	u32 metadata_cap;
 555};
 556
 557/* All traps must be documented in
 558 * Documentation/networking/devlink-trap.rst
 559 */
 560enum devlink_trap_generic_id {
 561	DEVLINK_TRAP_GENERIC_ID_SMAC_MC,
 562	DEVLINK_TRAP_GENERIC_ID_VLAN_TAG_MISMATCH,
 563	DEVLINK_TRAP_GENERIC_ID_INGRESS_VLAN_FILTER,
 564	DEVLINK_TRAP_GENERIC_ID_INGRESS_STP_FILTER,
 565	DEVLINK_TRAP_GENERIC_ID_EMPTY_TX_LIST,
 566	DEVLINK_TRAP_GENERIC_ID_PORT_LOOPBACK_FILTER,
 567	DEVLINK_TRAP_GENERIC_ID_BLACKHOLE_ROUTE,
 568	DEVLINK_TRAP_GENERIC_ID_TTL_ERROR,
 569	DEVLINK_TRAP_GENERIC_ID_TAIL_DROP,
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 570
 571	/* Add new generic trap IDs above */
 572	__DEVLINK_TRAP_GENERIC_ID_MAX,
 573	DEVLINK_TRAP_GENERIC_ID_MAX = __DEVLINK_TRAP_GENERIC_ID_MAX - 1,
 574};
 575
 576/* All trap groups must be documented in
 577 * Documentation/networking/devlink-trap.rst
 578 */
 579enum devlink_trap_group_generic_id {
 580	DEVLINK_TRAP_GROUP_GENERIC_ID_L2_DROPS,
 581	DEVLINK_TRAP_GROUP_GENERIC_ID_L3_DROPS,
 
 582	DEVLINK_TRAP_GROUP_GENERIC_ID_BUFFER_DROPS,
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 583
 584	/* Add new generic trap group IDs above */
 585	__DEVLINK_TRAP_GROUP_GENERIC_ID_MAX,
 586	DEVLINK_TRAP_GROUP_GENERIC_ID_MAX =
 587		__DEVLINK_TRAP_GROUP_GENERIC_ID_MAX - 1,
 588};
 589
 590#define DEVLINK_TRAP_GENERIC_NAME_SMAC_MC \
 591	"source_mac_is_multicast"
 592#define DEVLINK_TRAP_GENERIC_NAME_VLAN_TAG_MISMATCH \
 593	"vlan_tag_mismatch"
 594#define DEVLINK_TRAP_GENERIC_NAME_INGRESS_VLAN_FILTER \
 595	"ingress_vlan_filter"
 596#define DEVLINK_TRAP_GENERIC_NAME_INGRESS_STP_FILTER \
 597	"ingress_spanning_tree_filter"
 598#define DEVLINK_TRAP_GENERIC_NAME_EMPTY_TX_LIST \
 599	"port_list_is_empty"
 600#define DEVLINK_TRAP_GENERIC_NAME_PORT_LOOPBACK_FILTER \
 601	"port_loopback_filter"
 602#define DEVLINK_TRAP_GENERIC_NAME_BLACKHOLE_ROUTE \
 603	"blackhole_route"
 604#define DEVLINK_TRAP_GENERIC_NAME_TTL_ERROR \
 605	"ttl_value_is_too_small"
 606#define DEVLINK_TRAP_GENERIC_NAME_TAIL_DROP \
 607	"tail_drop"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 608
 609#define DEVLINK_TRAP_GROUP_GENERIC_NAME_L2_DROPS \
 610	"l2_drops"
 611#define DEVLINK_TRAP_GROUP_GENERIC_NAME_L3_DROPS \
 612	"l3_drops"
 
 
 613#define DEVLINK_TRAP_GROUP_GENERIC_NAME_BUFFER_DROPS \
 614	"buffer_drops"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 615
 616#define DEVLINK_TRAP_GENERIC(_type, _init_action, _id, _group, _metadata_cap) \
 
 617	{								      \
 618		.type = DEVLINK_TRAP_TYPE_##_type,			      \
 619		.init_action = DEVLINK_TRAP_ACTION_##_init_action,	      \
 620		.generic = true,					      \
 621		.id = DEVLINK_TRAP_GENERIC_ID_##_id,			      \
 622		.name = DEVLINK_TRAP_GENERIC_NAME_##_id,		      \
 623		.group = _group,					      \
 624		.metadata_cap = _metadata_cap,				      \
 625	}
 626
 627#define DEVLINK_TRAP_DRIVER(_type, _init_action, _id, _name, _group,	      \
 628			    _metadata_cap)				      \
 629	{								      \
 630		.type = DEVLINK_TRAP_TYPE_##_type,			      \
 631		.init_action = DEVLINK_TRAP_ACTION_##_init_action,	      \
 632		.generic = false,					      \
 633		.id = _id,						      \
 634		.name = _name,						      \
 635		.group = _group,					      \
 636		.metadata_cap = _metadata_cap,				      \
 637	}
 638
 639#define DEVLINK_TRAP_GROUP_GENERIC(_id)					      \
 640	{								      \
 641		.name = DEVLINK_TRAP_GROUP_GENERIC_NAME_##_id,		      \
 642		.id = DEVLINK_TRAP_GROUP_GENERIC_ID_##_id,		      \
 643		.generic = true,					      \
 
 
 
 
 
 
 
 
 
 
 
 
 
 644	}
 645
 
 
 
 
 
 646struct devlink_ops {
 647	int (*reload_down)(struct devlink *devlink,
 
 
 
 
 
 
 
 
 
 
 648			   struct netlink_ext_ack *extack);
 649	int (*reload_up)(struct devlink *devlink,
 
 650			 struct netlink_ext_ack *extack);
 651	int (*port_type_set)(struct devlink_port *devlink_port,
 652			     enum devlink_port_type port_type);
 653	int (*port_split)(struct devlink *devlink, unsigned int port_index,
 654			  unsigned int count, struct netlink_ext_ack *extack);
 655	int (*port_unsplit)(struct devlink *devlink, unsigned int port_index,
 656			    struct netlink_ext_ack *extack);
 657	int (*sb_pool_get)(struct devlink *devlink, unsigned int sb_index,
 658			   u16 pool_index,
 659			   struct devlink_sb_pool_info *pool_info);
 660	int (*sb_pool_set)(struct devlink *devlink, unsigned int sb_index,
 661			   u16 pool_index, u32 size,
 662			   enum devlink_sb_threshold_type threshold_type,
 663			   struct netlink_ext_ack *extack);
 664	int (*sb_port_pool_get)(struct devlink_port *devlink_port,
 665				unsigned int sb_index, u16 pool_index,
 666				u32 *p_threshold);
 667	int (*sb_port_pool_set)(struct devlink_port *devlink_port,
 668				unsigned int sb_index, u16 pool_index,
 669				u32 threshold, struct netlink_ext_ack *extack);
 670	int (*sb_tc_pool_bind_get)(struct devlink_port *devlink_port,
 671				   unsigned int sb_index,
 672				   u16 tc_index,
 673				   enum devlink_sb_pool_type pool_type,
 674				   u16 *p_pool_index, u32 *p_threshold);
 675	int (*sb_tc_pool_bind_set)(struct devlink_port *devlink_port,
 676				   unsigned int sb_index,
 677				   u16 tc_index,
 678				   enum devlink_sb_pool_type pool_type,
 679				   u16 pool_index, u32 threshold,
 680				   struct netlink_ext_ack *extack);
 681	int (*sb_occ_snapshot)(struct devlink *devlink,
 682			       unsigned int sb_index);
 683	int (*sb_occ_max_clear)(struct devlink *devlink,
 684				unsigned int sb_index);
 685	int (*sb_occ_port_pool_get)(struct devlink_port *devlink_port,
 686				    unsigned int sb_index, u16 pool_index,
 687				    u32 *p_cur, u32 *p_max);
 688	int (*sb_occ_tc_port_bind_get)(struct devlink_port *devlink_port,
 689				       unsigned int sb_index,
 690				       u16 tc_index,
 691				       enum devlink_sb_pool_type pool_type,
 692				       u32 *p_cur, u32 *p_max);
 693
 694	int (*eswitch_mode_get)(struct devlink *devlink, u16 *p_mode);
 695	int (*eswitch_mode_set)(struct devlink *devlink, u16 mode,
 696				struct netlink_ext_ack *extack);
 697	int (*eswitch_inline_mode_get)(struct devlink *devlink, u8 *p_inline_mode);
 698	int (*eswitch_inline_mode_set)(struct devlink *devlink, u8 inline_mode,
 699				       struct netlink_ext_ack *extack);
 700	int (*eswitch_encap_mode_get)(struct devlink *devlink,
 701				      enum devlink_eswitch_encap_mode *p_encap_mode);
 702	int (*eswitch_encap_mode_set)(struct devlink *devlink,
 703				      enum devlink_eswitch_encap_mode encap_mode,
 704				      struct netlink_ext_ack *extack);
 705	int (*info_get)(struct devlink *devlink, struct devlink_info_req *req,
 706			struct netlink_ext_ack *extack);
 707	int (*flash_update)(struct devlink *devlink, const char *file_name,
 708			    const char *component,
 
 
 
 
 
 
 
 709			    struct netlink_ext_ack *extack);
 710	/**
 711	 * @trap_init: Trap initialization function.
 712	 *
 713	 * Should be used by device drivers to initialize the trap in the
 714	 * underlying device. Drivers should also store the provided trap
 715	 * context, so that they could efficiently pass it to
 716	 * devlink_trap_report() when the trap is triggered.
 717	 */
 718	int (*trap_init)(struct devlink *devlink,
 719			 const struct devlink_trap *trap, void *trap_ctx);
 720	/**
 721	 * @trap_fini: Trap de-initialization function.
 722	 *
 723	 * Should be used by device drivers to de-initialize the trap in the
 724	 * underlying device.
 725	 */
 726	void (*trap_fini)(struct devlink *devlink,
 727			  const struct devlink_trap *trap, void *trap_ctx);
 728	/**
 729	 * @trap_action_set: Trap action set function.
 730	 */
 731	int (*trap_action_set)(struct devlink *devlink,
 732			       const struct devlink_trap *trap,
 733			       enum devlink_trap_action action);
 
 734	/**
 735	 * @trap_group_init: Trap group initialization function.
 736	 *
 737	 * Should be used by device drivers to initialize the trap group in the
 738	 * underlying device.
 739	 */
 740	int (*trap_group_init)(struct devlink *devlink,
 741			       const struct devlink_trap_group *group);
 742};
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 743
 744static inline void *devlink_priv(struct devlink *devlink)
 745{
 746	BUG_ON(!devlink);
 747	return &devlink->priv;
 748}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 749
 750static inline struct devlink *priv_to_devlink(void *priv)
 751{
 752	BUG_ON(!priv);
 753	return container_of(priv, struct devlink, priv);
 754}
 
 
 
 
 
 755
 756static inline struct devlink_port *
 757netdev_to_devlink_port(struct net_device *dev)
 758{
 759	if (dev->netdev_ops->ndo_get_devlink_port)
 760		return dev->netdev_ops->ndo_get_devlink_port(dev);
 761	return NULL;
 762}
 763
 764static inline struct devlink *netdev_to_devlink(struct net_device *dev)
 
 
 
 
 
 
 
 
 
 
 
 765{
 766	struct devlink_port *devlink_port = netdev_to_devlink_port(dev);
 767
 768	if (devlink_port)
 769		return devlink_port->devlink;
 770	return NULL;
 771}
 772
 773struct ib_device;
 774
 775struct devlink *devlink_alloc(const struct devlink_ops *ops, size_t priv_size);
 776int devlink_register(struct devlink *devlink, struct device *dev);
 777void devlink_unregister(struct devlink *devlink);
 778void devlink_reload_enable(struct devlink *devlink);
 779void devlink_reload_disable(struct devlink *devlink);
 780void devlink_free(struct devlink *devlink);
 
 
 
 
 
 
 781int devlink_port_register(struct devlink *devlink,
 782			  struct devlink_port *devlink_port,
 783			  unsigned int port_index);
 
 784void devlink_port_unregister(struct devlink_port *devlink_port);
 785void devlink_port_type_eth_set(struct devlink_port *devlink_port,
 786			       struct net_device *netdev);
 787void devlink_port_type_ib_set(struct devlink_port *devlink_port,
 788			      struct ib_device *ibdev);
 789void devlink_port_type_clear(struct devlink_port *devlink_port);
 790void devlink_port_attrs_set(struct devlink_port *devlink_port,
 791			    enum devlink_port_flavour flavour,
 792			    u32 port_number, bool split,
 793			    u32 split_subport_number,
 794			    const unsigned char *switch_id,
 795			    unsigned char switch_id_len);
 796void devlink_port_attrs_pci_pf_set(struct devlink_port *devlink_port,
 797				   const unsigned char *switch_id,
 798				   unsigned char switch_id_len, u16 pf);
 799void devlink_port_attrs_pci_vf_set(struct devlink_port *devlink_port,
 800				   const unsigned char *switch_id,
 801				   unsigned char switch_id_len,
 802				   u16 pf, u16 vf);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 803int devlink_sb_register(struct devlink *devlink, unsigned int sb_index,
 804			u32 size, u16 ingress_pools_count,
 805			u16 egress_pools_count, u16 ingress_tc_count,
 806			u16 egress_tc_count);
 
 807void devlink_sb_unregister(struct devlink *devlink, unsigned int sb_index);
 808int devlink_dpipe_table_register(struct devlink *devlink,
 809				 const char *table_name,
 810				 struct devlink_dpipe_table_ops *table_ops,
 811				 void *priv, bool counter_control_extern);
 812void devlink_dpipe_table_unregister(struct devlink *devlink,
 813				    const char *table_name);
 814int devlink_dpipe_headers_register(struct devlink *devlink,
 815				   struct devlink_dpipe_headers *dpipe_headers);
 816void devlink_dpipe_headers_unregister(struct devlink *devlink);
 817bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
 818					 const char *table_name);
 819int devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx);
 820int devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
 821				   struct devlink_dpipe_entry *entry);
 822int devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx);
 823void devlink_dpipe_entry_clear(struct devlink_dpipe_entry *entry);
 824int devlink_dpipe_action_put(struct sk_buff *skb,
 825			     struct devlink_dpipe_action *action);
 826int devlink_dpipe_match_put(struct sk_buff *skb,
 827			    struct devlink_dpipe_match *match);
 828extern struct devlink_dpipe_header devlink_dpipe_header_ethernet;
 829extern struct devlink_dpipe_header devlink_dpipe_header_ipv4;
 830extern struct devlink_dpipe_header devlink_dpipe_header_ipv6;
 831
 
 
 
 
 
 
 832int devlink_resource_register(struct devlink *devlink,
 833			      const char *resource_name,
 834			      u64 resource_size,
 835			      u64 resource_id,
 836			      u64 parent_resource_id,
 837			      const struct devlink_resource_size_params *size_params);
 838void devlink_resources_unregister(struct devlink *devlink,
 839				  struct devlink_resource *resource);
 840int devlink_resource_size_get(struct devlink *devlink,
 841			      u64 resource_id,
 842			      u64 *p_resource_size);
 
 
 
 843int devlink_dpipe_table_resource_set(struct devlink *devlink,
 844				     const char *table_name, u64 resource_id,
 845				     u64 resource_units);
 
 
 
 
 846void devlink_resource_occ_get_register(struct devlink *devlink,
 847				       u64 resource_id,
 848				       devlink_resource_occ_get_t *occ_get,
 849				       void *occ_get_priv);
 
 
 
 850void devlink_resource_occ_get_unregister(struct devlink *devlink,
 851					 u64 resource_id);
 852int devlink_params_register(struct devlink *devlink,
 853			    const struct devlink_param *params,
 854			    size_t params_count);
 855void devlink_params_unregister(struct devlink *devlink,
 856			       const struct devlink_param *params,
 857			       size_t params_count);
 858void devlink_params_publish(struct devlink *devlink);
 859void devlink_params_unpublish(struct devlink *devlink);
 860int devlink_port_params_register(struct devlink_port *devlink_port,
 861				 const struct devlink_param *params,
 862				 size_t params_count);
 863void devlink_port_params_unregister(struct devlink_port *devlink_port,
 864				    const struct devlink_param *params,
 865				    size_t params_count);
 866int devlink_param_driverinit_value_get(struct devlink *devlink, u32 param_id,
 867				       union devlink_param_value *init_val);
 868int devlink_param_driverinit_value_set(struct devlink *devlink, u32 param_id,
 869				       union devlink_param_value init_val);
 870int
 871devlink_port_param_driverinit_value_get(struct devlink_port *devlink_port,
 872					u32 param_id,
 873					union devlink_param_value *init_val);
 874int devlink_port_param_driverinit_value_set(struct devlink_port *devlink_port,
 875					    u32 param_id,
 876					    union devlink_param_value init_val);
 877void devlink_param_value_changed(struct devlink *devlink, u32 param_id);
 878void devlink_port_param_value_changed(struct devlink_port *devlink_port,
 879				      u32 param_id);
 880void devlink_param_value_str_fill(union devlink_param_value *dst_val,
 881				  const char *src);
 882struct devlink_region *devlink_region_create(struct devlink *devlink,
 883					     const char *region_name,
 884					     u32 region_max_snapshots,
 885					     u64 region_size);
 
 
 
 
 
 886void devlink_region_destroy(struct devlink_region *region);
 887u32 devlink_region_shapshot_id_get(struct devlink *devlink);
 
 
 
 888int devlink_region_snapshot_create(struct devlink_region *region,
 889				   u8 *data, u32 snapshot_id,
 890				   devlink_snapshot_data_dest_t *data_destructor);
 891int devlink_info_serial_number_put(struct devlink_info_req *req,
 892				   const char *sn);
 893int devlink_info_driver_name_put(struct devlink_info_req *req,
 894				 const char *name);
 
 
 
 
 
 
 
 
 895int devlink_info_version_fixed_put(struct devlink_info_req *req,
 896				   const char *version_name,
 897				   const char *version_value);
 898int devlink_info_version_stored_put(struct devlink_info_req *req,
 899				    const char *version_name,
 900				    const char *version_value);
 
 
 
 
 901int devlink_info_version_running_put(struct devlink_info_req *req,
 902				     const char *version_name,
 903				     const char *version_value);
 
 
 
 
 904
 905int devlink_fmsg_obj_nest_start(struct devlink_fmsg *fmsg);
 906int devlink_fmsg_obj_nest_end(struct devlink_fmsg *fmsg);
 907
 908int devlink_fmsg_pair_nest_start(struct devlink_fmsg *fmsg, const char *name);
 909int devlink_fmsg_pair_nest_end(struct devlink_fmsg *fmsg);
 910
 911int devlink_fmsg_arr_pair_nest_start(struct devlink_fmsg *fmsg,
 912				     const char *name);
 913int devlink_fmsg_arr_pair_nest_end(struct devlink_fmsg *fmsg);
 
 
 
 914
 915int devlink_fmsg_bool_put(struct devlink_fmsg *fmsg, bool value);
 916int devlink_fmsg_u8_put(struct devlink_fmsg *fmsg, u8 value);
 917int devlink_fmsg_u32_put(struct devlink_fmsg *fmsg, u32 value);
 918int devlink_fmsg_u64_put(struct devlink_fmsg *fmsg, u64 value);
 919int devlink_fmsg_string_put(struct devlink_fmsg *fmsg, const char *value);
 920int devlink_fmsg_binary_put(struct devlink_fmsg *fmsg, const void *value,
 921			    u16 value_len);
 922
 923int devlink_fmsg_bool_pair_put(struct devlink_fmsg *fmsg, const char *name,
 924			       bool value);
 925int devlink_fmsg_u8_pair_put(struct devlink_fmsg *fmsg, const char *name,
 926			     u8 value);
 927int devlink_fmsg_u32_pair_put(struct devlink_fmsg *fmsg, const char *name,
 928			      u32 value);
 929int devlink_fmsg_u64_pair_put(struct devlink_fmsg *fmsg, const char *name,
 930			      u64 value);
 931int devlink_fmsg_string_pair_put(struct devlink_fmsg *fmsg, const char *name,
 932				 const char *value);
 933int devlink_fmsg_binary_pair_put(struct devlink_fmsg *fmsg, const char *name,
 934				 const void *value, u16 value_len);
 935
 936struct devlink_health_reporter *
 937devlink_health_reporter_create(struct devlink *devlink,
 938			       const struct devlink_health_reporter_ops *ops,
 939			       u64 graceful_period, bool auto_recover,
 940			       void *priv);
 
 
 
 
 
 941void
 942devlink_health_reporter_destroy(struct devlink_health_reporter *reporter);
 943
 
 
 
 944void *
 945devlink_health_reporter_priv(struct devlink_health_reporter *reporter);
 946int devlink_health_report(struct devlink_health_reporter *reporter,
 947			  const char *msg, void *priv_ctx);
 948void
 949devlink_health_reporter_state_update(struct devlink_health_reporter *reporter,
 950				     enum devlink_health_reporter_state state);
 
 
 951
 952bool devlink_is_reload_failed(const struct devlink *devlink);
 
 
 
 953
 954void devlink_flash_update_begin_notify(struct devlink *devlink);
 955void devlink_flash_update_end_notify(struct devlink *devlink);
 956void devlink_flash_update_status_notify(struct devlink *devlink,
 957					const char *status_msg,
 958					const char *component,
 959					unsigned long done,
 960					unsigned long total);
 961
 
 
 
 
 
 
 
 962int devlink_traps_register(struct devlink *devlink,
 963			   const struct devlink_trap *traps,
 964			   size_t traps_count, void *priv);
 
 
 
 965void devlink_traps_unregister(struct devlink *devlink,
 966			      const struct devlink_trap *traps,
 967			      size_t traps_count);
 968void devlink_trap_report(struct devlink *devlink,
 969			 struct sk_buff *skb, void *trap_ctx,
 970			 struct devlink_port *in_devlink_port);
 971void *devlink_trap_ctx_priv(void *trap_ctx);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 972
 973#if IS_ENABLED(CONFIG_NET_DEVLINK)
 974
 975void devlink_compat_running_version(struct net_device *dev,
 
 
 
 976				    char *buf, size_t len);
 977int devlink_compat_flash_update(struct net_device *dev, const char *file_name);
 978int devlink_compat_phys_port_name_get(struct net_device *dev,
 979				      char *name, size_t len);
 980int devlink_compat_switch_id_get(struct net_device *dev,
 981				 struct netdev_phys_item_id *ppid);
 982
 
 
 
 983#else
 984
 
 
 
 
 
 
 
 
 
 985static inline void
 986devlink_compat_running_version(struct net_device *dev, char *buf, size_t len)
 987{
 988}
 989
 990static inline int
 991devlink_compat_flash_update(struct net_device *dev, const char *file_name)
 992{
 993	return -EOPNOTSUPP;
 994}
 995
 996static inline int
 997devlink_compat_phys_port_name_get(struct net_device *dev,
 998				  char *name, size_t len)
 999{
1000	return -EOPNOTSUPP;
1001}
1002
1003static inline int
1004devlink_compat_switch_id_get(struct net_device *dev,
1005			     struct netdev_phys_item_id *ppid)
1006{
1007	return -EOPNOTSUPP;
 
 
 
 
 
 
 
 
 
 
 
1008}
1009
1010#endif
1011
1012#endif /* _NET_DEVLINK_H_ */
v6.2
   1/* SPDX-License-Identifier: GPL-2.0-or-later */
   2/*
   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>
   6 */
   7#ifndef _NET_DEVLINK_H_
   8#define _NET_DEVLINK_H_
   9
  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 <net/flow_offload.h>
  20#include <uapi/linux/devlink.h>
  21#include <linux/xarray.h>
  22#include <linux/firmware.h>
  23
  24struct devlink;
  25struct devlink_linecard;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  26
  27struct devlink_port_phys_attrs {
  28	u32 port_number; /* Same value as "split group".
  29			  * A physical port which is visible to the user
  30			  * for a given port flavour.
  31			  */
  32	u32 split_subport_number; /* If the port is split, this is the number of subport. */
  33};
  34
  35/**
  36 * struct devlink_port_pci_pf_attrs - devlink port's PCI PF attributes
  37 * @controller: Associated controller number
  38 * @pf: Associated PCI PF number for this port.
  39 * @external: when set, indicates if a port is for an external controller
  40 */
  41struct devlink_port_pci_pf_attrs {
  42	u32 controller;
  43	u16 pf;
  44	u8 external:1;
  45};
  46
  47/**
  48 * struct devlink_port_pci_vf_attrs - devlink port's PCI VF attributes
  49 * @controller: Associated controller number
  50 * @pf: Associated PCI PF number for this port.
  51 * @vf: Associated PCI VF for of the PCI PF for this port.
  52 * @external: when set, indicates if a port is for an external controller
  53 */
  54struct devlink_port_pci_vf_attrs {
  55	u32 controller;
  56	u16 pf;
  57	u16 vf;
  58	u8 external:1;
  59};
  60
  61/**
  62 * struct devlink_port_pci_sf_attrs - devlink port's PCI SF attributes
  63 * @controller: Associated controller number
  64 * @sf: Associated PCI SF for of the PCI PF for this port.
  65 * @pf: Associated PCI PF number for this port.
  66 * @external: when set, indicates if a port is for an external controller
  67 */
  68struct devlink_port_pci_sf_attrs {
  69	u32 controller;
  70	u32 sf;
  71	u16 pf;
  72	u8 external:1;
  73};
  74
  75/**
  76 * struct devlink_port_attrs - devlink port object
  77 * @flavour: flavour of the port
  78 * @split: indicates if this is split port
  79 * @splittable: indicates if the port can be split.
  80 * @lanes: maximum number of lanes the port supports. 0 value is not passed to netlink.
  81 * @switch_id: if the port is part of switch, this is buffer with ID, otherwise this is NULL
  82 * @phys: physical port attributes
  83 * @pci_pf: PCI PF port attributes
  84 * @pci_vf: PCI VF port attributes
  85 * @pci_sf: PCI SF port attributes
  86 */
  87struct devlink_port_attrs {
  88	u8 split:1,
  89	   splittable:1;
  90	u32 lanes;
  91	enum devlink_port_flavour flavour;
  92	struct netdev_phys_item_id switch_id;
  93	union {
  94		struct devlink_port_phys_attrs phys;
  95		struct devlink_port_pci_pf_attrs pci_pf;
  96		struct devlink_port_pci_vf_attrs pci_vf;
  97		struct devlink_port_pci_sf_attrs pci_sf;
  98	};
  99};
 100
 101struct devlink_rate {
 102	struct list_head list;
 103	enum devlink_rate_type type;
 104	struct devlink *devlink;
 105	void *priv;
 106	u64 tx_share;
 107	u64 tx_max;
 108
 109	struct devlink_rate *parent;
 110	union {
 111		struct devlink_port *devlink_port;
 112		struct {
 113			char *name;
 114			refcount_t refcnt;
 115		};
 116	};
 117
 118	u32 tx_priority;
 119	u32 tx_weight;
 120};
 121
 122struct devlink_port {
 123	struct list_head list;
 124	struct list_head region_list;
 125	struct devlink *devlink;
 126	unsigned int index;
 127	spinlock_t type_lock; /* Protects type and type_eth/ib
 128			       * structures consistency.
 
 129			       */
 130	enum devlink_port_type type;
 131	enum devlink_port_type desired_type;
 132	union {
 133		struct {
 134			struct net_device *netdev;
 135			int ifindex;
 136			char ifname[IFNAMSIZ];
 137		} type_eth;
 138		struct {
 139			struct ib_device *ibdev;
 140		} type_ib;
 141	};
 142	struct devlink_port_attrs attrs;
 143	u8 attrs_set:1,
 144	   switch_port:1,
 145	   registered:1,
 146	   initialized:1;
 147	struct delayed_work type_warn_dw;
 148	struct list_head reporter_list;
 149	struct mutex reporters_lock; /* Protects reporter_list */
 150
 151	struct devlink_rate *devlink_rate;
 152	struct devlink_linecard *linecard;
 153};
 154
 155struct devlink_port_new_attrs {
 156	enum devlink_port_flavour flavour;
 157	unsigned int port_index;
 158	u32 controller;
 159	u32 sfnum;
 160	u16 pfnum;
 161	u8 port_index_valid:1,
 162	   controller_valid:1,
 163	   sfnum_valid:1;
 164};
 165
 166/**
 167 * struct devlink_linecard_ops - Linecard operations
 168 * @provision: callback to provision the linecard slot with certain
 169 *	       type of linecard. As a result of this operation,
 170 *	       driver is expected to eventually (could be after
 171 *	       the function call returns) call one of:
 172 *	       devlink_linecard_provision_set()
 173 *	       devlink_linecard_provision_fail()
 174 * @unprovision: callback to unprovision the linecard slot. As a result
 175 *		 of this operation, driver is expected to eventually
 176 *		 (could be after the function call returns) call
 177 *	         devlink_linecard_provision_clear()
 178 *	         devlink_linecard_provision_fail()
 179 * @same_provision: callback to ask the driver if linecard is already
 180 *                  provisioned in the same way user asks this linecard to be
 181 *                  provisioned.
 182 * @types_count: callback to get number of supported types
 183 * @types_get: callback to get next type in list
 184 */
 185struct devlink_linecard_ops {
 186	int (*provision)(struct devlink_linecard *linecard, void *priv,
 187			 const char *type, const void *type_priv,
 188			 struct netlink_ext_ack *extack);
 189	int (*unprovision)(struct devlink_linecard *linecard, void *priv,
 190			   struct netlink_ext_ack *extack);
 191	bool (*same_provision)(struct devlink_linecard *linecard, void *priv,
 192			       const char *type, const void *type_priv);
 193	unsigned int (*types_count)(struct devlink_linecard *linecard,
 194				    void *priv);
 195	void (*types_get)(struct devlink_linecard *linecard,
 196			  void *priv, unsigned int index, const char **type,
 197			  const void **type_priv);
 198};
 199
 200struct devlink_sb_pool_info {
 201	enum devlink_sb_pool_type pool_type;
 202	u32 size;
 203	enum devlink_sb_threshold_type threshold_type;
 204	u32 cell_size;
 205};
 206
 207/**
 208 * struct devlink_dpipe_field - dpipe field object
 209 * @name: field name
 210 * @id: index inside the headers field array
 211 * @bitwidth: bitwidth
 212 * @mapping_type: mapping type
 213 */
 214struct devlink_dpipe_field {
 215	const char *name;
 216	unsigned int id;
 217	unsigned int bitwidth;
 218	enum devlink_dpipe_field_mapping_type mapping_type;
 219};
 220
 221/**
 222 * struct devlink_dpipe_header - dpipe header object
 223 * @name: header name
 224 * @id: index, global/local detrmined by global bit
 225 * @fields: fields
 226 * @fields_count: number of fields
 227 * @global: indicates if header is shared like most protocol header
 228 *	    or driver specific
 229 */
 230struct devlink_dpipe_header {
 231	const char *name;
 232	unsigned int id;
 233	struct devlink_dpipe_field *fields;
 234	unsigned int fields_count;
 235	bool global;
 236};
 237
 238/**
 239 * struct devlink_dpipe_match - represents match operation
 240 * @type: type of match
 241 * @header_index: header index (packets can have several headers of same
 242 *		  type like in case of tunnels)
 243 * @header: header
 244 * @fieled_id: field index
 245 */
 246struct devlink_dpipe_match {
 247	enum devlink_dpipe_match_type type;
 248	unsigned int header_index;
 249	struct devlink_dpipe_header *header;
 250	unsigned int field_id;
 251};
 252
 253/**
 254 * struct devlink_dpipe_action - represents action operation
 255 * @type: type of action
 256 * @header_index: header index (packets can have several headers of same
 257 *		  type like in case of tunnels)
 258 * @header: header
 259 * @fieled_id: field index
 260 */
 261struct devlink_dpipe_action {
 262	enum devlink_dpipe_action_type type;
 263	unsigned int header_index;
 264	struct devlink_dpipe_header *header;
 265	unsigned int field_id;
 266};
 267
 268/**
 269 * struct devlink_dpipe_value - represents value of match/action
 270 * @action: action
 271 * @match: match
 272 * @mapping_value: in case the field has some mapping this value
 273 *                 specified the mapping value
 274 * @mapping_valid: specify if mapping value is valid
 275 * @value_size: value size
 276 * @value: value
 277 * @mask: bit mask
 278 */
 279struct devlink_dpipe_value {
 280	union {
 281		struct devlink_dpipe_action *action;
 282		struct devlink_dpipe_match *match;
 283	};
 284	unsigned int mapping_value;
 285	bool mapping_valid;
 286	unsigned int value_size;
 287	void *value;
 288	void *mask;
 289};
 290
 291/**
 292 * struct devlink_dpipe_entry - table entry object
 293 * @index: index of the entry in the table
 294 * @match_values: match values
 295 * @matche_values_count: count of matches tuples
 296 * @action_values: actions values
 297 * @action_values_count: count of actions values
 298 * @counter: value of counter
 299 * @counter_valid: Specify if value is valid from hardware
 300 */
 301struct devlink_dpipe_entry {
 302	u64 index;
 303	struct devlink_dpipe_value *match_values;
 304	unsigned int match_values_count;
 305	struct devlink_dpipe_value *action_values;
 306	unsigned int action_values_count;
 307	u64 counter;
 308	bool counter_valid;
 309};
 310
 311/**
 312 * struct devlink_dpipe_dump_ctx - context provided to driver in order
 313 *				   to dump
 314 * @info: info
 315 * @cmd: devlink command
 316 * @skb: skb
 317 * @nest: top attribute
 318 * @hdr: hdr
 319 */
 320struct devlink_dpipe_dump_ctx {
 321	struct genl_info *info;
 322	enum devlink_command cmd;
 323	struct sk_buff *skb;
 324	struct nlattr *nest;
 325	void *hdr;
 326};
 327
 328struct devlink_dpipe_table_ops;
 329
 330/**
 331 * struct devlink_dpipe_table - table object
 332 * @priv: private
 333 * @name: table name
 334 * @counters_enabled: indicates if counters are active
 335 * @counter_control_extern: indicates if counter control is in dpipe or
 336 *			    external tool
 337 * @resource_valid: Indicate that the resource id is valid
 338 * @resource_id: relative resource this table is related to
 339 * @resource_units: number of resource's unit consumed per table's entry
 340 * @table_ops: table operations
 341 * @rcu: rcu
 342 */
 343struct devlink_dpipe_table {
 344	void *priv;
 345	struct list_head list;
 346	const char *name;
 347	bool counters_enabled;
 348	bool counter_control_extern;
 349	bool resource_valid;
 350	u64 resource_id;
 351	u64 resource_units;
 352	struct devlink_dpipe_table_ops *table_ops;
 353	struct rcu_head rcu;
 354};
 355
 356/**
 357 * struct devlink_dpipe_table_ops - dpipe_table ops
 358 * @actions_dump - dumps all tables actions
 359 * @matches_dump - dumps all tables matches
 360 * @entries_dump - dumps all active entries in the table
 361 * @counters_set_update - when changing the counter status hardware sync
 362 *			  maybe needed to allocate/free counter related
 363 *			  resources
 364 * @size_get - get size
 365 */
 366struct devlink_dpipe_table_ops {
 367	int (*actions_dump)(void *priv, struct sk_buff *skb);
 368	int (*matches_dump)(void *priv, struct sk_buff *skb);
 369	int (*entries_dump)(void *priv, bool counters_enabled,
 370			    struct devlink_dpipe_dump_ctx *dump_ctx);
 371	int (*counters_set_update)(void *priv, bool enable);
 372	u64 (*size_get)(void *priv);
 373};
 374
 375/**
 376 * struct devlink_dpipe_headers - dpipe headers
 377 * @headers - header array can be shared (global bit) or driver specific
 378 * @headers_count - count of headers
 379 */
 380struct devlink_dpipe_headers {
 381	struct devlink_dpipe_header **headers;
 382	unsigned int headers_count;
 383};
 384
 385/**
 386 * struct devlink_resource_size_params - resource's size parameters
 387 * @size_min: minimum size which can be set
 388 * @size_max: maximum size which can be set
 389 * @size_granularity: size granularity
 390 * @size_unit: resource's basic unit
 391 */
 392struct devlink_resource_size_params {
 393	u64 size_min;
 394	u64 size_max;
 395	u64 size_granularity;
 396	enum devlink_resource_unit unit;
 397};
 398
 399static inline void
 400devlink_resource_size_params_init(struct devlink_resource_size_params *size_params,
 401				  u64 size_min, u64 size_max,
 402				  u64 size_granularity,
 403				  enum devlink_resource_unit unit)
 404{
 405	size_params->size_min = size_min;
 406	size_params->size_max = size_max;
 407	size_params->size_granularity = size_granularity;
 408	size_params->unit = unit;
 409}
 410
 411typedef u64 devlink_resource_occ_get_t(void *priv);
 412
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 413#define DEVLINK_RESOURCE_ID_PARENT_TOP 0
 414
 415#define DEVLINK_RESOURCE_GENERIC_NAME_PORTS "physical_ports"
 416
 417#define __DEVLINK_PARAM_MAX_STRING_VALUE 32
 418enum devlink_param_type {
 419	DEVLINK_PARAM_TYPE_U8,
 420	DEVLINK_PARAM_TYPE_U16,
 421	DEVLINK_PARAM_TYPE_U32,
 422	DEVLINK_PARAM_TYPE_STRING,
 423	DEVLINK_PARAM_TYPE_BOOL,
 424};
 425
 426union devlink_param_value {
 427	u8 vu8;
 428	u16 vu16;
 429	u32 vu32;
 430	char vstr[__DEVLINK_PARAM_MAX_STRING_VALUE];
 431	bool vbool;
 432};
 433
 434struct devlink_param_gset_ctx {
 435	union devlink_param_value val;
 436	enum devlink_param_cmode cmode;
 437};
 438
 439/**
 440 * struct devlink_flash_notify - devlink dev flash notify data
 441 * @status_msg: current status string
 442 * @component: firmware component being updated
 443 * @done: amount of work completed of total amount
 444 * @total: amount of work expected to be done
 445 * @timeout: expected max timeout in seconds
 446 *
 447 * These are values to be given to userland to be displayed in order
 448 * to show current activity in a firmware update process.
 449 */
 450struct devlink_flash_notify {
 451	const char *status_msg;
 452	const char *component;
 453	unsigned long done;
 454	unsigned long total;
 455	unsigned long timeout;
 456};
 457
 458/**
 459 * struct devlink_param - devlink configuration parameter data
 460 * @name: name of the parameter
 461 * @generic: indicates if the parameter is generic or driver specific
 462 * @type: parameter type
 463 * @supported_cmodes: bitmap of supported configuration modes
 464 * @get: get parameter value, used for runtime and permanent
 465 *       configuration modes
 466 * @set: set parameter value, used for runtime and permanent
 467 *       configuration modes
 468 * @validate: validate input value is applicable (within value range, etc.)
 469 *
 470 * This struct should be used by the driver to fill the data for
 471 * a parameter it registers.
 472 */
 473struct devlink_param {
 474	u32 id;
 475	const char *name;
 476	bool generic;
 477	enum devlink_param_type type;
 478	unsigned long supported_cmodes;
 479	int (*get)(struct devlink *devlink, u32 id,
 480		   struct devlink_param_gset_ctx *ctx);
 481	int (*set)(struct devlink *devlink, u32 id,
 482		   struct devlink_param_gset_ctx *ctx);
 483	int (*validate)(struct devlink *devlink, u32 id,
 484			union devlink_param_value val,
 485			struct netlink_ext_ack *extack);
 486};
 487
 488struct devlink_param_item {
 489	struct list_head list;
 490	const struct devlink_param *param;
 491	union devlink_param_value driverinit_value;
 492	bool driverinit_value_valid;
 
 493};
 494
 495enum devlink_param_generic_id {
 496	DEVLINK_PARAM_GENERIC_ID_INT_ERR_RESET,
 497	DEVLINK_PARAM_GENERIC_ID_MAX_MACS,
 498	DEVLINK_PARAM_GENERIC_ID_ENABLE_SRIOV,
 499	DEVLINK_PARAM_GENERIC_ID_REGION_SNAPSHOT,
 500	DEVLINK_PARAM_GENERIC_ID_IGNORE_ARI,
 501	DEVLINK_PARAM_GENERIC_ID_MSIX_VEC_PER_PF_MAX,
 502	DEVLINK_PARAM_GENERIC_ID_MSIX_VEC_PER_PF_MIN,
 503	DEVLINK_PARAM_GENERIC_ID_FW_LOAD_POLICY,
 504	DEVLINK_PARAM_GENERIC_ID_RESET_DEV_ON_DRV_PROBE,
 505	DEVLINK_PARAM_GENERIC_ID_ENABLE_ROCE,
 506	DEVLINK_PARAM_GENERIC_ID_ENABLE_REMOTE_DEV_RESET,
 507	DEVLINK_PARAM_GENERIC_ID_ENABLE_ETH,
 508	DEVLINK_PARAM_GENERIC_ID_ENABLE_RDMA,
 509	DEVLINK_PARAM_GENERIC_ID_ENABLE_VNET,
 510	DEVLINK_PARAM_GENERIC_ID_ENABLE_IWARP,
 511	DEVLINK_PARAM_GENERIC_ID_IO_EQ_SIZE,
 512	DEVLINK_PARAM_GENERIC_ID_EVENT_EQ_SIZE,
 513
 514	/* add new param generic ids above here*/
 515	__DEVLINK_PARAM_GENERIC_ID_MAX,
 516	DEVLINK_PARAM_GENERIC_ID_MAX = __DEVLINK_PARAM_GENERIC_ID_MAX - 1,
 517};
 518
 519#define DEVLINK_PARAM_GENERIC_INT_ERR_RESET_NAME "internal_error_reset"
 520#define DEVLINK_PARAM_GENERIC_INT_ERR_RESET_TYPE DEVLINK_PARAM_TYPE_BOOL
 521
 522#define DEVLINK_PARAM_GENERIC_MAX_MACS_NAME "max_macs"
 523#define DEVLINK_PARAM_GENERIC_MAX_MACS_TYPE DEVLINK_PARAM_TYPE_U32
 524
 525#define DEVLINK_PARAM_GENERIC_ENABLE_SRIOV_NAME "enable_sriov"
 526#define DEVLINK_PARAM_GENERIC_ENABLE_SRIOV_TYPE DEVLINK_PARAM_TYPE_BOOL
 527
 528#define DEVLINK_PARAM_GENERIC_REGION_SNAPSHOT_NAME "region_snapshot_enable"
 529#define DEVLINK_PARAM_GENERIC_REGION_SNAPSHOT_TYPE DEVLINK_PARAM_TYPE_BOOL
 530
 531#define DEVLINK_PARAM_GENERIC_IGNORE_ARI_NAME "ignore_ari"
 532#define DEVLINK_PARAM_GENERIC_IGNORE_ARI_TYPE DEVLINK_PARAM_TYPE_BOOL
 533
 534#define DEVLINK_PARAM_GENERIC_MSIX_VEC_PER_PF_MAX_NAME "msix_vec_per_pf_max"
 535#define DEVLINK_PARAM_GENERIC_MSIX_VEC_PER_PF_MAX_TYPE DEVLINK_PARAM_TYPE_U32
 536
 537#define DEVLINK_PARAM_GENERIC_MSIX_VEC_PER_PF_MIN_NAME "msix_vec_per_pf_min"
 538#define DEVLINK_PARAM_GENERIC_MSIX_VEC_PER_PF_MIN_TYPE DEVLINK_PARAM_TYPE_U32
 539
 540#define DEVLINK_PARAM_GENERIC_FW_LOAD_POLICY_NAME "fw_load_policy"
 541#define DEVLINK_PARAM_GENERIC_FW_LOAD_POLICY_TYPE DEVLINK_PARAM_TYPE_U8
 542
 543#define DEVLINK_PARAM_GENERIC_RESET_DEV_ON_DRV_PROBE_NAME \
 544	"reset_dev_on_drv_probe"
 545#define DEVLINK_PARAM_GENERIC_RESET_DEV_ON_DRV_PROBE_TYPE DEVLINK_PARAM_TYPE_U8
 546
 547#define DEVLINK_PARAM_GENERIC_ENABLE_ROCE_NAME "enable_roce"
 548#define DEVLINK_PARAM_GENERIC_ENABLE_ROCE_TYPE DEVLINK_PARAM_TYPE_BOOL
 549
 550#define DEVLINK_PARAM_GENERIC_ENABLE_REMOTE_DEV_RESET_NAME "enable_remote_dev_reset"
 551#define DEVLINK_PARAM_GENERIC_ENABLE_REMOTE_DEV_RESET_TYPE DEVLINK_PARAM_TYPE_BOOL
 552
 553#define DEVLINK_PARAM_GENERIC_ENABLE_ETH_NAME "enable_eth"
 554#define DEVLINK_PARAM_GENERIC_ENABLE_ETH_TYPE DEVLINK_PARAM_TYPE_BOOL
 555
 556#define DEVLINK_PARAM_GENERIC_ENABLE_RDMA_NAME "enable_rdma"
 557#define DEVLINK_PARAM_GENERIC_ENABLE_RDMA_TYPE DEVLINK_PARAM_TYPE_BOOL
 558
 559#define DEVLINK_PARAM_GENERIC_ENABLE_VNET_NAME "enable_vnet"
 560#define DEVLINK_PARAM_GENERIC_ENABLE_VNET_TYPE DEVLINK_PARAM_TYPE_BOOL
 561
 562#define DEVLINK_PARAM_GENERIC_ENABLE_IWARP_NAME "enable_iwarp"
 563#define DEVLINK_PARAM_GENERIC_ENABLE_IWARP_TYPE DEVLINK_PARAM_TYPE_BOOL
 564
 565#define DEVLINK_PARAM_GENERIC_IO_EQ_SIZE_NAME "io_eq_size"
 566#define DEVLINK_PARAM_GENERIC_IO_EQ_SIZE_TYPE DEVLINK_PARAM_TYPE_U32
 567
 568#define DEVLINK_PARAM_GENERIC_EVENT_EQ_SIZE_NAME "event_eq_size"
 569#define DEVLINK_PARAM_GENERIC_EVENT_EQ_SIZE_TYPE DEVLINK_PARAM_TYPE_U32
 570
 571#define DEVLINK_PARAM_GENERIC(_id, _cmodes, _get, _set, _validate)	\
 572{									\
 573	.id = DEVLINK_PARAM_GENERIC_ID_##_id,				\
 574	.name = DEVLINK_PARAM_GENERIC_##_id##_NAME,			\
 575	.type = DEVLINK_PARAM_GENERIC_##_id##_TYPE,			\
 576	.generic = true,						\
 577	.supported_cmodes = _cmodes,					\
 578	.get = _get,							\
 579	.set = _set,							\
 580	.validate = _validate,						\
 581}
 582
 583#define DEVLINK_PARAM_DRIVER(_id, _name, _type, _cmodes, _get, _set, _validate)	\
 584{									\
 585	.id = _id,							\
 586	.name = _name,							\
 587	.type = _type,							\
 588	.supported_cmodes = _cmodes,					\
 589	.get = _get,							\
 590	.set = _set,							\
 591	.validate = _validate,						\
 592}
 593
 594/* Part number, identifier of board design */
 595#define DEVLINK_INFO_VERSION_GENERIC_BOARD_ID	"board.id"
 596/* Revision of board design */
 597#define DEVLINK_INFO_VERSION_GENERIC_BOARD_REV	"board.rev"
 598/* Maker of the board */
 599#define DEVLINK_INFO_VERSION_GENERIC_BOARD_MANUFACTURE	"board.manufacture"
 600
 601/* Part number, identifier of asic design */
 602#define DEVLINK_INFO_VERSION_GENERIC_ASIC_ID	"asic.id"
 603/* Revision of asic design */
 604#define DEVLINK_INFO_VERSION_GENERIC_ASIC_REV	"asic.rev"
 605
 606/* Overall FW version */
 607#define DEVLINK_INFO_VERSION_GENERIC_FW		"fw"
 608/* Control processor FW version */
 609#define DEVLINK_INFO_VERSION_GENERIC_FW_MGMT	"fw.mgmt"
 610/* FW interface specification version */
 611#define DEVLINK_INFO_VERSION_GENERIC_FW_MGMT_API	"fw.mgmt.api"
 612/* Data path microcode controlling high-speed packet processing */
 613#define DEVLINK_INFO_VERSION_GENERIC_FW_APP	"fw.app"
 614/* UNDI software version */
 615#define DEVLINK_INFO_VERSION_GENERIC_FW_UNDI	"fw.undi"
 616/* NCSI support/handler version */
 617#define DEVLINK_INFO_VERSION_GENERIC_FW_NCSI	"fw.ncsi"
 618/* FW parameter set id */
 619#define DEVLINK_INFO_VERSION_GENERIC_FW_PSID	"fw.psid"
 620/* RoCE FW version */
 621#define DEVLINK_INFO_VERSION_GENERIC_FW_ROCE	"fw.roce"
 622/* Firmware bundle identifier */
 623#define DEVLINK_INFO_VERSION_GENERIC_FW_BUNDLE_ID	"fw.bundle_id"
 624/* Bootloader */
 625#define DEVLINK_INFO_VERSION_GENERIC_FW_BOOTLOADER	"fw.bootloader"
 626
 627/**
 628 * struct devlink_flash_update_params - Flash Update parameters
 629 * @fw: pointer to the firmware data to update from
 630 * @component: the flash component to update
 631 *
 632 * With the exception of fw, drivers must opt-in to parameters by
 633 * setting the appropriate bit in the supported_flash_update_params field in
 634 * their devlink_ops structure.
 635 */
 636struct devlink_flash_update_params {
 637	const struct firmware *fw;
 638	const char *component;
 639	u32 overwrite_mask;
 640};
 641
 642#define DEVLINK_SUPPORT_FLASH_UPDATE_OVERWRITE_MASK	BIT(0)
 643
 644struct devlink_region;
 645struct devlink_info_req;
 646
 647/**
 648 * struct devlink_region_ops - Region operations
 649 * @name: region name
 650 * @destructor: callback used to free snapshot memory when deleting
 651 * @snapshot: callback to request an immediate snapshot. On success,
 652 *            the data variable must be updated to point to the snapshot data.
 653 *            The function will be called while the devlink instance lock is
 654 *            held.
 655 * @read: callback to directly read a portion of the region. On success,
 656 *        the data pointer will be updated with the contents of the
 657 *        requested portion of the region. The function will be called
 658 *        while the devlink instance lock is held.
 659 * @priv: Pointer to driver private data for the region operation
 660 */
 661struct devlink_region_ops {
 662	const char *name;
 663	void (*destructor)(const void *data);
 664	int (*snapshot)(struct devlink *devlink,
 665			const struct devlink_region_ops *ops,
 666			struct netlink_ext_ack *extack,
 667			u8 **data);
 668	int (*read)(struct devlink *devlink,
 669		    const struct devlink_region_ops *ops,
 670		    struct netlink_ext_ack *extack,
 671		    u64 offset, u32 size, u8 *data);
 672	void *priv;
 673};
 674
 675/**
 676 * struct devlink_port_region_ops - Region operations for a port
 677 * @name: region name
 678 * @destructor: callback used to free snapshot memory when deleting
 679 * @snapshot: callback to request an immediate snapshot. On success,
 680 *            the data variable must be updated to point to the snapshot data.
 681 *            The function will be called while the devlink instance lock is
 682 *            held.
 683 * @read: callback to directly read a portion of the region. On success,
 684 *        the data pointer will be updated with the contents of the
 685 *        requested portion of the region. The function will be called
 686 *        while the devlink instance lock is held.
 687 * @priv: Pointer to driver private data for the region operation
 688 */
 689struct devlink_port_region_ops {
 690	const char *name;
 691	void (*destructor)(const void *data);
 692	int (*snapshot)(struct devlink_port *port,
 693			const struct devlink_port_region_ops *ops,
 694			struct netlink_ext_ack *extack,
 695			u8 **data);
 696	int (*read)(struct devlink_port *port,
 697		    const struct devlink_port_region_ops *ops,
 698		    struct netlink_ext_ack *extack,
 699		    u64 offset, u32 size, u8 *data);
 700	void *priv;
 701};
 702
 703struct devlink_fmsg;
 704struct devlink_health_reporter;
 705
 706enum devlink_health_reporter_state {
 707	DEVLINK_HEALTH_REPORTER_STATE_HEALTHY,
 708	DEVLINK_HEALTH_REPORTER_STATE_ERROR,
 709};
 710
 711/**
 712 * struct devlink_health_reporter_ops - Reporter operations
 713 * @name: reporter name
 714 * @recover: callback to recover from reported error
 715 *           if priv_ctx is NULL, run a full recover
 716 * @dump: callback to dump an object
 717 *        if priv_ctx is NULL, run a full dump
 718 * @diagnose: callback to diagnose the current status
 719 * @test: callback to trigger a test event
 720 */
 721
 722struct devlink_health_reporter_ops {
 723	char *name;
 724	int (*recover)(struct devlink_health_reporter *reporter,
 725		       void *priv_ctx, struct netlink_ext_ack *extack);
 726	int (*dump)(struct devlink_health_reporter *reporter,
 727		    struct devlink_fmsg *fmsg, void *priv_ctx,
 728		    struct netlink_ext_ack *extack);
 729	int (*diagnose)(struct devlink_health_reporter *reporter,
 730			struct devlink_fmsg *fmsg,
 731			struct netlink_ext_ack *extack);
 732	int (*test)(struct devlink_health_reporter *reporter,
 733		    struct netlink_ext_ack *extack);
 734};
 735
 736/**
 737 * struct devlink_trap_metadata - Packet trap metadata.
 738 * @trap_name: Trap name.
 739 * @trap_group_name: Trap group name.
 740 * @input_dev: Input netdevice.
 741 * @dev_tracker: refcount tracker for @input_dev.
 742 * @fa_cookie: Flow action user cookie.
 743 * @trap_type: Trap type.
 744 */
 745struct devlink_trap_metadata {
 746	const char *trap_name;
 747	const char *trap_group_name;
 748
 749	struct net_device *input_dev;
 750	netdevice_tracker dev_tracker;
 751
 752	const struct flow_action_cookie *fa_cookie;
 753	enum devlink_trap_type trap_type;
 754};
 755
 756/**
 757 * struct devlink_trap_policer - Immutable packet trap policer attributes.
 758 * @id: Policer identifier.
 759 * @init_rate: Initial rate in packets / sec.
 760 * @init_burst: Initial burst size in packets.
 761 * @max_rate: Maximum rate.
 762 * @min_rate: Minimum rate.
 763 * @max_burst: Maximum burst size.
 764 * @min_burst: Minimum burst size.
 765 *
 766 * Describes immutable attributes of packet trap policers that drivers register
 767 * with devlink.
 768 */
 769struct devlink_trap_policer {
 770	u32 id;
 771	u64 init_rate;
 772	u64 init_burst;
 773	u64 max_rate;
 774	u64 min_rate;
 775	u64 max_burst;
 776	u64 min_burst;
 777};
 778
 779/**
 780 * struct devlink_trap_group - Immutable packet trap group attributes.
 781 * @name: Trap group name.
 782 * @id: Trap group identifier.
 783 * @generic: Whether the trap group is generic or not.
 784 * @init_policer_id: Initial policer identifier.
 785 *
 786 * Describes immutable attributes of packet trap groups that drivers register
 787 * with devlink.
 788 */
 789struct devlink_trap_group {
 790	const char *name;
 791	u16 id;
 792	bool generic;
 793	u32 init_policer_id;
 794};
 795
 796#define DEVLINK_TRAP_METADATA_TYPE_F_IN_PORT	BIT(0)
 797#define DEVLINK_TRAP_METADATA_TYPE_F_FA_COOKIE	BIT(1)
 798
 799/**
 800 * struct devlink_trap - Immutable packet trap attributes.
 801 * @type: Trap type.
 802 * @init_action: Initial trap action.
 803 * @generic: Whether the trap is generic or not.
 804 * @id: Trap identifier.
 805 * @name: Trap name.
 806 * @init_group_id: Initial group identifier.
 807 * @metadata_cap: Metadata types that can be provided by the trap.
 808 *
 809 * Describes immutable attributes of packet traps that drivers register with
 810 * devlink.
 811 */
 812struct devlink_trap {
 813	enum devlink_trap_type type;
 814	enum devlink_trap_action init_action;
 815	bool generic;
 816	u16 id;
 817	const char *name;
 818	u16 init_group_id;
 819	u32 metadata_cap;
 820};
 821
 822/* All traps must be documented in
 823 * Documentation/networking/devlink/devlink-trap.rst
 824 */
 825enum devlink_trap_generic_id {
 826	DEVLINK_TRAP_GENERIC_ID_SMAC_MC,
 827	DEVLINK_TRAP_GENERIC_ID_VLAN_TAG_MISMATCH,
 828	DEVLINK_TRAP_GENERIC_ID_INGRESS_VLAN_FILTER,
 829	DEVLINK_TRAP_GENERIC_ID_INGRESS_STP_FILTER,
 830	DEVLINK_TRAP_GENERIC_ID_EMPTY_TX_LIST,
 831	DEVLINK_TRAP_GENERIC_ID_PORT_LOOPBACK_FILTER,
 832	DEVLINK_TRAP_GENERIC_ID_BLACKHOLE_ROUTE,
 833	DEVLINK_TRAP_GENERIC_ID_TTL_ERROR,
 834	DEVLINK_TRAP_GENERIC_ID_TAIL_DROP,
 835	DEVLINK_TRAP_GENERIC_ID_NON_IP_PACKET,
 836	DEVLINK_TRAP_GENERIC_ID_UC_DIP_MC_DMAC,
 837	DEVLINK_TRAP_GENERIC_ID_DIP_LB,
 838	DEVLINK_TRAP_GENERIC_ID_SIP_MC,
 839	DEVLINK_TRAP_GENERIC_ID_SIP_LB,
 840	DEVLINK_TRAP_GENERIC_ID_CORRUPTED_IP_HDR,
 841	DEVLINK_TRAP_GENERIC_ID_IPV4_SIP_BC,
 842	DEVLINK_TRAP_GENERIC_ID_IPV6_MC_DIP_RESERVED_SCOPE,
 843	DEVLINK_TRAP_GENERIC_ID_IPV6_MC_DIP_INTERFACE_LOCAL_SCOPE,
 844	DEVLINK_TRAP_GENERIC_ID_MTU_ERROR,
 845	DEVLINK_TRAP_GENERIC_ID_UNRESOLVED_NEIGH,
 846	DEVLINK_TRAP_GENERIC_ID_RPF,
 847	DEVLINK_TRAP_GENERIC_ID_REJECT_ROUTE,
 848	DEVLINK_TRAP_GENERIC_ID_IPV4_LPM_UNICAST_MISS,
 849	DEVLINK_TRAP_GENERIC_ID_IPV6_LPM_UNICAST_MISS,
 850	DEVLINK_TRAP_GENERIC_ID_NON_ROUTABLE,
 851	DEVLINK_TRAP_GENERIC_ID_DECAP_ERROR,
 852	DEVLINK_TRAP_GENERIC_ID_OVERLAY_SMAC_MC,
 853	DEVLINK_TRAP_GENERIC_ID_INGRESS_FLOW_ACTION_DROP,
 854	DEVLINK_TRAP_GENERIC_ID_EGRESS_FLOW_ACTION_DROP,
 855	DEVLINK_TRAP_GENERIC_ID_STP,
 856	DEVLINK_TRAP_GENERIC_ID_LACP,
 857	DEVLINK_TRAP_GENERIC_ID_LLDP,
 858	DEVLINK_TRAP_GENERIC_ID_IGMP_QUERY,
 859	DEVLINK_TRAP_GENERIC_ID_IGMP_V1_REPORT,
 860	DEVLINK_TRAP_GENERIC_ID_IGMP_V2_REPORT,
 861	DEVLINK_TRAP_GENERIC_ID_IGMP_V3_REPORT,
 862	DEVLINK_TRAP_GENERIC_ID_IGMP_V2_LEAVE,
 863	DEVLINK_TRAP_GENERIC_ID_MLD_QUERY,
 864	DEVLINK_TRAP_GENERIC_ID_MLD_V1_REPORT,
 865	DEVLINK_TRAP_GENERIC_ID_MLD_V2_REPORT,
 866	DEVLINK_TRAP_GENERIC_ID_MLD_V1_DONE,
 867	DEVLINK_TRAP_GENERIC_ID_IPV4_DHCP,
 868	DEVLINK_TRAP_GENERIC_ID_IPV6_DHCP,
 869	DEVLINK_TRAP_GENERIC_ID_ARP_REQUEST,
 870	DEVLINK_TRAP_GENERIC_ID_ARP_RESPONSE,
 871	DEVLINK_TRAP_GENERIC_ID_ARP_OVERLAY,
 872	DEVLINK_TRAP_GENERIC_ID_IPV6_NEIGH_SOLICIT,
 873	DEVLINK_TRAP_GENERIC_ID_IPV6_NEIGH_ADVERT,
 874	DEVLINK_TRAP_GENERIC_ID_IPV4_BFD,
 875	DEVLINK_TRAP_GENERIC_ID_IPV6_BFD,
 876	DEVLINK_TRAP_GENERIC_ID_IPV4_OSPF,
 877	DEVLINK_TRAP_GENERIC_ID_IPV6_OSPF,
 878	DEVLINK_TRAP_GENERIC_ID_IPV4_BGP,
 879	DEVLINK_TRAP_GENERIC_ID_IPV6_BGP,
 880	DEVLINK_TRAP_GENERIC_ID_IPV4_VRRP,
 881	DEVLINK_TRAP_GENERIC_ID_IPV6_VRRP,
 882	DEVLINK_TRAP_GENERIC_ID_IPV4_PIM,
 883	DEVLINK_TRAP_GENERIC_ID_IPV6_PIM,
 884	DEVLINK_TRAP_GENERIC_ID_UC_LB,
 885	DEVLINK_TRAP_GENERIC_ID_LOCAL_ROUTE,
 886	DEVLINK_TRAP_GENERIC_ID_EXTERNAL_ROUTE,
 887	DEVLINK_TRAP_GENERIC_ID_IPV6_UC_DIP_LINK_LOCAL_SCOPE,
 888	DEVLINK_TRAP_GENERIC_ID_IPV6_DIP_ALL_NODES,
 889	DEVLINK_TRAP_GENERIC_ID_IPV6_DIP_ALL_ROUTERS,
 890	DEVLINK_TRAP_GENERIC_ID_IPV6_ROUTER_SOLICIT,
 891	DEVLINK_TRAP_GENERIC_ID_IPV6_ROUTER_ADVERT,
 892	DEVLINK_TRAP_GENERIC_ID_IPV6_REDIRECT,
 893	DEVLINK_TRAP_GENERIC_ID_IPV4_ROUTER_ALERT,
 894	DEVLINK_TRAP_GENERIC_ID_IPV6_ROUTER_ALERT,
 895	DEVLINK_TRAP_GENERIC_ID_PTP_EVENT,
 896	DEVLINK_TRAP_GENERIC_ID_PTP_GENERAL,
 897	DEVLINK_TRAP_GENERIC_ID_FLOW_ACTION_SAMPLE,
 898	DEVLINK_TRAP_GENERIC_ID_FLOW_ACTION_TRAP,
 899	DEVLINK_TRAP_GENERIC_ID_EARLY_DROP,
 900	DEVLINK_TRAP_GENERIC_ID_VXLAN_PARSING,
 901	DEVLINK_TRAP_GENERIC_ID_LLC_SNAP_PARSING,
 902	DEVLINK_TRAP_GENERIC_ID_VLAN_PARSING,
 903	DEVLINK_TRAP_GENERIC_ID_PPPOE_PPP_PARSING,
 904	DEVLINK_TRAP_GENERIC_ID_MPLS_PARSING,
 905	DEVLINK_TRAP_GENERIC_ID_ARP_PARSING,
 906	DEVLINK_TRAP_GENERIC_ID_IP_1_PARSING,
 907	DEVLINK_TRAP_GENERIC_ID_IP_N_PARSING,
 908	DEVLINK_TRAP_GENERIC_ID_GRE_PARSING,
 909	DEVLINK_TRAP_GENERIC_ID_UDP_PARSING,
 910	DEVLINK_TRAP_GENERIC_ID_TCP_PARSING,
 911	DEVLINK_TRAP_GENERIC_ID_IPSEC_PARSING,
 912	DEVLINK_TRAP_GENERIC_ID_SCTP_PARSING,
 913	DEVLINK_TRAP_GENERIC_ID_DCCP_PARSING,
 914	DEVLINK_TRAP_GENERIC_ID_GTP_PARSING,
 915	DEVLINK_TRAP_GENERIC_ID_ESP_PARSING,
 916	DEVLINK_TRAP_GENERIC_ID_BLACKHOLE_NEXTHOP,
 917	DEVLINK_TRAP_GENERIC_ID_DMAC_FILTER,
 918	DEVLINK_TRAP_GENERIC_ID_EAPOL,
 919	DEVLINK_TRAP_GENERIC_ID_LOCKED_PORT,
 920
 921	/* Add new generic trap IDs above */
 922	__DEVLINK_TRAP_GENERIC_ID_MAX,
 923	DEVLINK_TRAP_GENERIC_ID_MAX = __DEVLINK_TRAP_GENERIC_ID_MAX - 1,
 924};
 925
 926/* All trap groups must be documented in
 927 * Documentation/networking/devlink/devlink-trap.rst
 928 */
 929enum devlink_trap_group_generic_id {
 930	DEVLINK_TRAP_GROUP_GENERIC_ID_L2_DROPS,
 931	DEVLINK_TRAP_GROUP_GENERIC_ID_L3_DROPS,
 932	DEVLINK_TRAP_GROUP_GENERIC_ID_L3_EXCEPTIONS,
 933	DEVLINK_TRAP_GROUP_GENERIC_ID_BUFFER_DROPS,
 934	DEVLINK_TRAP_GROUP_GENERIC_ID_TUNNEL_DROPS,
 935	DEVLINK_TRAP_GROUP_GENERIC_ID_ACL_DROPS,
 936	DEVLINK_TRAP_GROUP_GENERIC_ID_STP,
 937	DEVLINK_TRAP_GROUP_GENERIC_ID_LACP,
 938	DEVLINK_TRAP_GROUP_GENERIC_ID_LLDP,
 939	DEVLINK_TRAP_GROUP_GENERIC_ID_MC_SNOOPING,
 940	DEVLINK_TRAP_GROUP_GENERIC_ID_DHCP,
 941	DEVLINK_TRAP_GROUP_GENERIC_ID_NEIGH_DISCOVERY,
 942	DEVLINK_TRAP_GROUP_GENERIC_ID_BFD,
 943	DEVLINK_TRAP_GROUP_GENERIC_ID_OSPF,
 944	DEVLINK_TRAP_GROUP_GENERIC_ID_BGP,
 945	DEVLINK_TRAP_GROUP_GENERIC_ID_VRRP,
 946	DEVLINK_TRAP_GROUP_GENERIC_ID_PIM,
 947	DEVLINK_TRAP_GROUP_GENERIC_ID_UC_LB,
 948	DEVLINK_TRAP_GROUP_GENERIC_ID_LOCAL_DELIVERY,
 949	DEVLINK_TRAP_GROUP_GENERIC_ID_EXTERNAL_DELIVERY,
 950	DEVLINK_TRAP_GROUP_GENERIC_ID_IPV6,
 951	DEVLINK_TRAP_GROUP_GENERIC_ID_PTP_EVENT,
 952	DEVLINK_TRAP_GROUP_GENERIC_ID_PTP_GENERAL,
 953	DEVLINK_TRAP_GROUP_GENERIC_ID_ACL_SAMPLE,
 954	DEVLINK_TRAP_GROUP_GENERIC_ID_ACL_TRAP,
 955	DEVLINK_TRAP_GROUP_GENERIC_ID_PARSER_ERROR_DROPS,
 956	DEVLINK_TRAP_GROUP_GENERIC_ID_EAPOL,
 957
 958	/* Add new generic trap group IDs above */
 959	__DEVLINK_TRAP_GROUP_GENERIC_ID_MAX,
 960	DEVLINK_TRAP_GROUP_GENERIC_ID_MAX =
 961		__DEVLINK_TRAP_GROUP_GENERIC_ID_MAX - 1,
 962};
 963
 964#define DEVLINK_TRAP_GENERIC_NAME_SMAC_MC \
 965	"source_mac_is_multicast"
 966#define DEVLINK_TRAP_GENERIC_NAME_VLAN_TAG_MISMATCH \
 967	"vlan_tag_mismatch"
 968#define DEVLINK_TRAP_GENERIC_NAME_INGRESS_VLAN_FILTER \
 969	"ingress_vlan_filter"
 970#define DEVLINK_TRAP_GENERIC_NAME_INGRESS_STP_FILTER \
 971	"ingress_spanning_tree_filter"
 972#define DEVLINK_TRAP_GENERIC_NAME_EMPTY_TX_LIST \
 973	"port_list_is_empty"
 974#define DEVLINK_TRAP_GENERIC_NAME_PORT_LOOPBACK_FILTER \
 975	"port_loopback_filter"
 976#define DEVLINK_TRAP_GENERIC_NAME_BLACKHOLE_ROUTE \
 977	"blackhole_route"
 978#define DEVLINK_TRAP_GENERIC_NAME_TTL_ERROR \
 979	"ttl_value_is_too_small"
 980#define DEVLINK_TRAP_GENERIC_NAME_TAIL_DROP \
 981	"tail_drop"
 982#define DEVLINK_TRAP_GENERIC_NAME_NON_IP_PACKET \
 983	"non_ip"
 984#define DEVLINK_TRAP_GENERIC_NAME_UC_DIP_MC_DMAC \
 985	"uc_dip_over_mc_dmac"
 986#define DEVLINK_TRAP_GENERIC_NAME_DIP_LB \
 987	"dip_is_loopback_address"
 988#define DEVLINK_TRAP_GENERIC_NAME_SIP_MC \
 989	"sip_is_mc"
 990#define DEVLINK_TRAP_GENERIC_NAME_SIP_LB \
 991	"sip_is_loopback_address"
 992#define DEVLINK_TRAP_GENERIC_NAME_CORRUPTED_IP_HDR \
 993	"ip_header_corrupted"
 994#define DEVLINK_TRAP_GENERIC_NAME_IPV4_SIP_BC \
 995	"ipv4_sip_is_limited_bc"
 996#define DEVLINK_TRAP_GENERIC_NAME_IPV6_MC_DIP_RESERVED_SCOPE \
 997	"ipv6_mc_dip_reserved_scope"
 998#define DEVLINK_TRAP_GENERIC_NAME_IPV6_MC_DIP_INTERFACE_LOCAL_SCOPE \
 999	"ipv6_mc_dip_interface_local_scope"
1000#define DEVLINK_TRAP_GENERIC_NAME_MTU_ERROR \
1001	"mtu_value_is_too_small"
1002#define DEVLINK_TRAP_GENERIC_NAME_UNRESOLVED_NEIGH \
1003	"unresolved_neigh"
1004#define DEVLINK_TRAP_GENERIC_NAME_RPF \
1005	"mc_reverse_path_forwarding"
1006#define DEVLINK_TRAP_GENERIC_NAME_REJECT_ROUTE \
1007	"reject_route"
1008#define DEVLINK_TRAP_GENERIC_NAME_IPV4_LPM_UNICAST_MISS \
1009	"ipv4_lpm_miss"
1010#define DEVLINK_TRAP_GENERIC_NAME_IPV6_LPM_UNICAST_MISS \
1011	"ipv6_lpm_miss"
1012#define DEVLINK_TRAP_GENERIC_NAME_NON_ROUTABLE \
1013	"non_routable_packet"
1014#define DEVLINK_TRAP_GENERIC_NAME_DECAP_ERROR \
1015	"decap_error"
1016#define DEVLINK_TRAP_GENERIC_NAME_OVERLAY_SMAC_MC \
1017	"overlay_smac_is_mc"
1018#define DEVLINK_TRAP_GENERIC_NAME_INGRESS_FLOW_ACTION_DROP \
1019	"ingress_flow_action_drop"
1020#define DEVLINK_TRAP_GENERIC_NAME_EGRESS_FLOW_ACTION_DROP \
1021	"egress_flow_action_drop"
1022#define DEVLINK_TRAP_GENERIC_NAME_STP \
1023	"stp"
1024#define DEVLINK_TRAP_GENERIC_NAME_LACP \
1025	"lacp"
1026#define DEVLINK_TRAP_GENERIC_NAME_LLDP \
1027	"lldp"
1028#define DEVLINK_TRAP_GENERIC_NAME_IGMP_QUERY \
1029	"igmp_query"
1030#define DEVLINK_TRAP_GENERIC_NAME_IGMP_V1_REPORT \
1031	"igmp_v1_report"
1032#define DEVLINK_TRAP_GENERIC_NAME_IGMP_V2_REPORT \
1033	"igmp_v2_report"
1034#define DEVLINK_TRAP_GENERIC_NAME_IGMP_V3_REPORT \
1035	"igmp_v3_report"
1036#define DEVLINK_TRAP_GENERIC_NAME_IGMP_V2_LEAVE \
1037	"igmp_v2_leave"
1038#define DEVLINK_TRAP_GENERIC_NAME_MLD_QUERY \
1039	"mld_query"
1040#define DEVLINK_TRAP_GENERIC_NAME_MLD_V1_REPORT \
1041	"mld_v1_report"
1042#define DEVLINK_TRAP_GENERIC_NAME_MLD_V2_REPORT \
1043	"mld_v2_report"
1044#define DEVLINK_TRAP_GENERIC_NAME_MLD_V1_DONE \
1045	"mld_v1_done"
1046#define DEVLINK_TRAP_GENERIC_NAME_IPV4_DHCP \
1047	"ipv4_dhcp"
1048#define DEVLINK_TRAP_GENERIC_NAME_IPV6_DHCP \
1049	"ipv6_dhcp"
1050#define DEVLINK_TRAP_GENERIC_NAME_ARP_REQUEST \
1051	"arp_request"
1052#define DEVLINK_TRAP_GENERIC_NAME_ARP_RESPONSE \
1053	"arp_response"
1054#define DEVLINK_TRAP_GENERIC_NAME_ARP_OVERLAY \
1055	"arp_overlay"
1056#define DEVLINK_TRAP_GENERIC_NAME_IPV6_NEIGH_SOLICIT \
1057	"ipv6_neigh_solicit"
1058#define DEVLINK_TRAP_GENERIC_NAME_IPV6_NEIGH_ADVERT \
1059	"ipv6_neigh_advert"
1060#define DEVLINK_TRAP_GENERIC_NAME_IPV4_BFD \
1061	"ipv4_bfd"
1062#define DEVLINK_TRAP_GENERIC_NAME_IPV6_BFD \
1063	"ipv6_bfd"
1064#define DEVLINK_TRAP_GENERIC_NAME_IPV4_OSPF \
1065	"ipv4_ospf"
1066#define DEVLINK_TRAP_GENERIC_NAME_IPV6_OSPF \
1067	"ipv6_ospf"
1068#define DEVLINK_TRAP_GENERIC_NAME_IPV4_BGP \
1069	"ipv4_bgp"
1070#define DEVLINK_TRAP_GENERIC_NAME_IPV6_BGP \
1071	"ipv6_bgp"
1072#define DEVLINK_TRAP_GENERIC_NAME_IPV4_VRRP \
1073	"ipv4_vrrp"
1074#define DEVLINK_TRAP_GENERIC_NAME_IPV6_VRRP \
1075	"ipv6_vrrp"
1076#define DEVLINK_TRAP_GENERIC_NAME_IPV4_PIM \
1077	"ipv4_pim"
1078#define DEVLINK_TRAP_GENERIC_NAME_IPV6_PIM \
1079	"ipv6_pim"
1080#define DEVLINK_TRAP_GENERIC_NAME_UC_LB \
1081	"uc_loopback"
1082#define DEVLINK_TRAP_GENERIC_NAME_LOCAL_ROUTE \
1083	"local_route"
1084#define DEVLINK_TRAP_GENERIC_NAME_EXTERNAL_ROUTE \
1085	"external_route"
1086#define DEVLINK_TRAP_GENERIC_NAME_IPV6_UC_DIP_LINK_LOCAL_SCOPE \
1087	"ipv6_uc_dip_link_local_scope"
1088#define DEVLINK_TRAP_GENERIC_NAME_IPV6_DIP_ALL_NODES \
1089	"ipv6_dip_all_nodes"
1090#define DEVLINK_TRAP_GENERIC_NAME_IPV6_DIP_ALL_ROUTERS \
1091	"ipv6_dip_all_routers"
1092#define DEVLINK_TRAP_GENERIC_NAME_IPV6_ROUTER_SOLICIT \
1093	"ipv6_router_solicit"
1094#define DEVLINK_TRAP_GENERIC_NAME_IPV6_ROUTER_ADVERT \
1095	"ipv6_router_advert"
1096#define DEVLINK_TRAP_GENERIC_NAME_IPV6_REDIRECT \
1097	"ipv6_redirect"
1098#define DEVLINK_TRAP_GENERIC_NAME_IPV4_ROUTER_ALERT \
1099	"ipv4_router_alert"
1100#define DEVLINK_TRAP_GENERIC_NAME_IPV6_ROUTER_ALERT \
1101	"ipv6_router_alert"
1102#define DEVLINK_TRAP_GENERIC_NAME_PTP_EVENT \
1103	"ptp_event"
1104#define DEVLINK_TRAP_GENERIC_NAME_PTP_GENERAL \
1105	"ptp_general"
1106#define DEVLINK_TRAP_GENERIC_NAME_FLOW_ACTION_SAMPLE \
1107	"flow_action_sample"
1108#define DEVLINK_TRAP_GENERIC_NAME_FLOW_ACTION_TRAP \
1109	"flow_action_trap"
1110#define DEVLINK_TRAP_GENERIC_NAME_EARLY_DROP \
1111	"early_drop"
1112#define DEVLINK_TRAP_GENERIC_NAME_VXLAN_PARSING \
1113	"vxlan_parsing"
1114#define DEVLINK_TRAP_GENERIC_NAME_LLC_SNAP_PARSING \
1115	"llc_snap_parsing"
1116#define DEVLINK_TRAP_GENERIC_NAME_VLAN_PARSING \
1117	"vlan_parsing"
1118#define DEVLINK_TRAP_GENERIC_NAME_PPPOE_PPP_PARSING \
1119	"pppoe_ppp_parsing"
1120#define DEVLINK_TRAP_GENERIC_NAME_MPLS_PARSING \
1121	"mpls_parsing"
1122#define DEVLINK_TRAP_GENERIC_NAME_ARP_PARSING \
1123	"arp_parsing"
1124#define DEVLINK_TRAP_GENERIC_NAME_IP_1_PARSING \
1125	"ip_1_parsing"
1126#define DEVLINK_TRAP_GENERIC_NAME_IP_N_PARSING \
1127	"ip_n_parsing"
1128#define DEVLINK_TRAP_GENERIC_NAME_GRE_PARSING \
1129	"gre_parsing"
1130#define DEVLINK_TRAP_GENERIC_NAME_UDP_PARSING \
1131	"udp_parsing"
1132#define DEVLINK_TRAP_GENERIC_NAME_TCP_PARSING \
1133	"tcp_parsing"
1134#define DEVLINK_TRAP_GENERIC_NAME_IPSEC_PARSING \
1135	"ipsec_parsing"
1136#define DEVLINK_TRAP_GENERIC_NAME_SCTP_PARSING \
1137	"sctp_parsing"
1138#define DEVLINK_TRAP_GENERIC_NAME_DCCP_PARSING \
1139	"dccp_parsing"
1140#define DEVLINK_TRAP_GENERIC_NAME_GTP_PARSING \
1141	"gtp_parsing"
1142#define DEVLINK_TRAP_GENERIC_NAME_ESP_PARSING \
1143	"esp_parsing"
1144#define DEVLINK_TRAP_GENERIC_NAME_BLACKHOLE_NEXTHOP \
1145	"blackhole_nexthop"
1146#define DEVLINK_TRAP_GENERIC_NAME_DMAC_FILTER \
1147	"dmac_filter"
1148#define DEVLINK_TRAP_GENERIC_NAME_EAPOL \
1149	"eapol"
1150#define DEVLINK_TRAP_GENERIC_NAME_LOCKED_PORT \
1151	"locked_port"
1152
1153#define DEVLINK_TRAP_GROUP_GENERIC_NAME_L2_DROPS \
1154	"l2_drops"
1155#define DEVLINK_TRAP_GROUP_GENERIC_NAME_L3_DROPS \
1156	"l3_drops"
1157#define DEVLINK_TRAP_GROUP_GENERIC_NAME_L3_EXCEPTIONS \
1158	"l3_exceptions"
1159#define DEVLINK_TRAP_GROUP_GENERIC_NAME_BUFFER_DROPS \
1160	"buffer_drops"
1161#define DEVLINK_TRAP_GROUP_GENERIC_NAME_TUNNEL_DROPS \
1162	"tunnel_drops"
1163#define DEVLINK_TRAP_GROUP_GENERIC_NAME_ACL_DROPS \
1164	"acl_drops"
1165#define DEVLINK_TRAP_GROUP_GENERIC_NAME_STP \
1166	"stp"
1167#define DEVLINK_TRAP_GROUP_GENERIC_NAME_LACP \
1168	"lacp"
1169#define DEVLINK_TRAP_GROUP_GENERIC_NAME_LLDP \
1170	"lldp"
1171#define DEVLINK_TRAP_GROUP_GENERIC_NAME_MC_SNOOPING  \
1172	"mc_snooping"
1173#define DEVLINK_TRAP_GROUP_GENERIC_NAME_DHCP \
1174	"dhcp"
1175#define DEVLINK_TRAP_GROUP_GENERIC_NAME_NEIGH_DISCOVERY \
1176	"neigh_discovery"
1177#define DEVLINK_TRAP_GROUP_GENERIC_NAME_BFD \
1178	"bfd"
1179#define DEVLINK_TRAP_GROUP_GENERIC_NAME_OSPF \
1180	"ospf"
1181#define DEVLINK_TRAP_GROUP_GENERIC_NAME_BGP \
1182	"bgp"
1183#define DEVLINK_TRAP_GROUP_GENERIC_NAME_VRRP \
1184	"vrrp"
1185#define DEVLINK_TRAP_GROUP_GENERIC_NAME_PIM \
1186	"pim"
1187#define DEVLINK_TRAP_GROUP_GENERIC_NAME_UC_LB \
1188	"uc_loopback"
1189#define DEVLINK_TRAP_GROUP_GENERIC_NAME_LOCAL_DELIVERY \
1190	"local_delivery"
1191#define DEVLINK_TRAP_GROUP_GENERIC_NAME_EXTERNAL_DELIVERY \
1192	"external_delivery"
1193#define DEVLINK_TRAP_GROUP_GENERIC_NAME_IPV6 \
1194	"ipv6"
1195#define DEVLINK_TRAP_GROUP_GENERIC_NAME_PTP_EVENT \
1196	"ptp_event"
1197#define DEVLINK_TRAP_GROUP_GENERIC_NAME_PTP_GENERAL \
1198	"ptp_general"
1199#define DEVLINK_TRAP_GROUP_GENERIC_NAME_ACL_SAMPLE \
1200	"acl_sample"
1201#define DEVLINK_TRAP_GROUP_GENERIC_NAME_ACL_TRAP \
1202	"acl_trap"
1203#define DEVLINK_TRAP_GROUP_GENERIC_NAME_PARSER_ERROR_DROPS \
1204	"parser_error_drops"
1205#define DEVLINK_TRAP_GROUP_GENERIC_NAME_EAPOL \
1206	"eapol"
1207
1208#define DEVLINK_TRAP_GENERIC(_type, _init_action, _id, _group_id,	      \
1209			     _metadata_cap)				      \
1210	{								      \
1211		.type = DEVLINK_TRAP_TYPE_##_type,			      \
1212		.init_action = DEVLINK_TRAP_ACTION_##_init_action,	      \
1213		.generic = true,					      \
1214		.id = DEVLINK_TRAP_GENERIC_ID_##_id,			      \
1215		.name = DEVLINK_TRAP_GENERIC_NAME_##_id,		      \
1216		.init_group_id = _group_id,				      \
1217		.metadata_cap = _metadata_cap,				      \
1218	}
1219
1220#define DEVLINK_TRAP_DRIVER(_type, _init_action, _id, _name, _group_id,	      \
1221			    _metadata_cap)				      \
1222	{								      \
1223		.type = DEVLINK_TRAP_TYPE_##_type,			      \
1224		.init_action = DEVLINK_TRAP_ACTION_##_init_action,	      \
1225		.generic = false,					      \
1226		.id = _id,						      \
1227		.name = _name,						      \
1228		.init_group_id = _group_id,				      \
1229		.metadata_cap = _metadata_cap,				      \
1230	}
1231
1232#define DEVLINK_TRAP_GROUP_GENERIC(_id, _policer_id)			      \
1233	{								      \
1234		.name = DEVLINK_TRAP_GROUP_GENERIC_NAME_##_id,		      \
1235		.id = DEVLINK_TRAP_GROUP_GENERIC_ID_##_id,		      \
1236		.generic = true,					      \
1237		.init_policer_id = _policer_id,				      \
1238	}
1239
1240#define DEVLINK_TRAP_POLICER(_id, _rate, _burst, _max_rate, _min_rate,	      \
1241			     _max_burst, _min_burst)			      \
1242	{								      \
1243		.id = _id,						      \
1244		.init_rate = _rate,					      \
1245		.init_burst = _burst,					      \
1246		.max_rate = _max_rate,					      \
1247		.min_rate = _min_rate,					      \
1248		.max_burst = _max_burst,				      \
1249		.min_burst = _min_burst,				      \
1250	}
1251
1252enum {
1253	/* device supports reload operations */
1254	DEVLINK_F_RELOAD = 1UL << 0,
1255};
1256
1257struct devlink_ops {
1258	/**
1259	 * @supported_flash_update_params:
1260	 * mask of parameters supported by the driver's .flash_update
1261	 * implemementation.
1262	 */
1263	u32 supported_flash_update_params;
1264	unsigned long reload_actions;
1265	unsigned long reload_limits;
1266	int (*reload_down)(struct devlink *devlink, bool netns_change,
1267			   enum devlink_reload_action action,
1268			   enum devlink_reload_limit limit,
1269			   struct netlink_ext_ack *extack);
1270	int (*reload_up)(struct devlink *devlink, enum devlink_reload_action action,
1271			 enum devlink_reload_limit limit, u32 *actions_performed,
1272			 struct netlink_ext_ack *extack);
1273	int (*port_type_set)(struct devlink_port *devlink_port,
1274			     enum devlink_port_type port_type);
1275	int (*port_split)(struct devlink *devlink, struct devlink_port *port,
1276			  unsigned int count, struct netlink_ext_ack *extack);
1277	int (*port_unsplit)(struct devlink *devlink, struct devlink_port *port,
1278			    struct netlink_ext_ack *extack);
1279	int (*sb_pool_get)(struct devlink *devlink, unsigned int sb_index,
1280			   u16 pool_index,
1281			   struct devlink_sb_pool_info *pool_info);
1282	int (*sb_pool_set)(struct devlink *devlink, unsigned int sb_index,
1283			   u16 pool_index, u32 size,
1284			   enum devlink_sb_threshold_type threshold_type,
1285			   struct netlink_ext_ack *extack);
1286	int (*sb_port_pool_get)(struct devlink_port *devlink_port,
1287				unsigned int sb_index, u16 pool_index,
1288				u32 *p_threshold);
1289	int (*sb_port_pool_set)(struct devlink_port *devlink_port,
1290				unsigned int sb_index, u16 pool_index,
1291				u32 threshold, struct netlink_ext_ack *extack);
1292	int (*sb_tc_pool_bind_get)(struct devlink_port *devlink_port,
1293				   unsigned int sb_index,
1294				   u16 tc_index,
1295				   enum devlink_sb_pool_type pool_type,
1296				   u16 *p_pool_index, u32 *p_threshold);
1297	int (*sb_tc_pool_bind_set)(struct devlink_port *devlink_port,
1298				   unsigned int sb_index,
1299				   u16 tc_index,
1300				   enum devlink_sb_pool_type pool_type,
1301				   u16 pool_index, u32 threshold,
1302				   struct netlink_ext_ack *extack);
1303	int (*sb_occ_snapshot)(struct devlink *devlink,
1304			       unsigned int sb_index);
1305	int (*sb_occ_max_clear)(struct devlink *devlink,
1306				unsigned int sb_index);
1307	int (*sb_occ_port_pool_get)(struct devlink_port *devlink_port,
1308				    unsigned int sb_index, u16 pool_index,
1309				    u32 *p_cur, u32 *p_max);
1310	int (*sb_occ_tc_port_bind_get)(struct devlink_port *devlink_port,
1311				       unsigned int sb_index,
1312				       u16 tc_index,
1313				       enum devlink_sb_pool_type pool_type,
1314				       u32 *p_cur, u32 *p_max);
1315
1316	int (*eswitch_mode_get)(struct devlink *devlink, u16 *p_mode);
1317	int (*eswitch_mode_set)(struct devlink *devlink, u16 mode,
1318				struct netlink_ext_ack *extack);
1319	int (*eswitch_inline_mode_get)(struct devlink *devlink, u8 *p_inline_mode);
1320	int (*eswitch_inline_mode_set)(struct devlink *devlink, u8 inline_mode,
1321				       struct netlink_ext_ack *extack);
1322	int (*eswitch_encap_mode_get)(struct devlink *devlink,
1323				      enum devlink_eswitch_encap_mode *p_encap_mode);
1324	int (*eswitch_encap_mode_set)(struct devlink *devlink,
1325				      enum devlink_eswitch_encap_mode encap_mode,
1326				      struct netlink_ext_ack *extack);
1327	int (*info_get)(struct devlink *devlink, struct devlink_info_req *req,
1328			struct netlink_ext_ack *extack);
1329	/**
1330	 * @flash_update: Device flash update function
1331	 *
1332	 * Used to perform a flash update for the device. The set of
1333	 * parameters supported by the driver should be set in
1334	 * supported_flash_update_params.
1335	 */
1336	int (*flash_update)(struct devlink *devlink,
1337			    struct devlink_flash_update_params *params,
1338			    struct netlink_ext_ack *extack);
1339	/**
1340	 * @trap_init: Trap initialization function.
1341	 *
1342	 * Should be used by device drivers to initialize the trap in the
1343	 * underlying device. Drivers should also store the provided trap
1344	 * context, so that they could efficiently pass it to
1345	 * devlink_trap_report() when the trap is triggered.
1346	 */
1347	int (*trap_init)(struct devlink *devlink,
1348			 const struct devlink_trap *trap, void *trap_ctx);
1349	/**
1350	 * @trap_fini: Trap de-initialization function.
1351	 *
1352	 * Should be used by device drivers to de-initialize the trap in the
1353	 * underlying device.
1354	 */
1355	void (*trap_fini)(struct devlink *devlink,
1356			  const struct devlink_trap *trap, void *trap_ctx);
1357	/**
1358	 * @trap_action_set: Trap action set function.
1359	 */
1360	int (*trap_action_set)(struct devlink *devlink,
1361			       const struct devlink_trap *trap,
1362			       enum devlink_trap_action action,
1363			       struct netlink_ext_ack *extack);
1364	/**
1365	 * @trap_group_init: Trap group initialization function.
1366	 *
1367	 * Should be used by device drivers to initialize the trap group in the
1368	 * underlying device.
1369	 */
1370	int (*trap_group_init)(struct devlink *devlink,
1371			       const struct devlink_trap_group *group);
1372	/**
1373	 * @trap_group_set: Trap group parameters set function.
1374	 *
1375	 * Note: @policer can be NULL when a policer is being unbound from
1376	 * @group.
1377	 */
1378	int (*trap_group_set)(struct devlink *devlink,
1379			      const struct devlink_trap_group *group,
1380			      const struct devlink_trap_policer *policer,
1381			      struct netlink_ext_ack *extack);
1382	/**
1383	 * @trap_group_action_set: Trap group action set function.
1384	 *
1385	 * If this callback is populated, it will take precedence over looping
1386	 * over all traps in a group and calling .trap_action_set().
1387	 */
1388	int (*trap_group_action_set)(struct devlink *devlink,
1389				     const struct devlink_trap_group *group,
1390				     enum devlink_trap_action action,
1391				     struct netlink_ext_ack *extack);
1392	/**
1393	 * @trap_drop_counter_get: Trap drop counter get function.
1394	 *
1395	 * Should be used by device drivers to report number of packets
1396	 * that have been dropped, and cannot be passed to the devlink
1397	 * subsystem by the underlying device.
1398	 */
1399	int (*trap_drop_counter_get)(struct devlink *devlink,
1400				     const struct devlink_trap *trap,
1401				     u64 *p_drops);
1402	/**
1403	 * @trap_policer_init: Trap policer initialization function.
1404	 *
1405	 * Should be used by device drivers to initialize the trap policer in
1406	 * the underlying device.
1407	 */
1408	int (*trap_policer_init)(struct devlink *devlink,
1409				 const struct devlink_trap_policer *policer);
1410	/**
1411	 * @trap_policer_fini: Trap policer de-initialization function.
1412	 *
1413	 * Should be used by device drivers to de-initialize the trap policer
1414	 * in the underlying device.
1415	 */
1416	void (*trap_policer_fini)(struct devlink *devlink,
1417				  const struct devlink_trap_policer *policer);
1418	/**
1419	 * @trap_policer_set: Trap policer parameters set function.
1420	 */
1421	int (*trap_policer_set)(struct devlink *devlink,
1422				const struct devlink_trap_policer *policer,
1423				u64 rate, u64 burst,
1424				struct netlink_ext_ack *extack);
1425	/**
1426	 * @trap_policer_counter_get: Trap policer counter get function.
1427	 *
1428	 * Should be used by device drivers to report number of packets dropped
1429	 * by the policer.
1430	 */
1431	int (*trap_policer_counter_get)(struct devlink *devlink,
1432					const struct devlink_trap_policer *policer,
1433					u64 *p_drops);
1434	/**
1435	 * @port_function_hw_addr_get: Port function's hardware address get function.
1436	 *
1437	 * Should be used by device drivers to report the hardware address of a function managed
1438	 * by the devlink port. Driver should return -EOPNOTSUPP if it doesn't support port
1439	 * function handling for a particular port.
1440	 *
1441	 * Note: @extack can be NULL when port notifier queries the port function.
1442	 */
1443	int (*port_function_hw_addr_get)(struct devlink_port *port, u8 *hw_addr,
1444					 int *hw_addr_len,
1445					 struct netlink_ext_ack *extack);
1446	/**
1447	 * @port_function_hw_addr_set: Port function's hardware address set function.
1448	 *
1449	 * Should be used by device drivers to set the hardware address of a function managed
1450	 * by the devlink port. Driver should return -EOPNOTSUPP if it doesn't support port
1451	 * function handling for a particular port.
1452	 */
1453	int (*port_function_hw_addr_set)(struct devlink_port *port,
1454					 const u8 *hw_addr, int hw_addr_len,
1455					 struct netlink_ext_ack *extack);
1456	/**
1457	 * @port_fn_roce_get: Port function's roce get function.
1458	 *
1459	 * Query RoCE state of a function managed by the devlink port.
1460	 * Return -EOPNOTSUPP if port function RoCE handling is not supported.
1461	 */
1462	int (*port_fn_roce_get)(struct devlink_port *devlink_port,
1463				bool *is_enable,
1464				struct netlink_ext_ack *extack);
1465	/**
1466	 * @port_fn_roce_set: Port function's roce set function.
1467	 *
1468	 * Enable/Disable the RoCE state of a function managed by the devlink
1469	 * port.
1470	 * Return -EOPNOTSUPP if port function RoCE handling is not supported.
1471	 */
1472	int (*port_fn_roce_set)(struct devlink_port *devlink_port,
1473				bool enable, struct netlink_ext_ack *extack);
1474	/**
1475	 * @port_fn_migratable_get: Port function's migratable get function.
1476	 *
1477	 * Query migratable state of a function managed by the devlink port.
1478	 * Return -EOPNOTSUPP if port function migratable handling is not
1479	 * supported.
1480	 */
1481	int (*port_fn_migratable_get)(struct devlink_port *devlink_port,
1482				      bool *is_enable,
1483				      struct netlink_ext_ack *extack);
1484	/**
1485	 * @port_fn_migratable_set: Port function's migratable set function.
1486	 *
1487	 * Enable/Disable migratable state of a function managed by the devlink
1488	 * port.
1489	 * Return -EOPNOTSUPP if port function migratable handling is not
1490	 * supported.
1491	 */
1492	int (*port_fn_migratable_set)(struct devlink_port *devlink_port,
1493				      bool enable,
1494				      struct netlink_ext_ack *extack);
1495	/**
1496	 * port_new() - Add a new port function of a specified flavor
1497	 * @devlink: Devlink instance
1498	 * @attrs: attributes of the new port
1499	 * @extack: extack for reporting error messages
1500	 * @new_port_index: index of the new port
1501	 *
1502	 * Devlink core will call this device driver function upon user request
1503	 * to create a new port function of a specified flavor and optional
1504	 * attributes
1505	 *
1506	 * Notes:
1507	 *	- Called without devlink instance lock being held. Drivers must
1508	 *	  implement own means of synchronization
1509	 *	- On success, drivers must register a port with devlink core
1510	 *
1511	 * Return: 0 on success, negative value otherwise.
1512	 */
1513	int (*port_new)(struct devlink *devlink,
1514			const struct devlink_port_new_attrs *attrs,
1515			struct netlink_ext_ack *extack,
1516			unsigned int *new_port_index);
1517	/**
1518	 * port_del() - Delete a port function
1519	 * @devlink: Devlink instance
1520	 * @port_index: port function index to delete
1521	 * @extack: extack for reporting error messages
1522	 *
1523	 * Devlink core will call this device driver function upon user request
1524	 * to delete a previously created port function
1525	 *
1526	 * Notes:
1527	 *	- Called without devlink instance lock being held. Drivers must
1528	 *	  implement own means of synchronization
1529	 *	- On success, drivers must unregister the corresponding devlink
1530	 *	  port
1531	 *
1532	 * Return: 0 on success, negative value otherwise.
1533	 */
1534	int (*port_del)(struct devlink *devlink, unsigned int port_index,
1535			struct netlink_ext_ack *extack);
1536	/**
1537	 * port_fn_state_get() - Get the state of a port function
1538	 * @devlink: Devlink instance
1539	 * @port: The devlink port
1540	 * @state: Admin configured state
1541	 * @opstate: Current operational state
1542	 * @extack: extack for reporting error messages
1543	 *
1544	 * Reports the admin and operational state of a devlink port function
1545	 *
1546	 * Return: 0 on success, negative value otherwise.
1547	 */
1548	int (*port_fn_state_get)(struct devlink_port *port,
1549				 enum devlink_port_fn_state *state,
1550				 enum devlink_port_fn_opstate *opstate,
1551				 struct netlink_ext_ack *extack);
1552	/**
1553	 * port_fn_state_set() - Set the admin state of a port function
1554	 * @devlink: Devlink instance
1555	 * @port: The devlink port
1556	 * @state: Admin state
1557	 * @extack: extack for reporting error messages
1558	 *
1559	 * Set the admin state of a devlink port function
1560	 *
1561	 * Return: 0 on success, negative value otherwise.
1562	 */
1563	int (*port_fn_state_set)(struct devlink_port *port,
1564				 enum devlink_port_fn_state state,
1565				 struct netlink_ext_ack *extack);
1566
1567	/**
1568	 * Rate control callbacks.
1569	 */
1570	int (*rate_leaf_tx_share_set)(struct devlink_rate *devlink_rate, void *priv,
1571				      u64 tx_share, struct netlink_ext_ack *extack);
1572	int (*rate_leaf_tx_max_set)(struct devlink_rate *devlink_rate, void *priv,
1573				    u64 tx_max, struct netlink_ext_ack *extack);
1574	int (*rate_leaf_tx_priority_set)(struct devlink_rate *devlink_rate, void *priv,
1575					 u32 tx_priority, struct netlink_ext_ack *extack);
1576	int (*rate_leaf_tx_weight_set)(struct devlink_rate *devlink_rate, void *priv,
1577				       u32 tx_weight, struct netlink_ext_ack *extack);
1578	int (*rate_node_tx_share_set)(struct devlink_rate *devlink_rate, void *priv,
1579				      u64 tx_share, struct netlink_ext_ack *extack);
1580	int (*rate_node_tx_max_set)(struct devlink_rate *devlink_rate, void *priv,
1581				    u64 tx_max, struct netlink_ext_ack *extack);
1582	int (*rate_node_tx_priority_set)(struct devlink_rate *devlink_rate, void *priv,
1583					 u32 tx_priority, struct netlink_ext_ack *extack);
1584	int (*rate_node_tx_weight_set)(struct devlink_rate *devlink_rate, void *priv,
1585				       u32 tx_weight, struct netlink_ext_ack *extack);
1586	int (*rate_node_new)(struct devlink_rate *rate_node, void **priv,
1587			     struct netlink_ext_ack *extack);
1588	int (*rate_node_del)(struct devlink_rate *rate_node, void *priv,
1589			     struct netlink_ext_ack *extack);
1590	int (*rate_leaf_parent_set)(struct devlink_rate *child,
1591				    struct devlink_rate *parent,
1592				    void *priv_child, void *priv_parent,
1593				    struct netlink_ext_ack *extack);
1594	int (*rate_node_parent_set)(struct devlink_rate *child,
1595				    struct devlink_rate *parent,
1596				    void *priv_child, void *priv_parent,
1597				    struct netlink_ext_ack *extack);
1598	/**
1599	 * selftests_check() - queries if selftest is supported
1600	 * @devlink: devlink instance
1601	 * @id: test index
1602	 * @extack: extack for reporting error messages
1603	 *
1604	 * Return: true if test is supported by the driver
1605	 */
1606	bool (*selftest_check)(struct devlink *devlink, unsigned int id,
1607			       struct netlink_ext_ack *extack);
1608	/**
1609	 * selftest_run() - Runs a selftest
1610	 * @devlink: devlink instance
1611	 * @id: test index
1612	 * @extack: extack for reporting error messages
1613	 *
1614	 * Return: status of the test
1615	 */
1616	enum devlink_selftest_status
1617	(*selftest_run)(struct devlink *devlink, unsigned int id,
1618			struct netlink_ext_ack *extack);
1619};
1620
1621void *devlink_priv(struct devlink *devlink);
1622struct devlink *priv_to_devlink(void *priv);
1623struct device *devlink_to_dev(const struct devlink *devlink);
1624
1625/* Devlink instance explicit locking */
1626void devl_lock(struct devlink *devlink);
1627int devl_trylock(struct devlink *devlink);
1628void devl_unlock(struct devlink *devlink);
1629void devl_assert_locked(struct devlink *devlink);
1630bool devl_lock_is_held(struct devlink *devlink);
1631
1632struct ib_device;
 
 
 
 
 
 
1633
1634struct net *devlink_net(const struct devlink *devlink);
1635/* This call is intended for software devices that can create
1636 * devlink instances in other namespaces than init_net.
1637 *
1638 * Drivers that operate on real HW must use devlink_alloc() instead.
1639 */
1640struct devlink *devlink_alloc_ns(const struct devlink_ops *ops,
1641				 size_t priv_size, struct net *net,
1642				 struct device *dev);
1643static inline struct devlink *devlink_alloc(const struct devlink_ops *ops,
1644					    size_t priv_size,
1645					    struct device *dev)
1646{
1647	return devlink_alloc_ns(ops, priv_size, &init_net, dev);
 
 
 
 
1648}
1649void devlink_set_features(struct devlink *devlink, u64 features);
1650void devlink_register(struct devlink *devlink);
 
 
 
1651void devlink_unregister(struct devlink *devlink);
 
 
1652void devlink_free(struct devlink *devlink);
1653void devlink_port_init(struct devlink *devlink,
1654		       struct devlink_port *devlink_port);
1655void devlink_port_fini(struct devlink_port *devlink_port);
1656int devl_port_register(struct devlink *devlink,
1657		       struct devlink_port *devlink_port,
1658		       unsigned int port_index);
1659int devlink_port_register(struct devlink *devlink,
1660			  struct devlink_port *devlink_port,
1661			  unsigned int port_index);
1662void devl_port_unregister(struct devlink_port *devlink_port);
1663void devlink_port_unregister(struct devlink_port *devlink_port);
1664void devlink_port_type_eth_set(struct devlink_port *devlink_port);
 
1665void devlink_port_type_ib_set(struct devlink_port *devlink_port,
1666			      struct ib_device *ibdev);
1667void devlink_port_type_clear(struct devlink_port *devlink_port);
1668void devlink_port_attrs_set(struct devlink_port *devlink_port,
1669			    struct devlink_port_attrs *devlink_port_attrs);
1670void devlink_port_attrs_pci_pf_set(struct devlink_port *devlink_port, u32 controller,
1671				   u16 pf, bool external);
1672void devlink_port_attrs_pci_vf_set(struct devlink_port *devlink_port, u32 controller,
1673				   u16 pf, u16 vf, bool external);
1674void devlink_port_attrs_pci_sf_set(struct devlink_port *devlink_port,
1675				   u32 controller, u16 pf, u32 sf,
1676				   bool external);
1677struct devlink_rate *
1678devl_rate_node_create(struct devlink *devlink, void *priv, char *node_name,
1679		      struct devlink_rate *parent);
1680int
1681devl_rate_leaf_create(struct devlink_port *devlink_port, void *priv,
1682		      struct devlink_rate *parent);
1683void devl_rate_leaf_destroy(struct devlink_port *devlink_port);
1684void devl_rate_nodes_destroy(struct devlink *devlink);
1685void devlink_port_linecard_set(struct devlink_port *devlink_port,
1686			       struct devlink_linecard *linecard);
1687struct devlink_linecard *
1688devlink_linecard_create(struct devlink *devlink, unsigned int linecard_index,
1689			const struct devlink_linecard_ops *ops, void *priv);
1690void devlink_linecard_destroy(struct devlink_linecard *linecard);
1691void devlink_linecard_provision_set(struct devlink_linecard *linecard,
1692				    const char *type);
1693void devlink_linecard_provision_clear(struct devlink_linecard *linecard);
1694void devlink_linecard_provision_fail(struct devlink_linecard *linecard);
1695void devlink_linecard_activate(struct devlink_linecard *linecard);
1696void devlink_linecard_deactivate(struct devlink_linecard *linecard);
1697void devlink_linecard_nested_dl_set(struct devlink_linecard *linecard,
1698				    struct devlink *nested_devlink);
1699int devl_sb_register(struct devlink *devlink, unsigned int sb_index,
1700		     u32 size, u16 ingress_pools_count,
1701		     u16 egress_pools_count, u16 ingress_tc_count,
1702		     u16 egress_tc_count);
1703int devlink_sb_register(struct devlink *devlink, unsigned int sb_index,
1704			u32 size, u16 ingress_pools_count,
1705			u16 egress_pools_count, u16 ingress_tc_count,
1706			u16 egress_tc_count);
1707void devl_sb_unregister(struct devlink *devlink, unsigned int sb_index);
1708void devlink_sb_unregister(struct devlink *devlink, unsigned int sb_index);
1709int devl_dpipe_table_register(struct devlink *devlink,
1710			      const char *table_name,
1711			      struct devlink_dpipe_table_ops *table_ops,
1712			      void *priv, bool counter_control_extern);
1713void devl_dpipe_table_unregister(struct devlink *devlink,
1714				 const char *table_name);
1715void devl_dpipe_headers_register(struct devlink *devlink,
1716				 struct devlink_dpipe_headers *dpipe_headers);
1717void devl_dpipe_headers_unregister(struct devlink *devlink);
1718bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
1719					 const char *table_name);
1720int devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx);
1721int devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
1722				   struct devlink_dpipe_entry *entry);
1723int devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx);
1724void devlink_dpipe_entry_clear(struct devlink_dpipe_entry *entry);
1725int devlink_dpipe_action_put(struct sk_buff *skb,
1726			     struct devlink_dpipe_action *action);
1727int devlink_dpipe_match_put(struct sk_buff *skb,
1728			    struct devlink_dpipe_match *match);
1729extern struct devlink_dpipe_header devlink_dpipe_header_ethernet;
1730extern struct devlink_dpipe_header devlink_dpipe_header_ipv4;
1731extern struct devlink_dpipe_header devlink_dpipe_header_ipv6;
1732
1733int devl_resource_register(struct devlink *devlink,
1734			   const char *resource_name,
1735			   u64 resource_size,
1736			   u64 resource_id,
1737			   u64 parent_resource_id,
1738			   const struct devlink_resource_size_params *size_params);
1739int devlink_resource_register(struct devlink *devlink,
1740			      const char *resource_name,
1741			      u64 resource_size,
1742			      u64 resource_id,
1743			      u64 parent_resource_id,
1744			      const struct devlink_resource_size_params *size_params);
1745void devl_resources_unregister(struct devlink *devlink);
1746void devlink_resources_unregister(struct devlink *devlink);
1747int devl_resource_size_get(struct devlink *devlink,
1748			   u64 resource_id,
1749			   u64 *p_resource_size);
1750int devl_dpipe_table_resource_set(struct devlink *devlink,
1751				  const char *table_name, u64 resource_id,
1752				  u64 resource_units);
1753int devlink_dpipe_table_resource_set(struct devlink *devlink,
1754				     const char *table_name, u64 resource_id,
1755				     u64 resource_units);
1756void devl_resource_occ_get_register(struct devlink *devlink,
1757				    u64 resource_id,
1758				    devlink_resource_occ_get_t *occ_get,
1759				    void *occ_get_priv);
1760void devlink_resource_occ_get_register(struct devlink *devlink,
1761				       u64 resource_id,
1762				       devlink_resource_occ_get_t *occ_get,
1763				       void *occ_get_priv);
1764void devl_resource_occ_get_unregister(struct devlink *devlink,
1765				      u64 resource_id);
1766
1767void devlink_resource_occ_get_unregister(struct devlink *devlink,
1768					 u64 resource_id);
1769int devlink_params_register(struct devlink *devlink,
1770			    const struct devlink_param *params,
1771			    size_t params_count);
1772void devlink_params_unregister(struct devlink *devlink,
1773			       const struct devlink_param *params,
1774			       size_t params_count);
1775int devlink_param_register(struct devlink *devlink,
1776			   const struct devlink_param *param);
1777void devlink_param_unregister(struct devlink *devlink,
1778			      const struct devlink_param *param);
 
 
 
 
1779int devlink_param_driverinit_value_get(struct devlink *devlink, u32 param_id,
1780				       union devlink_param_value *init_val);
1781int devlink_param_driverinit_value_set(struct devlink *devlink, u32 param_id,
1782				       union devlink_param_value init_val);
 
 
 
 
 
 
 
1783void devlink_param_value_changed(struct devlink *devlink, u32 param_id);
1784struct devlink_region *devl_region_create(struct devlink *devlink,
1785					  const struct devlink_region_ops *ops,
1786					  u32 region_max_snapshots,
1787					  u64 region_size);
1788struct devlink_region *
1789devlink_region_create(struct devlink *devlink,
1790		      const struct devlink_region_ops *ops,
1791		      u32 region_max_snapshots, u64 region_size);
1792struct devlink_region *
1793devlink_port_region_create(struct devlink_port *port,
1794			   const struct devlink_port_region_ops *ops,
1795			   u32 region_max_snapshots, u64 region_size);
1796void devl_region_destroy(struct devlink_region *region);
1797void devlink_region_destroy(struct devlink_region *region);
1798void devlink_port_region_destroy(struct devlink_region *region);
1799
1800int devlink_region_snapshot_id_get(struct devlink *devlink, u32 *id);
1801void devlink_region_snapshot_id_put(struct devlink *devlink, u32 id);
1802int devlink_region_snapshot_create(struct devlink_region *region,
1803				   u8 *data, u32 snapshot_id);
 
1804int devlink_info_serial_number_put(struct devlink_info_req *req,
1805				   const char *sn);
1806int devlink_info_board_serial_number_put(struct devlink_info_req *req,
1807					 const char *bsn);
1808
1809enum devlink_info_version_type {
1810	DEVLINK_INFO_VERSION_TYPE_NONE,
1811	DEVLINK_INFO_VERSION_TYPE_COMPONENT, /* May be used as flash update
1812					      * component by name.
1813					      */
1814};
1815
1816int devlink_info_version_fixed_put(struct devlink_info_req *req,
1817				   const char *version_name,
1818				   const char *version_value);
1819int devlink_info_version_stored_put(struct devlink_info_req *req,
1820				    const char *version_name,
1821				    const char *version_value);
1822int devlink_info_version_stored_put_ext(struct devlink_info_req *req,
1823					const char *version_name,
1824					const char *version_value,
1825					enum devlink_info_version_type version_type);
1826int devlink_info_version_running_put(struct devlink_info_req *req,
1827				     const char *version_name,
1828				     const char *version_value);
1829int devlink_info_version_running_put_ext(struct devlink_info_req *req,
1830					 const char *version_name,
1831					 const char *version_value,
1832					 enum devlink_info_version_type version_type);
1833
1834int devlink_fmsg_obj_nest_start(struct devlink_fmsg *fmsg);
1835int devlink_fmsg_obj_nest_end(struct devlink_fmsg *fmsg);
1836
1837int devlink_fmsg_pair_nest_start(struct devlink_fmsg *fmsg, const char *name);
1838int devlink_fmsg_pair_nest_end(struct devlink_fmsg *fmsg);
1839
1840int devlink_fmsg_arr_pair_nest_start(struct devlink_fmsg *fmsg,
1841				     const char *name);
1842int devlink_fmsg_arr_pair_nest_end(struct devlink_fmsg *fmsg);
1843int devlink_fmsg_binary_pair_nest_start(struct devlink_fmsg *fmsg,
1844					const char *name);
1845int devlink_fmsg_binary_pair_nest_end(struct devlink_fmsg *fmsg);
1846
 
 
1847int devlink_fmsg_u32_put(struct devlink_fmsg *fmsg, u32 value);
 
1848int devlink_fmsg_string_put(struct devlink_fmsg *fmsg, const char *value);
1849int devlink_fmsg_binary_put(struct devlink_fmsg *fmsg, const void *value,
1850			    u16 value_len);
1851
1852int devlink_fmsg_bool_pair_put(struct devlink_fmsg *fmsg, const char *name,
1853			       bool value);
1854int devlink_fmsg_u8_pair_put(struct devlink_fmsg *fmsg, const char *name,
1855			     u8 value);
1856int devlink_fmsg_u32_pair_put(struct devlink_fmsg *fmsg, const char *name,
1857			      u32 value);
1858int devlink_fmsg_u64_pair_put(struct devlink_fmsg *fmsg, const char *name,
1859			      u64 value);
1860int devlink_fmsg_string_pair_put(struct devlink_fmsg *fmsg, const char *name,
1861				 const char *value);
1862int devlink_fmsg_binary_pair_put(struct devlink_fmsg *fmsg, const char *name,
1863				 const void *value, u32 value_len);
1864
1865struct devlink_health_reporter *
1866devlink_health_reporter_create(struct devlink *devlink,
1867			       const struct devlink_health_reporter_ops *ops,
1868			       u64 graceful_period, void *priv);
1869
1870struct devlink_health_reporter *
1871devlink_port_health_reporter_create(struct devlink_port *port,
1872				    const struct devlink_health_reporter_ops *ops,
1873				    u64 graceful_period, void *priv);
1874
1875void
1876devlink_health_reporter_destroy(struct devlink_health_reporter *reporter);
1877
1878void
1879devlink_port_health_reporter_destroy(struct devlink_health_reporter *reporter);
1880
1881void *
1882devlink_health_reporter_priv(struct devlink_health_reporter *reporter);
1883int devlink_health_report(struct devlink_health_reporter *reporter,
1884			  const char *msg, void *priv_ctx);
1885void
1886devlink_health_reporter_state_update(struct devlink_health_reporter *reporter,
1887				     enum devlink_health_reporter_state state);
1888void
1889devlink_health_reporter_recovery_done(struct devlink_health_reporter *reporter);
1890
1891bool devlink_is_reload_failed(const struct devlink *devlink);
1892void devlink_remote_reload_actions_performed(struct devlink *devlink,
1893					     enum devlink_reload_limit limit,
1894					     u32 actions_performed);
1895
 
 
1896void devlink_flash_update_status_notify(struct devlink *devlink,
1897					const char *status_msg,
1898					const char *component,
1899					unsigned long done,
1900					unsigned long total);
1901void devlink_flash_update_timeout_notify(struct devlink *devlink,
1902					 const char *status_msg,
1903					 const char *component,
1904					 unsigned long timeout);
1905
1906int devl_traps_register(struct devlink *devlink,
1907			const struct devlink_trap *traps,
1908			size_t traps_count, void *priv);
1909int devlink_traps_register(struct devlink *devlink,
1910			   const struct devlink_trap *traps,
1911			   size_t traps_count, void *priv);
1912void devl_traps_unregister(struct devlink *devlink,
1913			   const struct devlink_trap *traps,
1914			   size_t traps_count);
1915void devlink_traps_unregister(struct devlink *devlink,
1916			      const struct devlink_trap *traps,
1917			      size_t traps_count);
1918void devlink_trap_report(struct devlink *devlink, struct sk_buff *skb,
1919			 void *trap_ctx, struct devlink_port *in_devlink_port,
1920			 const struct flow_action_cookie *fa_cookie);
1921void *devlink_trap_ctx_priv(void *trap_ctx);
1922int devl_trap_groups_register(struct devlink *devlink,
1923			      const struct devlink_trap_group *groups,
1924			      size_t groups_count);
1925int devlink_trap_groups_register(struct devlink *devlink,
1926				 const struct devlink_trap_group *groups,
1927				 size_t groups_count);
1928void devl_trap_groups_unregister(struct devlink *devlink,
1929				 const struct devlink_trap_group *groups,
1930				 size_t groups_count);
1931void devlink_trap_groups_unregister(struct devlink *devlink,
1932				    const struct devlink_trap_group *groups,
1933				    size_t groups_count);
1934int
1935devl_trap_policers_register(struct devlink *devlink,
1936			    const struct devlink_trap_policer *policers,
1937			    size_t policers_count);
1938void
1939devl_trap_policers_unregister(struct devlink *devlink,
1940			      const struct devlink_trap_policer *policers,
1941			      size_t policers_count);
1942
1943#if IS_ENABLED(CONFIG_NET_DEVLINK)
1944
1945struct devlink *__must_check devlink_try_get(struct devlink *devlink);
1946void devlink_put(struct devlink *devlink);
1947
1948void devlink_compat_running_version(struct devlink *devlink,
1949				    char *buf, size_t len);
1950int devlink_compat_flash_update(struct devlink *devlink, const char *file_name);
1951int devlink_compat_phys_port_name_get(struct net_device *dev,
1952				      char *name, size_t len);
1953int devlink_compat_switch_id_get(struct net_device *dev,
1954				 struct netdev_phys_item_id *ppid);
1955
1956int devlink_nl_port_handle_fill(struct sk_buff *msg, struct devlink_port *devlink_port);
1957size_t devlink_nl_port_handle_size(struct devlink_port *devlink_port);
1958
1959#else
1960
1961static inline struct devlink *devlink_try_get(struct devlink *devlink)
1962{
1963	return NULL;
1964}
1965
1966static inline void devlink_put(struct devlink *devlink)
1967{
1968}
1969
1970static inline void
1971devlink_compat_running_version(struct devlink *devlink, char *buf, size_t len)
1972{
1973}
1974
1975static inline int
1976devlink_compat_flash_update(struct devlink *devlink, const char *file_name)
1977{
1978	return -EOPNOTSUPP;
1979}
1980
1981static inline int
1982devlink_compat_phys_port_name_get(struct net_device *dev,
1983				  char *name, size_t len)
1984{
1985	return -EOPNOTSUPP;
1986}
1987
1988static inline int
1989devlink_compat_switch_id_get(struct net_device *dev,
1990			     struct netdev_phys_item_id *ppid)
1991{
1992	return -EOPNOTSUPP;
1993}
1994
1995static inline int
1996devlink_nl_port_handle_fill(struct sk_buff *msg, struct devlink_port *devlink_port)
1997{
1998	return 0;
1999}
2000
2001static inline size_t devlink_nl_port_handle_size(struct devlink_port *devlink_port)
2002{
2003	return 0;
2004}
2005
2006#endif
2007
2008#endif /* _NET_DEVLINK_H_ */