Release notes for VPP 26.10 =========================== More than 556 commits since the previous release, including 228 fixes. Release Highlights: Upcoming libvnet Symbol Visibility Change ------------------------------------------------------------- Starting with VPP 27.02, libvnet will be built with hidden symbol visibility by default. This behavior is not enabled by default in VPP 26.10. With hidden visibility enabled, only libvnet symbols explicitly marked with ``__clib_export`` are available to other shared objects. Out-of-tree plugins and applications that link directly against libvnet should verify the symbols they require before moving to a later VPP release. Use the standalone checker with an unstripped libvnet binary from the VPP build tree and one or more external plugin binaries: .. code-block:: console $ vpp-check-libvnet-exports.sh \ /path/to/unstripped/libvnet.so \ /path/to/my_plugin.so If the checker reports a required symbol, either remove that dependency or mark the corresponding libvnet declaration with ``__clib_export`` when it is part of the intended interface. Please upstream justified export additions so other consumers benefit from the same interface. Builds can temporarily retain the legacy behavior, where all non-static libvnet symbols are exported, by disabling the option: .. code-block:: console $ make build VPP_EXTRA_CMAKE_ARGS=-DVPP_LIBVNET_HIDDEN_VISIBILITY=OFF The implementation and migration tooling are tracked in: * `External libvnet export checker `_ * `Hidden visibility with explicit exports `_ Features -------- - Marvell Octeon device driver - Implement hardware traffic management (`40d1f5cd7 `_) - Update octeon roc version (`12fd8e97f `_) - Add support to set link-speed (`2f6fc11c1 `_) - Plugins - AF\_XDP driver - Add support for multi-buffer (`345071c78 `_) - DHCP - Export DHCPv6 runtime state for PPPoE observability (`0a143dac6 `_) - DPDK - Add Intel QAT 420xx series support (`830331ea8 `_) - Bump to DPDK 26.07 and rdma-core 64.0 (`dd6c72f23 `_) - HSI - Basic support for session tracking (`ddaacff4e `_) - Http\_static - Support disabling the server via the API (`be0ece802 `_) - Retrieve status information (`0c2f7a88d `_) - VNET - Add set interface link speed API (`b83c7d9ec `_) - FLOW - Add flow template and async range infrastructure (`629fe2764 `_) - New Device Drivers Infra - Add port attribute for speed capability (`e1c793db4 `_) - TCP - Dsack receiver (RFC 2883) (`dd2e033f1 `_) - RACK loss detection (RFC 8985) (`8494103c1 `_) - Add tail loss probe (RFC 8985) (`a0807aade `_) - Add BBRv3 congestion control (`b7249de38 `_) - Traffic Management - Add 'mark\_flow' action for traffic management (`4b2416d79 `_) - Vector Library - Add per-thread index pool cache (`3381b9557 `_) Known issues ------------ For the full list of issues please refer to fd.io `GitHub `_. Fixed issues ------------ For the full list of fixed issues please refer to: - fd.io `GitHub `_ - git `commit log `_ 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 ============================================================= ================== af_xdp_create_v4 only in image af_xdp_create_v4_reply only in image flow_async_range_disable only in image flow_async_range_disable_reply only in image flow_async_range_enable only in image flow_async_range_enable_reply only in image flow_disable_v2 only in image flow_disable_v2_reply only in image flow_template_add only in image flow_template_add_reply only in image flow_template_del only in image flow_template_del_reply only in image flow_template_disable only in image flow_template_disable_reply only in image flow_template_enable only in image flow_template_enable_reply only in image http_static_disable only in image http_static_disable_reply only in image http_static_get only in image http_static_get_reply only in image lb_add_del_as_v2 only in image lb_add_del_as_v2_reply only in image lb_as_set_weight only in image lb_as_set_weight_reply only in image lb_as_v2_details only in image lb_as_v2_dump only in image lb_conf_get only in image lb_conf_get_reply only in image lldp_details definition changed rdma_create_v5 only in image rdma_create_v5_reply only in image sfdp_set_timeout definition changed sfdp_timeout_details only in image sfdp_timeout_dump only in image sw_interface_get_speed_capa only in image sw_interface_get_speed_capa_reply only in image sw_interface_set_link_speed only in image sw_interface_set_link_speed_reply only in image tracepath_details only in image tracepath_dump only in image ============================================================= ================== Found 40 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. - af_xdp_create_v3 - flow_disable - flow_disable_reply - rdma_create_v4 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 - bpf_trace_filter_set - bpf_trace_filter_set_reply - bpf_trace_filter_set_v2 - bpf_trace_filter_set_v2_reply - det44_get_timeouts_reply - det44_set_timeouts - det44_set_timeouts_reply - dev_attach - dev_attach_reply - dev_create_port_if - dev_create_port_if_reply - dev_detach - dev_detach_reply - dev_remove_port_if - dev_remove_port_if_reply - flowprobe_get_params - flowprobe_get_params_reply - flowprobe_interface_add_del - flowprobe_interface_add_del_reply - flowprobe_interface_details - flowprobe_interface_dump - flowprobe_set_params - flowprobe_set_params_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 - gtpu_add_del_forward - gtpu_add_del_forward_reply - gtpu_add_del_tunnel_v2 - gtpu_add_del_tunnel_v2_reply - gtpu_get_transfer_counts - gtpu_get_transfer_counts_reply - gtpu_tunnel_v2_details - gtpu_tunnel_v2_dump - ikev2_child_sa_v2_details - ikev2_child_sa_v2_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_v3_details - ikev2_sa_v3_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_neighbor_config_get - ip_neighbor_config_get_reply - 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 - ip_session_redirect_add - ip_session_redirect_add_reply - ip_session_redirect_add_v2 - ip_session_redirect_add_v2_reply - ip_session_redirect_del - ip_session_redirect_del_reply - ip_session_redirect_details - ip_session_redirect_dump - l2_emulation - l2_emulation_reply - lcp_default_ns_get_reply - lcp_default_ns_set - lcp_default_ns_set_reply - lcp_itf_pair_add_del_v2 - lcp_itf_pair_add_del_v2_reply - lcp_itf_pair_add_del_v3 - lcp_itf_pair_add_del_v3_reply - lcp_itf_pair_details - lldp_details - mdata_enable_disable - mdata_enable_disable_reply - nat44_ed_vrf_tables_v2_details - nat44_ed_vrf_tables_v2_dump - 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_user_session_v2_details - nat44_ei_user_session_v2_dump - nat44_ei_worker_details - nat44_ei_worker_dump - nat64_plugin_enable_disable - nat64_plugin_enable_disable_reply - npol_configure_policies - npol_configure_policies_reply - npol_get_version - npol_get_version_reply - npol_ipset_add_del_members - npol_ipset_add_del_members_reply - npol_ipset_create - npol_ipset_create_reply - npol_ipset_delete - npol_ipset_delete_reply - npol_policy_create - npol_policy_create_reply - npol_policy_delete - npol_policy_delete_reply - npol_policy_update - npol_policy_update_reply - npol_rule_create - npol_rule_create_reply - npol_rule_delete - npol_rule_delete_reply - npol_rule_update - npol_rule_update_reply - npt66_binding_add_del - npt66_binding_add_del_reply - oddbuf_enable_disable - oddbuf_enable_disable_reply - pg_interface_enable_disable_coalesce - pg_interface_enable_disable_coalesce_reply - ping_finished_event - pnat_binding_add - pnat_binding_add_reply - pnat_binding_add_v2 - pnat_binding_add_v2_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_flow_lookup - pnat_flow_lookup_reply - pnat_interfaces_details - pnat_interfaces_get - pnat_interfaces_get_reply - pvti_interface_create - pvti_interface_create_reply - pvti_interface_delete - pvti_interface_delete_reply - pvti_interface_details - pvti_interface_dump - sample_macswap_enable_disable - sample_macswap_enable_disable_reply - selog_event_type_details - selog_event_type_dump - selog_event_type_string_details - selog_event_type_string_dump - selog_get_shm - selog_get_shm_reply - selog_get_string_table - selog_get_string_table_reply - selog_track_details - selog_track_dump - set_ip_flow_hash_v3 - set_ip_flow_hash_v3_reply - sfdp_gateway_geneve_input_enable_disable - sfdp_gateway_geneve_input_enable_disable_reply - sfdp_gateway_set_geneve_output - sfdp_gateway_set_geneve_output_reply - sfdp_interface_input_set - sfdp_interface_input_set_reply - sfdp_nat_alloc_pool_add_del - sfdp_nat_alloc_pool_add_del_reply - sfdp_nat_set_external_interface - sfdp_nat_set_external_interface_reply - sfdp_nat_snat_set_unset - sfdp_nat_snat_set_unset_reply - sfdp_tcp_session_details - sfdp_tcp_session_dump - sflow_direction_get - sflow_direction_get_reply - sflow_direction_set - sflow_direction_set_reply - sflow_drop_monitoring_get - sflow_drop_monitoring_get_reply - sflow_drop_monitoring_set - sflow_drop_monitoring_set_reply - sflow_enable_disable - sflow_enable_disable_reply - sflow_header_bytes_get - sflow_header_bytes_get_reply - sflow_header_bytes_set - sflow_header_bytes_set_reply - sflow_interface_details - sflow_interface_dump - sflow_polling_interval_get - sflow_polling_interval_get_reply - sflow_polling_interval_set - sflow_polling_interval_set_reply - sflow_sampling_rate_get - sflow_sampling_rate_get_reply - sflow_sampling_rate_set - sflow_sampling_rate_set_reply - sr_localsid_add_del_v2 - sr_localsid_add_del_v2_reply - sr_localsids_with_packet_stats_details - sr_localsids_with_packet_stats_dump - sr_mobile_localsid_add_del - sr_mobile_localsid_add_del_reply - sr_mobile_policy_add - sr_mobile_policy_add_reply - sr_policies_with_sl_index_details - sr_policies_with_sl_index_dump - sr_policy_add_v2 - sr_policy_add_v2_reply - sr_policy_mod_v2 - sr_policy_mod_v2_reply - sw_interface_ip6nd_ra_details - sw_interface_ip6nd_ra_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 - tm_sys_get_capabilities - tm_sys_get_capabilities_reply - tm_sys_level_get_capabilities - tm_sys_level_get_capabilities_reply - tm_sys_node_add - tm_sys_node_add_reply - tm_sys_node_delete - tm_sys_node_delete_reply - tm_sys_node_read_stats - tm_sys_node_read_stats_reply - tm_sys_node_resume - tm_sys_node_resume_reply - tm_sys_node_sched_weight_update - tm_sys_node_sched_weight_update_reply - tm_sys_node_shaper_update - tm_sys_node_shaper_update_reply - tm_sys_node_suspend - tm_sys_node_suspend_reply - tm_sys_shaper_profile_create - tm_sys_shaper_profile_create_reply - tm_sys_shaper_profile_delete - tm_sys_shaper_profile_delete_reply - tm_sys_start_tm - tm_sys_start_tm_reply - tm_sys_stop_tm - tm_sys_stop_tm_reply - trace_capture_packets - trace_capture_packets_reply - trace_clear_cache - trace_clear_cache_reply - trace_clear_capture - trace_clear_capture_reply - trace_details - trace_dump - trace_dump_reply - trace_filter_function_details - trace_filter_function_dump - trace_set_filter_function - trace_set_filter_function_reply - trace_set_filters - trace_set_filters_reply - trace_v2_details - trace_v2_dump - tracenode_enable_disable - tracenode_enable_disable_reply - tracepath_details - tracepath_dump - vxlan_gbp_tunnel_add_del - vxlan_gbp_tunnel_add_del_reply - vxlan_gbp_tunnel_details - vxlan_gbp_tunnel_dump - want_ping_finished_events - want_ping_finished_events_reply - wireguard_peer_add_v2 - wireguard_peer_add_v2_reply - wireguard_peers_v2_details - wireguard_peers_v2_dump Patches that changed API definitions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``src/plugins/lldp/lldp.api`` * `47a8ae9c3 `_ lldp: extend data returned by lldp-dump API ``src/plugins/af_xdp/af_xdp.api`` * `cbcb2f5f2 `_ af_xdp: add optional socket busy polling * `345071c78 `_ af_xdp: add support for multi-buffer ``src/plugins/ipip/ipip.api`` * `11c5a0d6e `_ ipip: move to a plugin ``src/plugins/tracepath/tracepath.api`` * `47dcef757 `_ tracepath: add api to dump trace paths ``src/plugins/rdma/rdma.api`` * `f96a3d699 `_ rdma: fix verbs port selection ``src/plugins/lb/lb.api`` * `ca870e99f `_ lb: Allow setting weight on AS * `db44addb6 `_ lb: API bugfix ``src/plugins/http_static/http_static.api`` * `0c2f7a88d `_ http_static: retrieve status information * `be0ece802 `_ http_static: support disabling the server via the API ``src/vnet/classify/classify.api`` * `4b2416d79 `_ tm: add 'mark_flow' action for traffic management ``src/vnet/ipsec/ipsec.api`` * `4f9eb4ea0 `_ ipsec: remove esp_encrypt next node check * `8ffeb3667 `_ vlib crypto ipsec: preserve scalar frame metadata ``src/vnet/interface.api`` * `b83c7d9ec `_ vnet: add set interface link speed API ``src/vnet/sfdp/sfdp_types.api`` * `a80fce357 `_ sfdp: bump APIs to v1.0.0 * `c399babd5 `_ sfdp: improve generic timeout registration * `2c4994432 `_ sfdp: add api enum for timeouts ``src/vnet/sfdp/sfdp.api`` * `a80fce357 `_ sfdp: bump APIs to v1.0.0 * `c399babd5 `_ sfdp: improve generic timeout registration * `2c4994432 `_ sfdp: add api enum for timeouts ``src/vnet/flow/flow.api`` * `629fe2764 `_ flow: add flow template and async range infrastructure * `6d974b9aa `_ flow: single-interface-per-flow model