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 list_head resource_list;
  30         struct devlink_dpipe_headers *dpipe_headers;
  31         const struct devlink_ops *ops;
  32         struct device *dev;
  33         possible_net_t _net;
  34         struct mutex lock;
  35         char priv[0] __aligned(NETDEV_ALIGN);
  36 };
  37
  38 struct devlink_port {
  39         struct list_head list;
  40         struct devlink *devlink;
  41         unsigned index;
  42         bool registered;
  43         enum devlink_port_type type;
  44         enum devlink_port_type desired_type;
  45         void *type_dev;
  46         bool split;
  47         u32 split_group;
  48 };
  49
  50 struct devlink_sb_pool_info {
  51         enum devlink_sb_pool_type pool_type;
  52         u32 size;
  53         enum devlink_sb_threshold_type threshold_type;
  54 };
  55
  56 /**
  57  * struct devlink_dpipe_field - dpipe field object
  58  * @name: field name
  59  * @id: index inside the headers field array
  60  * @bitwidth: bitwidth
  61  * @mapping_type: mapping type
  62  */
  63 struct devlink_dpipe_field {
  64         const char *name;
  65         unsigned int id;
  66         unsigned int bitwidth;
  67         enum devlink_dpipe_field_mapping_type mapping_type;
  68 };
  69
  70 /**
  71  * struct devlink_dpipe_header - dpipe header object
  72  * @name: header name
  73  * @id: index, global/local detrmined by global bit
  74  * @fields: fields
  75  * @fields_count: number of fields
  76  * @global: indicates if header is shared like most protocol header
  77  *          or driver specific
  78  */
  79 struct devlink_dpipe_header {
  80         const char *name;
  81         unsigned int id;
  82         struct devlink_dpipe_field *fields;
  83         unsigned int fields_count;
  84         bool global;
  85 };
  86
  87 /**
  88  * struct devlink_dpipe_match - represents match operation
  89  * @type: type of match
  90  * @header_index: header index (packets can have several headers of same
  91  *                type like in case of tunnels)
  92  * @header: header
  93  * @fieled_id: field index
  94  */
  95 struct devlink_dpipe_match {
  96         enum devlink_dpipe_match_type type;
  97         unsigned int header_index;
  98         struct devlink_dpipe_header *header;
  99         unsigned int field_id;
 100 };
 101
 102 /**
 103  * struct devlink_dpipe_action - represents action operation
 104  * @type: type of action
 105  * @header_index: header index (packets can have several headers of same
 106  *                type like in case of tunnels)
 107  * @header: header
 108  * @fieled_id: field index
 109  */
 110 struct devlink_dpipe_action {
 111         enum devlink_dpipe_action_type type;
 112         unsigned int header_index;
 113         struct devlink_dpipe_header *header;
 114         unsigned int field_id;
 115 };
 116
 117 /**
 118  * struct devlink_dpipe_value - represents value of match/action
 119  * @action: action
 120  * @match: match
 121  * @mapping_value: in case the field has some mapping this value
 122  *                 specified the mapping value
 123  * @mapping_valid: specify if mapping value is valid
 124  * @value_size: value size
 125  * @value: value
 126  * @mask: bit mask
 127  */
 128 struct devlink_dpipe_value {
 129         union {
 130                 struct devlink_dpipe_action *action;
 131                 struct devlink_dpipe_match *match;
 132         };
 133         unsigned int mapping_value;
 134         bool mapping_valid;
 135         unsigned int value_size;
 136         void *value;
 137         void *mask;
 138 };
 139
 140 /**
 141  * struct devlink_dpipe_entry - table entry object
 142  * @index: index of the entry in the table
 143  * @match_values: match values
 144  * @matche_values_count: count of matches tuples
 145  * @action_values: actions values
 146  * @action_values_count: count of actions values
 147  * @counter: value of counter
 148  * @counter_valid: Specify if value is valid from hardware
 149  */
 150 struct devlink_dpipe_entry {
 151         u64 index;
 152         struct devlink_dpipe_value *match_values;
 153         unsigned int match_values_count;
 154         struct devlink_dpipe_value *action_values;
 155         unsigned int action_values_count;
 156         u64 counter;
 157         bool counter_valid;
 158 };
 159
 160 /**
 161  * struct devlink_dpipe_dump_ctx - context provided to driver in order
 162  *                                 to dump
 163  * @info: info
 164  * @cmd: devlink command
 165  * @skb: skb
 166  * @nest: top attribute
 167  * @hdr: hdr
 168  */
 169 struct devlink_dpipe_dump_ctx {
 170         struct genl_info *info;
 171         enum devlink_command cmd;
 172         struct sk_buff *skb;
 173         struct nlattr *nest;
 174         void *hdr;
 175 };
 176
 177 struct devlink_dpipe_table_ops;
 178
 179 /**
 180  * struct devlink_dpipe_table - table object
 181  * @priv: private
 182  * @name: table name
 183  * @counters_enabled: indicates if counters are active
 184  * @counter_control_extern: indicates if counter control is in dpipe or
 185  *                          external tool
 186  * @resource_valid: Indicate that the resource id is valid
 187  * @resource_id: relative resource this table is related to
 188  * @resource_units: number of resource's unit consumed per table's entry
 189  * @table_ops: table operations
 190  * @rcu: rcu
 191  */
 192 struct devlink_dpipe_table {
 193         void *priv;
 194         struct list_head list;
 195         const char *name;
 196         bool counters_enabled;
 197         bool counter_control_extern;
 198         bool resource_valid;
 199         u64 resource_id;
 200         u64 resource_units;
 201         struct devlink_dpipe_table_ops *table_ops;
 202         struct rcu_head rcu;
 203 };
 204
 205 /**
 206  * struct devlink_dpipe_table_ops - dpipe_table ops
 207  * @actions_dump - dumps all tables actions
 208  * @matches_dump - dumps all tables matches
 209  * @entries_dump - dumps all active entries in the table
 210  * @counters_set_update - when changing the counter status hardware sync
 211  *                        maybe needed to allocate/free counter related
 212  *                        resources
 213  * @size_get - get size
 214  */
 215 struct devlink_dpipe_table_ops {
 216         int (*actions_dump)(void *priv, struct sk_buff *skb);
 217         int (*matches_dump)(void *priv, struct sk_buff *skb);
 218         int (*entries_dump)(void *priv, bool counters_enabled,
 219                             struct devlink_dpipe_dump_ctx *dump_ctx);
 220         int (*counters_set_update)(void *priv, bool enable);
 221         u64 (*size_get)(void *priv);
 222 };
 223
 224 /**
 225  * struct devlink_dpipe_headers - dpipe headers
 226  * @headers - header array can be shared (global bit) or driver specific
 227  * @headers_count - count of headers
 228  */
 229 struct devlink_dpipe_headers {
 230         struct devlink_dpipe_header **headers;
 231         unsigned int headers_count;
 232 };
 233
 234 /**
 235  * struct devlink_resource_ops - resource ops
 236  * @occ_get: get the occupied size
 237  */
 238 struct devlink_resource_ops {
 239         u64 (*occ_get)(struct devlink *devlink);
 240 };
 241
 242 /**
 243  * struct devlink_resource_size_params - resource's size parameters
 244  * @size_min: minimum size which can be set
 245  * @size_max: maximum size which can be set
 246  * @size_granularity: size granularity
 247  * @size_unit: resource's basic unit
 248  */
 249 struct devlink_resource_size_params {
 250         u64 size_min;
 251         u64 size_max;
 252         u64 size_granularity;
 253         enum devlink_resource_unit unit;
 254 };
 255
 256 static inline void
 257 devlink_resource_size_params_init(struct devlink_resource_size_params *size_params,
 258                                   u64 size_min, u64 size_max,
 259                                   u64 size_granularity,
 260                                   enum devlink_resource_unit unit)
 261 {
 262         size_params->size_min = size_min;
 263         size_params->size_max = size_max;
 264         size_params->size_granularity = size_granularity;
 265         size_params->unit = unit;
 266 }
 267
 268 /**
 269  * struct devlink_resource - devlink resource
 270  * @name: name of the resource
 271  * @id: id, per devlink instance
 272  * @size: size of the resource
 273  * @size_new: updated size of the resource, reload is needed
 274  * @size_valid: valid in case the total size of the resource is valid
 275  *              including its children
 276  * @parent: parent resource
 277  * @size_params: size parameters
 278  * @list: parent list
 279  * @resource_list: list of child resources
 280  * @resource_ops: resource ops
 281  */
 282 struct devlink_resource {
 283         const char *name;
 284         u64 id;
 285         u64 size;
 286         u64 size_new;
 287         bool size_valid;
 288         struct devlink_resource *parent;
 289         struct devlink_resource_size_params size_params;
 290         struct list_head list;
 291         struct list_head resource_list;
 292         const struct devlink_resource_ops *resource_ops;
 293 };
 294
 295 #define DEVLINK_RESOURCE_ID_PARENT_TOP 0
 296
 297 struct devlink_ops {
 298         int (*reload)(struct devlink *devlink);
 299         int (*port_type_set)(struct devlink_port *devlink_port,
 300                              enum devlink_port_type port_type);
 301         int (*port_split)(struct devlink *devlink, unsigned int port_index,
 302                           unsigned int count);
 303         int (*port_unsplit)(struct devlink *devlink, unsigned int port_index);
 304         int (*sb_pool_get)(struct devlink *devlink, unsigned int sb_index,
 305                            u16 pool_index,
 306                            struct devlink_sb_pool_info *pool_info);
 307         int (*sb_pool_set)(struct devlink *devlink, unsigned int sb_index,
 308                            u16 pool_index, u32 size,
 309                            enum devlink_sb_threshold_type threshold_type);
 310         int (*sb_port_pool_get)(struct devlink_port *devlink_port,
 311                                 unsigned int sb_index, u16 pool_index,
 312                                 u32 *p_threshold);
 313         int (*sb_port_pool_set)(struct devlink_port *devlink_port,
 314                                 unsigned int sb_index, u16 pool_index,
 315                                 u32 threshold);
 316         int (*sb_tc_pool_bind_get)(struct devlink_port *devlink_port,
 317                                    unsigned int sb_index,
 318                                    u16 tc_index,
 319                                    enum devlink_sb_pool_type pool_type,
 320                                    u16 *p_pool_index, u32 *p_threshold);
 321         int (*sb_tc_pool_bind_set)(struct devlink_port *devlink_port,
 322                                    unsigned int sb_index,
 323                                    u16 tc_index,
 324                                    enum devlink_sb_pool_type pool_type,
 325                                    u16 pool_index, u32 threshold);
 326         int (*sb_occ_snapshot)(struct devlink *devlink,
 327                                unsigned int sb_index);
 328         int (*sb_occ_max_clear)(struct devlink *devlink,
 329                                 unsigned int sb_index);
 330         int (*sb_occ_port_pool_get)(struct devlink_port *devlink_port,
 331                                     unsigned int sb_index, u16 pool_index,
 332                                     u32 *p_cur, u32 *p_max);
 333         int (*sb_occ_tc_port_bind_get)(struct devlink_port *devlink_port,
 334                                        unsigned int sb_index,
 335                                        u16 tc_index,
 336                                        enum devlink_sb_pool_type pool_type,
 337                                        u32 *p_cur, u32 *p_max);
 338
 339         int (*eswitch_mode_get)(struct devlink *devlink, u16 *p_mode);
 340         int (*eswitch_mode_set)(struct devlink *devlink, u16 mode);
 341         int (*eswitch_inline_mode_get)(struct devlink *devlink, u8 *p_inline_mode);
 342         int (*eswitch_inline_mode_set)(struct devlink *devlink, u8 inline_mode);
 343         int (*eswitch_encap_mode_get)(struct devlink *devlink, u8 *p_encap_mode);
 344         int (*eswitch_encap_mode_set)(struct devlink *devlink, u8 encap_mode);
 345 };
 346
 347 static inline void *devlink_priv(struct devlink *devlink)
 348 {
 349         BUG_ON(!devlink);
 350         return &devlink->priv;
 351 }
 352
 353 static inline struct devlink *priv_to_devlink(void *priv)
 354 {
 355         BUG_ON(!priv);
 356         return container_of(priv, struct devlink, priv);
 357 }
 358
 359 struct ib_device;
 360
 361 #if IS_ENABLED(CONFIG_NET_DEVLINK)
 362
 363 struct devlink *devlink_alloc(const struct devlink_ops *ops, size_t priv_size);
 364 int devlink_register(struct devlink *devlink, struct device *dev);
 365 void devlink_unregister(struct devlink *devlink);
 366 void devlink_free(struct devlink *devlink);
 367 int devlink_port_register(struct devlink *devlink,
 368                           struct devlink_port *devlink_port,
 369                           unsigned int port_index);
 370 void devlink_port_unregister(struct devlink_port *devlink_port);
 371 void devlink_port_type_eth_set(struct devlink_port *devlink_port,
 372                                struct net_device *netdev);
 373 void devlink_port_type_ib_set(struct devlink_port *devlink_port,
 374                               struct ib_device *ibdev);
 375 void devlink_port_type_clear(struct devlink_port *devlink_port);
 376 void devlink_port_split_set(struct devlink_port *devlink_port,
 377                             u32 split_group);
 378 int devlink_sb_register(struct devlink *devlink, unsigned int sb_index,
 379                         u32 size, u16 ingress_pools_count,
 380                         u16 egress_pools_count, u16 ingress_tc_count,
 381                         u16 egress_tc_count);
 382 void devlink_sb_unregister(struct devlink *devlink, unsigned int sb_index);
 383 int devlink_dpipe_table_register(struct devlink *devlink,
 384                                  const char *table_name,
 385                                  struct devlink_dpipe_table_ops *table_ops,
 386                                  void *priv, bool counter_control_extern);
 387 void devlink_dpipe_table_unregister(struct devlink *devlink,
 388                                     const char *table_name);
 389 int devlink_dpipe_headers_register(struct devlink *devlink,
 390                                    struct devlink_dpipe_headers *dpipe_headers);
 391 void devlink_dpipe_headers_unregister(struct devlink *devlink);
 392 bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
 393                                          const char *table_name);
 394 int devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx);
 395 int devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
 396                                    struct devlink_dpipe_entry *entry);
 397 int devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx);
 398 void devlink_dpipe_entry_clear(struct devlink_dpipe_entry *entry);
 399 int devlink_dpipe_action_put(struct sk_buff *skb,
 400                              struct devlink_dpipe_action *action);
 401 int devlink_dpipe_match_put(struct sk_buff *skb,
 402                             struct devlink_dpipe_match *match);
 403 extern struct devlink_dpipe_header devlink_dpipe_header_ethernet;
 404 extern struct devlink_dpipe_header devlink_dpipe_header_ipv4;
 405 extern struct devlink_dpipe_header devlink_dpipe_header_ipv6;
 406
 407 int devlink_resource_register(struct devlink *devlink,
 408                               const char *resource_name,
 409                               bool top_hierarchy,
 410                               u64 resource_size,
 411                               u64 resource_id,
 412                               u64 parent_resource_id,
 413                               const struct devlink_resource_size_params *size_params,
 414                               const struct devlink_resource_ops *resource_ops);
 415 void devlink_resources_unregister(struct devlink *devlink,
 416                                   struct devlink_resource *resource);
 417 int devlink_resource_size_get(struct devlink *devlink,
 418                               u64 resource_id,
 419                               u64 *p_resource_size);
 420 int devlink_dpipe_table_resource_set(struct devlink *devlink,
 421                                      const char *table_name, u64 resource_id,
 422                                      u64 resource_units);
 423
 424 #else
 425
 426 static inline struct devlink *devlink_alloc(const struct devlink_ops *ops,
 427                                             size_t priv_size)
 428 {
 429         return kzalloc(sizeof(struct devlink) + priv_size, GFP_KERNEL);
 430 }
 431
 432 static inline int devlink_register(struct devlink *devlink, struct device *dev)
 433 {
 434         return 0;
 435 }
 436
 437 static inline void devlink_unregister(struct devlink *devlink)
 438 {
 439 }
 440
 441 static inline void devlink_free(struct devlink *devlink)
 442 {
 443         kfree(devlink);
 444 }
 445
 446 static inline int devlink_port_register(struct devlink *devlink,
 447                                         struct devlink_port *devlink_port,
 448                                         unsigned int port_index)
 449 {
 450         return 0;
 451 }
 452
 453 static inline void devlink_port_unregister(struct devlink_port *devlink_port)
 454 {
 455 }
 456
 457 static inline void devlink_port_type_eth_set(struct devlink_port *devlink_port,
 458                                              struct net_device *netdev)
 459 {
 460 }
 461
 462 static inline void devlink_port_type_ib_set(struct devlink_port *devlink_port,
 463                                             struct ib_device *ibdev)
 464 {
 465 }
 466
 467 static inline void devlink_port_type_clear(struct devlink_port *devlink_port)
 468 {
 469 }
 470
 471 static inline void devlink_port_split_set(struct devlink_port *devlink_port,
 472                                           u32 split_group)
 473 {
 474 }
 475
 476 static inline int devlink_sb_register(struct devlink *devlink,
 477                                       unsigned int sb_index, u32 size,
 478                                       u16 ingress_pools_count,
 479                                       u16 egress_pools_count,
 480                                       u16 ingress_tc_count,
 481                                       u16 egress_tc_count)
 482 {
 483         return 0;
 484 }
 485
 486 static inline void devlink_sb_unregister(struct devlink *devlink,
 487                                          unsigned int sb_index)
 488 {
 489 }
 490
 491 static inline int
 492 devlink_dpipe_table_register(struct devlink *devlink,
 493                              const char *table_name,
 494                              struct devlink_dpipe_table_ops *table_ops,
 495                              void *priv, bool counter_control_extern)
 496 {
 497         return 0;
 498 }
 499
 500 static inline void devlink_dpipe_table_unregister(struct devlink *devlink,
 501                                                   const char *table_name)
 502 {
 503 }
 504
 505 static inline int devlink_dpipe_headers_register(struct devlink *devlink,
 506                                                  struct devlink_dpipe_headers *
 507                                                  dpipe_headers)
 508 {
 509         return 0;
 510 }
 511
 512 static inline void devlink_dpipe_headers_unregister(struct devlink *devlink)
 513 {
 514 }
 515
 516 static inline bool devlink_dpipe_table_counter_enabled(struct devlink *devlink,
 517                                                        const char *table_name)
 518 {
 519         return false;
 520 }
 521
 522 static inline int
 523 devlink_dpipe_entry_ctx_prepare(struct devlink_dpipe_dump_ctx *dump_ctx)
 524 {
 525         return 0;
 526 }
 527
 528 static inline int
 529 devlink_dpipe_entry_ctx_append(struct devlink_dpipe_dump_ctx *dump_ctx,
 530                                struct devlink_dpipe_entry *entry)
 531 {
 532         return 0;
 533 }
 534
 535 static inline int
 536 devlink_dpipe_entry_ctx_close(struct devlink_dpipe_dump_ctx *dump_ctx)
 537 {
 538         return 0;
 539 }
 540
 541 static inline void
 542 devlink_dpipe_entry_clear(struct devlink_dpipe_entry *entry)
 543 {
 544 }
 545
 546 static inline int
 547 devlink_dpipe_action_put(struct sk_buff *skb,
 548                          struct devlink_dpipe_action *action)
 549 {
 550         return 0;
 551 }
 552
 553 static inline int
 554 devlink_dpipe_match_put(struct sk_buff *skb,
 555                         struct devlink_dpipe_match *match)
 556 {
 557         return 0;
 558 }
 559
 560 static inline int
 561 devlink_resource_register(struct devlink *devlink,
 562                           const char *resource_name,
 563                           bool top_hierarchy,
 564                           u64 resource_size,
 565                           u64 resource_id,
 566                           u64 parent_resource_id,
 567                           const struct devlink_resource_size_params *size_params,
 568                           const struct devlink_resource_ops *resource_ops)
 569 {
 570         return 0;
 571 }
 572
 573 static inline void
 574 devlink_resources_unregister(struct devlink *devlink,
 575                              struct devlink_resource *resource)
 576 {
 577 }
 578
 579 static inline int
 580 devlink_resource_size_get(struct devlink *devlink, u64 resource_id,
 581                           u64 *p_resource_size)
 582 {
 583         return -EOPNOTSUPP;
 584 }
 585
 586 static inline int
 587 devlink_dpipe_table_resource_set(struct devlink *devlink,
 588                                  const char *table_name, u64 resource_id,
 589                                  u64 resource_units)
 590 {
 591         return -EOPNOTSUPP;
 592 }
 593
 594 #endif
 595
 596 #endif /* _NET_DEVLINK_H_ */