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 /** \brief L2 interface vlan tag rewrite configure request
1804 @param client_index - opaque cookie to identify the sender
1805 @param context - sender context, to match reply w/ request
1806 @param sw_if_index - interface the operation is applied to
1807 @param vtr_op - Choose from l2_vtr_op_t enum values
1808 @param push_dot1q - first pushed flag dot1q id set, else dot1ad
1809 @param tag1 - Needed for any push or translate vtr op
1810 @param tag2 - Needed for any push 2 or translate x-2 vtr ops
1812 define l2_interface_vlan_tag_rewrite {
1817 u32 push_dot1q; // ethertype of first pushed tag is dot1q/dot1ad
1818 u32 tag1; // first pushed tag
1819 u32 tag2; // second pushed tag
1822 /** \brief L2 interface vlan tag rewrite response
1823 @param context - sender context, to match reply w/ request
1824 @param retval - return code for the request
1826 define l2_interface_vlan_tag_rewrite_reply {
1831 /** \brief vhost-user interface create request
1832 @param client_index - opaque cookie to identify the sender
1833 @param is_server - our side is socket server
1834 @param sock_filename - unix socket filename, used to speak with frontend
1835 @param use_custom_mac - enable or disable the use of the provided hardware address
1836 @param mac_address - hardware address to use if 'use_custom_mac' is set
1838 define create_vhost_user_if {
1842 u8 sock_filename[256];
1844 u32 custom_dev_instance;
1849 /** \brief vhost-user interface create response
1850 @param context - sender context, to match reply w/ request
1851 @param retval - return code for the request
1852 @param sw_if_index - interface the operation is applied to
1854 define create_vhost_user_if_reply {
1860 /** \brief vhost-user interface modify 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
1865 define modify_vhost_user_if {
1870 u8 sock_filename[256];
1872 u32 custom_dev_instance;
1875 /** \brief vhost-user interface modify response
1876 @param context - sender context, to match reply w/ request
1877 @param retval - return code for the request
1879 define modify_vhost_user_if_reply {
1884 /** \brief vhost-user interface delete request
1885 @param client_index - opaque cookie to identify the sender
1887 define delete_vhost_user_if {
1893 /** \brief vhost-user interface delete response
1894 @param context - sender context, to match reply w/ request
1895 @param retval - return code for the request
1897 define delete_vhost_user_if_reply {
1902 define create_subif {
1908 /* These fields map directly onto the subif template */
1912 u8 dot1ad; // 0 = dot1q, 1=dot1ad
1915 u8 outer_vlan_id_any;
1916 u8 inner_vlan_id_any;
1921 define create_subif_reply {
1927 /** \brief show version
1928 @param client_index - opaque cookie to identify the sender
1929 @param context - sender context, to match reply w/ request
1931 define show_version {
1936 /** \brief show version response
1937 @param context - sender context, to match reply w/ request
1938 @param retval - return code for the request
1939 @param program - name of the program (vpe)
1940 @param version - version of the program
1941 @param build_directory - root of the workspace where the program was built
1943 manual_java define show_version_reply {
1949 u8 build_directory[256];
1952 define nsh_gre_add_del_tunnel {
1959 u32 decap_next_index;
1960 u8 tlv_len_in_words;
1966 /* in network byte order */
1975 define nsh_gre_add_del_tunnel_reply {
1981 /** \brief Vhost-user interface details structure (fix this)
1982 @param sw_if_index - index of the interface
1983 @param interface_name - name of interface
1984 @param virtio_net_hdr_sz - net header size
1985 @param features - interface features
1986 @param is_server - vhost-user server socket
1987 @param sock_filename - socket filename
1988 @param num_regions - number of used memory regions
1990 manual_java define sw_interface_vhost_user_details {
1993 u8 interface_name[64];
1994 u32 virtio_net_hdr_sz;
1997 u8 sock_filename[256];
2003 define sw_interface_vhost_user_dump {
2008 manual_java define ip_address_details {
2015 manual_java define ip_address_dump {
2022 manual_java define ip_details {
2033 /** \brief l2 fib table entry structure
2034 @param bd_id - the l2 fib / bridge domain table id
2035 @param mac - the entry's mac address
2036 @param sw_if_index - index of the interface
2037 @param static_mac - the entry is statically configured.
2038 @param filter_mac - the entry is a mac filter entry.
2039 @param bvi_mac - the mac address is a bridge virtual interface
2041 manual_java define l2_fib_table_entry {
2051 /** \brief Dump l2 fib (aka bridge domain) table
2052 @param client_index - opaque cookie to identify the sender
2053 @param bd_id - the l2 fib / bridge domain table identifier
2055 manual_java define l2_fib_table_dump {
2061 define nsh_vxlan_gpe_add_del_tunnel {
2068 u32 decap_next_index;
2070 u8 tlv_len_in_words;
2076 /* in network byte order */
2085 define nsh_vxlan_gpe_add_del_tunnel_reply {
2091 define lisp_gpe_add_del_tunnel {
2098 u32 decap_next_index;
2104 /* in network byte order */
2108 define lisp_gpe_add_del_tunnel_reply {
2114 /** \brief add or delete locator_set
2115 @param client_index - opaque cookie to identify the sender
2116 @param context - sender context, to match reply w/ request
2117 @param is_add - add address if non-zero, else delete
2118 @param locator_set_name - locator name
2120 define lisp_add_del_locator_set {
2124 u8 locator_set_name[64];
2127 /** \brief Reply for locator_set add/del
2128 @param context - returned sender context, to match reply w/ request
2129 @param retval - return code
2131 define lisp_add_del_locator_set_reply {
2136 /** \brief add or delete locator for locator_set
2137 @param client_index - opaque cookie to identify the sender
2138 @param context - sender context, to match reply w/ request
2139 @param is_add - add address if non-zero, else delete
2140 @param locator_set_name - name of locator_set to add/del locator
2141 @param sw_if_index - index of the interface
2142 @param priority - priority of the lisp locator
2143 @param weight - weight of the lisp locator
2145 define lisp_add_del_locator {
2149 u8 locator_set_name[64];
2155 /** \brief Reply for locator add/del
2156 @param context - returned sender context, to match reply w/ request
2157 @param retval - return code
2159 define lisp_add_del_locator_reply {
2164 /** \brief add or delete lisp eid-table
2165 @param client_index - opaque cookie to identify the sender
2166 @param context - sender context, to match reply w/ request
2167 @param is_add - add address if non-zero, else delete
2168 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
2169 @param ip_address - array of address bytes
2170 @param prefix_len - prefix len
2171 @param locator_set_name - name of locator_set to add/del eid-table
2173 define lisp_add_del_local_eid {
2180 u8 locator_set_name[64];
2183 /** \brief Reply for local_eid add/del
2184 @param context - returned sender context, to match reply w/ request
2185 @param retval - return code
2187 define lisp_add_del_local_eid_reply {
2192 /** \brief add or delete lisp gpe maptunel
2193 @param client_index - opaque cookie to identify the sender
2194 @param context - sender context, to match reply w/ request
2195 @param is_add - add address if non-zero, else delete
2196 @param eid_is_ipv6 - if non-zero the address is ipv6, else ipv4
2197 @param eid_ip_address - array of address bytes
2198 @param eid_prefix_len - prefix len
2199 @param address_is_ipv6 - if non-zero the address is ipv6, else ipv4
2200 @param source_ip_address - array of address bytes
2201 @param destination_ip_address - array of address bytes
2203 define lisp_gpe_add_del_fwd_entry {
2208 u8 eid_ip_address[16];
2211 u8 source_ip_address[16];
2212 u8 destination_ip_address[16];
2215 /** \brief Reply for gpe_fwd_entry add/del
2216 @param context - returned sender context, to match reply w/ request
2217 @param retval - return code
2219 define lisp_gpe_add_del_fwd_entry_reply {
2224 /** \brief add or delete map-resolver
2225 @param client_index - opaque cookie to identify the sender
2226 @param context - sender context, to match reply w/ request
2227 @param is_add - add address if non-zero, else delete
2228 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
2229 @param ip_address - array of address bytes
2231 define lisp_add_del_map_resolver {
2239 /** \brief Reply for map_resolver add/del
2240 @param context - returned sender context, to match reply w/ request
2241 @param retval - return code
2243 define lisp_add_del_map_resolver_reply {
2248 /** \brief enable or disable lisp-gpe protocol
2249 @param client_index - opaque cookie to identify the sender
2250 @param context - sender context, to match reply w/ request
2251 @param is_en - enable protocol if non-zero, else disable
2253 define lisp_gpe_enable_disable {
2259 /** \brief Reply for gpe enable/disable
2260 @param context - returned sender context, to match reply w/ request
2261 @param retval - return code
2263 define lisp_gpe_enable_disable_reply {
2268 /** \brief add or delete gpe_iface
2269 @param client_index - opaque cookie to identify the sender
2270 @param context - sender context, to match reply w/ request
2271 @param is_add - add address if non-zero, else delete
2273 define lisp_gpe_add_del_iface {
2281 /** \brief Reply for gpe_iface add/del
2282 @param context - returned sender context, to match reply w/ request
2283 @param retval - return code
2285 define lisp_gpe_add_del_iface_reply {
2290 /** \brief LISP locator_set status
2291 @param locator_set_name - name of the locator_set
2292 @param sw_if_index - sw_if_index of the locator
2293 @param priority - locator priority
2294 @param weight - locator weight
2296 manual_java define lisp_locator_set_details {
2298 u8 locator_set_name[64];
2304 /** \brief Request for locator_set summary status
2305 @param client_index - opaque cookie to identify the sender
2306 @param context - sender context, to match reply w/ request
2308 define lisp_locator_set_dump {
2313 /** \brief LISP local eid table status
2314 @param locator_set_name - name of the locator_set
2315 @param eid_is_ipv6 - if non-zero the address is ipv6, else ipv4
2316 @param eid_ip_address - array of address bytes
2317 @param eid_prefix_len - prefix len
2319 manual_java define lisp_local_eid_table_details {
2321 u8 locator_set_name[64];
2323 u8 eid_ip_address[16];
2327 /** \brief Request for local eid table summary status
2328 @param client_index - opaque cookie to identify the sender
2329 @param context - sender context, to match reply w/ request
2331 define lisp_local_eid_table_dump {
2336 manual_java define lisp_gpe_tunnel_details {
2341 u8 destination_ip[16];
2353 /** \brief Request for gpe tunnel summary status
2354 @param client_index - opaque cookie to identify the sender
2355 @param context - sender context, to match reply w/ request
2357 define lisp_gpe_tunnel_dump {
2362 /** \brief LISP map resolver status
2363 @param locator_set_name - name of the locator_set
2364 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
2365 @param ip_address - array of address bytes
2367 manual_java define lisp_map_resolver_details {
2373 /** \brief Request for map resolver summary status
2374 @param client_index - opaque cookie to identify the sender
2375 @param context - sender context, to match reply w/ request
2377 define lisp_map_resolver_dump {
2382 /* Gross kludge, DGMS */
2383 define interface_name_renumber {
2387 u32 new_show_dev_instance;
2390 define interface_name_renumber_reply {
2395 /** \brief Register for ip4 arp resolution events
2396 @param client_index - opaque cookie to identify the sender
2397 @param context - sender context, to match reply w/ request
2398 @param enable_disable - 1 => register for events, 0 => cancel registration
2399 @param pid - sender's pid
2400 @param address - the exact ip4 address of interest
2402 define want_ip4_arp_events {
2410 /** \brief Reply for interface events registration
2411 @param context - returned sender context, to match reply w/ request
2412 @param retval - return code
2414 define want_ip4_arp_events_reply {
2419 /** \brief Tell client about an ip4 arp resolution event
2420 @param client_index - opaque cookie to identify the sender
2421 @param context - sender context, to match reply w/ request
2422 @param address - the exact ip4 address of interest
2423 @param pid - client pid registered to receive notification
2424 @param sw_if_index - interface which received ARP packet
2425 @param new_mac - the new mac address
2427 define ip4_arp_event {
2436 /** \brief L2 bridge domain add or delete request
2437 @param client_index - opaque cookie to identify the sender
2438 @param context - sender context, to match reply w/ request
2439 @param bd_id - the bridge domain to create
2440 @param flood - enable/disable bcast/mcast flooding in the bd
2441 @param uu_flood - enable/disable uknown unicast flood in the bd
2442 @param forward - enable/disable forwarding on all interfaces in the bd
2443 @param learn - enable/disable learning on all interfaces in the bd
2444 @param arp_term - enable/disable arp termination in the bd
2445 @param is_add - add or delete flag
2447 define bridge_domain_add_del {
2459 /** \brief L2 bridge domain add or delete response
2460 @param context - sender context, to match reply w/ request
2461 @param retval - return code for the set bridge flags request
2463 define bridge_domain_add_del_reply {
2468 /** \brief L2 bridge domain request operational state details
2469 @param client_index - opaque cookie to identify the sender
2470 @param context - sender context, to match reply w/ request
2471 @param bd_id - the bridge domain id desired or ~0 to request all bds
2473 manual_java define bridge_domain_dump {
2479 /** \brief L2 bridge domain operational state response
2480 @param bd_id - the bridge domain id
2481 @param flood - bcast/mcast flooding state on all interfaces in the bd
2482 @param uu_flood - uknown unicast flooding state on all interfaces in the bd
2483 @param forward - forwarding state on all interfaces in the bd
2484 @param learn - learning state on all interfaces in the bd
2485 @param arp_term - arp termination state on all interfaces in the bd
2486 @param n_sw_ifs - number of sw_if_index's in the domain
2488 manual_java define bridge_domain_details {
2496 u32 bvi_sw_if_index;
2500 /** \brief L2 bridge domain sw interface operational state response
2501 @param bd_id - the bridge domain id
2502 @param sw_if_index - sw_if_index in the domain
2503 @param shg - split horizon group for the interface
2505 manual_java define bridge_domain_sw_if_details {
2512 /** \brief DHCP Client config add / del request
2513 @param client_index - opaque cookie to identify the sender
2514 @param context - sender context, to match reply w/ request
2515 @param sw_if_index - index of the interface for DHCP client
2516 @param hostname - hostname
2517 @param is_add - add the config if non-zero, else delete
2518 @param want_dhcp_event - DHCP event sent to the sender
2519 via dhcp_compl_event API message if non-zero
2520 @param pid - sender's pid
2522 define dhcp_client_config {
2532 /** \brief DHCP Client config response
2533 @param context - sender context, to match reply w/ request
2534 @param retval - return code for the request
2536 define dhcp_client_config_reply {
2541 /** \brief Set/unset input ACL interface
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 - interface to set/unset input ACL
2545 @param ip4_table_index - ip4 classify table index (~0 for skip)
2546 @param ip6_table_index - ip6 classify table index (~0 for skip)
2547 @param l2_table_index - l2 classify table index (~0 for skip)
2548 @param is_add - Set input ACL if non-zero, else unset
2549 Note: User is recommeneded to use just one valid table_index per call.
2550 (ip4_table_index, ip6_table_index, or l2_table_index)
2552 define input_acl_set_interface {
2556 u32 ip4_table_index;
2557 u32 ip6_table_index;
2562 /** \brief Set/unset input ACL interface response
2563 @param context - sender context, to match reply w/ request
2564 @param retval - return code for the request
2566 define input_acl_set_interface_reply {
2571 /** \brief IPsec: Add/delete Security Policy Database
2572 @param client_index - opaque cookie to identify the sender
2573 @param context - sender context, to match reply w/ request
2574 @param is_add - add SPD if non-zero, else delete
2575 @param spd_id - SPD instance id (control plane allocated)
2578 define ipsec_spd_add_del {
2585 /** \brief Reply for IPsec: Add/delete Security Policy Database entry
2586 @param context - returned sender context, to match reply w/ request
2587 @param retval - return code
2590 define ipsec_spd_add_del_reply {
2595 /** \brief IPsec: Add/delete SPD from interface
2597 @param client_index - opaque cookie to identify the sender
2598 @param context - sender context, to match reply w/ request
2599 @param is_add - add security mode if non-zero, else delete
2600 @param sw_if_index - index of the interface
2601 @param spd_id - SPD instance id to use for lookups
2605 define ipsec_interface_add_del_spd {
2614 /** \brief Reply for IPsec: Add/delete SPD from interface
2615 @param context - returned sender context, to match reply w/ request
2616 @param retval - return code
2619 define ipsec_interface_add_del_spd_reply {
2624 /** \brief IPsec: Add/delete Security Policy Database entry
2626 See RFC 4301, 4.4.1.1 on how to match packet to selectors
2628 @param client_index - opaque cookie to identify the sender
2629 @param context - sender context, to match reply w/ request
2630 @param is_add - add SPD if non-zero, else delete
2631 @param spd_id - SPD instance id (control plane allocated)
2632 @param priority - priority of SPD entry (non-unique value). Used to order SPD matching - higher priorities match before lower
2633 @param is_outbound - entry applies to outbound traffic if non-zero, otherwise applies to inbound traffic
2634 @param is_ipv6 - remote/local address are IPv6 if non-zero, else IPv4
2635 @param remote_address_start - start of remote address range to match
2636 @param remote_address_stop - end of remote address range to match
2637 @param local_address_start - start of local address range to match
2638 @param local_address_stop - end of local address range to match
2639 @param protocol - protocol type to match [0 means any]
2640 @param remote_port_start - start of remote port range to match ...
2641 @param remote_port_stop - end of remote port range to match [0 to 65535 means ANY, 65535 to 0 means OPAQUE]
2642 @param local_port_start - start of local port range to match ...
2643 @param local_port_stop - end of remote port range to match [0 to 65535 means ANY, 65535 to 0 means OPAQUE]
2644 @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)
2645 @param sa_id - SAD instance id (control plane allocated)
2649 define ipsec_spd_add_del_entry {
2661 u8 remote_address_start[16];
2662 u8 remote_address_stop[16];
2663 u8 local_address_start[16];
2664 u8 local_address_stop[16];
2668 u16 remote_port_start;
2669 u16 remote_port_stop;
2670 u16 local_port_start;
2671 u16 local_port_stop;
2678 /** \brief Reply for IPsec: Add/delete Security Policy Database entry
2679 @param context - returned sender context, to match reply w/ request
2680 @param retval - return code
2683 define ipsec_spd_add_del_entry_reply {
2688 /** \brief IPsec: Add/delete Security Association Database entry
2689 @param client_index - opaque cookie to identify the sender
2690 @param context - sender context, to match reply w/ request
2691 @param is_add - add SAD entry if non-zero, else delete
2693 @param sad_id - sad id
2695 @param spi - security parameter index
2697 @param protocol - 0 = AH, 1 = ESP
2699 @param crypto_algorithm - 0 = Null, 1 = AES-CBC-128, 2 = AES-CBC-192, 3 = AES-CBC-256, 4 = 3DES-CBC
2700 @param crypto_key_length - length of crypto_key in bytes
2701 @param crypto_key - crypto keying material
2703 @param integrity_algorithm - 0 = None, 1 = MD5-96, 2 = SHA1-96, 3 = SHA-256, 4 = SHA-384, 5=SHA-512
2704 @param integrity_key_length - length of integrity_key in bytes
2705 @param integrity_key - integrity keying material
2707 @param use_extended_sequence_number - use ESN when non-zero
2709 @param is_tunnel - IPsec tunnel mode if non-zero, else transport mode
2710 @param is_tunnel_ipv6 - IPsec tunnel mode is IPv6 if non-zero, else IPv4 tunnel only valid if is_tunnel is non-zero
2711 @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
2712 @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
2716 IPsec tunnel address copy mode (to support GDOI)
2719 define ipsec_sad_add_del_entry {
2730 u8 crypto_algorithm;
2731 u8 crypto_key_length;
2734 u8 integrity_algorithm;
2735 u8 integrity_key_length;
2736 u8 integrity_key[128];
2738 u8 use_extended_sequence_number;
2742 u8 tunnel_src_address[16];
2743 u8 tunnel_dst_address[16];
2746 /** \brief Reply for IPsec: Add/delete Security Association Database entry
2747 @param context - returned sender context, to match reply w/ request
2748 @param retval - return code
2751 define ipsec_sad_add_del_entry_reply {
2756 /** \brief IPsec: Update Security Association keys
2757 @param client_index - opaque cookie to identify the sender
2758 @param context - sender context, to match reply w/ request
2760 @param sa_id - sa id
2762 @param crypto_key_length - length of crypto_key in bytes
2763 @param crypto_key - crypto keying material
2765 @param integrity_key_length - length of integrity_key in bytes
2766 @param integrity_key - integrity keying material
2769 define ipsec_sa_set_key {
2775 u8 crypto_key_length;
2778 u8 integrity_key_length;
2779 u8 integrity_key[128];
2782 /** \brief Reply for IPsec: Update Security Association keys
2783 @param context - returned sender context, to match reply w/ request
2784 @param retval - return code
2787 define ipsec_sa_set_key_reply {
2792 /** \brief IKEv2: Add/delete profile
2793 @param client_index - opaque cookie to identify the sender
2794 @param context - sender context, to match reply w/ request
2796 @param name - IKEv2 profile name
2797 @param is_add - Add IKEv2 profile if non-zero, else delete
2799 define ikev2_profile_add_del {
2807 /** \brief Reply for IKEv2: Add/delete profile
2808 @param context - returned sender context, to match reply w/ request
2809 @param retval - return code
2811 define ikev2_profile_add_del_reply {
2816 /** \brief IKEv2: Set IKEv2 profile authentication method
2817 @param client_index - opaque cookie to identify the sender
2818 @param context - sender context, to match reply w/ request
2820 @param name - IKEv2 profile name
2821 @param auth_method - IKEv2 authentication method (shared-key-mic/rsa-sig)
2822 @param is_hex - Authentication data in hex format if non-zero, else string
2823 @param data_len - Authentication data length
2824 @param data - Authentication data (for rsa-sig cert file path)
2826 define ikev2_profile_set_auth {
2837 /** \brief Reply for IKEv2: Set IKEv2 profile authentication method
2838 @param context - returned sender context, to match reply w/ request
2839 @param retval - return code
2841 define ikev2_profile_set_auth_reply {
2846 /** \brief IKEv2: Set IKEv2 profile local/remote identification
2847 @param client_index - opaque cookie to identify the sender
2848 @param context - sender context, to match reply w/ request
2850 @param name - IKEv2 profile name
2851 @param is_local - Identification is local if non-zero, else remote
2852 @param id_type - Identification type
2853 @param data_len - Identification data length
2854 @param data - Identification data
2856 define ikev2_profile_set_id {
2867 /** \brief Reply for IKEv2:
2868 @param context - returned sender context, to match reply w/ request
2869 @param retval - return code
2871 define ikev2_profile_set_id_reply {
2876 /** \brief IKEv2: Set IKEv2 profile traffic selector parameters
2877 @param client_index - opaque cookie to identify the sender
2878 @param context - sender context, to match reply w/ request
2880 @param name - IKEv2 profile name
2881 @param is_local - Traffic selector is local if non-zero, else remote
2882 @param proto - Traffic selector IP protocol (if zero not relevant)
2883 @param start_port - The smallest port number allowed by traffic selector
2884 @param end_port - The largest port number allowed by traffic selector
2885 @param start_addr - The smallest address included in traffic selector
2886 @param end_addr - The largest address included in traffic selector
2888 define ikev2_profile_set_ts {
2901 /** \brief Reply for IKEv2: Set IKEv2 profile traffic selector parameters
2902 @param context - returned sender context, to match reply w/ request
2903 @param retval - return code
2905 define ikev2_profile_set_ts_reply {
2910 /** \brief IKEv2: Set IKEv2 local RSA private key
2911 @param client_index - opaque cookie to identify the sender
2912 @param context - sender context, to match reply w/ request
2914 @param key_file - Key file absolute path
2916 define ikev2_set_local_key {
2923 /** \brief Reply for IKEv2: Set IKEv2 local key
2924 @param context - returned sender context, to match reply w/ request
2925 @param retval - return code
2927 define ikev2_set_local_key_reply {
2932 /** \brief Tell client about a DHCP completion event
2933 @param client_index - opaque cookie to identify the sender
2934 @param pid - client pid registered to receive notification
2935 @param is_ipv6 - if non-zero the address is ipv6, else ipv4
2936 @param host_address - Host IP address
2937 @param router_address - Router IP address
2938 @param host_mac - Host MAC address
2940 manual_java define dhcp_compl_event {
2945 u8 host_address[16];
2946 u8 router_address[16];
2950 /** \brief Add MAP domains
2951 @param client_index - opaque cookie to identify the sender
2952 @param context - sender context, to match reply w/ request
2953 @param ip6_prefix - Rule IPv6 prefix
2954 @param ip4_prefix - Rule IPv4 prefix
2955 @param ip6_src - MAP domain IPv6 BR address / Tunnel source
2956 @param ip6_prefix_len - Rule IPv6 prefix length
2957 @param ip4_prefix_len - Rule IPv4 prefix length
2958 @param ea_bits_len - Embedded Address bits length
2959 @param psid_offset - Port Set Identifider (PSID) offset
2960 @param psid_length - PSID length
2961 @param is_translation - MAP-E / MAP-T
2964 define map_add_domain {
2972 u8 ip6_src_prefix_len;
2980 /** \brief Reply for MAP domain add
2981 @param context - returned sender context, to match reply w/ request
2982 @param index - MAP domain index
2983 @param retval - return code
2985 define map_add_domain_reply {
2991 /** \brief Delete MAP domain
2992 @param client_index - opaque cookie to identify the sender
2993 @param context - sender context, to match reply w/ request
2994 @param index - MAP Domain index
2996 define map_del_domain {
3002 /** \brief Reply for MAP domain del
3003 @param context - returned sender context, to match reply w/ request
3004 @param retval - return code
3006 define map_del_domain_reply {
3011 /** \brief Add or Delete MAP rule from a domain (Only used for shared IPv4 per subscriber)
3012 @param client_index - opaque cookie to identify the sender
3013 @param context - sender context, to match reply w/ request
3014 @param index - MAP Domain index
3015 @param is_add - If 1 add rule, if 0 delete rule
3016 @param ip6_dst - MAP CE IPv6 address
3017 @param psid - Rule PSID
3019 define map_add_del_rule {
3028 /** \brief Reply for MAP rule add/del
3029 @param context - returned sender context, to match reply w/ request
3030 @param retval - return code
3032 define map_add_del_rule_reply {
3037 /** \brief Get list of map domains
3038 @param client_index - opaque cookie to identify the sender
3040 define map_domain_dump {
3045 manual_java define map_domain_details {
3062 define map_rule_dump {
3068 manual_java define map_rule_details {
3074 /** \brief Request for a single block of summary stats
3075 @param client_index - opaque cookie to identify the sender
3076 @param context - sender context, to match reply w/ request
3078 define map_summary_stats {
3083 /** \brief Reply for map_summary_stats request
3084 @param context - sender context, to match reply w/ request
3085 @param retval - return code for request
3086 @param total_bindings -
3088 @param total_ip4_fragments -
3089 @param total_security_check -
3091 define map_summary_stats_reply {
3097 u64 total_ip4_fragments;
3098 u64 total_security_check[2];
3101 /** \brief cop: enable/disable junk filtration features on an interface
3102 @param client_index - opaque cookie to identify the sender
3103 @param context - sender context, to match reply w/ request
3104 @param sw_if_inded - desired interface
3105 @param enable_disable - 1 => enable, 0 => disable
3108 define cop_interface_enable_disable {
3115 /** \brief cop: interface enable/disable junk filtration reply
3116 @param context - returned sender context, to match reply w/ request
3117 @param retval - return code
3120 define cop_interface_enable_disable_reply {
3125 /** \brief cop: enable/disable whitelist filtration features on an interface
3126 Note: the supplied fib_id must match in order to remove the feature!
3128 @param client_index - opaque cookie to identify the sender
3129 @param context - sender context, to match reply w/ request
3130 @param sw_if_index - interface handle, physical interfaces only
3131 @param fib_id - fib identifier for the whitelist / blacklist fib
3132 @param ip4 - 1 => enable ip4 filtration, 0=> disable ip4 filtration
3133 @param ip6 - 1 => enable ip6 filtration, 0=> disable ip6 filtration
3134 @param default_cop - 1 => enable non-ip4, non-ip6 filtration 0=> disable it
3137 define cop_whitelist_enable_disable {
3147 /** \brief cop: interface enable/disable junk filtration reply
3148 @param context - returned sender context, to match reply w/ request
3149 @param retval - return code
3152 define cop_whitelist_enable_disable_reply {
3157 /** \brief get_node_graph - get a copy of the vpp node graph
3158 including the current set of graph arcs.
3160 @param client_index - opaque cookie to identify the sender
3161 @param context - sender context, to match reply w/ request
3164 define get_node_graph {
3169 /** \brief get_node_graph_reply
3170 @param context - returned sender context, to match reply w/ request
3171 @param retval - return code
3172 @param reply_in_shmem - result from vlib_node_serialize, in shared
3173 memory. Process with vlib_node_unserialize, remember to switch
3174 heaps and free the result.
3177 define get_node_graph_reply {
3183 /** \brief Clear interface statistics
3184 @param client_index - opaque cookie to identify the sender
3185 @param context - sender context, to match reply w/ request
3186 @param sw_if_index - index of the interface to clear statistics
3188 define sw_interface_clear_stats {
3194 /** \brief Reply to sw_interface_clear_stats
3195 @param context - sender context which was passed in the request
3196 @param retval - return code of the set flags request
3198 define sw_interface_clear_stats_reply {
3203 /** \brief IOAM Trace : Set TRACE profile
3204 @param id - profile id
3205 @param trace_type - Trace type
3206 @param trace_num_elt - Number of nodes in trace path
3207 @param trace_ppc - Trace PPC (none/encap/decap)
3208 @param trace_tsp - Trace timestamp precision (0-sec,1-ms,2-us,3-ns)
3209 @param trace_app_data - Trace application data, can be any 4 bytes
3210 @param pow_enable - Proof of Work enabled or not flag
3211 @param node_id - Id of this node
3213 define trace_profile_add {
3226 /** \brief Trace profile add / del response
3227 @param context - sender context, to match reply w/ request
3228 @param retval - return value for request
3230 define trace_profile_add_reply {
3235 /** \brief IOAM Trace enable trace profile for a flow
3236 @param id - id of the trace profile to be applied
3237 @param dest_ipv6 - Destination IPv6 address
3238 @param prefix_length - prefix mask
3239 @param vrf_id - VRF ID
3240 @param trace_op - Trace operation (add/mod/del)
3241 @param enable - apply/remove the trace profile for the flow
3243 define trace_profile_apply {
3254 /** \brief Trace profile apply response
3255 @param context - sender context, to match reply w/ request
3256 @param retval - return value for request
3258 define trace_profile_apply_reply {
3263 /** \brief Delete Trace Profile
3264 @param client_index - opaque cookie to identify the sender
3265 @param context - sender context, to match reply w/ request
3266 @param index - MAP Domain index
3268 define trace_profile_del {
3274 /** \brief Trace profile add / del response
3275 @param context - sender context, to match reply w/ request
3276 @param retval - return value for request
3278 define trace_profile_del_reply {