[PATCH v2 0/2] use NUMA node terminology
Chengwen Feng
chengwen.feng at linux.dev
Fri Nov 6 07:14:36 CET 2026
From: Chengwen Feng <fengchengwen at huawei.com>
This is a new version of the "use NUMA node terminology" series,
which converted the whole tree to the NUMA node terminology
(about 227 patches).
Following the review feedback, this version takes a staged
approach. This series only contains the groundwork, there is no
tree-wide replacement patch:
1/2 doc: deprecate socket terminology in favor of NUMA node
2/2 cocci: add script for NUMA node terminology renames
The deprecation notice announces the socket_id to numa_node field
renames of the public structures and the deprecation of the
socket-named functions, the rte_malloc_socket_stats structure and
the SOCKET_ID_ANY macro. The old names are kept as deprecated
aliases for one release, giving applications a full release
window to migrate.
Once the notice has completed a release cycle, the coccinelle
script will be used to generate a single tree-wide conversion
patch, instead of the previous large series of small patches
which overloaded the CI.
The script covers the mechanical source renames: API function
call sites, macros, the rte_malloc_socket_stats structure, and
socket_id member accesses. Coccinelle cannot express every
needed change: designated initializers, union field declarations,
documentation and string literals require manual adjustments; it
also silently skips functions whose signature carries attribute
macros it does not know (e.g. __rte_unused). The same applies to
the fields named "socket" in rte_graph and rte_bbdev_queue_conf,
where a generic rename rule would over-match.
The replacement names follow the libnuma node semantics while
keeping the existing DPDK memory allocation model: bare node
getters (rte_numa_node(), rte_numa_node_count(),
rte_numa_node_by_idx(), rte_cpu_numa_node(),
rte_lcore_to_numa_node()), an rte_malloc_onnode() allocation
family shaped after libnuma's numa_alloc_onnode(), and
rte_malloc_heap_get_numa_node().
Series-changes: 2
- only the deprecation notice and the coccinelle script, the
tree-wide conversion patch will be submitted after the notice
completes a release cycle
- keep old names as deprecated aliases for one release window
- cover the full rename set in the script (malloc family,
rte_cpu_socket_id, rte_cryptodev_socket_id,
rte_ml_dev_socket_id, rte_malloc_socket_stats)
- use a "Terminology change" tag in the deprecation notice as
the rename spans several libraries
- name the replacements after libnuma semantics
(rte_numa_node(), rte_malloc_onnode(), ...)
Chengwen Feng (2):
doc: deprecate socket terminology in favor of NUMA node
cocci: add script for NUMA node terminology renames
devtools/cocci/socket_to_numa_node.cocci | 152 +++++++++++++++++++++++
doc/guides/rel_notes/deprecation.rst | 35 ++++++
2 files changed, 187 insertions(+)
create mode 100644 devtools/cocci/socket_to_numa_node.cocci
--
2.55.0
More information about the dev
mailing list