From 0e0384cde97a71acc0313a0904ed340730a87817 Mon Sep 17 00:00:00 2001 From: Andrew Yourtchenko Date: Thu, 23 Sep 2021 20:37:06 +0200 Subject: misc: 21.10 Release Notes Change-Id: I7aa0708d54156166f2dcdc8359e2450a3c4bf9af Type: docs Signed-off-by: Andrew Yourtchenko --- RELEASE.md | 474 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 473 insertions(+), 1 deletion(-) diff --git a/RELEASE.md b/RELEASE.md index 49046050e0c..5828a9d1bff 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -35,7 +35,479 @@ @page release_notes_2110 Release notes for VPP 21.10 -TBD +More than 358 commits since the previous release, including 187 fixes. + +## Features + +- Infrastructure Library + - Add array mask func ([0ec7dad7a](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=0ec7dad7a)) + - Add abstract socket & netns fns ([4cef6de59](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=4cef6de59)) + - Move format\_table from perfmon ([0e6584014](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=0e6584014)) +- Plugins + - DPDK + - Bump to 21.05 ([9303b1089](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=9303b1089)) + - Bump to 21.08 ([8990f095a](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=8990f095a)) + - Bufmon + - Add buffer monitoring plugin ([e09a2337b](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=e09a2337b)) + - Performance counter + - Adding support for papi TMAM ([c3cb2075d](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=c3cb2075d)) + - Snort plugin + - Snort3 plugin and DAQ ([839b1473e](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=839b1473e)) + - Vmxnet3 device driver + - Support manual thread assignment to tx queue ([a57a7005d](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=a57a7005d)) +- Python binding for the VPP API + - Remove shared memory transport ([041372b79](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=041372b79)) +- VNET + - - IP6 Neighbor Discovery + - Add ip6-nd proxy ([cebb47733](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=cebb47733)) + - FIB + - A 16-8-8 and a 8-8-8-8 versions of an ip4\_fib\_t ([d6953332d](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=d6953332d)) + - Compiile time option to use 8-8-8-8 stride tries for FIB rather than 16-8-8-8 ([a70b015ce](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=a70b015ce)) + - FLOW + - Add esp spi rss type ([da6520b4e](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=da6520b4e)) + - Hash + - Add support for hashing infra ([41b23bc95](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=41b23bc95)) + - IPv4 LPM + - Allow the 'ip6 enable' on tunnel interface types ([dfef64b4c](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=dfef64b4c)) + - Source address selection ([8034a36a9](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=8034a36a9)) + - Punt redirect add nh in api ([2a1783fd6](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=2a1783fd6)) + - Show ip table CLI ([14b472e37](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=14b472e37)) + - Interface Common + - Add custom interface name support ([f49734d3b](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=f49734d3b)) + - Packet Generator + - A Tunnel mode variant of a pg interface ([6197cb730](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=6197cb730)) + - Segment Routing (IPv6 and MPLS) + - Extend the srv6 sid list structure ([ad8b82d83](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=ad8b82d83)) + - Session Layer + - Optimize ct fifo segment allocations ([da78c5abc](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=da78c5abc)) + - Support abstract sockets for app ns ([7cb471a02](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=7cb471a02)) + - Add sock\_name option to add\_ns ([1a9e2f96d](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=1a9e2f96d)) + - UDP + - Add udp decapsulation ([8a6f5d394](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=8a6f5d394)) +- VPP Comms Library + - Basic support for epoll level-triggered evts ([fe286f7d1](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=fe286f7d1)) + +## Known issues + +For the full list of issues please refer to fd.io [JIRA](https://jira.fd.io). + +## Fixed issues + +For the full list of fixed issues please refer to: +- fd.io [JIRA](https://jira.fd.io) +- git [commit log](https://git.fd.io/vpp/log/?h=stable/2110) + + +## API changes + +Description of results: + +* _Definition changed_: indicates that the API file was modified between releases. +* _Only in image_: indicates the API is new for this release. +* _Only in file_: indicates the API has been removed in this release. + +Message Name | Result +-------------------------------------------------------------|------------------ +acl_plugin_use_hash_lookup_get | only in image +acl_plugin_use_hash_lookup_get_reply | only in image +acl_plugin_use_hash_lookup_set | only in image +acl_plugin_use_hash_lookup_set_reply | only in image +add_del_ip_punt_redirect_v2 | only in image +add_del_ip_punt_redirect_v2_reply | only in image +app_namespace_add_del_v2 | only in image +app_namespace_add_del_v2_reply | only in image +app_namespace_add_del_v3 | only in image +app_namespace_add_del_v3_reply | only in image +ip6nd_proxy_enable_disable | only in image +ip6nd_proxy_enable_disable_reply | only in image +ip_punt_redirect_v2_details | only in image +ip_punt_redirect_v2_dump | only in image +ipsec_sad_entry_add | only in image +ipsec_sad_entry_add_reply | only in image +ipsec_sad_entry_del | only in image +ipsec_sad_entry_del_reply | only in image +pg_create_interface_v2 | only in image +pg_create_interface_v2_reply | only in image +sw_interface_set_interface_name | only in image +sw_interface_set_interface_name_reply | only in image +udp_decap_add_del | only in image +udp_decap_add_del_reply | only in image + +Found 24 api message signature differences + + +### Newly deprecated API messages + +These messages are still there in the API, but can and probably +will disappear in the next release. + +- app_namespace_add_del +- app_namespace_add_del_reply +- ip_punt_redirect +- ip_punt_redirect_reply + +### In-progress API messages + +These messages are provided for testing and experimentation only. +They are *not* subject to any compatibility process, +and therefore can arbitrarily change or disappear at *any* moment. +Also they may have less than satisfactory testing, making +them unsuitable for other use than the technology preview. +If you are intending to use these messages in production projects, +please collaborate with the feature maintainer on their productization. + +- abf_itf_attach_add_del +- abf_itf_attach_add_del_reply +- abf_itf_attach_details +- abf_itf_attach_dump +- abf_plugin_get_version +- abf_plugin_get_version_reply +- abf_policy_add_del +- abf_policy_add_del_reply +- abf_policy_details +- abf_policy_dump +- acl_plugin_use_hash_lookup_get +- acl_plugin_use_hash_lookup_get_reply +- acl_plugin_use_hash_lookup_set +- acl_plugin_use_hash_lookup_set_reply +- adl_allowlist_enable_disable +- adl_allowlist_enable_disable_reply +- adl_interface_enable_disable +- adl_interface_enable_disable_reply +- af_xdp_create +- af_xdp_create_reply +- af_xdp_delete +- af_xdp_delete_reply +- cnat_get_snat_addresses +- cnat_get_snat_addresses_reply +- cnat_session_details +- cnat_session_dump +- cnat_session_purge +- cnat_session_purge_reply +- cnat_set_snat_addresses +- cnat_set_snat_addresses_reply +- cnat_set_snat_policy +- cnat_set_snat_policy_reply +- cnat_snat_policy_add_del_exclude_pfx +- cnat_snat_policy_add_del_exclude_pfx_reply +- cnat_snat_policy_add_del_if +- cnat_snat_policy_add_del_if_reply +- cnat_translation_del +- cnat_translation_del_reply +- cnat_translation_details +- cnat_translation_dump +- cnat_translation_update +- cnat_translation_update_reply +- crypto_sw_scheduler_set_worker +- crypto_sw_scheduler_set_worker_reply +- det44_get_timeouts_reply +- det44_interface_add_del_feature +- det44_interface_add_del_feature_reply +- det44_interface_details +- det44_interface_dump +- det44_plugin_enable_disable +- det44_plugin_enable_disable_reply +- det44_set_timeouts +- det44_set_timeouts_reply +- flow_add +- flow_add_reply +- flow_del +- flow_del_reply +- flow_disable +- flow_disable_reply +- flow_enable +- flow_enable_reply +- gbp_bridge_domain_add +- gbp_bridge_domain_add_reply +- gbp_bridge_domain_del +- gbp_bridge_domain_del_reply +- gbp_bridge_domain_details +- gbp_bridge_domain_dump +- gbp_bridge_domain_dump_reply +- gbp_contract_add_del +- gbp_contract_add_del_reply +- gbp_contract_details +- gbp_contract_dump +- gbp_endpoint_add +- gbp_endpoint_add_reply +- gbp_endpoint_del +- gbp_endpoint_del_reply +- gbp_endpoint_details +- gbp_endpoint_dump +- gbp_endpoint_group_add +- gbp_endpoint_group_add_reply +- gbp_endpoint_group_del +- gbp_endpoint_group_del_reply +- gbp_endpoint_group_details +- gbp_endpoint_group_dump +- gbp_ext_itf_add_del +- gbp_ext_itf_add_del_reply +- gbp_ext_itf_details +- gbp_ext_itf_dump +- gbp_recirc_add_del +- gbp_recirc_add_del_reply +- gbp_recirc_details +- gbp_recirc_dump +- gbp_route_domain_add +- gbp_route_domain_add_reply +- gbp_route_domain_del +- gbp_route_domain_del_reply +- gbp_route_domain_details +- gbp_route_domain_dump +- gbp_route_domain_dump_reply +- gbp_subnet_add_del +- gbp_subnet_add_del_reply +- gbp_subnet_details +- gbp_subnet_dump +- gbp_vxlan_tunnel_add +- gbp_vxlan_tunnel_add_reply +- gbp_vxlan_tunnel_del +- gbp_vxlan_tunnel_del_reply +- gbp_vxlan_tunnel_details +- gbp_vxlan_tunnel_dump +- ikev2_child_sa_details +- ikev2_child_sa_dump +- ikev2_initiate_del_child_sa +- ikev2_initiate_del_child_sa_reply +- ikev2_initiate_del_ike_sa +- ikev2_initiate_del_ike_sa_reply +- ikev2_initiate_rekey_child_sa +- ikev2_initiate_rekey_child_sa_reply +- ikev2_initiate_sa_init +- ikev2_initiate_sa_init_reply +- ikev2_nonce_get +- ikev2_nonce_get_reply +- ikev2_profile_add_del +- ikev2_profile_add_del_reply +- ikev2_profile_details +- ikev2_profile_disable_natt +- ikev2_profile_disable_natt_reply +- ikev2_profile_dump +- ikev2_profile_set_auth +- ikev2_profile_set_auth_reply +- ikev2_profile_set_id +- ikev2_profile_set_id_reply +- ikev2_profile_set_ipsec_udp_port +- ikev2_profile_set_ipsec_udp_port_reply +- ikev2_profile_set_liveness +- ikev2_profile_set_liveness_reply +- ikev2_profile_set_ts +- ikev2_profile_set_ts_reply +- ikev2_profile_set_udp_encap +- ikev2_profile_set_udp_encap_reply +- ikev2_sa_details +- ikev2_sa_dump +- ikev2_set_esp_transforms +- ikev2_set_esp_transforms_reply +- ikev2_set_ike_transforms +- ikev2_set_ike_transforms_reply +- ikev2_set_local_key +- ikev2_set_local_key_reply +- ikev2_set_responder +- ikev2_set_responder_hostname +- ikev2_set_responder_hostname_reply +- ikev2_set_responder_reply +- ikev2_set_sa_lifetime +- ikev2_set_sa_lifetime_reply +- ikev2_set_tunnel_interface +- ikev2_set_tunnel_interface_reply +- ikev2_traffic_selector_details +- ikev2_traffic_selector_dump +- ip_route_add_del_v2 +- ip_route_add_del_v2_reply +- ip_route_lookup_v2 +- ip_route_lookup_v2_reply +- ip_route_v2_details +- ip_route_v2_dump +- l2_emulation +- l2_emulation_reply +- mdata_enable_disable +- mdata_enable_disable_reply +- nat44_add_del_static_mapping_v2 +- nat44_add_del_static_mapping_v2_reply +- nat44_ed_plugin_enable_disable +- nat44_ed_plugin_enable_disable_reply +- nat44_ed_set_fq_options +- nat44_ed_set_fq_options_reply +- nat44_ed_show_fq_options +- nat44_ed_show_fq_options_reply +- nat44_ei_add_del_address_range +- nat44_ei_add_del_address_range_reply +- nat44_ei_add_del_static_mapping +- nat44_ei_add_del_static_mapping_reply +- nat44_ei_address_details +- nat44_ei_address_dump +- nat44_ei_del_session +- nat44_ei_del_session_reply +- nat44_ei_del_user +- nat44_ei_del_user_reply +- nat44_ei_forwarding_enable_disable +- nat44_ei_forwarding_enable_disable_reply +- nat44_ei_ha_flush +- nat44_ei_ha_flush_reply +- nat44_ei_ha_resync +- nat44_ei_ha_resync_completed_event +- nat44_ei_ha_resync_reply +- nat44_ei_ha_set_failover +- nat44_ei_ha_set_failover_reply +- nat44_ei_ha_set_listener +- nat44_ei_ha_set_listener_reply +- nat44_ei_interface_add_del_feature +- nat44_ei_interface_add_del_feature_reply +- nat44_ei_interface_details +- nat44_ei_interface_dump +- nat44_ei_ipfix_enable_disable +- nat44_ei_ipfix_enable_disable_reply +- nat44_ei_plugin_enable_disable +- nat44_ei_plugin_enable_disable_reply +- nat44_ei_set_addr_and_port_alloc_alg +- nat44_ei_set_addr_and_port_alloc_alg_reply +- nat44_ei_set_fq_options +- nat44_ei_set_fq_options_reply +- nat44_ei_set_mss_clamping +- nat44_ei_set_mss_clamping_reply +- nat44_ei_set_timeouts +- nat44_ei_set_timeouts_reply +- nat44_ei_set_workers +- nat44_ei_set_workers_reply +- nat44_ei_show_fq_options +- nat44_ei_show_fq_options_reply +- nat44_ei_show_running_config +- nat44_ei_show_running_config_reply +- nat44_ei_static_mapping_details +- nat44_ei_static_mapping_dump +- nat44_ei_user_details +- nat44_ei_user_dump +- nat44_ei_user_session_details +- nat44_ei_user_session_dump +- nat44_ei_worker_details +- nat44_ei_worker_dump +- nat44_show_running_config +- nat44_show_running_config_reply +- nat64_plugin_enable_disable +- nat64_plugin_enable_disable_reply +- oddbuf_enable_disable +- oddbuf_enable_disable_reply +- pg_interface_enable_disable_coalesce +- pg_interface_enable_disable_coalesce_reply +- pnat_binding_add +- pnat_binding_add_reply +- pnat_binding_attach +- pnat_binding_attach_reply +- pnat_binding_del +- pnat_binding_del_reply +- pnat_binding_detach +- pnat_binding_detach_reply +- pnat_bindings_details +- pnat_bindings_get +- pnat_bindings_get_reply +- pnat_interfaces_details +- pnat_interfaces_get +- pnat_interfaces_get_reply +- sample_macswap_enable_disable +- sample_macswap_enable_disable_reply +- sr_policies_with_sl_index_details +- sr_policies_with_sl_index_dump +- sw_interface_set_vxlan_gbp_bypass +- sw_interface_set_vxlan_gbp_bypass_reply +- test_addresses +- test_addresses2 +- test_addresses2_reply +- test_addresses3 +- test_addresses3_reply +- test_addresses_reply +- test_empty +- test_empty_reply +- test_enum +- test_enum_reply +- test_interface +- test_interface_reply +- test_prefix +- test_prefix_reply +- test_string +- test_string2 +- test_string2_reply +- test_string_reply +- test_vla +- test_vla2 +- test_vla2_reply +- test_vla3 +- test_vla3_reply +- test_vla4 +- test_vla4_reply +- test_vla5 +- test_vla5_reply +- test_vla_reply +- trace_capture_packets +- trace_capture_packets_reply +- trace_clear_capture +- trace_clear_capture_reply +- trace_details +- trace_dump +- trace_dump_reply +- trace_set_filters +- trace_set_filters_reply +- vxlan_gbp_tunnel_add_del +- vxlan_gbp_tunnel_add_del_reply +- vxlan_gbp_tunnel_details +- vxlan_gbp_tunnel_dump +- wireguard_interface_create +- wireguard_interface_create_reply +- wireguard_interface_delete +- wireguard_interface_delete_reply +- wireguard_interface_details +- wireguard_interface_dump +- wireguard_peer_add +- wireguard_peer_add_reply +- wireguard_peer_remove +- wireguard_peer_remove_reply +- wireguard_peers_details +- wireguard_peers_dump + +### Patches that changed API definitions + +| @c src/vnet/session/session.api || +| ------- | ------- | +| [1a9e2f96d](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=1a9e2f96d) | session: Add sock_name option to add_ns | +| [7cb471a02](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=7cb471a02) | session vcl: support abstract sockets for app ns | + +| @c src/vnet/pg/pg.api || +| ------- | ------- | +| [6197cb730](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=6197cb730) | pg: A Tunnel mode variant of a pg interface | + +| @c src/vnet/ipsec/ipsec.api || +| ------- | ------- | +| [ff2e4138c](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=ff2e4138c) | ipsec: Split the SA add_del API into an separate add and del | + +| @c src/vnet/ipsec/ipsec_types.api || +| ------- | ------- | +| [53dd08c59](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=53dd08c59) | ipsec: Derive the TUNNEL_V6 flag from the configured address types | + +| @c src/vnet/ip6-nd/ip6_nd.api || +| ------- | ------- | +| [cebb47733](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=cebb47733) | ip6-nd: add ip6-nd proxy | + +| @c src/vnet/udp/udp.api || +| ------- | ------- | +| [8a6f5d394](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=8a6f5d394) | udp: add udp decapsulation | + +| @c src/vnet/interface.api || +| ------- | ------- | +| [f49734d3b](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=f49734d3b) | interface: add custom interface name support | + +| @c src/vnet/ip/ip.api || +| ------- | ------- | +| [2a1783fd6](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=2a1783fd6) | ip: punt redirect add nh in api | + +| @c src/plugins/acl/acl.api || +| ------- | ------- | +| [1d342b9c8](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=1d342b9c8) | acl: add API call for setting the toggle to select between linear and bihash-based lookups | + +| @c src/plugins/nat/nat44-ed/nat44_ed.api || +| ------- | ------- | +| [2ac5c11cd](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=2ac5c11cd) | nat: Revert "nat: nat44-ed add session timing out indicator in api" | +| [f059a3452](https://gerrit.fd.io/r/gitweb?p=vpp.git;a=commit;h=f059a3452) | nat: nat44-ed add session timing out indicator in api | + @page release_notes_2106 Release notes for VPP 21.06 -- cgit 1.2.3-korg