1. DPDK Release 24.11

1.1. New Features

  • Added new bit manipulation API.

    The support for bit-level operations on single 32- and 64-bit words in <rte_bitops.h> has been extended with semantically well-defined functions.

    • rte_bit_[test|set|clear|assign|flip] functions provide excellent performance (by avoiding restricting the compiler and CPU), but give no guarantees in regards to memory ordering or atomicity.

    • rte_bit_atomic_* provide atomic bit-level operations, including the possibility to specify memory ordering constraints.

    The new public API elements are polymorphic, using the _Generic-based macros (for C) and function overloading (in C++ translation units).

  • Added multi-word bitset API.

    A new multi-word bitset API has been introduced in the EAL. The RTE bitset is optimized for scenarios where the bitset size exceeds the capacity of a single word (e.g., larger than 64 bits), but is not large enough to justify the overhead and complexity of the more scalable, yet slower, <rte_bitmap.h> API. This addition provides an efficient and straightforward alternative for handling bitsets of intermediate sizes.

  • Added per-lcore static memory allocation facility.

    Added EAL API <rte_lcore_var.h> for statically allocating small, frequently-accessed data structures, for which one instance should exist for each EAL thread and registered non-EAL thread.

    With lcore variables, data is organized spatially on a per-lcore id basis, rather than per library or PMD, avoiding the need for cache aligning (or RTE_CACHE_GUARDing) data structures, which in turn reduces CPU cache internal fragmentation, improving performance.

    Lcore variables are similar to thread-local storage (TLS, e.g. C11 _Thread_local), but decoupling the values’ life time from that of the threads.

  • Extended service cores statistics.

    Two new per-service counters are added to the service cores framework.

    • RTE_SERVICE_ATTR_IDLE_CALL_COUNT tracks the number of service function invocations where no actual work was performed.

    • RTE_SERVICE_ATTR_ERROR_CALL_COUNT tracks the number invocations resulting in an error.

    The new statistics are useful for debugging and profiling.

  • Hardened rte_malloc and related functions.

    Added function attributes to rte_malloc and similar functions that can catch some obvious bugs at compile time (with GCC 11.0 or later). Examples: calling free on pointer that was allocated with rte_malloc (and vice versa); freeing the same pointer twice in the same routine; freeing an object that was not created by allocation; etc.

  • Updated logging library

    • The log subsystem is initialized earlier in startup so all messages go through the library.

    • If the application is a systemd service and the log output is being sent to standard error then DPDK will switch to journal native protocol. This allows the more data such as severity to be sent.

    • The syslog option has changed. By default, messages are no longer sent to syslog unless the --syslog option is specified. Syslog is also supported on FreeBSD (but not on Windows).

    • Log messages can be timestamped with --log-timestamp option.

    • Log messages can be colorized with the --log-color option.

  • Updated Marvell cnxk mempool driver.

    • Added mempool driver support for CN20K SoC.

  • Added more ICMP message types and codes.

    New ICMP message types and codes from RFC 792 were added in rte_icmp.h.

  • Added IPv6 address structure and related utilities.

    A new IPv6 address structure is now available in rte_ip6.h. It comes with a set of helper functions and macros.

  • Added link speed lanes API.

    Added functions to query or force the link lanes configuration.

  • Added Ethernet device clock frequency adjustment.

    Added the function rte_eth_timesync_adjust_freq to adjust the clock frequency for Ethernet devices.

  • Extended flow table index features.

    • Extended the flow table insertion type enum with RTE_FLOW_TABLE_INSERTION_TYPE_INDEX_WITH_PATTERN type.

    • Added a function for inserting a flow rule by index with pattern: rte_flow_async_create_by_index_with_pattern().

    • Added a flow action to redirect packets to a particular index in a flow table: RTE_FLOW_ACTION_TYPE_JUMP_TO_TABLE_INDEX.

  • Added support for dumping registers with names and filtering by modules.

    Added a new function rte_eth_dev_get_reg_info_ext() to filter the registers by module names and get the information (names, values and other attributes) of the filtered registers.

  • Updated Amazon ENA (Elastic Network Adapter) net driver.

    • Modified the PMD API that controls the LLQ header policy.

    • Replaced enable_llq, normal_llq_hdr and large_llq_hdr devargs with a new shared devarg llq_policy that keeps the same logic.

    • Added validation check for Rx packet descriptor consistency.

  • Updated Cisco enic driver.

    • Added SR-IOV VF support.

    • Added recent 1400/14000 and 15000 models to the supported list.

  • Updated Marvell cnxk net driver.

    • Added ethdev driver support for CN20K SoC.

  • Updated Napatech ntnic net driver [EXPERIMENTAL].

    • Updated supported version of the FPGA to 9563.55.49.

    • Extended and fixed logging.

    • Added NT flow filter initialization.

    • Added NT flow backend initialization.

    • Added initialization of FPGA modules related to flow HW offload.

    • Added basic handling of the virtual queues.

    • Added flow handling support.

    • Added statistics support.

    • Added age flow action support.

    • Added meter flow metering and flow policy support.

    • Added flow actions update support.

    • Added asynchronous flow support.

    • Added MTU update support.

  • Updated NVIDIA mlx5 net driver.

    • Added rte_flow_async_create_by_index_with_pattern() support.

    • Added jump to flow table index support.

  • Added ZTE zxdh net driver [EXPERIMENTAL].

    Added ethdev driver support for zxdh NX Series Ethernet Controller.

    • Ability to initialize the NIC.

    • No datapath support.

  • Added cryptodev queue pair reset support.

    A new API rte_cryptodev_queue_pair_reset is added to reset a particular queue pair of a device.

  • Added cryptodev asymmetric EdDSA support.

    Added asymmetric EdDSA as referenced in RFC 8032.

  • Added cryptodev SM4-XTS support.

    Added symmetric cipher algorithm ShangMi 4 (SM4) in XTS mode.

  • Updated IPsec_MB crypto driver.

    • Added support for SM3 algorithm.

    • Added support for SM3 HMAC algorithm.

    • Added support for SM4 CBC, SM4 ECB and SM4 CTR algorithms.

    • Bumped the minimum version requirement of Intel IPsec Multi-buffer library to v1.4. Affected PMDs: KASUMI, SNOW3G, ZUC, AESNI GCM, AESNI MB and CHACHAPOLY.

  • Updated openssl crypto driver.

    • Added support for asymmetric crypto EdDSA algorithm.

  • Updated Marvell cnxk crypto driver.

    • Added support for asymmetric crypto EdDSA algorithm.

  • Added stateless IPsec processing.

    New functions were added to enable providing sequence number to be used for the IPsec operation.

  • Added strict priority capability for dmadev.

    Added new capability flag RTE_DMA_CAPA_PRI_POLICY_SP to check if the DMA device supports assigning fixed priority, allowing for better control over resource allocation and scheduling.

  • Updated Marvell cnxk DMA driver.

    • Added support for DMA queue priority configuration.

  • Added Marvell cnxk RVU LF rawdev driver.

    Added a new raw device driver for Marvell cnxk based devices to allow out-of-tree driver to manage RVU LF device. It enables operations such as sending/receiving mailbox, register and notify the interrupts, etc.

  • Added event device pre-scheduling support.

    Added support for pre-scheduling of events to event ports to improve scheduling performance and latency.

    • Added rte_event_dev_config::preschedule_type to configure the device level pre-scheduling type.

    • Added rte_event_port_preschedule_modify to modify pre-scheduling type on a given event port.

    • Added rte_event_port_preschedule to allow applications provide explicit pre-schedule hints to event ports.

  • Updated event device library for independent enqueue feature.

    Added support for independent enqueue feature. With this feature eventdev supports enqueue in any order or specifically in a different order than dequeue. The feature is intended for eventdevs supporting burst mode. Applications should use RTE_EVENT_PORT_CFG_INDEPENDENT_ENQ to enable the feature if the capability RTE_EVENT_DEV_CAP_INDEPENDENT_ENQ exists.

  • Updated DLB2 event driver.

    • Added independent enqueue feature.

  • Updated DSW event driver.

    • Added independent enqueue feature.

  • Updated Marvell cnxk event device driver.

    • Added eventdev driver support for CN20K SoC.

  • Added IPv4 network order lookup in the FIB library.

    A new flag field is introduced in rte_fib_conf structure. This field is used to pass an extra configuration settings such as ability to lookup IPv4 addresses in network byte order.

  • Added RSS hash key generating API.

    A new function rte_thash_gen_key is provided to modify the RSS hash key to achieve better traffic distribution with RSS.

  • Added per-CPU power management QoS interface.

    Added per-CPU PM QoS interface to lower the resume latency when wake up from idle state.

  • Added new API to register telemetry endpoint callbacks with private arguments.

    A new rte_telemetry_register_cmd_arg function is available to pass an opaque value to telemetry endpoint callback.

  • Added node specific statistics.

    Added ability for node to advertise and update multiple xstat counters, that can be retrieved using rte_graph_cluster_stats_get.

1.2. Removed Items

  • ethdev: Removed the __rte_ethdev_trace_rx_burst symbol, as the corresponding tracepoint was split into two separate ones for empty and non-empty calls.

1.3. API Changes

  • kvargs: reworked the process API.

    • The already existing rte_kvargs_process now only handles key=value cases and rejects if only a key is present in the parsed string.

    • rte_kvargs_process_opt has been added to behave as rte_kvargs_process in previous releases: it handles key=value and only-key cases.

    • Both rte_kvargs_process and rte_kvargs_process_opt reject a NULL kvlist parameter.

  • net: The IPv4 header structure rte_ipv4_hdr has been marked as two bytes aligned.

  • net: The ICMP message types RTE_IP_ICMP_ECHO_REPLY and RTE_IP_ICMP_ECHO_REQUEST are marked as deprecated, and are replaced by RTE_ICMP_TYPE_ECHO_REPLY and RTE_ICMP_TYPE_ECHO_REQUEST.

  • net: The IPv6 header structure rte_ipv6_hdr and extension structures rte_ipv6_routing_ext and rte_ipv6_fragment_ext have been marked as two bytes aligned.

  • net: A new IPv6 address structure was introduced to replace ad-hoc uint8_t[16] arrays. The following libraries and symbols were modified:

    cmdline

    • cmdline_ipaddr_t

    ethdev

    • struct rte_flow_action_set_ipv6

    • struct rte_flow_item_icmp6_nd_na

    • struct rte_flow_item_icmp6_nd_ns

    • struct rte_flow_tunnel

    fib

    • rte_fib6_add()

    • rte_fib6_delete()

    • rte_fib6_lookup_bulk()

    • RTE_FIB6_IPV6_ADDR_SIZE (deprecated, replaced with RTE_IPV6_ADDR_SIZE)

    • RTE_FIB6_MAXDEPTH (deprecated, replaced with RTE_IPV6_MAX_DEPTH)

    hash

    • struct rte_ipv6_tuple

    ipsec

    • struct rte_ipsec_sadv6_key

    lpm

    • rte_lpm6_add()

    • rte_lpm6_delete()

    • rte_lpm6_delete_bulk_func()

    • rte_lpm6_is_rule_present()

    • rte_lpm6_lookup()

    • rte_lpm6_lookup_bulk_func()

    • RTE_LPM6_IPV6_ADDR_SIZE (deprecated, replaced with RTE_IPV6_ADDR_SIZE)

    • RTE_LPM6_MAX_DEPTH (deprecated, replaced with RTE_IPV6_MAX_DEPTH)

    net

    • struct rte_ipv6_hdr

    node

    • rte_node_ip6_route_add()

    pipeline

    • struct rte_swx_ipsec_sa_encap_params

    • struct rte_table_action_ipv6_header

    • struct rte_table_action_nat_params

    security

    • struct rte_security_ipsec_tunnel_param

    table

    • struct rte_table_lpm_ipv6_key

    • RTE_LPM_IPV6_ADDR_SIZE (deprecated, replaced with RTE_IPV6_ADDR_SIZE)

    rib

    • rte_rib6_get_ip()

    • rte_rib6_get_nxt()

    • rte_rib6_insert()

    • rte_rib6_lookup()

    • rte_rib6_lookup_exact()

    • rte_rib6_remove()

    • RTE_RIB6_IPV6_ADDR_SIZE (deprecated, replaced with RTE_IPV6_ADDR_SIZE)

    • get_msk_part() (deprecated)

    • rte_rib6_copy_addr() (deprecated, replaced with direct structure assignments)

    • rte_rib6_is_equal() (deprecated, replaced with rte_ipv6_addr_eq())

  • drivers/net/ena: Removed enable_llq, normal_llq_hdr and large_llq_hdr devargs and replaced it with a new shared devarg llq_policy that keeps the same logic.

1.4. ABI Changes

  • eal: The maximum number of file descriptors that can be passed to a secondary process has been increased from 8 to 253 (which is the maximum possible with Unix domain socket). This allows for more queues when using software devices such as TAP and XDP.

  • ethdev: Added filter and names fields to rte_dev_reg_info structure for filtering by modules and reporting names of registers.

  • cryptodev: The queue pair configuration structure rte_cryptodev_qp_conf is updated to have a new parameter to set priority of that particular queue pair.

  • cryptodev: The list end enumerators RTE_CRYPTO_ASYM_XFORM_TYPE_LIST_END and RTE_CRYPTO_RSA_PADDING_TYPE_LIST_END are removed to allow subsequent addition of new asymmetric algorithms and RSA padding types.

  • cryptodev: The enum rte_crypto_asym_xform_type and struct rte_crypto_asym_op are updated to include new values to support EdDSA.

  • cryptodev: The rte_crypto_rsa_xform struct member to hold private key in either exponent or quintuple format is changed from union to struct data type. This change is to support ASN.1 syntax (RFC 3447 Appendix A.1.2).

  • cryptodev: The padding struct rte_crypto_rsa_padding is moved from rte_crypto_rsa_op_param to rte_crypto_rsa_xform as the padding information is part of session creation instead of per packet crypto operation. This change is required to support virtio-crypto specifications.

  • bbdev: The structure rte_bbdev_stats was updated to add a new parameter to optionally report the number of enqueue batch available enqueue_depth_avail.

  • dmadev: Added nb_priorities field to rte_dma_info structure and priority field to rte_dma_conf structure to get device supported priority levels and configure required priority from the application.

  • eventdev: Added preschedule_type field to rte_event_dev_config structure.

  • eventdev: Removed the single-event enqueue and dequeue function pointers from rte_event_fp_fps.

  • graph: To accommodate node specific xstats counters, added xstat_cntrs, xstat_desc and xstat_count to rte_graph_cluster_node_stats, added new structure rte_node_xstats to rte_node_register and added xstat_off to rte_node.

1.5. Known Issues

1.6. Tested Platforms