src/vnet/interface.api

   1 /* Hey Emacs use -*- mode: C -*- */
   2 /*
   3  * Copyright (c) 2018 Cisco and/or its affiliates.
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at:
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 option version = "3.2.2";
  18
  19 import "vnet/interface_types.api";
  20 import "vnet/ethernet/ethernet_types.api";
  21 import "vnet/ip/ip_types.api";
  22
  23 service {
  24   rpc want_interface_events returns want_interface_events_reply
  25     events sw_interface_event;
  26 };
  27
  28 /** \brief Set flags on the interface
  29     @param client_index - opaque cookie to identify the sender
  30     @param context - sender context, to match reply w/ request
  31     @param sw_if_index - index of the interface to set flags on
  32     @param flags - interface_status flags
  33         (only IF_STATUS_API_FLAG_ADMIN_UP used in config)
  34 */
  35 autoreply define sw_interface_set_flags
  36 {
  37   u32 client_index;
  38   u32 context;
  39   vl_api_interface_index_t sw_if_index;
  40   vl_api_if_status_flags_t flags;
  41 };
  42
  43 /** \brief Set interface promiscuous mode
  44     @param client_index - opaque cookie to identify the sender
  45     @param context - sender context, to match reply w/ request
  46     @param sw_if_index - index of the interface to set flags on
  47     @param promisc_on - promiscuous mode is on ?
  48 */
  49 autoreply define sw_interface_set_promisc
  50 {
  51   u32 client_index;
  52   u32 context;
  53   vl_api_interface_index_t sw_if_index;
  54   bool promisc_on;
  55 };
  56
  57 /** \brief Set interface physical MTU
  58     @param client_index - opaque cookie to identify the sender
  59     @param context - sender context, to match reply w/ request
  60     @param sw_if_index - index of the interface to set MTU on
  61     @param mtu - MTU
  62 */
  63 autoreply define hw_interface_set_mtu
  64 {
  65   u32 client_index;
  66   u32 context;
  67   vl_api_interface_index_t sw_if_index;
  68   u16 mtu;
  69 };
  70
  71 /** \brief Set interface L3 MTU */
  72 autoreply define sw_interface_set_mtu
  73 {
  74   u32 client_index;
  75   u32 context;
  76   vl_api_interface_index_t sw_if_index;
  77   u32 mtu[4]; /* vl_api_mtu_proto_t 0 - L3, 1 - IP4, 2 - IP6, 3 - MPLS */
  78 };
  79
  80 /** \brief Set IP4 directed broadcast
  81     The directed broadcast enabled a packet sent to the interface's
  82     subnet address will be broadcast on the interface
  83     @param sw_if_index
  84     @param enable
  85 */
  86 autoreply define sw_interface_set_ip_directed_broadcast
  87 {
  88   u32 client_index;
  89   u32 context;
  90   vl_api_interface_index_t sw_if_index;
  91   bool  enable;
  92 };
  93
  94 /** \brief Interface Event generated by want_interface_events
  95     @param client_index - opaque cookie to identify the sender
  96     @param pid - client pid registered to receive notification
  97     @param sw_if_index - index of the interface of the event
  98     @param flags - interface_status flags
  99     @param deleted - interface was deleted
 100 */
 101 define sw_interface_event
 102 {
 103   u32 client_index;
 104   u32 pid;
 105   vl_api_interface_index_t sw_if_index;
 106   vl_api_if_status_flags_t flags;
 107   bool deleted;
 108 };
 109
 110 /** \brief Register for interface events
 111     @param client_index - opaque cookie to identify the sender
 112     @param context - sender context, to match reply w/ request
 113     @param enable_disable - 1 => register for events, 0 => cancel registration
 114     @param pid - sender's pid
 115 */
 116 autoreply define want_interface_events
 117 {
 118   u32 client_index;
 119   u32 context;
 120   u32 enable_disable;
 121   u32 pid;
 122 };
 123
 124 /** \brief Interface details structure (fix this)
 125     @param sw_if_index - index of the interface
 126     @param sup_sw_if_index - index of parent interface if any, else same as sw_if_index
 127     @param l2_address - the interface's l2 address
 128     @param flags - interface_status flags
 129     @param type - interface type
 130     @param link_duplex - 1 if half duplex, 2 if full duplex
 131     @param link_speed - value in kbps
 132     @param link_MTU - max. transmission unit
 133     @param sub_id - A number 0-N to uniquely identify this subif on super if
 134     @param sub_number_of_tags - Number of tags (0 - 2)
 135     @param sub_outer_vlan_id
 136     @param sub_inner_vlan_id
 137     @param sub_if_flags - sub interface flags
 138     @param vtr_op - vlan tag rewrite operation
 139     @param vtr_push_dot1q
 140     @param vtr_tag1
 141     @param vtr_tag2
 142     @param pbb_outer_tag - translate pbb s-tag
 143     @param pbb_b_dmac[6] - B-tag remote mac address
 144     @param pbb_b_smac[6] - B-tag local mac address
 145     @param pbb_b_vlanid - B-tag vlanid
 146     @param pbb_i_sid - I-tag service id
 147     @param interface_name - name of the interface
 148     @param interface_dev_type - device type of the interface
 149     @param tag - an ascii tag
 150 */
 151 define sw_interface_details
 152 {
 153   u32 context;
 154   vl_api_interface_index_t sw_if_index;
 155
 156   /* index of sup interface (e.g. hw interface).
 157      equal to sw_if_index for super hw interface. */
 158   u32 sup_sw_if_index;
 159
 160   /* Layer 2 address, if applicable */
 161   vl_api_mac_address_t l2_address;
 162
 163   vl_api_if_status_flags_t flags;
 164
 165   vl_api_if_type_t type;
 166
 167   /* 1 = half duplex, 2 = full duplex */
 168   vl_api_link_duplex_t link_duplex;
 169
 170   /* link speed in kbps */
 171   u32 link_speed;
 172
 173   /* MTU */
 174   u16 link_mtu;
 175
 176   /* Per protocol MTUs */
 177   u32 mtu[4]; /* vl_api_mtu_proto_t 0 - L3, 1 - IP4, 2 - IP6, 3 - MPLS */
 178
 179   /* Subinterface ID. A number 0-N to uniquely identify this subinterface under the super interface */
 180   u32 sub_id;
 181
 182   /* Number of tags 0-2 */
 183   u8 sub_number_of_tags;
 184   u16 sub_outer_vlan_id;
 185   u16 sub_inner_vlan_id;
 186
 187   vl_api_sub_if_flags_t sub_if_flags;
 188
 189   /* vlan tag rewrite state */
 190   u32 vtr_op;
 191   u32 vtr_push_dot1q;           // ethertype of first pushed tag is dot1q/dot1ad
 192   u32 vtr_tag1;                 // first pushed tag
 193   u32 vtr_tag2;                 // second pushed tag
 194
 195   /* pbb tag rewrite info */
 196   u16 outer_tag;
 197   vl_api_mac_address_t  b_dmac;
 198   vl_api_mac_address_t  b_smac;
 199   u16 b_vlanid;
 200   u32 i_sid;
 201
 202   /* Interface name */
 203   string interface_name[64];
 204   string interface_dev_type[64];
 205   string tag[64];
 206 };
 207
 208 /** \brief Request all or filtered subset of sw_interface_details
 209     @param client_index - opaque cookie to identify the sender
 210     @param context - sender context, to match reply w/ request
 211     @param sw_if_index - index of the interface to dump info on, 0 or ~0 if on all
 212       TODO: Support selecting only index==0 when CSIT is ready.
 213     @param name_filter_valid - 1 if requesting a filtered subset of records else 0
 214       if name filter is set as valid, sw_if_index value is ignored and all interfaces are examined
 215     @param name_filter - interface name substring filter. Eg. loop1 returns [loop1, loop10]
 216 */
 217 define sw_interface_dump
 218 {
 219   u32 client_index;
 220   u32 context;
 221   vl_api_interface_index_t sw_if_index [default=0xFFFFFFFF];
 222   bool name_filter_valid;
 223   string name_filter[];
 224 };
 225
 226 /** \brief Set or delete one or all ip addresses on a specified interface
 227     @param client_index - opaque cookie to identify the sender
 228     @param context - sender context, to match reply w/ request
 229     @param sw_if_index - index of the interface to add/del addresses
 230     @param is_add - add address if non-zero, else delete
 231     @param del_all - if non-zero delete all addresses on the interface
 232     @param prefix - address + a prefix length for the implied connected route
 233 */
 234 autoreply define sw_interface_add_del_address
 235 {
 236   u32 client_index;
 237   u32 context;
 238   vl_api_interface_index_t sw_if_index;
 239   bool is_add;
 240
 241   bool del_all;
 242   vl_api_address_with_prefix_t prefix;
 243 };
 244
 245 /** \brief IP interface address replace begin
 246
 247     The use-case is that, for some unspecified reason, the control plane
 248     has a different set of interface addresses than VPP
 249     currently has. The CP would thus like to 'replace' VPP's set
 250     only by specifying what the new set shall be, i.e. it is not
 251     going to delete anything that already eixts, rather, is wants any
 252     unspecified interface addresses to be deleted implicitly.
 253     The CP declares the start of this procedure with this replace_begin
 254     API Call, and when it has populated all addresses it wants, it calls
 255     the below replace_end API. From this point on it is of course free
 256     to add and delete interface addresses as usual.
 257     The underlying mechanism by which VPP implements this replace is
 258     intentionally left unspecified.
 259
 260     @param client_index - opaque cookie to identify the sender
 261     @param context - sender context, to match reply w/ request
 262 */
 263 autoreply define sw_interface_address_replace_begin
 264 {
 265   u32 client_index;
 266   u32 context;
 267 };
 268
 269 /** \brief IP interface address replace end
 270
 271     see ip_interface_address_replace_begin description.
 272
 273     @param client_index - opaque cookie to identify the sender
 274     @param context - sender context, to match reply w/ request
 275 */
 276 autoreply define sw_interface_address_replace_end
 277 {
 278   u32 client_index;
 279   u32 context;
 280 };
 281
 282 /** \brief Associate the specified interface with a fib table
 283     @param client_index - opaque cookie to identify the sender
 284     @param context - sender context, to match reply w/ request
 285     @param sw_if_index - index of the interface
 286     @param is_ipv6 - if non-zero ipv6, else ipv4
 287     @param vrf_id - fib table/vrf id to associate the interface with
 288 */
 289 autoreply define sw_interface_set_table
 290 {
 291   u32 client_index;
 292   u32 context;
 293   vl_api_interface_index_t sw_if_index;
 294   bool is_ipv6;
 295   u32 vrf_id;
 296 };
 297
 298 /** \brief Get VRF id assigned to interface
 299     @param client_index - opaque cookie to identify the sender
 300     @param context - sender context, to match reply w/ request
 301     @param sw_if_index - index of the interface
 302 */
 303 define sw_interface_get_table
 304 {
 305   u32 client_index;
 306   u32 context;
 307   vl_api_interface_index_t sw_if_index;
 308   bool is_ipv6;
 309 };
 310
 311 /** \brief Reply to get_sw_interface_vrf
 312     @param context - sender context which was passed in the request
 313     @param vrf_id - VRF id assigned to the interface
 314 */
 315 define sw_interface_get_table_reply
 316 {
 317   u32 context;
 318   i32 retval;
 319   u32 vrf_id;
 320 };
 321
 322 /** \brief Set unnumbered interface add / del request
 323     @param client_index - opaque cookie to identify the sender
 324     @param context - sender context, to match reply w/ request
 325     @param sw_if_index - interface with an IP address
 326     @param unnumbered_sw_if_index - interface which will use the address
 327     @param is_add - if non-zero set the association, else unset it
 328 */
 329 autoreply define sw_interface_set_unnumbered
 330 {
 331   u32 client_index;
 332   u32 context;
 333   vl_api_interface_index_t sw_if_index;         /* use this intfc address */
 334   vl_api_interface_index_t unnumbered_sw_if_index;      /* on this interface */
 335   bool is_add;
 336 };
 337
 338 /** \brief Clear interface statistics
 339     @param client_index - opaque cookie to identify the sender
 340     @param context - sender context, to match reply w/ request
 341     @param sw_if_index - index of the interface to clear statistics
 342 */
 343 autoreply define sw_interface_clear_stats
 344 {
 345   u32 client_index;
 346   u32 context;
 347   vl_api_interface_index_t sw_if_index;
 348 };
 349
 350 /** \brief Set / clear software interface tag
 351     @param client_index - opaque cookie to identify the sender
 352     @param context - sender context, to match reply w/ request
 353     @param sw_if_index - the interface
 354     @param add_del - 1 = add, 0 = delete
 355     @param tag - an ascii tag
 356 */
 357 autoreply define sw_interface_tag_add_del
 358 {
 359   u32 client_index;
 360   u32 context;
 361   bool is_add;
 362   vl_api_interface_index_t sw_if_index;
 363   string tag[64];
 364 };
 365
 366 /** \brief Add or delete a secondary MAC address on an interface
 367     @param client_index - opaque cookie to identify the sender
 368     @param context - sender context, to match reply w/ request
 369     @param sw_if_index - the interface whose MAC will be set
 370     @param mac_addr - the new MAC address
 371     @param is_add - 0 to delete, != 0 to add
 372 */
 373 autoreply define sw_interface_add_del_mac_address
 374 {
 375     u32 client_index;
 376     u32 context;
 377     u32 sw_if_index;
 378     vl_api_mac_address_t addr;
 379     u8 is_add;
 380 };
 381
 382 /** \brief Set an interface's MAC address
 383     @param client_index - opaque cookie to identify the sender
 384     @param context - sender context, to match reply w/ request
 385     @param sw_if_index - the interface whose MAC will be set
 386     @param mac_addr - the new MAC address
 387 */
 388 autoreply define sw_interface_set_mac_address
 389 {
 390   u32 client_index;
 391   u32 context;
 392   vl_api_interface_index_t sw_if_index;
 393   vl_api_mac_address_t mac_address;
 394 };
 395
 396 /** \brief Get interface's MAC address
 397     @param client_index - opaque cookie to identify the sender
 398     @param context - sender context, to match reply w/ request
 399     @param sw_if_index - the interface whose MAC will be returned
 400 */
 401 define sw_interface_get_mac_address
 402 {
 403   u32 client_index;
 404   u32 context;
 405   vl_api_interface_index_t sw_if_index;
 406 };
 407
 408 /** \brief Reply for get interface's MAC address request
 409     @param context - returned sender context, to match reply w/ request
 410     @param retval - return code
 411     @param mac_addr - returned interface's MAC address
 412 */
 413 define sw_interface_get_mac_address_reply
 414 {
 415   u32 context;
 416   i32 retval;
 417   vl_api_mac_address_t mac_address;
 418 };
 419
 420 /** \brief Set an interface's rx-mode
 421     @param client_index - opaque cookie to identify the sender
 422     @param context - sender context, to match reply w/ request
 423     @param sw_if_index - the interface whose rx-mode will be set
 424     @param queue_id_valid - 1 = the queue_id field is valid. 0 means all
 425       queue_id's
 426     @param queue_id - the queue number whose rx-mode will be set. Only valid
 427       if queue_id_valid is 1
 428     @param mode - polling=1, interrupt=2, adaptive=3
 429 */
 430 autoreply define sw_interface_set_rx_mode
 431 {
 432   u32 client_index;
 433   u32 context;
 434   vl_api_interface_index_t sw_if_index;
 435   bool queue_id_valid;
 436   u32 queue_id;
 437   vl_api_rx_mode_t mode;
 438 };
 439
 440 /** \brief Set an interface's rx-placement
 441     Rx-Queue placement on specific thread is operational for only hardware
 442     interface. It will not set queue - thread placement for sub-interfaces,
 443     p2p and pipe interfaces.
 444     @param client_index - opaque cookie to identify the sender
 445     @param context - sender context, to match reply w/ request
 446     @param sw_if_index - the interface whose rx-placement will be set
 447     @param queue_id - the queue number whose rx-placement will be set.
 448     @param worker_id - the worker number whom rx-placement will be at.
 449     @param is_main - flag to set rx-placement to main thread
 450 */
 451 autoreply define sw_interface_set_rx_placement
 452 {
 453     u32 client_index;
 454     u32 context;
 455     vl_api_interface_index_t sw_if_index;
 456     u32 queue_id;
 457     u32 worker_id;
 458     bool is_main;
 459 };
 460
 461 /** \brief dump the rx queue placement of interface(s)
 462     @param sw_if_index - optional interface index for which queue placement to
 463       be requested. sw_if_index = ~0 will dump placement information for all
 464       interfaces. It will not dump information related to sub-interfaces, p2p
 465       and pipe interfaces.
 466 */
 467 define sw_interface_rx_placement_dump
 468 {
 469   u32 client_index;
 470   u32 context;
 471   vl_api_interface_index_t sw_if_index;
 472 };
 473
 474 /** \brief show the interface's queue - thread placement
 475     This api is used to display the interface and queue worker
 476     thread placement. One message per rx-queue per interface will
 477     be sent to client.
 478     Each message will contain information about rx-queue id of an
 479     interface, interface index, thread on which this rx-queue is
 480     placed and mode of rx-queue.
 481     @param client_index - opaque cookie to identify the sender
 482     @param context - sender context, to match reply w/ request
 483     @param sw_if_index - the interface whose rx-placement will be dumped
 484     @param queue_id - the queue id
 485     @param worker_id - the worker id on which queue_id is placed,
 486                        worker_id = 0 means main thread.
 487     @param mode - polling=1, interrupt=2, adaptive=3
 488 */
 489 define sw_interface_rx_placement_details
 490 {
 491   u32 client_index;
 492   u32 context;
 493   vl_api_interface_index_t sw_if_index;
 494   u32 queue_id;
 495   u32 worker_id;
 496   vl_api_rx_mode_t mode;
 497 };
 498
 499 /* Gross kludge, DGMS */
 500 autoreply define interface_name_renumber
 501 {
 502   u32 client_index;
 503   u32 context;
 504   vl_api_interface_index_t sw_if_index;
 505   u32 new_show_dev_instance;
 506 };
 507
 508 define create_subif
 509 {
 510   u32 client_index;
 511   u32 context;
 512   vl_api_interface_index_t sw_if_index;
 513   u32 sub_id;
 514
 515   vl_api_sub_if_flags_t sub_if_flags;
 516   u16 outer_vlan_id;
 517   u16 inner_vlan_id;
 518 };
 519
 520 define create_subif_reply
 521 {
 522   u32 context;
 523   i32 retval;
 524   vl_api_interface_index_t sw_if_index;
 525 };
 526
 527 /** \brief Create a new subinterface with the given vlan id
 528     @param client_index - opaque cookie to identify the sender
 529     @param context - sender context, to match reply w/ request
 530     @param sw_if_index - software index of the new vlan's parent interface
 531     @param vlan_id - vlan tag of the new interface
 532 */
 533 define create_vlan_subif
 534 {
 535   u32 client_index;
 536   u32 context;
 537   vl_api_interface_index_t sw_if_index;
 538   u32 vlan_id;
 539 };
 540
 541 /** \brief Reply for the vlan subinterface create request
 542     @param context - returned sender context, to match reply w/ request
 543     @param retval - return code
 544     @param sw_if_index - software index allocated for the new subinterface
 545 */
 546 define create_vlan_subif_reply
 547 {
 548   u32 context;
 549   i32 retval;
 550   vl_api_interface_index_t sw_if_index;
 551 };
 552
 553 /** \brief Delete sub interface request
 554     @param client_index - opaque cookie to identify the sender
 555     @param context - sender context, to match reply w/ request
 556     @param sw_if_index - sw index of the interface that was created by create_subif
 557 */
 558 autoreply define delete_subif {
 559   u32 client_index;
 560   u32 context;
 561   vl_api_interface_index_t sw_if_index;
 562 };
 563
 564 /** \brief Create loopback interface request
 565     @param client_index - opaque cookie to identify the sender
 566     @param context - sender context, to match reply w/ request
 567     @param mac_address - mac addr to assign to the interface if none-zero
 568 */
 569 define create_loopback
 570 {
 571   u32 client_index;
 572   u32 context;
 573   vl_api_mac_address_t mac_address;
 574 };
 575
 576 /** \brief Create loopback interface response
 577     @param context - sender context, to match reply w/ request
 578     @param sw_if_index - sw index of the interface that was created
 579     @param retval - return code for the request
 580 */
 581 define create_loopback_reply
 582 {
 583   u32 context;
 584   i32 retval;
 585   vl_api_interface_index_t sw_if_index;
 586 };
 587
 588 /** \brief Create loopback interface instance request
 589     @param client_index - opaque cookie to identify the sender
 590     @param context - sender context, to match reply w/ request
 591     @param mac_address - mac addr to assign to the interface if none-zero
 592     @param is_specified - if non-0, a specific user_instance is being requested
 593     @param user_instance - requested instance, ~0 => dynamically allocate
 594 */
 595 define create_loopback_instance
 596 {
 597   u32 client_index;
 598   u32 context;
 599   vl_api_mac_address_t mac_address;
 600   bool is_specified;
 601   u32 user_instance;
 602 };
 603
 604 /** \brief Create loopback interface instance response
 605     @param context - sender context, to match reply w/ request
 606     @param sw_if_index - sw index of the interface that was created
 607     @param retval - return code for the request
 608 */
 609 define create_loopback_instance_reply
 610 {
 611   u32 context;
 612   i32 retval;
 613   vl_api_interface_index_t sw_if_index;
 614 };
 615
 616 /** \brief Delete loopback interface request
 617     @param client_index - opaque cookie to identify the sender
 618     @param context - sender context, to match reply w/ request
 619     @param sw_if_index - sw index of the interface that was created
 620 */
 621 autoreply define delete_loopback
 622 {
 623   u32 client_index;
 624   u32 context;
 625   vl_api_interface_index_t sw_if_index;
 626 };
 627
 628 /** \brief Enable or disable detailed interface stats
 629     @param client_index - opaque cookie to identify the sender
 630     @param context - sender context, to match reply w/ request
 631     @param sw_if_index - The interface to collect detail stats on. ~0 implies
 632                          all interfaces.
 633     @param enable_disable - set to 1 to enable, 0 to disable detailed stats
 634 */
 635 autoreply define collect_detailed_interface_stats
 636 {
 637   u32 client_index;
 638   u32 context;
 639   vl_api_interface_index_t sw_if_index;
 640   bool  enable_disable;
 641 };
 642
 643 /*
 644  * Local Variables:
 645  * eval: (c-set-style "gnu")
 646  * End:
 647  */