On 11/4/2026 3:34 PM, Stephen Hemminger wrote:
> On Tue,  3 Nov 2026 22:49:18 +0800
> Chengwen Feng <[email protected]> wrote:
> 
>> From: Chengwen Feng <[email protected]>
>>
>> The DPDK tree conflates CPU sockets with NUMA memory nodes: public
>> APIs, structure fields and macros are named after "socket" although
>> they actually identify a NUMA node (e.g. rte_socket_id(), the
>> socket_id field of rte_memzone, SOCKET_ID_ANY). This naming misleads
>> application developers and pollutes vendor code that targets NUMA
>> topologies.
>>
>> This series renames the terminology tree-wide:
>>
>> Foundation (EAL):
>> - New NUMA-aware functions are added: rte_numa_id(),
>>   rte_numa_count(), rte_numa_id_by_idx(), rte_lcore_to_numa_id(),
>>   rte_malloc_heap_numa_is_external(), and friends.
>> - SOCKET_ID_ANY becomes RTE_NUMA_ID_ANY; SOCKET_ID_ANY is kept as a
>>   deprecated macro alias.
>> - The socket_id fields of the public structures are renamed to
>>   numa_id, keeping socket_id as a deprecated union alias (so field
>>   offsets, and therefore ABI layout, are unchanged). Affected
>>   structures include rte_memzone, rte_memseg, rte_memseg_list,
>>   rte_mempool, rte_hash_parameters, rte_graph, rte_service_spec,
>>   rte_acl_param, rte_gro_param, rte_ipsec_sad_conf, rte_member_*,
>>   rte_bbdev_*, rte_cryptodev_config, rte_compressdev_config,
>>   rte_event_*, rte_ml_dev_config, rte_rawdev* -- see
>>   doc/guides/rel_notes/deprecation.rst for the full list.
>>
>> Libraries:
>> - Library-specific APIs follow the same pattern: ethdev, cryptodev,
>>   compressdev, rawdev, mldev, bbdev and eventdev gain NUMA-named
>>   device APIs (e.g. rte_event_dev_numa_id()) with the socket
>>   variants kept as deprecated aliases.
>>
>> Drivers, applications, examples and documentation:
>> - One commit per unit; in-tree users are updated in the same commit
>>   as the unit they belong to, moving from libs to drivers and then
>>   to app/examples.
>> - The programming guides and API docs are updated to the new names.
>>
>> Compatibility notes:
>> - The deprecated aliases preserve source compatibility for external
>>   applications for one release; they will be removed in a future
>>   release, as recorded in deprecation.rst.
>> - No ABI break: the deprecated union alias keeps the layout
>>   identical.
>> - Device arguments and command-line options that literally use the
>>   "socket" name (e.g. --socket-mem, --socket-limit, the
>>   socket_id= parameter of the bbdev/compressdev vdevs) are
>>   intentionally NOT renamed to avoid breaking user scripts; their
>>   documentation still describes the existing parameter names.
>>   Feedback on whether/how to migrate these user-facing names is
>>   welcome.
>>
>> This series is based on v26.11-rc2 and developped by AI.
>>

...

>>  lib/vhost/rte_vhost_crypto.h                  |   4 +-
>>  lib/vhost/vhost.c                             |   4 +-
>>  lib/vhost/vhost_crypto.c                      |  16 +-
>>  lib/vhost/vhost_user.c                        |  22 +-
>>  905 files changed, 6113 insertions(+), 5439 deletions(-)
>>
> 
> Maybe a single coccinelle script would help here? Rather than trying to look
> at so many patches.

A coccinelle script is a helpful idea. I will try to prepare one.




Reply via email to