DPDK Release 22.11

新功能

添加了初始LoongArch架构支持。

添加了对 LoongArch 架构的 EAL 实现。在 Loongson 3A5000, Loongson 3C5000 和 Loongson 3C5000L 上测试初始端口。理论上，这个EAL实现可以在任何基于LoongArch ISA的目标上工作。

添加了对每个 ethdev Rx 队列的多个 mbuf 池的支持。

新添加的功能允许应用程序提供许多不同大小的内存池，提供PMD和/或NIC，以根据数据包的长度和/或Rx缓冲区可用性来选择内存池。

添加了对ethdev阻塞管理的支持。

添加了新的API函数 rte_eth_cman_config_init(), rte_eth_cman_config_get(), rte_eth_cman_config_set() 和 rte_eth_cman_info_get()，以支持阻塞管理。

添加了基于协议头的缓冲区分割。

添加了 rte_eth_buffer_split_get_supported_hdr_ptypes() 来获取支持做头部分割的协议。

使用 rte_eth_rxseg_split结构体中的新字段 proto_hdr ，对基于协议的缓冲区分割添加了支持。

为ethdev添加了主动的错误处理模式。

为 ethdev 添加了主动的错误处理模式，并引入了三个新事件：引入RTE_ETH_EVENT_ERR_RECOVERING 来报告端口正在从错误中恢复，以及RTE_ETH_EVENT_RECOVER_SUCCESS 和 RTE_ETH_EVENT_RECOVER_FAILED。

添加了ethdev Rx/Tx描述符转储API。

添加了ethdev Rx/Tx描述符转储API，提供从设备查询描述符的功能。描述符信息在不同的网卡中是不同的。这些信息体现了I/O过程，对调试很重要。转储格式是厂商特定的。

添加了ethdev hairpin内存配置选项。

为hairpin队列在rte_eth_hairpin_conf添加了新的配置标志：

use_locked_device_memory

use_rte_memory

force_memory

每个标志在 rte_eth_hairpin_queue_cap 结构体中都有一个相应的功能标志。

为预配置流提示添加了严格队列。

为 rte_flow_configure 和 rte_flow_info_get 添加了标志选项。

添加了 RTE_FLOW_PORT_FLAG_STRICT_QUEUE 标志，以表明特定流规则的所有操作将严格在同一个流量队列发生。

添加了异步流连接跟踪的配置。

为 rte_flow_configure 和 rte_flow_info_get 添加了连接跟踪操作编号提示。PMD可以根据该提示准备连接跟踪资源。

在流API中对基于队列的异步查询添加支持。

添加了新函数 rte_flow_async_action_handle_query()，用于异步查询操作。

扩展了流API的计量和标记支持。

添加了METER_COLOR项，以匹配meter设置的颜色标记。

添加了通过修改字段流API来设置颜色标记的能力。

添加了meter API，通过其ID获取指向配置文件/策略的指针。

添加了METER_MARK操作，用于测量无锁配置文件/策略的访问。

添加了支持到路由数据包及内核的流卸载操作。

添加了新的流操作，允许应用程序直接向内核重新分配数据包，而无需软件参与。

更新了 AF_XDP 驱动程序。

更新了 AF_XDP 驱动程序，使其与 libbpf v0.8.0 兼容（当与 libxdp 一起使用时）。

更新了 AMD Pensando ionic 驱动程序。

添加了对底板介质类型的支持。

更新了ionic驱动程序，以反映Pensando已被AMD收购的情况。

增强了数据路径以提供实质性能改进。

添加了对 mbuf快速释放的支持。

添加了对广告数据包类型的支持。

添加了对描述符状态功能的支持。

添加了由设备选项ionic_cmb控制的Q-in-CMB功能。

添加了对非分散型Rx和Tx的优化处理程序。

添加了GVE PMD。

为谷歌虚拟以太网设备添加了新的gve驱动程序。

有关这个新驱动程序的更多细节信息，请参见GVE轮询模式驱动网卡指南(http://doc.dpdk.org/guides/nics/gve.html)。

更新了英特尔iavf驱动程序。

添加了流订阅支持。

更新了英特尔ice驱动程序。

在标量路径中添加了基于协议的缓冲区分割支持。

添加了Intel idpf驱动程序。

为英特尔® Infrastructure Processing Unit（Intel® IPU）E2100添加了新的IDPF网络驱动程序。有关这个新驱动程序的更多细节信息，请参阅IDPF轮询模式驱动网卡指南(http://doc.dpdk.org/guides/nics/idpf.html)。

更新了Marvell cnxk驱动程序。

添加了对流操作 REPRESENTED_PORT 的支持。

添加了对阻塞管理的支持。

添加了Microsoft mana驱动程序。

由于目前缺少依赖关系，该驱动程序已被默认禁用。

更新了Netronome nfp驱动程序。

添加了流API支持：

添加了对flower固件的支持。

添加了flower服务的基础设施。

添加了PMD和固件之间的控制消息交互通道。

添加了对代表者(representor)端口的支持。

更新了NVIDIA mlx5驱动程序。

为基于队列的异步硬件转向加速添加了全面支持。

支持FDB。

支持控制流和隔离模式。

支持conntrack。

支持计数器。

支持老化。

支持仪表计量。

支持修改字段。

更新了NXP dpaa2驱动程序。

添加了对流操作 REPRESENTED_PORT 的支持。

更新了Wangxun ngbe驱动程序。

添加了对设置设备链接down/up的支持。

为异步vhost添加了DMA vChannel的取消配置。

为不再被vhost库使用的DMA vChannel添加取消配置支持。

为vhost库添加了非阻塞的通知API。

添加了 rte_vhost_vring_call_nonblock API，以通知客户已使用的描述符已以non-blocking方式添加到vring中。用户应该检查这个API的返回值，如果需要的话再试一次。

在 rte_security 中添加了对 MACsec 的支持。

为rte_security会话添加了MACsec转换，并添加了新的API来配置安全关联（SA）和安全通道（SC）。

为cryptodev添加了新的算法。

添加了对称哈希算法ShangMi 3（SM3）。

添加了ECB、CBC和CTR模式下的对称密码算法ShangMi 4（SM4）。

更新了Intel QuickAssist Technology (QAT)加密驱动程序

添加了对SM3哈希算法的支持。

添加了对ECB、CBC和CTR模式下SM4加密算法的支持。

添加了对ECDH密钥交换算法的支持。

更新了Marvell cnxk加密驱动程序。

为CN9K和CN10K的lookaside协议（IPsec）添加了AES-CCM支持。

为CN9K的lookaside加密添加了AES和DES DOCSIS算法支持。

更新了aesni_mb加密驱动程序。

为ZUC-EIA3-256的8字节和16字节标签添加了支持。

为in-place SGL, out-of-place SGL in SGL out, out-of-place LB in SGL out,以及out-of-place SGL in LB out添加了支持。

更新了ipsec_mb加密驱动程序。

添加了对ARM平台的SNOW-3G和ZUC支持。

为x86平台添加了Intel IPsec MB v1.3库支持。

添加了UADK加密驱动程序。

为UADK库添加了一个新的加密驱动程序。有关这个新驱动的更多细节信息，请查阅UADK Crypto轮询模式驱动指南(http://doc.dpdk.org/guides/cryptodevs/uadk.html)。

为FFT处理添加了bbdev操作。

在bbdev中添加了一个新的操作类型，用于FFT处理，包括新的函数rt_bbdev_enqueue_fft_ops和rt_bbdev_dequeue_fft_ops及相关结构体。

添加了Intel ACC200 bbdev驱动程序。

为集成在SPR-EE上的英特尔® ACC200加速器添加了新的acc200 bbdev驱动程序。有关该新驱动的更多信息，请参阅英特尔® ACC200 vRAN专用加速器轮询模式驱动程序指南(http://doc.dpdk.org/guides/bbdevs/acc200.html)。

添加了eventdev适配器实例获取API。

添加了 rte_event_eth_rx_adapter_instance_get 来获取指定以太网设备ID的Rx适配器实例ID和Rx队列索引。

添加了 rte_event_eth_tx_adapter_instance_get 来获取指定以太网设备ID的Tx适配器实例ID和Tx队列索引。

添加了eventdev Tx适配器队列启动/停止API。

添加了 rte_event_eth_tx_adapter_queue_start 以启动由Tx适配器向Tx队列排队的数据包。

添加了 rte_event_eth_tx_adapter_queue_stop 来停止Tx适配器向Tx队列排队的任何数据包。

添加了对事件加密适配器矢量化的支持。

支持将事件加密适配器处理的加密操作汇总到单个事件中，包含事件类型为RTE_EVENT_TYPE_CRYPTODEV_VECTOR的rte_event_vector。

在会员库中添加了NitroSketch。

在会员库中添加了一个新的数据结构，称为sketch，以有效描述流量。NitroSketch提供了高保真的近似测量，是传统方法（如数据包抽样）的积极替代方案。

在电源库中添加了英特尔uncore频率控制API。

添加了允许调整非核心频率的API。通过操作相关的非核心频率控制sysfs条目来调整最小和最大的非核心频率值，该功能只适用于Intel硬件的Linux。

添加了安全性能测试应用程序。

添加了新的应用程序，以测试 rte_security 会话创建/销毁的性能。更多细节请参见安全性能工具(http://doc.dpdk.org/guides/tools/securityperf.html)。

更新了 IPsec 示例应用程序。

为事件模式下lookaside会话添加了支持。更多细节请参见IPsec安全网关示例应用程序(http://doc.dpdk.org/guides/sample_app_ug/ipsec_secgw.html)。

更新了FIPS验证的样本应用。

添加了对非对称加密算法的支持。更多细节请参见联邦信息处理标准（FIPS）CryptoDev验证(http://doc.dpdk.org/guides/sample_app_ug/fips_validation.html)。

重写pmdinfo脚本。

重写了 dpdk-pmdinfo.py 脚本，只生成有效的 JSON。PCI-ID的解析已经被移除。为了获得类似于-r/--raw标志（现在已经移除）的输出，可以使用以下命令：

strings $dpdk_binary_or_driver | sed -n 's/^PMD_INFO_STRING= //p'

已移除的项目

mem:

移除了未实现和已废弃的 rte_malloc_set_limit。

ethdev：

移除了RTE_FLOW_ITEM_TYPE_PF；使用 RTE_FLOW_ITEM_TYPE_REPRESENTED_PORT来代替。

ethdev：

移除了RTE_FLOW_ITEM_TYPE_VF；使用 RTE_FLOW_ITEM_TYPE_REPRESENTED_PORT 来代替。

ethdev：

移除了RTE_FLOW_ITEM_TYPE_PHY_PORT；使用 RTE_FLOW_ITEM_TYPE_REPRESENTED_PORT 来代替。

ethdev：

移除了RTE_FLOW_ACTION_TYPE_PHY_PORT；使用 RTE_FLOW_ACTION_TYPE_REPRESENTED_PORT 来代替。

ethdev:

移除了 OF_SET_MPLS_TTL, OF_DEC_MPLS_TTL, OF_SET_NW_TTL, OF_COPY_TTL_OUT 以及 OF_COPY_TTL_IN, 因为它们实际上不被任何 PMD 支持。应该通过流API使用MODIFY_FIELD操作，以进行数据包编辑。

vhost:

移除了弃用的 rte_vhost_gpa_to_vva 和 rte_vhost_get_queue_num 帮助程序。

API 变更

eal:

RTE_FUNC_PTR_OR_* 宏已被标记为废弃，将来会被移除。应用程序可以使用devtools/cocci/func_or_ret.cocci来更新其代码。

eal:

更新了 rte_eal_remote_launch，使其在管道上出现读写错误时返回 -EPIPE，而不是调用 rte_panic。

eal:

更新了 rte_{bsf,fls} inline函数的返回类型，使其统一为 uint32_t。

mempool:

移除了废弃的辅助宏 MEMPOOL_HEADER_SIZE() 。替代的宏RTE_MEMPOOL_HEADER_SIZE()只在内部使用。

mempool:

用于注册 mempool 驱动程序的废弃宏 MEMPOOL_REGISTER_OPS() 已经被移除。请使用替代宏RTE_MEMPOOL_REGISTER_OPS()来代替。

mempool:

移除了已经废弃的宏 MEMPOOL_PG_NUM_DEFAULT 和 MEMPOOL_PG_SHIFT_MAX。这些宏不再使用，也不再需要了。

mbuf:

移除了废弃的PKT_*标志。使用带有 RTE_MBUF_F_ 前缀的相应标志来代替。应用程序可以使用 devtools/cocci/prefix_mbuf_offload_flags.cocci 来替换 C 代码中所有出现的旧 mbuf 标志。

bus:

当NUMA信息不可用时，将设备numa节点改为-1。dev->device.numa_node字段由每个总线驱动程序为其管理的每个设备设置，以表明该设备位于哪个NUMA节点上。若这一信息未知，分配的值在各总线驱动程序之间不一致。这也同样影响了rte_eth_dev_socket_id()。

bus:

注册总线已经被标记为一个内部API。外部用户仍然可以使用bus_driver.h驱动头来注册他们的总线（参见enable_driver_sdk meson选项）。rte_bus对象现在是不透明的，必须通过添加的访问器进行操作。

drivers:

在auxiliary, ifpga, pci, vdev, vmbus总线上注册驱动程序已经被标记为一个内部API。外部用户仍然可以使用相关的驱动程序头来注册他们的驱动程序（参见 enable_driver_sdk meson 选项）。rte_driver和rte_device对象现在是不透明的，必须通过添加的访问器来操作。

ethdev:

移除了已废弃的宏。应用程序可以使用devtools/cocci/namespace_ethdev.cocci来更新其代码。

移除了已废弃的ETH_LINK_SPEED_*, ETH_SPEED_NUM_*和ETH_LINK_*（双工相关）定义。使用相应带有RTE_前缀的定义来代替。
移除了已废弃的 ETH_MQ_RX_* 和 ETH_MQ_TX_* 定义。使用相应的带有RTE_前缀的定义来代替。
移除了已废弃的ETH_RSS_*定义，本用于哈希函数和RETA大小规范。使用相应带有RTE_前缀的定义来代替。
移除了已废弃的 DEV_RX_OFFLOAD_* 和 DEV_TX_OFFLOAD_ 定义。使用相应具有RTE_ETH_RX_OFFLOAD_和RTE_ETH_TX_OFFLOAD_前缀的定义来代替。
移除了已废弃的 ETH_DCB_*, ETH_VMDQ_, ETH_*_TCS, ETH_*_POOLS 和 ETH_MAX_VMDQ_POOL 定义。使用相应带有RTE_前缀的定义来代替。
移除了已废弃的 RTE_TUNNEL_* 定义。使用相应带有RTE_ETH_TUNNEL_前缀的定义来代替。
移除了已废弃的 RTE_FC_* 定义。使用相应带有RTE_ETH_FC_前缀的定义来代替。
移除了已废弃的 ETH_VLAN_* 和 ETH_QINQ_ 定义。使用相应带有 RTE_ 前缀的定义来代替。
移除了已废弃的 ETH_NUM_RECEIVE_MAC_ADDR 定义。使用相应带有RTE_前缀的定义来代替。
移除了已废弃的 PKT_{R,T}X_DYNF_METADATA 定义。使用相应的定义 RTE_MBUF_DYNFLAG_{R,T}X_METADATA来代替。

ethdev：

从设备配置（dev_conf.fdir_conf）中移除了废弃的Flow Director配置。将相应的结构体移至内部API，因为一些驱动程序仍然在内部使用它。

ethdev：

从用于配置头分割的结构体 rte_eth_rxmode 中移除 Rx 卸载标志 RTE_ETH_RX_OFFLOAD_HEADER_SPLIT 和字段 split_hdr_size。相反，用户仍然可以使用RTE_ETH_RX_OFFLOAD_BUFFER_SPLIT来进行每个队列的数据包分割卸载，由rt_eth_rxseg_split配置。

ethdev:

rte_eth_rxseg_split结构体中的reserved字段被替换为proto_hdr以支持基于协议头的缓冲区分割。用户可以根据NIC的能力，选择长度或协议头来配置缓冲区分割。

ethdev：

将函数 rte_eth_set_queue_rate_limit() 的参数 rate 的类型从 uint16_t 改为 uint32_t，以支持超64 Gbps。改变了函数 rte_pmd_bnxt_set_vf_rate_limit() 和 rte_pmd_ixgbe_set_vf_rate_limit() 的参数 tx_rate 类型，以保持一致性。

ethdev:

将 rte_eth_rx_metadata_negotiate() 从实验版提升到稳定版。

ethdev：

将以下流基元从实验版提升到稳定版。

RTE_FLOW_ACTION_TYPE_PORT_REPRESENTOR

RTE_FLOW_ACTION_TYPE_REPRESENTED_PORT

RTE_FLOW_ITEM_TYPE_PORT_REPRESENTOR

RTE_FLOW_ITEM_TYPE_REPRESENTED_PORT

ethdev:

将 rte_flow_pick_transfer_proxy() 从实验版提升到稳定版。

ethdev:

禁止在 "transfer "流中使用ingress/egress属性，这是始于DPDK 21.11的弃用过程的最后一步。参见项目 PORT_REPRESENTOR, REPRESENTED_PORT。

vhost:

将 rte_vhost_vring_stats_get(), rte_vhost_vring_stats_get_names() 和 rte_vhost_vring_stats_reset() 从实验版提升到稳定版。

cryptodev:

rte_cryptodev_sym_session 已成为内部结构体。移除了 API rte_cryptodev_sym_session_init 和 rte_cryptodev_sym_session_clear，用户只需要调用 rte_cryptodev_sym_session_create 和 rte_cryptodev_sym_session_free 来创建/销毁会话。更新了 rte_cryptodev_sym_session_create API，以获取一个元素大小足以容纳会话数据和会话私有数据的单一 mempool。所有示例程序都已更新，以便在排队时将会话的不透明指针附加到 rte_crypto_op 上。

security:

rte_security_session 已成为内部结构体，更新了相应的函数，以接收/返回不透明会话指针。更新了API rte_security_session_create，只获取一个有足够空间容纳会话和驱动私有数据的mempool。

security:

添加了对MACsec的支持，从而更新了rt_security_macsec_xform、rt_security_macsec_stats结构体和安全能力结构体rt_security_capability，以适应MACsec功能。

security:

实验性的 API rte_security_get_userdata 不再被大多数驱动程序使用，它从 mbuf 动态字段中获取用户数据。现在该 API 被移除，应用程序可以直接从 mbuf 动态字段中获取用户数据。

eventdev：

将rte_event_crypto_adapter_queue_pair_add 函数更新为接受 rte_event_crypto_adapter_queue_conf 类型的配置，而不是 rte_event，类似于 rte_event_eth_rx_adapter_queue_add 签名。事件将是配置字段之一，同时还有额外的向量参数。

eventdev:

将函数指针定义 eventdev_stop_flush_t 改名为 rte_eventdev_stop_flush_t ，避免与应用程序符号冲突。

eventdev:

rte_event_dev_xstats_names_get, rte_event_dev_xstats_get, rte_event_dev_xstats_by_name_get 和 rte_event_dev_xstats_reset函数中ID参数的数据类型从unsigned int和uint32_t改为uint64_t。

metrics:

更新了 rte_metrics_init，使其返回一个错误代码，而不是调用 rte_exit。

telemetry:

目前，字典值的名称中允许的字符被限制为字母数字字符和一小部分额外的可打印字符。这将确保所有的字典参数名都可以在JSON中输出而不需要转义--或者在未来使用的任何输出格式中都如此。遥测命令的名称现在也有类似的限制。遥测命令的参数不受这种变化的影响。

raw/ifgpa：

移除了函数 rte_pmd_ifpga_get_pci_bus。

ABI变更

eal:

将 EAL 线程名称从 lcore-worker-更新为 rte-worker-，以便 DPDK 能够容纳高于 99 的 lcores。

mbuf:

用下一个字段替换了buf_iova字段，如果RTE_IOVA_AS_PA为0，则在其第二条缓存线的位置添加了一个新字段dynfield2。

ethdev:

枚举RTE_FLOW_ITEM受到弃用程序的影响。

枚举RTE_FLOW_ACTION受到弃用程序的影响。

ethdev:

枚举 RTE_BBDEV_OP_TYPE_COUNT 受到影响，以移除 RTE_BBDEV_OP_TYPE_COUNT，并且为了允许未来的枚举插入，添加了填充的 RTE_BBDEV_OP_TYPE_SIZE_MAX 宏。

bbdev:

更新了 rte_bbdev_driver_info 结构体，以添加队列拓扑结构的新参数，使用 rte_bbdev_device_status 的设备状态。

bbdev:

更新了结构体 rte_bbdev_queue_data，以添加使用 rte_bbdev_enqueue_status 的enqueue状态的新参数。

eventdev:

在 rte_event_timer_adapter_stats 结构体中添加了 evtim_drop_count 字段。

eventdev:

在 rte_event_queue_conf 结构体中添加了 weight 和 affinity 字段。

eventdev:

rte_event_vector结构体中的*u64s字段被替换为u64s，因为该字段应该持有一个uint64_t值的数组。

eventdev：

更新了结构体rte_event_vector ，以包括新的位域 elem_offset:12。这些位取自位域rsvd:15。

测试平台

Intel® platforms with Intel® NICs combinations

CPU

Intel® Atom™ CPU C3758 @ 2.20GHz

Intel® Xeon® CPU D-1553N @ 2.30GHz

Intel® Xeon® CPU E5-2680 v2 @ 2.80GHz

Intel® Xeon® CPU E5-2699 v3 @ 2.30GHz

Intel® Xeon® CPU E5-2699 v4 @ 2.20GHz

Intel® Xeon® D-2796NT CPU @ 2.00GHz

Intel® Xeon® Gold 6139 CPU @ 2.30GHz

Intel® Xeon® Gold 6140M CPU @ 2.30GHz

Intel® Xeon® Gold 6252N CPU @ 2.30GHz

Intel® Xeon® Gold 6348 CPU @ 2.60GHz

Intel® Xeon® Platinum 8180M CPU @ 2.50GHz

Intel® Xeon® Platinum 8280M CPU @ 2.70GHz

Intel® Xeon® Platinum 8380 CPU @ 2.30GHz

OS:

Fedora 36

FreeBSD 13.1

Red Hat Enterprise Linux Server release 8.6

Red Hat Enterprise Linux Server release 9

CentOS 7.9

Ubuntu 20.04.5

Ubuntu 22.04.1

Ubuntu 22.10

SUSE Linux Enterprise Server 15 SP4

NICs:

Intel® Ethernet Controller E810-C for SFP (4x25G)

Firmware version: 4.10 0x800151d8 1.3310.0

Device id (pf/vf): 8086:1593 / 8086:1889

Driver version(out-tree): 1.10.6 (ice)

Driver version(in-tree): 5.15.0-46-generic / 4.18.0-372.9.1.rt7.166.el8.x86_64 (ice)

OS Default DDP: 1.3.30.0

COMMS DDP: 1.3.37.0

Wireless Edge DDP: 1.3.10.0

Intel® Ethernet Controller E810-C for QSFP (2x100G)

Firmware version: 4.10 0x8001518e 1.3310.0

Device id (pf/vf): 8086:1592 / 8086:1889

Driver version: 1.10.6 (ice)

OS Default DDP: 1.3.30.0

COMMS DDP: 1.3.37.0

Wireless Edge DDP: 1.3.10.0

Intel® Ethernet Controller E810-XXV for SFP (2x25G)

Firmware version: 4.10 0x80015188 1.3310.0

Device id (pf/vf): 8086:159b / 8086:1889

Driver version: 1.10.6 (ice)

OS Default DDP: 1.3.30.0

COMMS DDP: 1.3.37.0

Intel® 82599ES 10 Gigabit Ethernet Controller

Firmware version: 0x61bf0001

Device id (pf/vf): 8086:10fb / 8086:10ed

Driver version(out-tree): 5.16.5 (ixgbe)

Driver version(in-tree): 5.15.0-46-generic (ixgbe)

Intel® Ethernet Converged Network Adapter X710-DA4 (4x10G)

Firmware version: 9.00 0x8000cead 1.3179.0

Device id (pf/vf): 8086:1572 / 8086:154c

Driver version(out-tree): 2.20.12 (i40e)