src/vnet/ip/ip.api

   1 /*
   2  * Copyright (c) 2016 Cisco and/or its affiliates.
   3  * Licensed under the Apache License, Version 2.0 (the "License");
   4  * you may not use this file except in compliance with the License.
   5  * You may obtain a copy of the License at:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   9  * Unless required by applicable law or agreed to in writing, software
  10  * distributed under the License is distributed on an "AS IS" BASIS,
  11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12  * See the License for the specific language governing permissions and
  13  * limitations under the License.
  14  */
  15
  16 /** \file
  17
  18     This file defines vpp IP control-plane API messages which are generally
  19     called through a shared memory interface.
  20 */
  21
  22 option version = "1.2.2";
  23 import "vnet/fib/fib_types.api";
  24
  25 /** \brief Add / del table request
  26            A table can be added multiple times, but need be deleted only once.
  27     @param client_index - opaque cookie to identify the sender
  28     @param context - sender context, to match reply w/ request
  29     @param is_ipv6 - V4 or V6 table
  30     @param table_id - table ID associated with the route
  31                       This table ID will apply to both the unicats
  32                       and mlticast FIBs
  33     @param name - A client provided name/tag for the table. If this is
  34                   not set by the client, then VPP will generate something
  35                   meaningfull.
  36 */
  37 autoreply define ip_table_add_del
  38 {
  39   u32 client_index;
  40   u32 context;
  41   u32 table_id;
  42   u8 is_ipv6;
  43   u8 is_add;
  44   u8 name[64];
  45 };
  46
  47 /** \brief Dump IP fib table
  48     @param client_index - opaque cookie to identify the sender
  49 */
  50 define ip_fib_dump
  51 {
  52   u32 client_index;
  53   u32 context;
  54 };
  55
  56 /** \brief IP FIB table response
  57     @param table_id - IP fib table id
  58     @address_length - mask length
  59     @address - ip4 prefix
  60     @param count - the number of fib_path in path
  61     @param path  - array of of fib_path structures
  62 */
  63 manual_endian manual_print define ip_fib_details
  64 {
  65   u32 context;
  66   u32 table_id;
  67   u8  table_name[64];
  68   u8  address_length;
  69   u8  address[4];
  70   u32 count;
  71   vl_api_fib_path_t path[count];
  72 };
  73
  74 /** \brief Dump IP6 fib table
  75     @param client_index - opaque cookie to identify the sender
  76 */
  77 define ip6_fib_dump
  78 {
  79   u32 client_index;
  80   u32 context;
  81 };
  82
  83 /** \brief IP6 FIB table entry response
  84     @param table_id - IP6 fib table id
  85     @param address_length - mask length
  86     @param address - ip6 prefix
  87     @param count - the number of fib_path in path
  88     @param path  - array of of fib_path structures
  89 */
  90 manual_endian manual_print define ip6_fib_details
  91 {
  92   u32 context;
  93   u32 table_id;
  94   u8  table_name[64];
  95   u8  address_length;
  96   u8  address[16];
  97   u32 count;
  98   vl_api_fib_path_t path[count];
  99 };
 100
 101 /** \brief Dump IP neighboors
 102     @param client_index - opaque cookie to identify the sender
 103     @param context - sender context, to match reply w/ request
 104     @param sw_if_index - the interface to dump neighboors, ~0 == all
 105     @param is_ipv6 - [1|0] to indicate if address family is ipv[6|4]
 106 */
 107 define ip_neighbor_dump
 108 {
 109     u32 client_index;
 110     u32 context;
 111     u32 sw_if_index;
 112     u8  is_ipv6;
 113 };
 114
 115 /** \brief IP neighboors dump response
 116     @param context - sender context which was passed in the request
 117     @param sw_if_index - The interface used to reach the neighbor
 118     @param is_static - [1|0] to indicate if neighbor is statically configured
 119     @param is_ipv6 - [1|0] to indicate if address family is ipv[6|4]
 120 */
 121 define ip_neighbor_details {
 122     u32 context;
 123     u32 sw_if_index;
 124     u8  is_static;
 125     u8  is_ipv6;
 126     u8  mac_address[6];
 127     u8  ip_address[16];
 128 };
 129
 130 /** \brief IP neighbor add / del request
 131     @param client_index - opaque cookie to identify the sender
 132     @param context - sender context, to match reply w/ request
 133     @param sw_if_index - interface used to reach neighbor
 134     @param is_add - 1 to add neighbor, 0 to delete
 135     @param is_ipv6 - 1 for IPv6 neighbor, 0 for IPv4
 136     @param is_ipv6 - 1 for IPv6 neighbor, 0 for IPv4
 137     @param is_static - A static neighbor Entry - there are not flushed
 138                        If the interface goes down.
 139     @param is_no_adj_fib - Do not create a corresponding entry in the FIB
 140                            table for the neighbor.
 141     @param mac_address - l2 address of the neighbor
 142     @param dst_address - ip4 or ip6 address of the neighbor
 143 */
 144 autoreply define ip_neighbor_add_del
 145 {
 146   u32 client_index;
 147   u32 context;
 148   u32 sw_if_index;
 149   /* 1 = add, 0 = delete */
 150   u8 is_add;
 151   u8 is_ipv6;
 152   u8 is_static;
 153   u8 is_no_adj_fib;
 154   u8 mac_address[6];
 155   u8 dst_address[16];
 156 };
 157
 158 /** \brief Set the ip flow hash config for a fib request
 159     @param client_index - opaque cookie to identify the sender
 160     @param context - sender context, to match reply w/ request
 161     @param vrf_id - vrf/fib id
 162     @param is_ipv6 - if non-zero the fib is ip6, else ip4
 163     @param src - if non-zero include src in flow hash
 164     @param dst - if non-zero include dst in flow hash
 165     @param sport - if non-zero include sport in flow hash
 166     @param dport - if non-zero include dport in flow hash
 167     @param proto -if non-zero include proto in flow hash
 168     @param reverse - if non-zero include reverse in flow hash
 169 */
 170 autoreply define set_ip_flow_hash
 171 {
 172   u32 client_index;
 173   u32 context;
 174   u32 vrf_id;
 175   u8 is_ipv6;
 176   u8 src;
 177   u8 dst;
 178   u8 sport;
 179   u8 dport;
 180   u8 proto;
 181   u8 reverse;
 182 };
 183
 184 /** \brief IPv6 router advertisement config request
 185     @param client_index - opaque cookie to identify the sender
 186     @param context - sender context, to match reply w/ request
 187     @param suppress -
 188     @param managed -
 189     @param other -
 190     @param ll_option -
 191     @param send_unicast -
 192     @param cease -
 193     @param is_no -
 194     @param default_router -
 195     @param max_interval -
 196     @param min_interval -
 197     @param lifetime -
 198     @param initial_count -
 199     @param initial_interval -
 200 */
 201 autoreply define sw_interface_ip6nd_ra_config
 202 {
 203   u32 client_index;
 204   u32 context;
 205   u32 sw_if_index;
 206   u8 suppress;
 207   u8 managed;
 208   u8 other;
 209   u8 ll_option;
 210   u8 send_unicast;
 211   u8 cease;
 212   u8 is_no;
 213   u8 default_router;
 214   u32 max_interval;
 215   u32 min_interval;
 216   u32 lifetime;
 217   u32 initial_count;
 218   u32 initial_interval;
 219 };
 220
 221 /** \brief IPv6 router advertisement prefix config request
 222     @param client_index - opaque cookie to identify the sender
 223     @param context - sender context, to match reply w/ request
 224     @param sw_if_index - The interface the RA prefix information is for
 225     @param address[] - The prefix to advertise
 226     @param address_length - the prefix length
 227     @param use_default - Revert to default settings
 228     @param no_advertise - Do not advertise this prefix
 229     @param off_link - The prefix is off link (it is not configured on the interface)
 230                       Configures the L-flag, When set, indicates that this
 231                       prefix can be used for on-link determination.
 232     @param no_autoconfig - Setting for the A-flag. When
 233                            set indicates that this prefix can be used for
 234                           stateless address configuration.
 235     @param no_onlink - The prefix is not on link. Make sure this is consistent
 236                        with the off_link parameter else YMMV
 237     @param is_no - add/delete
 238     @param val_lifetime - The length of time in
 239                      seconds (relative to the time the packet is sent)
 240                      that the prefix is valid for the purpose of on-link
 241                      determination.  A value of all one bits
 242                      (0xffffffff) represents infinity
 243     @param pref_lifetime - The length of time in
 244                      seconds (relative to the time the packet is sent)
 245                      that addresses generated from the prefix via
 246                      stateless address autoconfiguration remain
 247                      preferred [ADDRCONF].  A value of all one bits
 248                      (0xffffffff) represents infinity.
 249 */
 250 autoreply define sw_interface_ip6nd_ra_prefix
 251 {
 252   u32 client_index;
 253   u32 context;
 254   u32 sw_if_index;
 255   u8 address[16];
 256   u8 address_length;
 257   u8 use_default;
 258   u8 no_advertise;
 259   u8 off_link;
 260   u8 no_autoconfig;
 261   u8 no_onlink;
 262   u8 is_no;
 263   u32 val_lifetime;
 264   u32 pref_lifetime;
 265 };
 266
 267 /** \brief IPv6 ND proxy config
 268     @param client_index - opaque cookie to identify the sender
 269     @param context - sender context, to match reply w/ request
 270     @param sw_if_index - The interface the host is on
 271     @param address - The address of the host for which to proxy for
 272     @param is_add - Adding or deleting
 273 */
 274 autoreply define ip6nd_proxy_add_del
 275 {
 276   u32 client_index;
 277   u32 context;
 278   u32 sw_if_index;
 279   u8 is_del;
 280   u8 address[16];
 281 };
 282
 283 /** \brief IPv6 ND proxy details returned after request
 284     @param context - sender context, to match reply w/ request
 285     @param retval - return code for the request
 286 */
 287 define ip6nd_proxy_details
 288 {
 289   u32 client_index;
 290   u32 context;
 291   u32 sw_if_index;
 292   u8 address[16];
 293 };
 294
 295 /** \brief IPv6 ND proxy dump request
 296     @param context - sender context, to match reply w/ request
 297     @param retval - return code for the request
 298     @param sw_if_index - The interface the host is on
 299     @param address - The address of the host for which to proxy for
 300 */
 301 define ip6nd_proxy_dump
 302 {
 303   u32 client_index;
 304   u32 context;
 305 };
 306
 307 /** \brief Start / stop sending router solicitation
 308     @param client_index - opaque cookie to identify the sender
 309     @param context - sender context, to match reply w/ request
 310     @param irt - initial retransmission time
 311     @param mrt - maximum retransmission time
 312     @param mrc - maximum retransmission count
 313     @param mrd - maximum retransmission duration
 314     @param sw_if_index - software interface index of interface
 315                          for sending router solicitation
 316     @param stop - if non-zero then stop sending router solicitation,
 317                   otherwise start sending router solicitation
 318 */
 319 autoreply define ip6nd_send_router_solicitation
 320 {
 321   u32 client_index;
 322   u32 context;
 323   u32 irt;
 324   u32 mrt;
 325   u32 mrc;
 326   u32 mrd;
 327   u32 sw_if_index;
 328   u8 stop;
 329 };
 330
 331 /** \brief IPv6 interface enable / disable request
 332     @param client_index - opaque cookie to identify the sender
 333     @param context - sender context, to match reply w/ request
 334     @param sw_if_index - interface used to reach neighbor
 335     @param enable - if non-zero enable ip6 on interface, else disable
 336 */
 337 autoreply define sw_interface_ip6_enable_disable
 338 {
 339   u32 client_index;
 340   u32 context;
 341   u32 sw_if_index;
 342   u8 enable;                    /* set to true if enable */
 343 };
 344
 345 /** \brief IPv6 set link local address on interface request
 346     @param client_index - opaque cookie to identify the sender
 347     @param context - sender context, to match reply w/ request
 348     @param sw_if_index - interface to set link local on
 349     @param address[] - the new link local address
 350 */
 351 autoreply define sw_interface_ip6_set_link_local_address
 352 {
 353   u32 client_index;
 354   u32 context;
 355   u32 sw_if_index;
 356   u8 address[16];
 357 };
 358
 359 /** \brief Add / del route request
 360     @param client_index - opaque cookie to identify the sender
 361     @param context - sender context, to match reply w/ request
 362     @param sw_if_index - software index of the new vlan's parent interface
 363     @param vrf_id - fib table /vrf associated with the route
 364     @param lookup_in_vrf -
 365     @param classify_table_index -
 366     @param is_add - 1 if adding the route, 0 if deleting
 367     @param is_drop - Drop the packet
 368     @param is_unreach - Drop the packet and rate limit send ICMP unreachable
 369     @param is_prohibit - Drop the packet and rate limit send ICMP prohibited
 370     @param is_ipv6 - 0 if an ip4 route, else ip6
 371     @param is_local - The route will result in packets sent to VPP IP stack
 372     @param is_udp_encap - The path describes a UDP-o-IP encapsulation.
 373     @param is_classify -
 374     @param is_multipath - Set to 1 if this is a multipath route, else 0
 375     @param is_dvr - Does the route resolve via a DVR interface.
 376     @param is_source_lookup - The the path is a deaggregate path (i.e. a lookup
 377                               in another table) is the lookup on the packet's
 378                               source address or destination.
 379     @param next_hop_weight - Weight for Unequal cost multi-path
 380     @param next_hop_preference - Path that are up that have the best preference are
 381                                  are used for forwarding. lower value is better.
 382     @param next_hop_id - Used when the path resolves via an object that has a unique
 383                          identifier.
 384     @param dst_address_length -
 385     @param dst_address[16] -
 386     @param next_hop_address[16] -
 387     @param next_hop_n_out_labels - the number of labels in the label stack
 388     @param next_hop_out_label_stack - the next-hop output label stack, outer most first
 389     @param next_hop_via_label - The next-hop is a resolved via a local label
 390 */
 391 autoreply define ip_add_del_route
 392 {
 393   u32 client_index;
 394   u32 context;
 395   u32 next_hop_sw_if_index;
 396   u32 table_id;
 397   u32 classify_table_index;
 398   u32 next_hop_table_id;
 399   u32 next_hop_id;
 400   u8 is_add;
 401   u8 is_drop;
 402   u8 is_unreach;
 403   u8 is_prohibit;
 404   u8 is_ipv6;
 405   u8 is_local;
 406   u8 is_classify;
 407   u8 is_multipath;
 408   u8 is_resolve_host;
 409   u8 is_resolve_attached;
 410   u8 is_dvr;
 411   u8 is_source_lookup;
 412   u8 is_udp_encap;
 413   u8 next_hop_weight;
 414   u8 next_hop_preference;
 415   u8 next_hop_proto;
 416   u8 dst_address_length;
 417   u8 dst_address[16];
 418   u8 next_hop_address[16];
 419   u8 next_hop_n_out_labels;
 420   u32 next_hop_via_label;
 421   vl_api_fib_mpls_label_t next_hop_out_label_stack[next_hop_n_out_labels];
 422 };
 423
 424 /** \brief Add / del route request
 425     @param client_index - opaque cookie to identify the sender
 426     @param context - sender context, to match reply w/ request
 427     @param sw_if_index - software index of the new vlan's parent interface
 428     @param vrf_id - fib table /vrf associated with the route
 429     @param next_hop_afi - Use dpo_proto_t
 430     FIXME
 431 */
 432 autoreply define ip_mroute_add_del
 433 {
 434   u32 client_index;
 435   u32 context;
 436   u32 next_hop_sw_if_index;
 437   u32 table_id;
 438   u32 entry_flags;
 439   u32 itf_flags;
 440   u32 rpf_id;
 441   u32 bier_imp;
 442   u16 grp_address_length;
 443   u8 next_hop_afi;
 444   u8 is_add;
 445   u8 is_ipv6;
 446   u8 is_local;
 447   u8 grp_address[16];
 448   u8 src_address[16];
 449   u8 nh_address[16];
 450 };
 451
 452 /** \brief Dump IP multicast fib table
 453     @param client_index - opaque cookie to identify the sender
 454 */
 455 define ip_mfib_dump
 456 {
 457   u32 client_index;
 458   u32 context;
 459 };
 460
 461 /** \brief IP Multicast FIB table response
 462     @param table_id - IP fib table id
 463     @address_length - mask length
 464     @grp_address - Group address/prefix
 465     @src_address - Source address
 466     @param count - the number of fib_path in path
 467     @param path  - array of of fib_path structures
 468 */
 469 manual_endian manual_print define ip_mfib_details
 470 {
 471   u32 context;
 472   u32 table_id;
 473   u32 entry_flags;
 474   u32 rpf_id;
 475   u8  address_length;
 476   u8  grp_address[4];
 477   u8  src_address[4];
 478   u32 count;
 479   vl_api_fib_path_t path[count];
 480 };
 481
 482 /** \brief Dump IP6 multicast fib table
 483     @param client_index - opaque cookie to identify the sender
 484 */
 485 define ip6_mfib_dump
 486 {
 487   u32 client_index;
 488   u32 context;
 489 };
 490
 491 /** \brief IP6 Multicast FIB table response
 492     @param table_id - IP fib table id
 493     @address_length - mask length
 494     @grp_address - Group address/prefix
 495     @src_address - Source address
 496     @param count - the number of fib_path in path
 497     @param path  - array of of fib_path structures
 498 */
 499 manual_endian manual_print define ip6_mfib_details
 500 {
 501   u32 context;
 502   u32 table_id;
 503   u8  address_length;
 504   u8  grp_address[16];
 505   u8  src_address[16];
 506   u32 count;
 507   vl_api_fib_path_t path[count];
 508 };
 509
 510 define ip_address_details
 511 {
 512   u32 client_index;
 513   u32 context;
 514   u8 ip[16];
 515   u8 prefix_length;
 516   u32 sw_if_index;
 517   u8 is_ipv6;
 518 };
 519
 520 define ip_address_dump
 521 {
 522   u32 client_index;
 523   u32 context;
 524   u32 sw_if_index;
 525   u8 is_ipv6;
 526 };
 527
 528 define ip_details
 529 {
 530   u32 sw_if_index;
 531   u32 context;
 532   u8 is_ipv6;
 533 };
 534
 535 define ip_dump
 536 {
 537   u32 client_index;
 538   u32 context;
 539   u8 is_ipv6;
 540 };
 541
 542 define mfib_signal_dump
 543 {
 544   u32 client_index;
 545   u32 context;
 546 };
 547
 548 define mfib_signal_details
 549 {
 550   u32 client_index;
 551   u32 context;
 552   u32 sw_if_index;
 553   u32 table_id;
 554   u16 grp_address_len;
 555   u8 grp_address[16];
 556   u8 src_address[16];
 557   u16 ip_packet_len;
 558   u8 ip_packet_data[256];
 559 };
 560
 561 /** \brief IP punt policer
 562     @param client_index - opaque cookie to identify the sender
 563     @param context - sender context, to match reply w/ request
 564     @param is_add - 1 to add neighbor, 0 to delete
 565     @param is_ipv6 - 1 for IPv6 neighbor, 0 for IPv4
 566     @param policer_index - Index of policer to use
 567 */
 568 autoreply define ip_punt_police
 569 {
 570   u32 client_index;
 571   u32 context;
 572   u32 policer_index;
 573   u8 is_add;
 574   u8 is_ip6;
 575 };
 576
 577 /** \brief IP punt redirect
 578     @param client_index - opaque cookie to identify the sender
 579     @param context - sender context, to match reply w/ request
 580     @param is_add - 1 to add neighbor, 0 to delete
 581     @param is_ipv6 - 1 for IPv6 neighbor, 0 for IPv4
 582     @param tx_sw_if_index - the TX interface to which traffic shoulde be
 583                             redirected.
 584     @param nh - The next-hop to redirect the traffic to.
 585 */
 586 autoreply define ip_punt_redirect
 587 {
 588   u32 client_index;
 589   u32 context;
 590   u32 rx_sw_if_index;
 591   u32 tx_sw_if_index;
 592   u8 is_add;
 593   u8 is_ip6;
 594   u8 nh[16];
 595 };
 596
 597 autoreply define ip_container_proxy_add_del
 598 {
 599   u32 client_index;
 600   u32 context;
 601   u8 ip[16];
 602   u8 is_ip4;
 603   u8 plen;
 604   u32 sw_if_index;
 605   u8 is_add;
 606 };
 607
 608 /** \brief Configure IP source and L4 port-range check
 609     @param client_index - opaque cookie to identify the sender
 610     @param context - sender context, to match reply w/ request
 611     @param is_ip6 - 1 if source address type is IPv6
 612     @param is_add - 1 if add, 0 if delete
 613     @param mask_length - mask length for address entry
 614     @param address - array of address bytes
 615     @param number_of_ranges - length of low_port and high_port arrays (must match)
 616     @param low_ports[32] - up to 32 low end of port range entries (must have corresponding high_ports entry)
 617     @param high_ports[32] - up to 32 high end of port range entries (must have corresponding low_ports entry)
 618     @param vrf_id - fib table/vrf id to associate the source and port-range check with
 619     @note To specify a single port set low_port and high_port entry the same
 620 */
 621 autoreply define ip_source_and_port_range_check_add_del
 622 {
 623   u32 client_index;
 624   u32 context;
 625   u8 is_ipv6;
 626   u8 is_add;
 627   u8 mask_length;
 628   u8 address[16];
 629   u8 number_of_ranges;
 630   u16 low_ports[32];
 631   u16 high_ports[32];
 632   u32 vrf_id;
 633 };
 634
 635 /** \brief Set interface source and L4 port-range request
 636     @param client_index - opaque cookie to identify the sender
 637     @param context - sender context, to match reply w/ request
 638     @param interface_id - interface index
 639     @param tcp_vrf_id - VRF associated with source and TCP port-range check
 640     @param udp_vrf_id - VRF associated with source and TCP port-range check
 641 */
 642 autoreply define ip_source_and_port_range_check_interface_add_del
 643 {
 644   u32 client_index;
 645   u32 context;
 646   u8 is_add;
 647   u32 sw_if_index;
 648   u32 tcp_in_vrf_id;
 649   u32 tcp_out_vrf_id;
 650   u32 udp_in_vrf_id;
 651   u32 udp_out_vrf_id;
 652 };
 653
 654 /** \brief IP probe neighbor address on an interface by sending an
 655            ARP request (for IP4) or ICMP6 Neighbor Solicitation (for IP6)
 656     @param client_index - opaque cookie to identify the sender
 657     @param context - sender context, to match reply w/ request
 658     @param sw_if_index - interface index
 659     @param dst_address - target IP address to send IP addr resolution request
 660     @param is_ipv6 - [1|0] to indicate if address family is IPv[6|4]
 661 */
 662 autoreply define ip_probe_neighbor
 663 {
 664   u32 client_index;
 665   u32 context;
 666   u32 sw_if_index;
 667   u8 dst_address[16];
 668   u8 is_ipv6;
 669 };
 670
 671 /** \brief Register for IP4 ARP resolution event on receing ARP reply or
 672            MAC/IP info from ARP requests in L2 BDs
 673     @param client_index - opaque cookie to identify the sender
 674     @param context - sender context, to match reply w/ request
 675     @param enable_disable - 1 => register for events, 0 => cancel registration
 676     @param pid - sender's pid
 677     @param address - exact IP4 address of interested arp resolution event, or
 678                      0 to get MAC/IP info from ARP requests in BDs
 679 */
 680 autoreply define want_ip4_arp_events
 681 {
 682   u32 client_index;
 683   u32 context;
 684   u8 enable_disable;
 685   u32 pid;
 686   u32 address;
 687 };
 688
 689 /** \brief Tell client about an IP4 ARP resolution event or
 690            MAC/IP info from ARP requests in L2 BDs
 691     @param client_index - opaque cookie to identify the sender
 692     @param address - the exact ip4 address of interest
 693     @param pid - client pid registered to receive notification
 694     @param sw_if_index - interface which received ARP packet
 695     @param new_mac - the new mac address
 696     @param mac_ip - 0: ARP resolution event, 1: MAC/IP info from L2 BDs
 697 */
 698 define ip4_arp_event
 699 {
 700   u32 client_index;
 701   u32 address;
 702   u32 pid;
 703   u32 sw_if_index;
 704   u8 new_mac[6];
 705   u8 mac_ip;
 706 };
 707
 708 service {
 709   rpc want_ip4_arp_events returns want_ip4_arp_events_reply
 710     events ip4_arp_event;
 711 };
 712
 713 /** \brief Register for IP6 ND resolution event on recieving NA reply
 714            MAC/IP info from ICMP6 Neighbor Solicitation in L2 BDs
 715     @param client_index - opaque cookie to identify the sender
 716     @param context - sender context, to match reply w/ request
 717     @param enable_disable - 1 => register for events, 0 => cancel registration
 718     @param pid - sender's pid
 719     @param address - the exact IP6 address of interested ND resolution event, or
 720                      0 to get MAC/IP info from ICMP6 NS in L2 BDs.
 721 */
 722 autoreply define want_ip6_nd_events
 723 {
 724   u32 client_index;
 725   u32 context;
 726   u8 enable_disable;
 727   u32 pid;
 728   u8 address[16];
 729 };
 730
 731 /** \brief Tell client about an IP6 ND resolution or
 732            MAC/IP info from ICMP6 Neighbor Solicitation in L2 BDs.
 733     @param client_index - opaque cookie to identify the sender
 734     @param pid - client pid registered to receive notification
 735     @param sw_if_index - interface which received ARP packet
 736     @param address - the exact ip6 address of interest
 737     @param new_mac - the new mac address
 738     @param mac_ip - 0: ND resolution event, 1: MAC/IP info from L2 BDs
 739 */
 740 define ip6_nd_event
 741 {
 742   u32 client_index;
 743   u32 pid;
 744   u32 sw_if_index;
 745   u8 address[16];
 746   u8 new_mac[6];
 747   u8 mac_ip;
 748 };
 749
 750 service {
 751   rpc want_ip6_ra_events returns want_ip6_ra_events_reply
 752     events ip6_ra_event;
 753 };
 754
 755 /** \brief Register for ip6 router advertisement events
 756     @param client_index - opaque cookie to identify the sender
 757     @param context - sender context, to match reply w/ request
 758     @param enable_disable - 1 => register for events, 0 => cancel registration
 759     @param pid - sender's pid
 760 */
 761 autoreply define want_ip6_ra_events
 762 {
 763   u32 client_index;
 764   u32 context;
 765   u8 enable_disable;
 766   u32 pid;
 767 };
 768
 769 /** \brief Struct representing RA prefix info
 770     @param dst_address - RA prefix info destination address
 771     @param dst_address_length - RA prefix info destination address length
 772     @param flags - RA prefix info flags
 773     @param valid_time - RA prefix info valid time
 774     @param preferred_time - RA prefix info preferred time
 775 */
 776 typeonly define ip6_ra_prefix_info
 777 {
 778   u8 dst_address[16];
 779   u8 dst_address_length;
 780   u8 flags;
 781   u32 valid_time;
 782   u32 preferred_time;
 783 };
 784
 785 /** \brief Tell client about a router advertisement event
 786     @param client_index - opaque cookie to identify the sender
 787     @param pid - client pid registered to receive notification
 788     @param current_hop_limit - RA current hop limit
 789     @param flags - RA flags
 790     @param router_lifetime_in_sec - RA lifetime in seconds
 791     @param neighbor_reachable_time_in_msec - RA neighbor reachable time in msec
 792     @param time_in_msec_between_retransmitted_neighbor_solicitations -
 793                time in msec between retransmitted neighbor solicitations
 794     @param n_prefixes -
 795     @param prefixes -
 796 */
 797 define ip6_ra_event
 798 {
 799   u32 client_index;
 800   u32 pid;
 801   u32 sw_if_index;
 802   u8 router_address[16];
 803   u8 current_hop_limit;
 804   u8 flags;
 805   u16 router_lifetime_in_sec;
 806   u32 neighbor_reachable_time_in_msec;
 807   u32 time_in_msec_between_retransmitted_neighbor_solicitations;
 808   u32 n_prefixes;
 809   vl_api_ip6_ra_prefix_info_t prefixes[n_prefixes];
 810 };
 811
 812 service {
 813   rpc want_ip6_nd_events returns want_ip6_nd_events_reply
 814     events ip6_nd_event;
 815 };
 816
 817 /** \brief Proxy ARP add / del request
 818     @param client_index - opaque cookie to identify the sender
 819     @param context - sender context, to match reply w/ request
 820     @param vrf_id - VRF / Fib table ID
 821     @param is_add - 1 if adding the Proxy ARP range, 0 if deleting
 822     @param low_address[4] - Low address of the Proxy ARP range
 823     @param hi_address[4] - High address of the Proxy ARP range
 824 */
 825 autoreply define proxy_arp_add_del
 826 {
 827   u32 client_index;
 828   u32 context;
 829   u32 vrf_id;
 830   u8 is_add;
 831   u8 low_address[4];
 832   u8 hi_address[4];
 833 };
 834
 835 /** \brief Proxy ARP add / del request
 836     @param client_index - opaque cookie to identify the sender
 837     @param context - sender context, to match reply w/ request
 838     @param sw_if_index - Which interface to enable / disable Proxy Arp on
 839     @param enable_disable - 1 to enable Proxy ARP on interface, 0 to disable
 840 */
 841 autoreply define proxy_arp_intfc_enable_disable
 842 {
 843   u32 client_index;
 844   u32 context;
 845   u32 sw_if_index;
 846   /* 1 = on, 0 = off */
 847   u8 enable_disable;
 848 };
 849
 850 /** \brief Reset fib table request
 851     @param client_index - opaque cookie to identify the sender
 852     @param context - sender context, to match reply w/ request
 853     @param vrf_id - vrf/table id of the fib table to reset
 854     @param is_ipv6 - an ipv6 fib to reset if non-zero, else ipv4
 855 */
 856 autoreply define reset_fib
 857 {
 858   u32 client_index;
 859   u32 context;
 860   u32 vrf_id;
 861   u8 is_ipv6;
 862 };
 863
 864 /** \brief Set max allowed ARP or ip6 neighbor entries request
 865     @param client_index - opaque cookie to identify the sender
 866     @param context - sender context, to match reply w/ request
 867     @param is_ipv6 - neighbor limit if non-zero, else ARP limit
 868     @param arp_neighbor_limit - the new limit, defaults are ~ 50k
 869 */
 870 autoreply define set_arp_neighbor_limit
 871 {
 872   u32 client_index;
 873   u32 context;
 874   u8 is_ipv6;
 875   u32 arp_neighbor_limit;
 876 };
 877
 878 /** \brief IOAM enable : Enable in-band OAM
 879     @param id - profile id
 880     @param seqno - To enable Seqno Processing
 881     @param analyse - Enabling analysis of iOAM at decap node
 882     @param pow_enable - Proof of Work enabled or not flag
 883     @param trace_enable - iOAM Trace enabled or not flag
 884 */
 885 autoreply define ioam_enable
 886 {
 887   u32 client_index;
 888   u32 context;
 889   u16 id;
 890   u8 seqno;
 891   u8 analyse;
 892   u8 pot_enable;
 893   u8 trace_enable;
 894   u32 node_id;
 895 };
 896
 897 /** \brief iOAM disable
 898     @param client_index - opaque cookie to identify the sender
 899     @param context - sender context, to match reply w/ request
 900     @param index - MAP Domain index
 901 */
 902 autoreply define ioam_disable
 903 {
 904   u32 client_index;
 905   u32 context;
 906   u16 id;
 907 };
 908
 909 autoreply define ip_reassembly_set
 910 {
 911   u32 client_index;
 912   u32 context;
 913   u32 timeout_ms;
 914   u32 max_reassemblies;
 915   u32 expire_walk_interval_ms;
 916   u8 is_ip6;
 917 };
 918
 919 define ip_reassembly_get
 920 {
 921   u32 client_index;
 922   u32 context;
 923   u8 is_ip6;
 924 };
 925
 926 define ip_reassembly_get_reply
 927 {
 928   u32 client_index;
 929   u32 context;
 930   i32 retval;
 931   u32 timeout_ms;
 932   u32 max_reassemblies;
 933   u32 expire_walk_interval_ms;
 934   u8 is_ip6;
 935 };
 936
 937 /** \brief Enable/disable reassembly feature
 938     @param client_index - opaque cookie to identify the sender
 939     @param context - sender context, to match reply w/ request
 940     @param sw_if_index - interface to enable/disable feature on
 941     @param enable_ip4 - enable ip4 reassembly if non-zero, disable if 0
 942     @param enable_ip6 - enable ip6 reassembly if non-zero, disable if 0
 943 */
 944 autoreply define ip_reassembly_enable_disable
 945 {
 946   u32 client_index;
 947   u32 context;
 948   u32 sw_if_index;
 949   u8 enable_ip4;
 950   u8 enable_ip6;
 951 };
 952
 953 /*
 954  * Local Variables:
 955  * eval: (c-set-style "gnu")
 956  * End:
 957  */