1 /* Hey Emacs use -*- mode: C -*- */
3 * Copyright (c) 2015 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:
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
19 This file defines vpe control-plane API messages which are generally
20 called through a shared memory interface.
24 /** \brief Register for interface events
25 @param client_index - opaque cookie to identify the sender
26 @param context - sender context, to match reply w/ request
27 @param enable_disable - 1 => register for events, 0 => cancel registration
28 @param pid - sender's pid
30 define want_interface_events {
37 /** \brief Reply for interface events registration
38 @param context - returned sender context, to match reply w/ request
39 @param retval - return code
41 define want_interface_events_reply {
46 /** \brief Interface details structure (fix this)
47 @param sw_if_index - index of the interface
48 @param sup_sw_if_index - index of parent interface if any, else same as sw_if_index
49 @param l2_address_length - length of the interface's l2 address
50 @param pid - the interface's l2 address
51 @param interface_name - name of the interface
52 @param link_duplex - 1 if half duplex, 2 if full duplex
53 @param link_speed - 1 = 10M, 2 = 100M, 4 = 1G, 8 = 10G, 16 = 40G, 32 = 100G
54 @param link_MTU - max. transmittion unit
55 @param sub_if_id - A number 0-N to uniquely identify this subif on super if
56 @param sub_dot1ad - 0 = dot1q, 1=dot1ad
57 @param sub_number_of_tags - Number of tags (0 - 2)
58 @param sub_outer_vlan_id
59 @param sub_inner_vlan_id
60 @param sub_exact_match
62 @param sub_outer_vlan_id_any
63 @param sub_inner_vlan_id_any
64 @param vtr_op - vlan tag rewrite operation
69 manual_java define sw_interface_details {
73 /* index of sup interface (e.g. hw interface).
74 equal to sw_if_index for super hw interface. */
77 /* Layer 2 address, if applicable */
78 u32 l2_address_length;
82 u8 interface_name[64];
84 /* 1 = up, 0 = down */
88 /* 1 = half duplex, 2 = full duplex */
91 /* 1 = 10M, 2 = 100M, 4 = 1G, 8 = 10G, 16 = 40G, 32 = 100G */
97 /* Subinterface ID. A number 0-N to uniquely identify this subinterface under the super interface*/
100 /* 0 = dot1q, 1=dot1ad */
103 /* Number of tags 0-2 */
104 u8 sub_number_of_tags;
105 u16 sub_outer_vlan_id;
106 u16 sub_inner_vlan_id;
109 u8 sub_outer_vlan_id_any;
110 u8 sub_inner_vlan_id_any;
112 /* vlan tag rewrite state */
114 u32 vtr_push_dot1q; // ethertype of first pushed tag is dot1q/dot1ad
115 u32 vtr_tag1; // first pushed tag
116 u32 vtr_tag2; // second pushed tag
119 /** \brief Set flags on the interface
120 @param client_index - opaque cookie to identify the sender
121 @param context - sender context, to match reply w/ request
122 @param sw_if_index - index of the interface to set flags on
123 @param admin_up_down - set the admin state, 1 = up, 0 = down
124 @param link_up_down - Oper state sent on change event, not used in config.
125 @param deleted - interface was deleted
127 define sw_interface_set_flags {
131 /* 1 = up, 0 = down */
137 /** \brief Reply to sw_interface_set_flags
138 @param context - sender context which was passed in the request
139 @param retval - return code of the set flags request
141 define sw_interface_set_flags_reply {
147 manual_java define sw_interface_dump {
150 u8 name_filter_valid;
154 /** \brief Set or delete one or all ip addresses on a specified interface
155 @param client_index - opaque cookie to identify the sender
156 @param context - sender context, to match reply w/ request
157 @param sw_if_index - index of the interface to add/del addresses
158 @param is_add - add address if non-zero, else delete
159 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
160 @param del_all - if non-zero delete all addresses on the interface
161 @param address_length - address length in bytes, 4 for ip4, 16 for ip6
162 @param address - array of address bytes
164 define sw_interface_add_del_address {
175 /** \brief Reply for interface events registration
176 @param context - returned sender context, to match reply w/ request
177 @param retval - return code
179 define sw_interface_add_del_address_reply {
184 /** \brief Associate the specified interface with a fib table
185 @param client_index - opaque cookie to identify the sender
186 @param context - sender context, to match reply w/ request
187 @param sw_if_index - index of the interface
188 @param is_ipv6 - if non-zero ipv6, else ipv4
189 @param vrf_id - fib table/vrd id to associate the interface with
191 define sw_interface_set_table {
199 /** \brief Reply for interface events registration
200 @param context - returned sender context, to match reply w/ request
201 @param retval - return code
203 define sw_interface_set_table_reply {
208 /** \brief Initialize a new tap interface with the given paramters
209 @param client_index - opaque cookie to identify the sender
210 @param context - sender context, to match reply w/ request
211 @param use_random_mac - let the system generate a unique mac address
212 @param tap_name - name to associate with the new interface
213 @param mac_address - mac addr to assign to the interface if use_radom not set
222 u32 custom_dev_instance;
225 /** \brief Reply for tap connect request
226 @param context - returned sender context, to match reply w/ request
227 @param retval - return code
228 @param sw_if_index - software index allocated for the new tap interface
230 define tap_connect_reply {
236 /** \brief Modify a tap interface with the given paramters
237 @param client_index - opaque cookie to identify the sender
238 @param context - sender context, to match reply w/ request
239 @param sw_if_index - interface index of existing tap interface
240 @param use_random_mac - let the system generate a unique mac address
241 @param tap_name - name to associate with the new interface
242 @param mac_address - mac addr to assign to the interface if use_radom not set
252 u32 custom_dev_instance;
255 /** \brief Reply for tap modify request
256 @param context - returned sender context, to match reply w/ request
257 @param retval - return code
258 @param sw_if_index - software index if the modified tap interface
260 define tap_modify_reply {
266 /** \brief Delete tap interface
267 @param client_index - opaque cookie to identify the sender
268 @param context - sender context, to match reply w/ request
269 @param sw_if_index - interface index of existing tap interface
277 /** \brief Reply for tap delete request
278 @param context - returned sender context, to match reply w/ request
279 @param retval - return code
281 define tap_delete_reply {
286 /** \brief Dump tap interfaces request */
287 define sw_interface_tap_dump {
292 /** \brief Reply for tap dump request
293 @param sw_if_index - software index of tap interface
294 @param dev_name - Linux tap device name
296 manual_java define sw_interface_tap_details {
302 /** \brief Create a new subinterface with the given vlan id
303 @param client_index - opaque cookie to identify the sender
304 @param context - sender context, to match reply w/ request
305 @param sw_if_index - software index of the new vlan's parent interface
306 @param vlan_id - vlan tag of the new interface
308 define create_vlan_subif {
315 /** \brief Reply for the vlan subinterface create request
316 @param context - returned sender context, to match reply w/ request
317 @param retval - return code
318 @param sw_if_index - software index allocated for the new subinterface
320 define create_vlan_subif_reply {
326 /** \brief Add / del route request
327 @param client_index - opaque cookie to identify the sender
328 @param context - sender context, to match reply w/ request
329 @param sw_if_index - software index of the new vlan's parent interface
330 @param vrf_id - fib table /vrf associated with the route
331 @param lookup_in_vrf -
332 @param resolve_attempts -
333 @param classify_table_index -
334 @param create_vrf_if_needed -
335 @param resolve_if_needed -
336 @param is_add - 1 if adding the route, 0 if deleting
338 @param is_ipv6 - 0 if an ip4 route, else ip6
341 @param is_multipath - Set to 1 if this is a multipath route, else 0
342 @param not_last - Is last or not last msg in group of multiple add/del msgs
343 @param next_hop_weight -
344 @param dst_address_length -
345 @param dst_address[16] -
346 @param next_hop_address[16] -
348 define ip_add_del_route {
351 u32 next_hop_sw_if_index;
354 u32 resolve_attempts;
355 u32 classify_table_index;
356 u8 create_vrf_if_needed;
357 u8 resolve_if_needed;
363 /* Is last/not-last message in group of multiple add/del messages. */
367 u8 dst_address_length;
369 u8 next_hop_address[16];
372 /** \brief Reply for add / del route request
373 @param context - returned sender context, to match reply w/ request
374 @param retval - return code
376 define ip_add_del_route_reply {
382 /** \brief Add / del gre tunnel request
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 - software index of the new vlan's parent interface
386 @param inner_vrf_id -
387 @param outer_vrf_id -
388 @param is_add - 1 if adding the tunnel, 0 if deleting
389 @param src_address[4] - tunnel source address
390 @param dst_address[4] - tunnel destination address
391 @param intf_address -
392 @param intf_address_length -
394 define mpls_gre_add_del_tunnel {
404 u8 intfc_address_length;
407 /** \brief Reply for add / del tunnel request
408 @param context - returned sender context, to match reply w/ request
409 @param retval - return code
411 define mpls_gre_add_del_tunnel_reply {
414 u32 tunnel_sw_if_index;
417 /** \brief Add / del MPLS encapsulation request
418 @param client_index - opaque cookie to identify the sender
419 @param context - sender context, to match reply w/ request
420 @param vrf_id - vrf id
421 @param dst_address[4] -
422 @param is_add - 1 if adding the encap, 0 if deleting
423 @param nlabels - number of labels
424 @param labels - array of labels
426 define mpls_add_del_encap {
431 /* 1 = add, 0 = delete */
437 /** \brief Reply for add / del encapsulation request
438 @param context - returned sender context, to match reply w/ request
439 @param retval - return code
441 define mpls_add_del_encap_reply {
446 /** \brief Add / del MPLS decapsulation request
447 @param client_index - opaque cookie to identify the sender
448 @param context - sender context, to match reply w/ request
449 @param rx_vrf_id - receive vrf
450 @param tx_vrf_id - transmit vrf
454 @param is_add - 1 if adding the encap, 0 if deleting
456 define mpls_add_del_decap {
467 /** \brief Reply for MPLS decap add / del request
468 @param context - returned sender context, to match reply w/ request
469 @param retval - return code
471 define mpls_add_del_decap_reply {
476 /** \brief Proxy ARP add / del request
477 @param client_index - opaque cookie to identify the sender
478 @param context - sender context, to match reply w/ request
479 @param vrf_id - VRF / Fib table ID
480 @param is_add - 1 if adding the Proxy ARP range, 0 if deleting
481 @param low_address[4] - Low address of the Proxy ARP range
482 @param hi_address[4] - High address of the Proxy ARP range
484 define proxy_arp_add_del {
493 /** \brief Reply for proxy arp add / del request
494 @param context - returned sender context, to match reply w/ request
495 @param retval - return code
497 define proxy_arp_add_del_reply {
502 /** \brief Proxy ARP add / del request
503 @param client_index - opaque cookie to identify the sender
504 @param context - sender context, to match reply w/ request
505 @param sw_if_index - Which interface to enable / disable Proxy Arp on
506 @param enable_disable - 1 to enable Proxy ARP on interface, 0 to disable
508 define proxy_arp_intfc_enable_disable {
512 /* 1 = on, 0 = off */
516 /** \brief Reply for Proxy ARP interface enable / disable request
517 @param context - returned sender context, to match reply w/ request
518 @param retval - return code
520 define proxy_arp_intfc_enable_disable_reply {
525 /** \brief IP neighbor add / del request
526 @param client_index - opaque cookie to identify the sender
527 @param context - sender context, to match reply w/ request
528 @param vrf_id - vrf_id, only for IP4
529 @param sw_if_index - interface used to reach neighbor
530 @param is_add - 1 to add neighbor, 0 to delete
531 @param is_ipv6 - 1 for IPv6 neighbor, 0 for IPv4
533 @param mac_address - l2 address of the neighbor
534 @param dst_address - ip4 or ip6 address of the neighbor
536 define ip_neighbor_add_del {
539 u32 vrf_id; /* only makes sense for ip4 */
541 /* 1 = add, 0 = delete */
549 /** \brief Reply for IP Neighbor add / delete request
550 @param context - returned sender context, to match reply w/ request
551 @param retval - return code
553 define ip_neighbor_add_del_reply {
558 /** \brief Reset VRF (remove all routes etc) request
559 @param client_index - opaque cookie to identify the sender
560 @param context - sender context, to match reply w/ request
561 @param is_ipv6 - 1 for IPv6 neighbor, 0 for IPv4
562 @param vrf_id - ID of th FIB table / VRF to reset
571 /** \brief Reply for Reset VRF request
572 @param context - returned sender context, to match reply w/ request
573 @param retval - return code
575 define reset_vrf_reply {
580 /** \brief Is Address Reachable request - DISABLED
581 @param client_index - opaque cookie to identify the sender
582 @param context - sender context, to match reply w/ request
583 @param next_hop_sw_if_index - index of interface used to get to next hop
584 @param is_ipv6 - 1 for IPv6, 0 for IPv4
585 @param is_error - address not found or does not match intf
586 @param address[] - Address in question
588 define is_address_reachable {
589 u32 client_index; /* (api_main_t *) am->my_client_index */
591 u32 next_hop_sw_if_index;
592 u8 is_known; /* on reply, this is the answer */
594 u8 is_error; /* address not found or does not match intf */
598 /** \brief Want Stats, register for stats updates
599 @param client_index - opaque cookie to identify the sender
600 @param context - sender context, to match reply w/ request
601 @param enable_disable - 1 = enable stats, 0 = disable
602 @param pid - pid of process requesting stats updates
611 /** \brief Reply for Want Stats request
612 @param context - returned sender context, to match reply w/ request
613 @param retval - return code
615 manual_java define want_stats_reply {
620 /** \brief Want stats counters structure
621 @param vnet_counter_type- such as ip4, ip6, punts, etc
622 @param is_combined - rx & tx total (all types) counts
623 @param first_sw_if_index - first sw index in block of index, counts
624 @param count - number of interfaces this stats block includes counters for
625 @param data - contiguous block of vlib_counter_t structures
627 manual_java define vnet_interface_counters {
628 /* enums - plural - in vnet/interface.h */
629 u8 vnet_counter_type;
631 u32 first_sw_if_index;
636 typeonly manual_print manual_endian define ip4_fib_counter {
643 manual_java manual_print manual_endian define vnet_ip4_fib_counters {
646 vl_api_ip4_fib_counter_t c[0];
649 typeonly manual_print manual_endian define ip6_fib_counter {
656 manual_java manual_print manual_endian define vnet_ip6_fib_counters {
659 vl_api_ip6_fib_counter_t c[0];
662 /** \brief Request for a single block of summary stats
663 @param client_index - opaque cookie to identify the sender
664 @param context - sender context, to match reply w/ request
666 define vnet_get_summary_stats {
671 /** \brief Reply for vnet_get_summary_stats request
672 @param context - sender context, to match reply w/ request
673 @param retval - return code for request
678 define vnet_summary_stats_reply {
686 /** \brief OAM event structure
687 @param dst_address[] -
690 manual_java define oam_event {
695 /** \brief Want OAM events request
696 @param client_index - opaque cookie to identify the sender
697 @param context - sender context, to match reply w/ request
698 @param enable_disable- enable if non-zero, else disable
699 @param pid - pid of the requesting process
701 define want_oam_events {
708 /** \brief Want OAM events response
709 @param context - sender context, to match reply w/ request
710 @param retval - return code for the want oam stats request
712 define want_oam_events_reply {
717 /** \brief OAM add / del target request
718 @param client_index - opaque cookie to identify the sender
719 @param context - sender context, to match reply w/ request
720 @param vrf_id - vrf_id of the target
721 @param src_address[] - source address to use for the updates
722 @param dst_address[] - destination address of the target
723 @param is_add - add target if non-zero, else delete
734 /** \brief OAM add / del target response
735 @param context - sender context, to match reply w/ request
736 @param retval - return code of the request
738 define oam_add_del_reply {
743 /** \brief Reset fib table request
744 @param client_index - opaque cookie to identify the sender
745 @param context - sender context, to match reply w/ request
746 @param vrf_id - vrf/table id of the fib table to reset
747 @param is_ipv6 - an ipv6 fib to reset if non-zero, else ipv4
756 /** \brief Reset fib response
757 @param context - sender context, to match reply w/ request
758 @param retval - return code for the reset bfib request
760 define reset_fib_reply {
765 /** \brief DHCP Proxy config add / del request
766 @param client_index - opaque cookie to identify the sender
767 @param context - sender context, to match reply w/ request
768 @param vrf_id - vrf id
769 @param if_ipv6 - ipv6 if non-zero, else ipv4
770 @param is_add - add the config if non-zero, else delete
771 @param insert_circuit_id - option82 suboption 1 fib number
772 @param dhcp_server[] - server address
773 @param dhcp_src_address[] - <fix this, need details>
775 define dhcp_proxy_config {
781 u8 insert_circuit_id;
783 u8 dhcp_src_address[16];
786 /** \brief DHCP Proxy config response
787 @param context - sender context, to match reply w/ request
788 @param retval - return code for the request
790 define dhcp_proxy_config_reply {
795 /** \brief DHCP Proxy set / unset vss request
796 @param client_index - opaque cookie to identify the sender
797 @param context - sender context, to match reply w/ request
798 @param tbl_id - table id
799 @param oui - first part of vpn id
800 @param fib_id - second part of vpn id
801 @param is_ipv6 - ip6 if non-zero, else ip4
802 @param is_add - set vss if non-zero, else delete
804 define dhcp_proxy_set_vss {
814 /** \brief DHCP proxy set / unset vss response
815 @param context - sender context, to match reply w/ request
816 @param retval - return code for the request
818 define dhcp_proxy_set_vss_reply {
823 /** \brief Set the ip flow hash config for a fib request
824 @param client_index - opaque cookie to identify the sender
825 @param context - sender context, to match reply w/ request
826 @param vrf_id - vrf/fib id
827 @param is_ipv6 - if non-zero the fib is ip6, else ip4
828 @param src - if non-zero include src in flow hash
829 @param dst - if non-zero include dst in flow hash
830 @param sport - if non-zero include sport in flow hash
831 @param dport - if non-zero include dport in flow hash
832 @param proto -if non-zero include proto in flow hash
833 @param reverse - if non-zero include reverse in flow hash
835 define set_ip_flow_hash {
848 /** \brief Set the ip flow hash config for a fib response
849 @param context - sender context, to match reply w/ request
850 @param retval - return code for the request
852 define set_ip_flow_hash_reply {
857 /** \brief IPv6 router advertisement config request
858 @param client_index - opaque cookie to identify the sender
859 @param context - sender context, to match reply w/ request
864 @param send_unicast -
867 @param default_router -
868 @param max_interval -
869 @param min_interval -
871 @param initial_count -
872 @param initial_interval -
874 define sw_interface_ip6nd_ra_config {
890 u32 initial_interval;
893 /** \brief IPv6 router advertisement config response
894 @param context - sender context, to match reply w/ request
895 @param retval - return code for the request
897 define sw_interface_ip6nd_ra_config_reply {
902 /** \brief IPv6 router advertisement prefix config request
903 @param client_index - opaque cookie to identify the sender
904 @param context - sender context, to match reply w/ request
907 @param address_length -
909 @param no_advertise -
911 @param no_autoconfig -
914 @param val_lifetime -
915 @param pref_lifetime -
917 define sw_interface_ip6nd_ra_prefix {
933 /** \brief IPv6 router advertisement prefix config response
934 @param context - sender context, to match reply w/ request
935 @param retval - return code for the request
937 define sw_interface_ip6nd_ra_prefix_reply {
942 /** \brief IPv6 interface enable / disable request
943 @param client_index - opaque cookie to identify the sender
944 @param context - sender context, to match reply w/ request
945 @param sw_if_index - interface used to reach neighbor
946 @param enable - if non-zero enable ip6 on interface, else disable
948 define sw_interface_ip6_enable_disable {
952 u8 enable; /* set to true if enable*/
955 /** \brief IPv6 interface enable / disable response
956 @param context - sender context, to match reply w/ request
957 @param retval - return code for the request
959 define sw_interface_ip6_enable_disable_reply {
964 /** \brief IPv6 set link local address on interface request
965 @param client_index - opaque cookie to identify the sender
966 @param context - sender context, to match reply w/ request
967 @param sw_if_index - interface to set link local on
968 @param address[] - the new link local address
969 @param address_length - link local address length
971 define sw_interface_ip6_set_link_local_address {
979 /** \brief IPv6 set link local address on interface response
980 @param context - sender context, to match reply w/ request
981 @param retval - error code for the request
983 define sw_interface_ip6_set_link_local_address_reply {
988 /** \brief Set unnumbered interface add / del request
989 @param client_index - opaque cookie to identify the sender
990 @param context - sender context, to match reply w/ request
991 @param sw_if_index - interface with an IP address
992 @param unnumbered_sw_if_index - interface which will use the address
993 @param is_add - if non-zero set the association, else unset it
995 define sw_interface_set_unnumbered {
998 u32 sw_if_index; /* use this intfc address */
999 u32 unnumbered_sw_if_index; /* on this interface */
1003 /** \brief Set unnumbered interface add / del response
1004 @param context - sender context, to match reply w/ request
1005 @param retval - return code for the request
1007 define sw_interface_set_unnumbered_reply {
1012 /** \brief Create loopback interface request
1013 @param client_index - opaque cookie to identify the sender
1014 @param context - sender context, to match reply w/ request
1015 @param mac_address - mac addr to assign to the interface if none-zero
1017 define create_loopback {
1023 /** \brief Create loopback interface response
1024 @param context - sender context, to match reply w/ request
1025 @param sw_if_index - sw index of the interface that was created
1026 @param retval - return code for the request
1028 define create_loopback_reply {
1034 /** \brief Delete loopback interface request
1035 @param client_index - opaque cookie to identify the sender
1036 @param context - sender context, to match reply w/ request
1037 @param sw_if_index - sw index of the interface that was created
1039 define delete_loopback {
1045 /** \brief Delete loopback interface response
1046 @param context - sender context, to match reply w/ request
1047 @param retval - return code for the request
1049 define delete_loopback_reply {
1054 /** \brief Control ping from client to api server request
1055 @param client_index - opaque cookie to identify the sender
1056 @param context - sender context, to match reply w/ request
1058 manual_java define control_ping {
1063 /** \brief Control ping from the client to the server response
1064 @param client_index - opaque cookie to identify the sender
1065 @param context - sender context, to match reply w/ request
1066 @param retval - return code for the request
1067 @param vpe_pid - the pid of the vpe, returned by the server
1069 manual_java define control_ping_reply {
1076 /** \brief Process a vpe parser cli string request
1077 @param client_index - opaque cookie to identify the sender
1078 @param context - sender context, to match reply w/ request
1079 @param cmd_in_shmem - pointer to cli command string
1081 define cli_request {
1087 /** \brief vpe parser cli string response
1088 @param context - sender context, to match reply w/ request
1089 @param retval - return code for request
1090 @param reply_in_shmem - Reply string from cli processing if any
1098 /** \brief Set max allowed ARP or ip6 neighbor entries request
1099 @param client_index - opaque cookie to identify the sender
1100 @param context - sender context, to match reply w/ request
1101 @param is_ipv6 - neighbor limit if non-zero, else ARP limit
1102 @param arp_neighbor_limit - the new limit, defaults are ~ 50k
1104 define set_arp_neighbor_limit {
1108 u32 arp_neighbor_limit;
1111 /** \brief Set max allowed ARP or ip6 neighbor entries response
1112 @param context - sender context, to match reply w/ request
1113 @param retval - return code for request
1115 define set_arp_neighbor_limit_reply {
1120 /** \brief L2 interface patch add / del request
1121 @param client_index - opaque cookie to identify the sender
1122 @param context - sender context, to match reply w/ request
1123 @param rx_sw_if_index - receive side interface
1124 @param tx_sw_if_index - transmit side interface
1125 @param is_add - if non-zero set up the interface patch, else remove it
1127 define l2_patch_add_del {
1135 /** \brief L2 interface patch add / del response
1136 @param context - sender context, to match reply w/ request
1137 @param retval - return code for the request
1139 define l2_patch_add_del_reply {
1144 /** \brief IPv6 segment routing tunnel add / del request
1145 @param client_index - opaque cookie to identify the sender
1146 @param context - sender context, to match reply w/ request
1147 @param is_add - add the tunnel if non-zero, else delete it
1148 @param src_address[] -
1149 @param dst_address[] -
1150 @param dst_mask_width -
1151 @param inner_vrf_id -
1152 @param outer_vrf_id -
1153 @param flags_net_byte_order -
1156 @param segs_and_tags[] -
1158 define sr_tunnel_add_del {
1167 u16 flags_net_byte_order;
1170 u8 segs_and_tags[0];
1173 /** \brief IPv6 segment routing tunnel add / del response
1174 @param context - sender context, to match reply w/ request
1175 @param retval - return value for request
1177 define sr_tunnel_add_del_reply {
1182 /** \brief Interface set vpath request
1183 @param client_index - opaque cookie to identify the sender
1184 @param context - sender context, to match reply w/ request
1185 @param sw_if_index - interface used to reach neighbor
1186 @param enable - if non-zero enable, else disable
1188 define sw_interface_set_vpath {
1195 /** \brief Interface set vpath response
1196 @param context - sender context, to match reply w/ request
1197 @param retval - return code for the request
1199 define sw_interface_set_vpath_reply {
1204 /** \brief MPLS Ethernet add / del tunnel request
1205 @param client_index - opaque cookie to identify the sender
1206 @param context - sender context, to match reply w/ request
1207 @param vrf_id - vrf_id, only for IP4
1208 @param sw_if_index - interface used to reach neighbor
1209 @param is_add - add if set, tunnel delete if 0
1210 @param dst_mac_address -
1211 @param adj_address -
1212 @param adj_address_length -
1214 define mpls_ethernet_add_del_tunnel {
1221 u8 dst_mac_address[6];
1223 u8 adj_address_length;
1226 /** \brief Reply for MPLS Ethernet add / delete tunnel request
1227 @param context - sender context, to match reply w/ request
1228 @param retval - return code for the request
1230 define mpls_ethernet_add_del_tunnel_reply {
1233 u32 tunnel_sw_if_index;
1235 /** \brief MPLS Ethernet add/ del tunnel 2
1236 @param client_index - opaque cookie to identify the sender
1237 @param context - sender context, to match reply w/ request
1238 @param inner_vrf_id -
1239 @param outer_vrf_id -
1240 @param resolve_attempts -
1241 @param resolve_opaque -
1242 @param resolve_if_needed -
1244 @param adj_address -
1245 @param adj_address_length -
1246 @param next_hop_ip4_address_in_outer_vrf -
1248 define mpls_ethernet_add_del_tunnel_2 {
1253 u32 resolve_attempts;
1254 u32 resolve_opaque; /* no need to set this */
1255 u8 resolve_if_needed;
1259 u8 adj_address_length;
1260 u8 next_hop_ip4_address_in_outer_vrf [4];
1263 /** \brief MPLS Ethernet add/ del tunnel 2
1264 @param context - sender context, to match reply w/ request
1265 @param retval - return code for add /del request
1267 define mpls_ethernet_add_del_tunnel_2_reply {
1272 /** \brief Set L2 XConnect between two interfaces request
1273 @param client_index - opaque cookie to identify the sender
1274 @param context - sender context, to match reply w/ request
1275 @param rx_sw_if_index - Receive interface index
1276 @param tx_sw_if_index - Transmit interface index
1277 @param enable - enable xconnect if not 0, else set to L3 mode
1279 define sw_interface_set_l2_xconnect {
1287 /** \brief Set L2 XConnect response
1288 @param context - sender context, to match reply w/ request
1289 @param retval - L2 XConnect request return code
1291 define sw_interface_set_l2_xconnect_reply {
1296 /** \brief Interface bridge mode request
1297 @param client_index - opaque cookie to identify the sender
1298 @param context - sender context, to match reply w/ request
1299 @param rx_sw_if_index - the interface
1300 @param bd_id - bridge domain id
1301 @param bvi - Setup interface as a bvi, bridge mode only
1302 @param shg - Shared horizon group, for bridge mode only
1303 @param enable - Enable beige mode if not 0, else set to L3 mode
1305 define sw_interface_set_l2_bridge {
1315 /** \brief Interface bridge mode response
1316 @param context - sender context, to match reply w/ request
1317 @param retval - Bridge mode request return code
1319 define sw_interface_set_l2_bridge_reply {
1324 /** \brief L2 FIB add entry request
1325 @param client_index - opaque cookie to identify the sender
1326 @param context - sender context, to match reply w/ request
1327 @param mac - the entry's mac address
1328 @param bd_id - the entry's bridge domain id
1329 @param sw_if_index - the interface
1330 @param is_add - If non zero add the entry, else delete it
1334 define l2fib_add_del {
1345 /** \brief L2 FIB add entry response
1346 @param context - sender context, to match reply w/ request
1347 @param retval - return code for the add l2fib entry request
1349 define l2fib_add_del_reply {
1354 /** \brief Set L2 flags request !!! TODO - need more info, feature bits in l2_input.h
1355 @param client_index - opaque cookie to identify the sender
1356 @param context - sender context, to match reply w/ request
1357 @param sw_if_index - interface
1358 @param is_set - if non-zero, set the bits, else clear them
1359 @param feature_bitmap - non-zero bits to set or clear
1369 /** \brief Set L2 bits response
1370 @param context - sender context, to match reply w/ request
1371 @param retval - return code for the set l2 bits request
1373 define l2_flags_reply {
1376 u32 resulting_feature_bitmap;
1379 /** \brief Set bridge flags (such as L2_LEARN, L2_FWD, L2_FLOOD,
1380 L2_UU_FLOOD, or L2_ARP_TERM) request
1381 @param client_index - opaque cookie to identify the sender
1382 @param context - sender context, to match reply w/ request
1383 @param bd_id - the bridge domain to set the flags for
1384 @param is_set - if non-zero, set the flags, else clear them
1385 @param feature_bitmap - bits that are non-zero to set or clear
1387 define bridge_flags {
1395 /** \brief Set bridge flags response
1396 @param context - sender context, to match reply w/ request
1397 @param retval - return code for the set bridge flags request
1398 @param resulting_feature_bitmap - the feature bitmap value after the request is implemented
1400 define bridge_flags_reply {
1403 u32 resulting_feature_bitmap;
1406 /** \brief Set bridge domain ip to mac entry request
1407 @param client_index - opaque cookie to identify the sender
1408 @param context - sender context, to match reply w/ request
1409 @param bd_id - the bridge domain to set the flags for
1410 @param is_add - if non-zero, add the entry, else clear it
1411 @param is_ipv6 - if non-zero, ipv6 address, else ipv4 address
1412 @param mac_address - MAC address
1415 define bd_ip_mac_add_del {
1425 /** \brief Set bridge domain ip to mac entry response
1426 @param context - sender context, to match reply w/ request
1427 @param retval - return code for the set bridge flags request
1429 define bd_ip_mac_add_del_reply {
1434 /** \brief Add/Delete classification table request
1435 @param client_index - opaque cookie to identify the sender
1436 @param context - sender context, to match reply w/ request
1437 @param is_add- if non-zero add the table, else delete it
1438 @param table_index - if add, reuturns index of the created table, else specifies the table to delete
1439 @param nbuckets - number of buckets when adding a table
1440 @param memory_size - memory size when adding a table
1441 @param match_n_vectors - number of match vectors
1442 @param next_table_index - index of next table
1443 @param miss_next_index - index of miss table
1444 @param mask[] - match mask
1446 define classify_add_del_table {
1454 u32 match_n_vectors;
1455 u32 next_table_index;
1456 u32 miss_next_index;
1460 /** \brief Add/Delete classification table response
1461 @param context - sender context, to match reply w/ request
1462 @param retval - return code for the table add/del requst
1463 @param new_table_index - for add, returned index of the new table
1464 @param skip_n_vectors - for add, returned value of skip_n_vectors in table
1465 @param match_n_vectors -for add, returned value of match_n_vectors in table
1467 define classify_add_del_table_reply {
1470 u32 new_table_index;
1472 u32 match_n_vectors;
1475 /** \brief Classify add / del session request
1476 @param client_index - opaque cookie to identify the sender
1477 @param context - sender context, to match reply w/ request
1478 @param is_add - add session if non-zero, else delete
1479 @param table_index - index of the table to add/del the session, required
1480 @param hit_next_index - for add, hit_next_index of new session, required
1481 @param opaque_index - for add, opaque_index of new session
1482 @param advance -for add, advance value for session
1483 @param match[] - for add, match value for session, required
1485 define classify_add_del_session {
1496 /** \brief Classify add / del session response
1497 @param context - sender context, to match reply w/ request
1498 @param retval - return code for the add/del session request
1500 define classify_add_del_session_reply {
1505 /** \brief Set/unset the classification table for an interface request
1506 @param client_index - opaque cookie to identify the sender
1507 @param context - sender context, to match reply w/ request
1508 @param is_ipv6 - ipv6 if non-zero, else ipv4
1509 @param sw_if_index - interface to associate with the table
1510 @param table_index - index of the table, if ~0 unset the table
1512 define classify_set_interface_ip_table {
1517 u32 table_index; /* ~0 => off */
1520 /** \brief Set/unset interface classification table response
1521 @param context - sender context, to match reply w/ request
1522 @param retval - return code
1524 define classify_set_interface_ip_table_reply {
1529 /** \brief Set/unset l2 classification tables for an interface request
1530 @param client_index - opaque cookie to identify the sender
1531 @param context - sender context, to match reply w/ request
1532 @param sw_if_index - interface to set/unset tables for
1533 @param ip4_table_index - ip4 index, use ~0 for all 3 indexes to unset
1534 @param ip6_table_index - ip6 index
1535 @param other_table_index - other index
1537 define classify_set_interface_l2_tables {
1542 u32 ip4_table_index;
1543 u32 ip6_table_index;
1544 u32 other_table_index;
1547 /** \brief Set/unset l2 classification tables for an interface response
1548 @param context - sender context, to match reply w/ request
1549 @param retval - return code for the request
1551 define classify_set_interface_l2_tables_reply {
1556 /** \brief Get node index using name request
1557 @param client_index - opaque cookie to identify the sender
1558 @param context - sender context, to match reply w/ request
1559 @param node_name[] - name of the node
1561 define get_node_index {
1567 /** \brief Get node index using name request
1568 @param context - sender context, to match reply w/ request
1569 @param retval - return code for the request
1570 @param node_index - index of the desired node if found, else ~0
1572 define get_node_index_reply {
1578 /** \brief Set the next node for a given node request
1579 @param client_index - opaque cookie to identify the sender
1580 @param context - sender context, to match reply w/ request
1581 @param node_name[] - node to add the next node to
1582 @param next_name[] - node to add as the next node
1584 define add_node_next {
1591 /** \brief IP Set the next node for a given node response
1592 @param context - sender context, to match reply w/ request
1593 @param retval - return code for the add next node request
1594 @param next_index - the index of the next node if success, else ~0
1596 define add_node_next_reply {
1602 /** \brief DHCP Proxy config 2 add / del request
1603 @param client_index - opaque cookie to identify the sender
1604 @param context - sender context, to match reply w/ request
1605 @param rx_vrf_id - receive vrf id
1606 @param server_vrf_id - server vrf id
1607 @param if_ipv6 - ipv6 if non-zero, else ipv4
1608 @param is_add - add the config if non-zero, else delete
1609 @param insert_circuit_id - option82 suboption 1 fib number
1610 @param dhcp_server[] - server address
1611 @param dhcp_src_address[] - <fix this, need details>
1613 define dhcp_proxy_config_2 {
1620 u8 insert_circuit_id;
1622 u8 dhcp_src_address[16];
1625 /** \brief DHCP Proxy config 2 add / del response
1626 @param context - sender context, to match reply w/ request
1627 @param retval - return code for request
1629 define dhcp_proxy_config_2_reply {
1634 /** \brief l2tpv3 tunnel interface create request
1635 @param client_index - opaque cookie to identify the sender
1636 @param context - sender context, to match reply w/ request
1637 @param client_address - remote client tunnel ip address
1638 @param client_address - local tunnel ip address
1639 @param is_ipv6 - ipv6 if non-zero, else ipv4
1640 @param local_session_id - local tunnel session id
1641 @param remote_session_id - remote tunnel session id
1642 @param local_cookie - local tunnel cookie
1643 @param l2_sublayer_present - l2 sublayer is present in packets if non-zero
1645 define l2tpv3_create_tunnel {
1648 u8 client_address [16];
1649 u8 our_address [16];
1651 u32 local_session_id;
1652 u32 remote_session_id;
1655 u8 l2_sublayer_present;
1658 /** \brief l2tpv3 tunnel interface create response
1659 @param context - sender context, to match reply w/ request
1660 @param retval - return code for the request
1661 @param sw_if_index - index of the new tunnel interface
1663 define l2tpv3_create_tunnel_reply {
1669 define l2tpv3_set_tunnel_cookies {
1673 u64 new_local_cookie;
1674 u64 new_remote_cookie;
1677 /** \brief L2TP tunnel set cookies response
1678 @param context - sender context, to match reply w/ request
1679 @param retval - return code for the request
1681 define l2tpv3_set_tunnel_cookies_reply {
1686 manual_java define sw_if_l2tpv3_tunnel_details {
1689 u8 interface_name[64];
1690 u8 client_address [16];
1691 u8 our_address [16];
1692 u32 local_session_id;
1693 u32 remote_session_id;
1694 u64 local_cookie[2];
1696 u8 l2_sublayer_present;
1699 define sw_if_l2tpv3_tunnel_dump {
1704 /** \brief L2 fib clear table request, clear all mac entries in the l2 fib
1705 @param client_index - opaque cookie to identify the sender
1706 @param context - sender context, to match reply w/ request
1708 define l2_fib_clear_table {
1713 /** \brief L2 fib clear table response
1714 @param context - sender context, to match reply w/ request
1715 @param retval - return code for the request
1717 define l2_fib_clear_table_reply {
1722 /** \brief L2 interface ethernet flow point filtering enable/disable request
1723 @param client_index - opaque cookie to identify the sender
1724 @param context - sender context, to match reply w/ request
1725 @param sw_if_index - interface to enable/disable filtering on
1726 @param enable_disable - if non-zero enable filtering, else disable
1728 define l2_interface_efp_filter {
1735 /** \brief L2 interface ethernet flow point filtering response
1736 @param context - sender context, to match reply w/ request
1737 @param retval - return code for the request
1739 define l2_interface_efp_filter_reply {
1744 define l2tpv3_interface_enable_disable {
1751 define l2tpv3_interface_enable_disable_reply {
1756 define l2tpv3_set_lookup_key {
1759 /* 0 = ip6 src_address, 1 = ip6 dst_address, 2 = session_id */
1763 define l2tpv3_set_lookup_key_reply {
1768 define vxlan_add_del_tunnel {
1776 u32 decap_next_index;
1780 define vxlan_add_del_tunnel_reply {
1786 manual_java define vxlan_tunnel_dump {
1792 manual_java define vxlan_tunnel_details {
1798 u32 decap_next_index;
1803 define gre_add_del_tunnel {
1812 define gre_add_del_tunnel_reply {
1818 manual_java define gre_tunnel_dump {
1824 manual_java define gre_tunnel_details {
1832 /** \brief L2 interface vlan tag rewrite configure request
1833 @param client_index - opaque cookie to identify the sender
1834 @param context - sender context, to match reply w/ request
1835 @param sw_if_index - interface the operation is applied to
1836 @param vtr_op - Choose from l2_vtr_op_t enum values
1837 @param push_dot1q - first pushed flag dot1q id set, else dot1ad
1838 @param tag1 - Needed for any push or translate vtr op
1839 @param tag2 - Needed for any push 2 or translate x-2 vtr ops
1841 define l2_interface_vlan_tag_rewrite {
1846 u32 push_dot1q; // ethertype of first pushed tag is dot1q/dot1ad
1847 u32 tag1; // first pushed tag
1848 u32 tag2; // second pushed tag
1851 /** \brief L2 interface vlan tag rewrite response
1852 @param context - sender context, to match reply w/ request
1853 @param retval - return code for the request
1855 define l2_interface_vlan_tag_rewrite_reply {
1860 /** \brief vhost-user interface create request
1861 @param client_index - opaque cookie to identify the sender
1862 @param is_server - our side is socket server
1863 @param sock_filename - unix socket filename, used to speak with frontend
1864 @param use_custom_mac - enable or disable the use of the provided hardware address
1865 @param mac_address - hardware address to use if 'use_custom_mac' is set
1867 define create_vhost_user_if {
1871 u8 sock_filename[256];
1873 u32 custom_dev_instance;
1878 /** \brief vhost-user interface create response
1879 @param context - sender context, to match reply w/ request
1880 @param retval - return code for the request
1881 @param sw_if_index - interface the operation is applied to
1883 define create_vhost_user_if_reply {
1889 /** \brief vhost-user interface modify request
1890 @param client_index - opaque cookie to identify the sender
1891 @param is_server - our side is socket server
1892 @param sock_filename - unix socket filename, used to speak with frontend
1894 define modify_vhost_user_if {
1899 u8 sock_filename[256];
1901 u32 custom_dev_instance;
1904 /** \brief vhost-user interface modify response
1905 @param context - sender context, to match reply w/ request
1906 @param retval - return code for the request
1908 define modify_vhost_user_if_reply {
1913 /** \brief vhost-user interface delete request
1914 @param client_index - opaque cookie to identify the sender
1916 define delete_vhost_user_if {
1922 /** \brief vhost-user interface delete response
1923 @param context - sender context, to match reply w/ request
1924 @param retval - return code for the request
1926 define delete_vhost_user_if_reply {
1931 define create_subif {
1937 /* These fields map directly onto the subif template */
1941 u8 dot1ad; // 0 = dot1q, 1=dot1ad
1944 u8 outer_vlan_id_any;
1945 u8 inner_vlan_id_any;
1950 define create_subif_reply {
1956 /** \brief show version
1957 @param client_index - opaque cookie to identify the sender
1958 @param context - sender context, to match reply w/ request
1960 define show_version {
1965 /** \brief show version response
1966 @param context - sender context, to match reply w/ request
1967 @param retval - return code for the request
1968 @param program - name of the program (vpe)
1969 @param version - version of the program
1970 @param build_directory - root of the workspace where the program was built
1972 manual_java define show_version_reply {
1978 u8 build_directory[256];
1981 define nsh_gre_add_del_tunnel {
1988 u32 decap_next_index;
1989 u8 tlv_len_in_words;
1995 /* in network byte order */
2004 define nsh_gre_add_del_tunnel_reply {
2010 /** \brief Vhost-user interface details structure (fix this)
2011 @param sw_if_index - index of the interface
2012 @param interface_name - name of interface
2013 @param virtio_net_hdr_sz - net header size
2014 @param features - interface features
2015 @param is_server - vhost-user server socket
2016 @param sock_filename - socket filename
2017 @param num_regions - number of used memory regions
2019 manual_java define sw_interface_vhost_user_details {
2022 u8 interface_name[64];
2023 u32 virtio_net_hdr_sz;
2026 u8 sock_filename[256];
2032 define sw_interface_vhost_user_dump {
2037 manual_java define ip_address_details {
2044 manual_java define ip_address_dump {
2051 manual_java define ip_details {
2062 /** \brief l2 fib table entry structure
2063 @param bd_id - the l2 fib / bridge domain table id
2064 @param mac - the entry's mac address
2065 @param sw_if_index - index of the interface
2066 @param static_mac - the entry is statically configured.
2067 @param filter_mac - the entry is a mac filter entry.
2068 @param bvi_mac - the mac address is a bridge virtual interface
2070 manual_java define l2_fib_table_entry {
2080 /** \brief Dump l2 fib (aka bridge domain) table
2081 @param client_index - opaque cookie to identify the sender
2082 @param bd_id - the l2 fib / bridge domain table identifier
2084 manual_java define l2_fib_table_dump {
2090 define nsh_vxlan_gpe_add_del_tunnel {
2097 u32 decap_next_index;
2099 u8 tlv_len_in_words;
2105 /* in network byte order */
2114 define nsh_vxlan_gpe_add_del_tunnel_reply {
2120 define lisp_gpe_add_del_tunnel {
2127 u32 decap_next_index;
2133 /* in network byte order */
2137 define lisp_gpe_add_del_tunnel_reply {
2143 /** \brief add or delete locator_set
2144 @param client_index - opaque cookie to identify the sender
2145 @param context - sender context, to match reply w/ request
2146 @param is_add - add address if non-zero, else delete
2147 @param locator_set_name - locator name
2149 define lisp_add_del_locator_set {
2153 u8 locator_set_name[64];
2156 /** \brief Reply for locator_set add/del
2157 @param context - returned sender context, to match reply w/ request
2158 @param retval - return code
2160 define lisp_add_del_locator_set_reply {
2165 /** \brief add or delete locator for locator_set
2166 @param client_index - opaque cookie to identify the sender
2167 @param context - sender context, to match reply w/ request
2168 @param is_add - add address if non-zero, else delete
2169 @param locator_set_name - name of locator_set to add/del locator
2170 @param sw_if_index - index of the interface
2171 @param priority - priority of the lisp locator
2172 @param weight - weight of the lisp locator
2174 define lisp_add_del_locator {
2178 u8 locator_set_name[64];
2184 /** \brief Reply for locator add/del
2185 @param context - returned sender context, to match reply w/ request
2186 @param retval - return code
2188 define lisp_add_del_locator_reply {
2193 /** \brief add or delete lisp eid-table
2194 @param client_index - opaque cookie to identify the sender
2195 @param context - sender context, to match reply w/ request
2196 @param is_add - add address if non-zero, else delete
2197 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
2198 @param ip_address - array of address bytes
2199 @param prefix_len - prefix len
2200 @param locator_set_name - name of locator_set to add/del eid-table
2202 define lisp_add_del_local_eid {
2209 u8 locator_set_name[64];
2212 /** \brief Reply for local_eid add/del
2213 @param context - returned sender context, to match reply w/ request
2214 @param retval - return code
2216 define lisp_add_del_local_eid_reply {
2221 /** \brief add or delete lisp gpe maptunel
2222 @param client_index - opaque cookie to identify the sender
2223 @param context - sender context, to match reply w/ request
2224 @param is_add - add address if non-zero, else delete
2225 @param eid_is_ipv6 - if non-zero the address is ipv6, else ipv4
2226 @param eid_ip_address - array of address bytes
2227 @param eid_prefix_len - prefix len
2228 @param address_is_ipv6 - if non-zero the address is ipv6, else ipv4
2229 @param source_ip_address - array of address bytes
2230 @param destination_ip_address - array of address bytes
2232 define lisp_gpe_add_del_fwd_entry {
2237 u8 eid_ip_address[16];
2240 u8 source_ip_address[16];
2241 u8 destination_ip_address[16];
2244 /** \brief Reply for gpe_fwd_entry add/del
2245 @param context - returned sender context, to match reply w/ request
2246 @param retval - return code
2248 define lisp_gpe_add_del_fwd_entry_reply {
2253 /** \brief add or delete map-resolver
2254 @param client_index - opaque cookie to identify the sender
2255 @param context - sender context, to match reply w/ request
2256 @param is_add - add address if non-zero, else delete
2257 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
2258 @param ip_address - array of address bytes
2260 define lisp_add_del_map_resolver {
2268 /** \brief Reply for map_resolver add/del
2269 @param context - returned sender context, to match reply w/ request
2270 @param retval - return code
2272 define lisp_add_del_map_resolver_reply {
2277 /** \brief enable or disable lisp-gpe protocol
2278 @param client_index - opaque cookie to identify the sender
2279 @param context - sender context, to match reply w/ request
2280 @param is_en - enable protocol if non-zero, else disable
2282 define lisp_gpe_enable_disable {
2288 /** \brief Reply for gpe enable/disable
2289 @param context - returned sender context, to match reply w/ request
2290 @param retval - return code
2292 define lisp_gpe_enable_disable_reply {
2297 /** \brief add or delete gpe_iface
2298 @param client_index - opaque cookie to identify the sender
2299 @param context - sender context, to match reply w/ request
2300 @param is_add - add address if non-zero, else delete
2302 define lisp_gpe_add_del_iface {
2310 /** \brief Reply for gpe_iface add/del
2311 @param context - returned sender context, to match reply w/ request
2312 @param retval - return code
2314 define lisp_gpe_add_del_iface_reply {
2319 /** \brief LISP locator_set status
2320 @param locator_set_name - name of the locator_set
2321 @param sw_if_index - sw_if_index of the locator
2322 @param priority - locator priority
2323 @param weight - locator weight
2325 manual_java define lisp_locator_set_details {
2327 u8 locator_set_name[64];
2333 /** \brief Request for locator_set summary status
2334 @param client_index - opaque cookie to identify the sender
2335 @param context - sender context, to match reply w/ request
2337 define lisp_locator_set_dump {
2342 /** \brief LISP local eid table status
2343 @param locator_set_name - name of the locator_set
2344 @param eid_is_ipv6 - if non-zero the address is ipv6, else ipv4
2345 @param eid_ip_address - array of address bytes
2346 @param eid_prefix_len - prefix len
2348 manual_java define lisp_local_eid_table_details {
2350 u8 locator_set_name[64];
2352 u8 eid_ip_address[16];
2356 /** \brief Request for local eid table summary status
2357 @param client_index - opaque cookie to identify the sender
2358 @param context - sender context, to match reply w/ request
2360 define lisp_local_eid_table_dump {
2365 manual_java define lisp_gpe_tunnel_details {
2370 u8 destination_ip[16];
2382 /** \brief Request for gpe tunnel summary status
2383 @param client_index - opaque cookie to identify the sender
2384 @param context - sender context, to match reply w/ request
2386 define lisp_gpe_tunnel_dump {
2391 /** \brief LISP map resolver status
2392 @param locator_set_name - name of the locator_set
2393 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
2394 @param ip_address - array of address bytes
2396 manual_java define lisp_map_resolver_details {
2402 /** \brief Request for map resolver summary status
2403 @param client_index - opaque cookie to identify the sender
2404 @param context - sender context, to match reply w/ request
2406 define lisp_map_resolver_dump {
2411 /* Gross kludge, DGMS */
2412 define interface_name_renumber {
2416 u32 new_show_dev_instance;
2419 define interface_name_renumber_reply {
2424 /** \brief Register for ip4 arp resolution events
2425 @param client_index - opaque cookie to identify the sender
2426 @param context - sender context, to match reply w/ request
2427 @param enable_disable - 1 => register for events, 0 => cancel registration
2428 @param pid - sender's pid
2429 @param address - the exact ip4 address of interest
2431 define want_ip4_arp_events {
2439 /** \brief Reply for interface events registration
2440 @param context - returned sender context, to match reply w/ request
2441 @param retval - return code
2443 define want_ip4_arp_events_reply {
2448 /** \brief Tell client about an ip4 arp resolution event
2449 @param client_index - opaque cookie to identify the sender
2450 @param context - sender context, to match reply w/ request
2451 @param address - the exact ip4 address of interest
2452 @param pid - client pid registered to receive notification
2453 @param sw_if_index - interface which received ARP packet
2454 @param new_mac - the new mac address
2456 define ip4_arp_event {
2465 /** \brief L2 bridge domain add or delete request
2466 @param client_index - opaque cookie to identify the sender
2467 @param context - sender context, to match reply w/ request
2468 @param bd_id - the bridge domain to create
2469 @param flood - enable/disable bcast/mcast flooding in the bd
2470 @param uu_flood - enable/disable uknown unicast flood in the bd
2471 @param forward - enable/disable forwarding on all interfaces in the bd
2472 @param learn - enable/disable learning on all interfaces in the bd
2473 @param arp_term - enable/disable arp termination in the bd
2474 @param is_add - add or delete flag
2476 define bridge_domain_add_del {
2488 /** \brief L2 bridge domain add or delete response
2489 @param context - sender context, to match reply w/ request
2490 @param retval - return code for the set bridge flags request
2492 define bridge_domain_add_del_reply {
2497 /** \brief L2 bridge domain request operational state details
2498 @param client_index - opaque cookie to identify the sender
2499 @param context - sender context, to match reply w/ request
2500 @param bd_id - the bridge domain id desired or ~0 to request all bds
2502 manual_java define bridge_domain_dump {
2508 /** \brief L2 bridge domain operational state response
2509 @param bd_id - the bridge domain id
2510 @param flood - bcast/mcast flooding state on all interfaces in the bd
2511 @param uu_flood - uknown unicast flooding state on all interfaces in the bd
2512 @param forward - forwarding state on all interfaces in the bd
2513 @param learn - learning state on all interfaces in the bd
2514 @param arp_term - arp termination state on all interfaces in the bd
2515 @param n_sw_ifs - number of sw_if_index's in the domain
2517 manual_java define bridge_domain_details {
2525 u32 bvi_sw_if_index;
2529 /** \brief L2 bridge domain sw interface operational state response
2530 @param bd_id - the bridge domain id
2531 @param sw_if_index - sw_if_index in the domain
2532 @param shg - split horizon group for the interface
2534 manual_java define bridge_domain_sw_if_details {
2541 /** \brief DHCP Client config add / del request
2542 @param client_index - opaque cookie to identify the sender
2543 @param context - sender context, to match reply w/ request
2544 @param sw_if_index - index of the interface for DHCP client
2545 @param hostname - hostname
2546 @param is_add - add the config if non-zero, else delete
2547 @param want_dhcp_event - DHCP event sent to the sender
2548 via dhcp_compl_event API message if non-zero
2549 @param pid - sender's pid
2551 define dhcp_client_config {
2561 /** \brief DHCP Client config response
2562 @param context - sender context, to match reply w/ request
2563 @param retval - return code for the request
2565 define dhcp_client_config_reply {
2570 /** \brief Set/unset input ACL interface
2571 @param client_index - opaque cookie to identify the sender
2572 @param context - sender context, to match reply w/ request
2573 @param sw_if_index - interface to set/unset input ACL
2574 @param ip4_table_index - ip4 classify table index (~0 for skip)
2575 @param ip6_table_index - ip6 classify table index (~0 for skip)
2576 @param l2_table_index - l2 classify table index (~0 for skip)
2577 @param is_add - Set input ACL if non-zero, else unset
2578 Note: User is recommeneded to use just one valid table_index per call.
2579 (ip4_table_index, ip6_table_index, or l2_table_index)
2581 define input_acl_set_interface {
2585 u32 ip4_table_index;
2586 u32 ip6_table_index;
2591 /** \brief Set/unset input ACL interface response
2592 @param context - sender context, to match reply w/ request
2593 @param retval - return code for the request
2595 define input_acl_set_interface_reply {
2600 /** \brief IPsec: Add/delete Security Policy Database
2601 @param client_index - opaque cookie to identify the sender
2602 @param context - sender context, to match reply w/ request
2603 @param is_add - add SPD if non-zero, else delete
2604 @param spd_id - SPD instance id (control plane allocated)
2607 define ipsec_spd_add_del {
2614 /** \brief Reply for IPsec: Add/delete Security Policy Database entry
2615 @param context - returned sender context, to match reply w/ request
2616 @param retval - return code
2619 define ipsec_spd_add_del_reply {
2624 /** \brief IPsec: Add/delete SPD from interface
2626 @param client_index - opaque cookie to identify the sender
2627 @param context - sender context, to match reply w/ request
2628 @param is_add - add security mode if non-zero, else delete
2629 @param sw_if_index - index of the interface
2630 @param spd_id - SPD instance id to use for lookups
2634 define ipsec_interface_add_del_spd {
2643 /** \brief Reply for IPsec: Add/delete SPD from interface
2644 @param context - returned sender context, to match reply w/ request
2645 @param retval - return code
2648 define ipsec_interface_add_del_spd_reply {
2653 /** \brief IPsec: Add/delete Security Policy Database entry
2655 See RFC 4301, 4.4.1.1 on how to match packet to selectors
2657 @param client_index - opaque cookie to identify the sender
2658 @param context - sender context, to match reply w/ request
2659 @param is_add - add SPD if non-zero, else delete
2660 @param spd_id - SPD instance id (control plane allocated)
2661 @param priority - priority of SPD entry (non-unique value). Used to order SPD matching - higher priorities match before lower
2662 @param is_outbound - entry applies to outbound traffic if non-zero, otherwise applies to inbound traffic
2663 @param is_ipv6 - remote/local address are IPv6 if non-zero, else IPv4
2664 @param remote_address_start - start of remote address range to match
2665 @param remote_address_stop - end of remote address range to match
2666 @param local_address_start - start of local address range to match
2667 @param local_address_stop - end of local address range to match
2668 @param protocol - protocol type to match [0 means any]
2669 @param remote_port_start - start of remote port range to match ...
2670 @param remote_port_stop - end of remote port range to match [0 to 65535 means ANY, 65535 to 0 means OPAQUE]
2671 @param local_port_start - start of local port range to match ...
2672 @param local_port_stop - end of remote port range to match [0 to 65535 means ANY, 65535 to 0 means OPAQUE]
2673 @param policy - 0 = bypass (no IPsec processing), 1 = discard (discard packet with ICMP processing), 2 = resolve (send request to control plane for SA resolving, and discard without ICMP processing), 3 = protect (apply IPsec policy using following parameters)
2674 @param sa_id - SAD instance id (control plane allocated)
2678 define ipsec_spd_add_del_entry {
2690 u8 remote_address_start[16];
2691 u8 remote_address_stop[16];
2692 u8 local_address_start[16];
2693 u8 local_address_stop[16];
2697 u16 remote_port_start;
2698 u16 remote_port_stop;
2699 u16 local_port_start;
2700 u16 local_port_stop;
2707 /** \brief Reply for IPsec: Add/delete Security Policy Database entry
2708 @param context - returned sender context, to match reply w/ request
2709 @param retval - return code
2712 define ipsec_spd_add_del_entry_reply {
2717 /** \brief IPsec: Add/delete Security Association Database entry
2718 @param client_index - opaque cookie to identify the sender
2719 @param context - sender context, to match reply w/ request
2720 @param is_add - add SAD entry if non-zero, else delete
2722 @param sad_id - sad id
2724 @param spi - security parameter index
2726 @param protocol - 0 = AH, 1 = ESP
2728 @param crypto_algorithm - 0 = Null, 1 = AES-CBC-128, 2 = AES-CBC-192, 3 = AES-CBC-256, 4 = 3DES-CBC
2729 @param crypto_key_length - length of crypto_key in bytes
2730 @param crypto_key - crypto keying material
2732 @param integrity_algorithm - 0 = None, 1 = MD5-96, 2 = SHA1-96, 3 = SHA-256, 4 = SHA-384, 5=SHA-512
2733 @param integrity_key_length - length of integrity_key in bytes
2734 @param integrity_key - integrity keying material
2736 @param use_extended_sequence_number - use ESN when non-zero
2738 @param is_tunnel - IPsec tunnel mode if non-zero, else transport mode
2739 @param is_tunnel_ipv6 - IPsec tunnel mode is IPv6 if non-zero, else IPv4 tunnel only valid if is_tunnel is non-zero
2740 @param tunnel_src_address - IPsec tunnel source address IPv6 if is_tunnel_ipv6 is non-zero, else IPv4. Only valid if is_tunnel is non-zero
2741 @param tunnel_dst_address - IPsec tunnel destination address IPv6 if is_tunnel_ipv6 is non-zero, else IPv4. Only valid if is_tunnel is non-zero
2745 IPsec tunnel address copy mode (to support GDOI)
2748 define ipsec_sad_add_del_entry {
2759 u8 crypto_algorithm;
2760 u8 crypto_key_length;
2763 u8 integrity_algorithm;
2764 u8 integrity_key_length;
2765 u8 integrity_key[128];
2767 u8 use_extended_sequence_number;
2771 u8 tunnel_src_address[16];
2772 u8 tunnel_dst_address[16];
2775 /** \brief Reply for IPsec: Add/delete Security Association Database entry
2776 @param context - returned sender context, to match reply w/ request
2777 @param retval - return code
2780 define ipsec_sad_add_del_entry_reply {
2785 /** \brief IPsec: Update Security Association keys
2786 @param client_index - opaque cookie to identify the sender
2787 @param context - sender context, to match reply w/ request
2789 @param sa_id - sa id
2791 @param crypto_key_length - length of crypto_key in bytes
2792 @param crypto_key - crypto keying material
2794 @param integrity_key_length - length of integrity_key in bytes
2795 @param integrity_key - integrity keying material
2798 define ipsec_sa_set_key {
2804 u8 crypto_key_length;
2807 u8 integrity_key_length;
2808 u8 integrity_key[128];
2811 /** \brief Reply for IPsec: Update Security Association keys
2812 @param context - returned sender context, to match reply w/ request
2813 @param retval - return code
2816 define ipsec_sa_set_key_reply {
2821 /** \brief IKEv2: Add/delete profile
2822 @param client_index - opaque cookie to identify the sender
2823 @param context - sender context, to match reply w/ request
2825 @param name - IKEv2 profile name
2826 @param is_add - Add IKEv2 profile if non-zero, else delete
2828 define ikev2_profile_add_del {
2836 /** \brief Reply for IKEv2: Add/delete profile
2837 @param context - returned sender context, to match reply w/ request
2838 @param retval - return code
2840 define ikev2_profile_add_del_reply {
2845 /** \brief IKEv2: Set IKEv2 profile authentication method
2846 @param client_index - opaque cookie to identify the sender
2847 @param context - sender context, to match reply w/ request
2849 @param name - IKEv2 profile name
2850 @param auth_method - IKEv2 authentication method (shared-key-mic/rsa-sig)
2851 @param is_hex - Authentication data in hex format if non-zero, else string
2852 @param data_len - Authentication data length
2853 @param data - Authentication data (for rsa-sig cert file path)
2855 define ikev2_profile_set_auth {
2866 /** \brief Reply for IKEv2: Set IKEv2 profile authentication method
2867 @param context - returned sender context, to match reply w/ request
2868 @param retval - return code
2870 define ikev2_profile_set_auth_reply {
2875 /** \brief IKEv2: Set IKEv2 profile local/remote identification
2876 @param client_index - opaque cookie to identify the sender
2877 @param context - sender context, to match reply w/ request
2879 @param name - IKEv2 profile name
2880 @param is_local - Identification is local if non-zero, else remote
2881 @param id_type - Identification type
2882 @param data_len - Identification data length
2883 @param data - Identification data
2885 define ikev2_profile_set_id {
2896 /** \brief Reply for IKEv2:
2897 @param context - returned sender context, to match reply w/ request
2898 @param retval - return code
2900 define ikev2_profile_set_id_reply {
2905 /** \brief IKEv2: Set IKEv2 profile traffic selector parameters
2906 @param client_index - opaque cookie to identify the sender
2907 @param context - sender context, to match reply w/ request
2909 @param name - IKEv2 profile name
2910 @param is_local - Traffic selector is local if non-zero, else remote
2911 @param proto - Traffic selector IP protocol (if zero not relevant)
2912 @param start_port - The smallest port number allowed by traffic selector
2913 @param end_port - The largest port number allowed by traffic selector
2914 @param start_addr - The smallest address included in traffic selector
2915 @param end_addr - The largest address included in traffic selector
2917 define ikev2_profile_set_ts {
2930 /** \brief Reply for IKEv2: Set IKEv2 profile traffic selector parameters
2931 @param context - returned sender context, to match reply w/ request
2932 @param retval - return code
2934 define ikev2_profile_set_ts_reply {
2939 /** \brief IKEv2: Set IKEv2 local RSA private key
2940 @param client_index - opaque cookie to identify the sender
2941 @param context - sender context, to match reply w/ request
2943 @param key_file - Key file absolute path
2945 define ikev2_set_local_key {
2952 /** \brief Reply for IKEv2: Set IKEv2 local key
2953 @param context - returned sender context, to match reply w/ request
2954 @param retval - return code
2956 define ikev2_set_local_key_reply {
2961 /** \brief Tell client about a DHCP completion event
2962 @param client_index - opaque cookie to identify the sender
2963 @param pid - client pid registered to receive notification
2964 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
2965 @param host_address - Host IP address
2966 @param router_address - Router IP address
2967 @param host_mac - Host MAC address
2969 manual_java define dhcp_compl_event {
2974 u8 host_address[16];
2975 u8 router_address[16];
2979 /** \brief Add MAP domains
2980 @param client_index - opaque cookie to identify the sender
2981 @param context - sender context, to match reply w/ request
2982 @param ip6_prefix - Rule IPv6 prefix
2983 @param ip4_prefix - Rule IPv4 prefix
2984 @param ip6_src - MAP domain IPv6 BR address / Tunnel source
2985 @param ip6_prefix_len - Rule IPv6 prefix length
2986 @param ip4_prefix_len - Rule IPv4 prefix length
2987 @param ea_bits_len - Embedded Address bits length
2988 @param psid_offset - Port Set Identifider (PSID) offset
2989 @param psid_length - PSID length
2990 @param is_translation - MAP-E / MAP-T
2993 define map_add_domain {
3001 u8 ip6_src_prefix_len;
3009 /** \brief Reply for MAP domain add
3010 @param context - returned sender context, to match reply w/ request
3011 @param index - MAP domain index
3012 @param retval - return code
3014 define map_add_domain_reply {
3020 /** \brief Delete MAP domain
3021 @param client_index - opaque cookie to identify the sender
3022 @param context - sender context, to match reply w/ request
3023 @param index - MAP Domain index
3025 define map_del_domain {
3031 /** \brief Reply for MAP domain del
3032 @param context - returned sender context, to match reply w/ request
3033 @param retval - return code
3035 define map_del_domain_reply {
3040 /** \brief Add or Delete MAP rule from a domain (Only used for shared IPv4 per subscriber)
3041 @param client_index - opaque cookie to identify the sender
3042 @param context - sender context, to match reply w/ request
3043 @param index - MAP Domain index
3044 @param is_add - If 1 add rule, if 0 delete rule
3045 @param ip6_dst - MAP CE IPv6 address
3046 @param psid - Rule PSID
3048 define map_add_del_rule {
3057 /** \brief Reply for MAP rule add/del
3058 @param context - returned sender context, to match reply w/ request
3059 @param retval - return code
3061 define map_add_del_rule_reply {
3066 /** \brief Get list of map domains
3067 @param client_index - opaque cookie to identify the sender
3069 define map_domain_dump {
3074 manual_java define map_domain_details {
3091 define map_rule_dump {
3097 manual_java define map_rule_details {
3103 /** \brief Request for a single block of summary stats
3104 @param client_index - opaque cookie to identify the sender
3105 @param context - sender context, to match reply w/ request
3107 define map_summary_stats {
3112 /** \brief Reply for map_summary_stats request
3113 @param context - sender context, to match reply w/ request
3114 @param retval - return code for request
3115 @param total_bindings -
3117 @param total_ip4_fragments -
3118 @param total_security_check -
3120 define map_summary_stats_reply {
3126 u64 total_ip4_fragments;
3127 u64 total_security_check[2];
3130 /** \brief cop: enable/disable junk filtration features on an interface
3131 @param client_index - opaque cookie to identify the sender
3132 @param context - sender context, to match reply w/ request
3133 @param sw_if_inded - desired interface
3134 @param enable_disable - 1 => enable, 0 => disable
3137 define cop_interface_enable_disable {
3144 /** \brief cop: interface enable/disable junk filtration reply
3145 @param context - returned sender context, to match reply w/ request
3146 @param retval - return code
3149 define cop_interface_enable_disable_reply {
3154 /** \brief cop: enable/disable whitelist filtration features on an interface
3155 Note: the supplied fib_id must match in order to remove the feature!
3157 @param client_index - opaque cookie to identify the sender
3158 @param context - sender context, to match reply w/ request
3159 @param sw_if_index - interface handle, physical interfaces only
3160 @param fib_id - fib identifier for the whitelist / blacklist fib
3161 @param ip4 - 1 => enable ip4 filtration, 0=> disable ip4 filtration
3162 @param ip6 - 1 => enable ip6 filtration, 0=> disable ip6 filtration
3163 @param default_cop - 1 => enable non-ip4, non-ip6 filtration 0=> disable it
3166 define cop_whitelist_enable_disable {
3176 /** \brief cop: interface enable/disable junk filtration reply
3177 @param context - returned sender context, to match reply w/ request
3178 @param retval - return code
3181 define cop_whitelist_enable_disable_reply {
3186 /** \brief get_node_graph - get a copy of the vpp node graph
3187 including the current set of graph arcs.
3189 @param client_index - opaque cookie to identify the sender
3190 @param context - sender context, to match reply w/ request
3193 define get_node_graph {
3198 /** \brief get_node_graph_reply
3199 @param context - returned sender context, to match reply w/ request
3200 @param retval - return code
3201 @param reply_in_shmem - result from vlib_node_serialize, in shared
3202 memory. Process with vlib_node_unserialize, remember to switch
3203 heaps and free the result.
3206 define get_node_graph_reply {
3212 /** \brief Clear interface statistics
3213 @param client_index - opaque cookie to identify the sender
3214 @param context - sender context, to match reply w/ request
3215 @param sw_if_index - index of the interface to clear statistics
3217 define sw_interface_clear_stats {
3223 /** \brief Reply to sw_interface_clear_stats
3224 @param context - sender context which was passed in the request
3225 @param retval - return code of the set flags request
3227 define sw_interface_clear_stats_reply {
3232 /** \brief IOAM Trace : Set TRACE profile
3233 @param id - profile id
3234 @param trace_type - Trace type
3235 @param trace_num_elt - Number of nodes in trace path
3236 @param trace_ppc - Trace PPC (none/encap/decap)
3237 @param trace_tsp - Trace timestamp precision (0-sec,1-ms,2-us,3-ns)
3238 @param trace_app_data - Trace application data, can be any 4 bytes
3239 @param pow_enable - Proof of Work enabled or not flag
3240 @param node_id - Id of this node
3242 define trace_profile_add {
3255 /** \brief Trace profile add / del response
3256 @param context - sender context, to match reply w/ request
3257 @param retval - return value for request
3259 define trace_profile_add_reply {
3264 /** \brief IOAM Trace enable trace profile for a flow
3265 @param id - id of the trace profile to be applied
3266 @param dest_ipv6 - Destination IPv6 address
3267 @param prefix_length - prefix mask
3268 @param vrf_id - VRF ID
3269 @param trace_op - Trace operation (add/mod/del)
3270 @param enable - apply/remove the trace profile for the flow
3272 define trace_profile_apply {
3283 /** \brief Trace profile apply response
3284 @param context - sender context, to match reply w/ request
3285 @param retval - return value for request
3287 define trace_profile_apply_reply {
3292 /** \brief Delete Trace Profile
3293 @param client_index - opaque cookie to identify the sender
3294 @param context - sender context, to match reply w/ request
3295 @param index - MAP Domain index
3297 define trace_profile_del {
3303 /** \brief Trace profile add / del response
3304 @param context - sender context, to match reply w/ request
3305 @param retval - return value for request
3307 define trace_profile_del_reply {