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:

$ 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:

$ make build VPP_EXTRA_CMAKE_ARGS=-DVPP_LIBVNET_HIDDEN_VISIBILITY=OFF

The implementation and migration tooling are tracked in:

Features

  • Marvell Octeon device driver

  • Plugins

    • AF_XDP driver

    • 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

    • 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

src/plugins/tracepath/tracepath.api

  • 47dcef757 tracepath: add api to dump trace paths

src/plugins/rdma/rdma.api

src/plugins/lb/lb.api

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

src/vnet/sfdp/sfdp.api

src/vnet/flow/flow.api

  • 629fe2764 flow: add flow template and async range infrastructure

  • 6d974b9aa flow: single-interface-per-flow model