include/net/devlink.h

   1 /*
   2  * include/net/devlink.h - Network physical device Netlink interface
   3  * Copyright (c) 2016 Mellanox Technologies. All rights reserved.
   4  * Copyright (c) 2016 Jiri Pirko <jiri@mellanox.com>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  */
  11 #ifndef _NET_DEVLINK_H_
  12 #define _NET_DEVLINK_H_
  13
  14 #include <linux/device.h>
  15 #include <linux/slab.h>
  16 #include <linux/gfp.h>
  17 #include <linux/list.h>
  18 #include <linux/netdevice.h>
  19 #include <net/net_namespace.h>
  20 #include <uapi/linux/devlink.h>
  21
  22 struct devlink_ops;
  23
  24 struct devlink {
  25         struct list_head list;
  26         struct list_head port_list;
  27         struct list_head sb_list;
  28         struct list_head dpipe_table_list;
  29         struct devlink_dpipe_headers *dpipe_headers;
  30         const struct devlink_ops *ops;
  31         struct device *dev;
  32         possible_net_t _net;
  33         char priv[0] __aligned(NETDEV_ALIGN);
  34 };
  35
  36 struct devlink_port {
  37         struct list_head list;
  38         struct devlink *devlink;
  39         unsigned index;
  40         bool registered;
  41         enum devlink_port_type type;
  42         enum devlink_port_type desired_type;
  43         void *type_dev;
  44         bool split;
  45         u32 split_group;
  46 };
  47
  48 struct devlink_sb_pool_info {
  49         enum devlink_sb_pool_type pool_type;
  50         u32 size;
  51         enum devlink_sb_threshold_type threshold_type;
  52 };
  53
  54 /**
  55  * struct devlink_dpipe_field - dpipe field object
  56  * @name: field name
  57  * @id: index inside the headers field array
  58  * @bitwidth: bitwidth
  59  * @mapping_type: mapping type
  60  */
  61 struct devlink_dpipe_field {
  62         const char *name;
  63         unsigned int id;
  64         unsigned int bitwidth;
  65         enum devlink_dpipe_field_mapping_type mapping_type;
  66 };
  67
  68 /**
  69  * struct devlink_dpipe_header - dpipe header object
  70  * @name: header name
  71  * @id: index, global/local detrmined by global bit
  72  * @fields: fields
  73  * @fields_count: number of fields
  74  * @global: indicates if header is shared like most protocol header
  75  *          or driver specific
  76  */
  77 struct devlink_dpipe_header {
  78         const char *name;
  79         unsigned int id;
  80         struct devlink_dpipe_field *fields;
  81         unsigned int fields_count;
  82         bool global;
  83 };
  84
  85 /**
  86  * struct devlink_dpipe_match - represents match operation
  87  * @type: type of match
  88  * @header_index: header index (packets can have several headers of same
  89  *                type like in case of tunnels)
  90  * @header: header
  91  * @fieled_id: field index
  92  */
  93 struct devlink_dpipe_match {
  94         enum devlink_dpipe_match_type type;
  95         unsigned int header_index;
  96         struct devlink_dpipe_header *header;
  97         unsigned int field_id;
  98 };
  99
 100 /**
 101  * struct devlink_dpipe_action - represents action operation
 102  * @type: type of action
 103  * @header_index: header index (packets can have several headers of same
 104  *                type like in case of tunnels)
 105  * @header: header
 106  * @fieled_id: field index
 107  */
 108 struct devlink_dpipe_action {
 109         enum devlink_dpipe_action_type type;
 110         unsigned int header_index;
 111         struct devlink_dpipe_header *header;
 112         unsigned int field_id;
 113 };
 114
 115 /**
 116  * struct devlink_dpipe_value - represents value of match/action
 117  * @action: action
 118  * @match: match
 119  * @mapping_value: in case the field has some mapping this value
 120  *                 specified the mapping value
 121  * @mapping_valid: specify if mapping value is valid
 122  * @value_size: value size
 123  * @value: value
 124  * @mask: bit mask
 125  */
 126 struct devlink_dpipe_value {
 127         union {
 128                 struct devlink_dpipe_action *action;
 129                 struct devlink_dpipe_match *match;
 130         };
 131         unsigned int mapping_value;
 132         bool mapping_valid;
 133         unsigned int value_size;
 134         void *value;
 135         void *mask;
 136 };
 137
 138 /**
 139  * struct devlink_dpipe_entry - table entry object
 140  * @index: index of the entry in the table
 141  * @match_values: match values
 142  * @matche_values_count: count of matches tuples
 143  * @action_values: actions values
 144  * @action_values_count: count of actions values
 145  * @counter: value of counter
 146  * @counter_valid: Specify if value is valid from hardware
 147  */
 148 struct devlink_dpipe_entry {
 149         u64 index;
 150         struct devlink_dpipe_value *match_values;
 151         unsigned int match_values_count;
 152         struct devlink_dpipe_value *action_values;
 153         unsigned int action_values_count;
 154         u64 counter;
 155         bool counter_valid;
 156 };
 157
 158 /**
 159  * struct devlink_dpipe_dump_ctx - context provided to driver in order
 160  *                                 to dump
 161  * @info: info
 162  * @cmd: devlink command
 163  * @skb: skb
 164  * @nest: top attribute
 165  * @hdr: hdr
 166  */
 167 struct devlink_dpipe_dump_ctx {
 168         struct genl_info *info;
 169         enum devlink_command cmd;
 170         struct sk_buff *skb;
 171         struct nlattr *nest;
 172         void *hdr;
 173 };
 174
 175 struct devlink_dpipe_table_ops;
 176
 177 /**
 178  * struct devlink_dpipe_table - table object
 179  * @priv: private
 180  * @name: table name
 181  * @size: maximum number of entries
 182  * @counters_enabled: indicates if counters are active
 183  * @counter_control_extern: indicates if counter control is in dpipe or
 184  *                          external tool
 185  * @table_ops: table operations
 186  * @rcu: rcu
 187  */
 188 struct devlink_dpipe_table {
 189         void *priv;
 190         struct list_head list;
 191         const char *name;
 192         u64 size;
 193         bool counters_enabled;
 194         bool counter_control_extern;
 195         struct devlink_dpipe_table_ops *table_ops;
 196         struct rcu_head rcu;
 197 };
 198
 199 /**
 200  * struct devlink_dpipe_table_ops - dpipe_table ops
 201  * @actions_dump - dumps all tables actions
 202  * @matches_dump - dumps all tables matches
 203  * @entries_dump - dumps all active entries in the table
 204  * @counters_set_update - when changing the counter status hardware sync
 205  *                        maybe needed to allocate/free counter related
 206  *                        resources
 207  */
 208 struct devlink_dpipe_table_ops {
 209         int (*actions_dump)(void *priv, struct sk_buff *skb);
 210         int (*matches_dump)(void *priv, struct sk_buff *skb);
 211         int (*entries_dump)(void *priv, bool counters_enabled,
 212                             struct devlink_dpipe_dump_ctx *dump_ctx);
 213         int (*counters_set_update)(void *priv, bool enable);
 214 };
 215
 216 /**
 217  * struct devlink_dpipe_headers - dpipe headers
 218  * @headers - header array can be shared (global bit) or driver specific
 219  * @headers_count - count of headers
 220  */
 221 struct devlink_dpipe_headers {
 222         struct devlink_dpipe_header **headers;
 223         unsigned int headers_count;
 224 };
 225
 226 struct devlink_ops {
 227         int (*port_type_set)(struct devlink_port *devlink_port,
 228                              enum devlink_port_type port_type);
 229         int (*port_split)(struct devlink *devlink, unsigned int port_index,
 230                           unsigned int count);
 231         int (*port_unsplit)(struct devlink *devlink, unsigned int port_index);
 232         int (*sb_pool_get)(struct devlink *devlink, unsigned int sb_index,
 233                            u16 pool_index,
 234                            struct devlink_sb_pool_info *pool_info);
 235         int (*sb_pool_set)(struct devlink *devlink, unsigned int sb_index,
 236                            u16 pool_index, u32 size,
 237                            enum devlink_sb_threshold_type threshold_type);
 238         int (*sb_port_pool_get)(struct devlink_port *devlink_port,
 239                                 unsigned int sb_index, u16 pool_index,
 240                                 u32 *p_threshold);
 241         int (*sb_port_pool_set)(struct devlink_port *devlink_port,
 242                                 unsigned int sb_index, u16 pool_index,
 243                                 u32 threshold);
 244         int (*sb_tc_pool_bind_get)(struct devlink_port *devlink_port,
 245                                    unsigned int sb_index,
 246                                    u16 tc_index,
 247                                    enum devlink_sb_pool_type pool_type,
 248                                    u16 *p_pool_index, u32 *p_threshold);
 249         int (*sb_tc_pool_bind_set)(struct devlink_port *devlink_port,
 250                                    unsigned int sb_index,
 251                                    u16 tc_index,
 252                                    enum devlink_sb_pool_type pool_type,
 253                                    u16 pool_index, u32 threshold);
 254         int (*sb_occ_snapshot)(struct devlink *devlink,
 255                                unsigned int sb_index);
 256         int (*sb_occ_max_clear)(struct devlink *devlink,
 257                                 unsigned int sb_index);
 258         int (*sb_occ_port_pool_get)(struct devlink_port *devlink_port,
 259                                     unsigned int sb_index, u16 pool_index,
 260                                     u32 *p_cur, u32 *p_max);
 261         int (*sb_occ_tc_port_bind_get)(struct devlink_port *devlink_port,
 262                                        unsigned int sb_index,
 263                                        u16 tc_index,
 264                                        enum devlink_sb_pool_type pool_type,
 265                                        u32 *p_cur, u32 *p_max);
 266
 267         int (*eswitch_mode_get)(struct devlink *devlink, u16 *p_mode);
 268         int (*eswitch_mode_set)(struct devlink *devlink, u16 mode);
 269         int (*eswitch_inline_mode_get)(struct devlink *devlink, u8 *p_inline_mode);
 270         int (*eswitch_inline_mode_set)(struct devlink *devlink, u8 inline_mode);
 271         int (*eswitch_encap_mode_get)(struct devlink *devlink, u8 *p_encap_mode);
 272         int (*eswitch_encap_mode_set)(struct devlink *devlink, u8 encap_mode);
 273 };
 274
 275 static inline void *devlink_priv(struct devlink *devlink)
 276 {
 277         BUG_ON(!devlink);
 278         return &devlink->priv;
 279 }
 280
 281 static inline struct devlink *priv_to_devlink(void *priv)
 282 {
 283         BUG_ON(!priv);
 284         return container_of(priv, struct devlink, priv);
 285 }
 286
 287 struct ib_device;
 288
 289 #if IS_ENABLED(CONFIG_NET_DEVLINK)
 290
 291 struct devlink *devlink_alloc(const struct devlink_ops *ops, size_t priv_size);
 292 int devlink_register(struct devlink *devlink, struct device *dev);
 293 void devlink_unregister(struct devlink *devlink);
 294 void devlink_free(struct devlink *devlink);
 295 int devlink_port_register(struct devlink *devlink,
 296                           struct devlink_port *devlink_port,
 297                           unsigned int port_index);
 298 void devlink_port_unregister(struct devlink_port *devlink_port);
 299 void devlink_port_type_eth_set(struct devlink_port *devlink_port,
 300                                struct net_device *netdev);
 301 void devlink_port_type_ib_set(struct devlink_port *devlink_port,
 302                               struct ib_device *ibdev);
 303 void devlink_port_type_clear(struct devlink_port *devlink_port);
 304 void devlink_port_split_set(struct devlink_port *devlink_port,
 305                             u32 split_group);
 306 int devlink_sb_register(struct devlink *devlink, unsigned int sb_index,
 307                         u32 size, u16 ingress_pools_count,
 308                         u16 egress_pools_count, u16 ingress_tc_count,
 309                         u16 egress_tc_count);
 310 void devlink_sb_unregister(struct devlink *devlink, unsigned int sb_index);
 311 int devlink_dpipe_table_register(struct devlink *devlink,
 312                                  const char *table_name,
 313                                  struct devlink_dpipe_table_ops *table_ops,
 314                                  void *priv, u64 size,
 315                                  bool counter_control_extern);
 316 void devlink_dpipe_table_unregister(struct devlink *devlink,
 317                                     const char *table_name);
 318 int devlink_dpipe_headers_register(struct devlink *devlink,
 319                                    struct devlink_dpipe_headers *dpipe_headers);
 320 void devlink_dpipe_headers_unregister(struct devlink *devlink);
 321 bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
 322                                          const char *table_name);
 323 int devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx);
 324 int devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
 325                                    struct devlink_dpipe_entry *entry);
 326 int devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx);
 327 int devlink_dpipe_action_put(struct sk_buff *skb,
 328                              struct devlink_dpipe_action *action);
 329 int devlink_dpipe_match_put(struct sk_buff *skb,
 330                             struct devlink_dpipe_match *match);
 331
 332 #else
 333
 334 static inline struct devlink *devlink_alloc(const struct devlink_ops *ops,
 335                                             size_t priv_size)
 336 {
 337         return kzalloc(sizeof(struct devlink) + priv_size, GFP_KERNEL);
 338 }
 339
 340 static inline int devlink_register(struct devlink *devlink, struct device *dev)
 341 {
 342         return 0;
 343 }
 344
 345 static inline void devlink_unregister(struct devlink *devlink)
 346 {
 347 }
 348
 349 static inline void devlink_free(struct devlink *devlink)
 350 {
 351         kfree(devlink);
 352 }
 353
 354 static inline int devlink_port_register(struct devlink *devlink,
 355                                         struct devlink_port *devlink_port,
 356                                         unsigned int port_index)
 357 {
 358         return 0;
 359 }
 360
 361 static inline void devlink_port_unregister(struct devlink_port *devlink_port)
 362 {
 363 }
 364
 365 static inline void devlink_port_type_eth_set(struct devlink_port *devlink_port,
 366                                              struct net_device *netdev)
 367 {
 368 }
 369
 370 static inline void devlink_port_type_ib_set(struct devlink_port *devlink_port,
 371                                             struct ib_device *ibdev)
 372 {
 373 }
 374
 375 static inline void devlink_port_type_clear(struct devlink_port *devlink_port)
 376 {
 377 }
 378
 379 static inline void devlink_port_split_set(struct devlink_port *devlink_port,
 380                                           u32 split_group)
 381 {
 382 }
 383
 384 static inline int devlink_sb_register(struct devlink *devlink,
 385                                       unsigned int sb_index, u32 size,
 386                                       u16 ingress_pools_count,
 387                                       u16 egress_pools_count,
 388                                       u16 ingress_tc_count,
 389                                       u16 egress_tc_count)
 390 {
 391         return 0;
 392 }
 393
 394 static inline void devlink_sb_unregister(struct devlink *devlink,
 395                                          unsigned int sb_index)
 396 {
 397 }
 398
 399 static inline int
 400 devlink_dpipe_table_register(struct devlink *devlink,
 401                              const char *table_name,
 402                              struct devlink_dpipe_table_ops *table_ops,
 403                              void *priv, u64 size,
 404                              bool counter_control_extern)
 405 {
 406         return 0;
 407 }
 408
 409 static inline void devlink_dpipe_table_unregister(struct devlink *devlink,
 410                                                   const char *table_name)
 411 {
 412 }
 413
 414 static inline int devlink_dpipe_headers_register(struct devlink *devlink,
 415                                                  struct devlink_dpipe_headers *
 416                                                  dpipe_headers)
 417 {
 418         return 0;
 419 }
 420
 421 static inline void devlink_dpipe_headers_unregister(struct devlink *devlink)
 422 {
 423 }
 424
 425 static inline bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
 426                                                        const char *table_name)
 427 {
 428         return false;
 429 }
 430
 431 static inline int
 432 devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx)
 433 {
 434         return 0;
 435 }
 436
 437 static inline int
 438 devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
 439                                struct devlink_dpipe_entry *entry)
 440 {
 441         return 0;
 442 }
 443
 444 static inline int
 445 devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx)
 446 {
 447         return 0;
 448 }
 449
 450 static inline int
 451 devlink_dpipe_action_put(struct sk_buff *skb,
 452                          struct devlink_dpipe_action *action)
 453 {
 454         return 0;
 455 }
 456
 457 static inline int
 458 devlink_dpipe_match_put(struct sk_buff *skb,
 459                         struct devlink_dpipe_match *match)
 460 {
 461         return 0;
 462 }
 463
 464 #endif
 465
 466 #endif /* _NET_DEVLINK_H_ */