![Arkadi Sharshevsky](/assets/img/avatar_default.png)
The pipeline debug is used to export the pipeline abstractions for the main objects - tables, headers and entries. The only support for set is for changing the counter parameter on specific table. The basic structures: Header - can represent a real protocol header information or internal metadata. Generic protocol headers like IPv4 can be shared between drivers. Each driver can add local headers. Field - part of a header. Can represent protocol field or specific ASIC metadata field. Hardware special metadata fields can be mapped to different resources, for example switch ASIC ports can have internal number which from the systems point of view is mapped to netdeivce ifindex. Match - represent specific match rule. Can describe match on specific field or header. The header index should be specified as well in order to support several header instances of the same type (tunneling). Action - represents specific action rule. Actions can describe operations on specific field values for example like set, increment, etc. And header operation like add and delete. Value - represents value which can be associated with specific match or action. Table - represents a hardware block which can be described with match/ action behavior. The match/action can be done on the packets data or on the internal metadata that it gathered along the packets traversal throw the pipeline which is vendor specific and should be exported in order to provide understanding of ASICs behavior. Entry - represents single record in a specific table. The entry is identified by specific combination of values for match/action. Prior to accessing the tables/entries the drivers provide the header/ field data base which is used by driver to user-space. The data base is split between the shared headers and unique headers. Signed-off-by: Arkadi Sharshevsky <arkadis@mellanox.com> Signed-off-by: Jiri Pirko <jiri@mellanox.com> Signed-off-by: David S. Miller <davem@davemloft.net>
465 lines
13 KiB
C
465 lines
13 KiB
C
/*
|
|
* include/net/devlink.h - Network physical device Netlink interface
|
|
* Copyright (c) 2016 Mellanox Technologies. All rights reserved.
|
|
* Copyright (c) 2016 Jiri Pirko <jiri@mellanox.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*/
|
|
#ifndef _NET_DEVLINK_H_
|
|
#define _NET_DEVLINK_H_
|
|
|
|
#include <linux/device.h>
|
|
#include <linux/slab.h>
|
|
#include <linux/gfp.h>
|
|
#include <linux/list.h>
|
|
#include <linux/netdevice.h>
|
|
#include <net/net_namespace.h>
|
|
#include <uapi/linux/devlink.h>
|
|
|
|
struct devlink_ops;
|
|
|
|
struct devlink {
|
|
struct list_head list;
|
|
struct list_head port_list;
|
|
struct list_head sb_list;
|
|
struct list_head dpipe_table_list;
|
|
struct devlink_dpipe_headers *dpipe_headers;
|
|
const struct devlink_ops *ops;
|
|
struct device *dev;
|
|
possible_net_t _net;
|
|
char priv[0] __aligned(NETDEV_ALIGN);
|
|
};
|
|
|
|
struct devlink_port {
|
|
struct list_head list;
|
|
struct devlink *devlink;
|
|
unsigned index;
|
|
bool registered;
|
|
enum devlink_port_type type;
|
|
enum devlink_port_type desired_type;
|
|
void *type_dev;
|
|
bool split;
|
|
u32 split_group;
|
|
};
|
|
|
|
struct devlink_sb_pool_info {
|
|
enum devlink_sb_pool_type pool_type;
|
|
u32 size;
|
|
enum devlink_sb_threshold_type threshold_type;
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_field - dpipe field object
|
|
* @name: field name
|
|
* @id: index inside the headers field array
|
|
* @bitwidth: bitwidth
|
|
* @mapping_type: mapping type
|
|
*/
|
|
struct devlink_dpipe_field {
|
|
const char *name;
|
|
unsigned int id;
|
|
unsigned int bitwidth;
|
|
enum devlink_dpipe_field_mapping_type mapping_type;
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_header - dpipe header object
|
|
* @name: header name
|
|
* @id: index, global/local detrmined by global bit
|
|
* @fields: fields
|
|
* @fields_count: number of fields
|
|
* @global: indicates if header is shared like most protocol header
|
|
* or driver specific
|
|
*/
|
|
struct devlink_dpipe_header {
|
|
const char *name;
|
|
unsigned int id;
|
|
struct devlink_dpipe_field *fields;
|
|
unsigned int fields_count;
|
|
bool global;
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_match - represents match operation
|
|
* @type: type of match
|
|
* @header_index: header index (packets can have several headers of same
|
|
* type like in case of tunnels)
|
|
* @header: header
|
|
* @fieled_id: field index
|
|
*/
|
|
struct devlink_dpipe_match {
|
|
enum devlink_dpipe_match_type type;
|
|
unsigned int header_index;
|
|
struct devlink_dpipe_header *header;
|
|
unsigned int field_id;
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_action - represents action operation
|
|
* @type: type of action
|
|
* @header_index: header index (packets can have several headers of same
|
|
* type like in case of tunnels)
|
|
* @header: header
|
|
* @fieled_id: field index
|
|
*/
|
|
struct devlink_dpipe_action {
|
|
enum devlink_dpipe_action_type type;
|
|
unsigned int header_index;
|
|
struct devlink_dpipe_header *header;
|
|
unsigned int field_id;
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_value - represents value of match/action
|
|
* @action: action
|
|
* @match: match
|
|
* @mapping_value: in case the field has some mapping this value
|
|
* specified the mapping value
|
|
* @mapping_valid: specify if mapping value is valid
|
|
* @value_size: value size
|
|
* @value: value
|
|
* @mask: bit mask
|
|
*/
|
|
struct devlink_dpipe_value {
|
|
union {
|
|
struct devlink_dpipe_action *action;
|
|
struct devlink_dpipe_match *match;
|
|
};
|
|
unsigned int mapping_value;
|
|
bool mapping_valid;
|
|
unsigned int value_size;
|
|
void *value;
|
|
void *mask;
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_entry - table entry object
|
|
* @index: index of the entry in the table
|
|
* @match_values: match values
|
|
* @matche_values_count: count of matches tuples
|
|
* @action_values: actions values
|
|
* @action_values_count: count of actions values
|
|
* @counter: value of counter
|
|
* @counter_valid: Specify if value is valid from hardware
|
|
*/
|
|
struct devlink_dpipe_entry {
|
|
u64 index;
|
|
struct devlink_dpipe_value *match_values;
|
|
unsigned int match_values_count;
|
|
struct devlink_dpipe_value *action_values;
|
|
unsigned int action_values_count;
|
|
u64 counter;
|
|
bool counter_valid;
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_dump_ctx - context provided to driver in order
|
|
* to dump
|
|
* @info: info
|
|
* @cmd: devlink command
|
|
* @skb: skb
|
|
* @nest: top attribute
|
|
* @hdr: hdr
|
|
*/
|
|
struct devlink_dpipe_dump_ctx {
|
|
struct genl_info *info;
|
|
enum devlink_command cmd;
|
|
struct sk_buff *skb;
|
|
struct nlattr *nest;
|
|
void *hdr;
|
|
};
|
|
|
|
struct devlink_dpipe_table_ops;
|
|
|
|
/**
|
|
* struct devlink_dpipe_table - table object
|
|
* @priv: private
|
|
* @name: table name
|
|
* @size: maximum number of entries
|
|
* @counters_enabled: indicates if counters are active
|
|
* @counter_control_extern: indicates if counter control is in dpipe or
|
|
* external tool
|
|
* @table_ops: table operations
|
|
* @rcu: rcu
|
|
*/
|
|
struct devlink_dpipe_table {
|
|
void *priv;
|
|
struct list_head list;
|
|
const char *name;
|
|
u64 size;
|
|
bool counters_enabled;
|
|
bool counter_control_extern;
|
|
struct devlink_dpipe_table_ops *table_ops;
|
|
struct rcu_head rcu;
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_table_ops - dpipe_table ops
|
|
* @actions_dump - dumps all tables actions
|
|
* @matches_dump - dumps all tables matches
|
|
* @entries_dump - dumps all active entries in the table
|
|
* @counters_set_update - when changing the counter status hardware sync
|
|
* maybe needed to allocate/free counter related
|
|
* resources
|
|
*/
|
|
struct devlink_dpipe_table_ops {
|
|
int (*actions_dump)(void *priv, struct sk_buff *skb);
|
|
int (*matches_dump)(void *priv, struct sk_buff *skb);
|
|
int (*entries_dump)(void *priv, bool counters_enabled,
|
|
struct devlink_dpipe_dump_ctx *dump_ctx);
|
|
int (*counters_set_update)(void *priv, bool enable);
|
|
};
|
|
|
|
/**
|
|
* struct devlink_dpipe_headers - dpipe headers
|
|
* @headers - header array can be shared (global bit) or driver specific
|
|
* @headers_count - count of headers
|
|
*/
|
|
struct devlink_dpipe_headers {
|
|
struct devlink_dpipe_header **headers;
|
|
unsigned int headers_count;
|
|
};
|
|
|
|
struct devlink_ops {
|
|
int (*port_type_set)(struct devlink_port *devlink_port,
|
|
enum devlink_port_type port_type);
|
|
int (*port_split)(struct devlink *devlink, unsigned int port_index,
|
|
unsigned int count);
|
|
int (*port_unsplit)(struct devlink *devlink, unsigned int port_index);
|
|
int (*sb_pool_get)(struct devlink *devlink, unsigned int sb_index,
|
|
u16 pool_index,
|
|
struct devlink_sb_pool_info *pool_info);
|
|
int (*sb_pool_set)(struct devlink *devlink, unsigned int sb_index,
|
|
u16 pool_index, u32 size,
|
|
enum devlink_sb_threshold_type threshold_type);
|
|
int (*sb_port_pool_get)(struct devlink_port *devlink_port,
|
|
unsigned int sb_index, u16 pool_index,
|
|
u32 *p_threshold);
|
|
int (*sb_port_pool_set)(struct devlink_port *devlink_port,
|
|
unsigned int sb_index, u16 pool_index,
|
|
u32 threshold);
|
|
int (*sb_tc_pool_bind_get)(struct devlink_port *devlink_port,
|
|
unsigned int sb_index,
|
|
u16 tc_index,
|
|
enum devlink_sb_pool_type pool_type,
|
|
u16 *p_pool_index, u32 *p_threshold);
|
|
int (*sb_tc_pool_bind_set)(struct devlink_port *devlink_port,
|
|
unsigned int sb_index,
|
|
u16 tc_index,
|
|
enum devlink_sb_pool_type pool_type,
|
|
u16 pool_index, u32 threshold);
|
|
int (*sb_occ_snapshot)(struct devlink *devlink,
|
|
unsigned int sb_index);
|
|
int (*sb_occ_max_clear)(struct devlink *devlink,
|
|
unsigned int sb_index);
|
|
int (*sb_occ_port_pool_get)(struct devlink_port *devlink_port,
|
|
unsigned int sb_index, u16 pool_index,
|
|
u32 *p_cur, u32 *p_max);
|
|
int (*sb_occ_tc_port_bind_get)(struct devlink_port *devlink_port,
|
|
unsigned int sb_index,
|
|
u16 tc_index,
|
|
enum devlink_sb_pool_type pool_type,
|
|
u32 *p_cur, u32 *p_max);
|
|
|
|
int (*eswitch_mode_get)(struct devlink *devlink, u16 *p_mode);
|
|
int (*eswitch_mode_set)(struct devlink *devlink, u16 mode);
|
|
int (*eswitch_inline_mode_get)(struct devlink *devlink, u8 *p_inline_mode);
|
|
int (*eswitch_inline_mode_set)(struct devlink *devlink, u8 inline_mode);
|
|
};
|
|
|
|
static inline void *devlink_priv(struct devlink *devlink)
|
|
{
|
|
BUG_ON(!devlink);
|
|
return &devlink->priv;
|
|
}
|
|
|
|
static inline struct devlink *priv_to_devlink(void *priv)
|
|
{
|
|
BUG_ON(!priv);
|
|
return container_of(priv, struct devlink, priv);
|
|
}
|
|
|
|
struct ib_device;
|
|
|
|
#if IS_ENABLED(CONFIG_NET_DEVLINK)
|
|
|
|
struct devlink *devlink_alloc(const struct devlink_ops *ops, size_t priv_size);
|
|
int devlink_register(struct devlink *devlink, struct device *dev);
|
|
void devlink_unregister(struct devlink *devlink);
|
|
void devlink_free(struct devlink *devlink);
|
|
int devlink_port_register(struct devlink *devlink,
|
|
struct devlink_port *devlink_port,
|
|
unsigned int port_index);
|
|
void devlink_port_unregister(struct devlink_port *devlink_port);
|
|
void devlink_port_type_eth_set(struct devlink_port *devlink_port,
|
|
struct net_device *netdev);
|
|
void devlink_port_type_ib_set(struct devlink_port *devlink_port,
|
|
struct ib_device *ibdev);
|
|
void devlink_port_type_clear(struct devlink_port *devlink_port);
|
|
void devlink_port_split_set(struct devlink_port *devlink_port,
|
|
u32 split_group);
|
|
int devlink_sb_register(struct devlink *devlink, unsigned int sb_index,
|
|
u32 size, u16 ingress_pools_count,
|
|
u16 egress_pools_count, u16 ingress_tc_count,
|
|
u16 egress_tc_count);
|
|
void devlink_sb_unregister(struct devlink *devlink, unsigned int sb_index);
|
|
int devlink_dpipe_table_register(struct devlink *devlink,
|
|
const char *table_name,
|
|
struct devlink_dpipe_table_ops *table_ops,
|
|
void *priv, u64 size,
|
|
bool counter_control_extern);
|
|
void devlink_dpipe_table_unregister(struct devlink *devlink,
|
|
const char *table_name);
|
|
int devlink_dpipe_headers_register(struct devlink *devlink,
|
|
struct devlink_dpipe_headers *dpipe_headers);
|
|
void devlink_dpipe_headers_unregister(struct devlink *devlink);
|
|
bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
|
|
const char *table_name);
|
|
int devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx);
|
|
int devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
|
|
struct devlink_dpipe_entry *entry);
|
|
int devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx);
|
|
int devlink_dpipe_action_put(struct sk_buff *skb,
|
|
struct devlink_dpipe_action *action);
|
|
int devlink_dpipe_match_put(struct sk_buff *skb,
|
|
struct devlink_dpipe_match *match);
|
|
|
|
#else
|
|
|
|
static inline struct devlink *devlink_alloc(const struct devlink_ops *ops,
|
|
size_t priv_size)
|
|
{
|
|
return kzalloc(sizeof(struct devlink) + priv_size, GFP_KERNEL);
|
|
}
|
|
|
|
static inline int devlink_register(struct devlink *devlink, struct device *dev)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline void devlink_unregister(struct devlink *devlink)
|
|
{
|
|
}
|
|
|
|
static inline void devlink_free(struct devlink *devlink)
|
|
{
|
|
kfree(devlink);
|
|
}
|
|
|
|
static inline int devlink_port_register(struct devlink *devlink,
|
|
struct devlink_port *devlink_port,
|
|
unsigned int port_index)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline void devlink_port_unregister(struct devlink_port *devlink_port)
|
|
{
|
|
}
|
|
|
|
static inline void devlink_port_type_eth_set(struct devlink_port *devlink_port,
|
|
struct net_device *netdev)
|
|
{
|
|
}
|
|
|
|
static inline void devlink_port_type_ib_set(struct devlink_port *devlink_port,
|
|
struct ib_device *ibdev)
|
|
{
|
|
}
|
|
|
|
static inline void devlink_port_type_clear(struct devlink_port *devlink_port)
|
|
{
|
|
}
|
|
|
|
static inline void devlink_port_split_set(struct devlink_port *devlink_port,
|
|
u32 split_group)
|
|
{
|
|
}
|
|
|
|
static inline int devlink_sb_register(struct devlink *devlink,
|
|
unsigned int sb_index, u32 size,
|
|
u16 ingress_pools_count,
|
|
u16 egress_pools_count,
|
|
u16 ingress_tc_count,
|
|
u16 egress_tc_count)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline void devlink_sb_unregister(struct devlink *devlink,
|
|
unsigned int sb_index)
|
|
{
|
|
}
|
|
|
|
static inline int
|
|
devlink_dpipe_table_register(struct devlink *devlink,
|
|
const char *table_name,
|
|
struct devlink_dpipe_table_ops *table_ops,
|
|
void *priv, u64 size,
|
|
bool counter_control_extern)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline void devlink_dpipe_table_unregister(struct devlink *devlink,
|
|
const char *table_name)
|
|
{
|
|
}
|
|
|
|
static inline int devlink_dpipe_headers_register(struct devlink *devlink,
|
|
struct devlink_dpipe_headers *
|
|
dpipe_headers)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline void devlink_dpipe_headers_unregister(struct devlink *devlink)
|
|
{
|
|
}
|
|
|
|
static inline bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
|
|
const char *table_name)
|
|
{
|
|
return false;
|
|
}
|
|
|
|
static inline int
|
|
devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline int
|
|
devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
|
|
struct devlink_dpipe_entry *entry)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline int
|
|
devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline int
|
|
devlink_dpipe_action_put(struct sk_buff *skb,
|
|
struct devlink_dpipe_action *action)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
static inline int
|
|
devlink_dpipe_match_put(struct sk_buff *skb,
|
|
struct devlink_dpipe_match *match)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif /* _NET_DEVLINK_H_ */
|