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
VNET
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
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
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