[PATCH v2 2/2] cocci: add script for NUMA node terminology renames
Chengwen Feng
chengwen.feng at linux.dev
Fri Nov 6 07:14:38 CET 2026
From: Chengwen Feng <fengchengwen at huawei.com>
Add a coccinelle script that codifies the socket to NUMA node
rename rules of the migration announced in the deprecation
notice.
The script is not applied now. Once the deprecation notice has
completed a release cycle, it will be used to generate a single
tree-wide conversion patch.
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 unknown attribute macros
(e.g. __rte_unused).
Signed-off-by: Chengwen Feng <fengchengwen at huawei.com>
---
devtools/cocci/socket_to_numa_node.cocci | 152 +++++++++++++++++++++++
1 file changed, 152 insertions(+)
create mode 100644 devtools/cocci/socket_to_numa_node.cocci
diff --git a/devtools/cocci/socket_to_numa_node.cocci b/devtools/cocci/socket_to_numa_node.cocci
new file mode 100644
index 0000000000..76d91df053
--- /dev/null
+++ b/devtools/cocci/socket_to_numa_node.cocci
@@ -0,0 +1,152 @@
+// Convert the socket terminology to NUMA node terminology.
+//
+// This script codifies the rename rules of the socket to NUMA node
+// terminology migration announced in
+// doc/guides/rel_notes/deprecation.rst. The tree is not converted
+// yet: once the deprecation notice has completed a release cycle,
+// this script is used to generate a single tree-wide conversion
+// patch.
+//
+// Coccinelle cannot express every needed change: designated
+// initializers, union field declarations, documentation and string
+// literals require manual adjustments.
+//
+// Coccinelle also silently skips functions whose signature carries
+// unknown attribute macros (e.g. __rte_unused); call sites inside
+// such functions need manual conversion as well.
+//
+// The socket_id names are kept as deprecated aliases, applications
+// get one release to switch (see deprecation.rst).
+
+// Union member of the public structures.
+@@
+expression E;
+@@
+-E.socket_id
++E.numa_node
+
+@@
+expression E;
+@@
+-E->socket_id
++E->numa_node
+
+// EAL APIs.
+@@
+@@
+-SOCKET_ID_ANY
++RTE_NUMA_NODE_ANY
+
+@@
+@@
+-rte_socket_id()
++rte_numa_node()
+
+@@
+@@
+-rte_socket_count()
++rte_numa_node_count()
+
+@@
+expression E;
+@@
+-rte_socket_id_by_idx(E)
++rte_numa_node_by_idx(E)
+
+@@
+expression E;
+@@
+-rte_cpu_socket_id(E)
++rte_cpu_numa_node(E)
+
+@@
+expression E;
+@@
+-rte_lcore_to_socket_id(E)
++rte_lcore_to_numa_node(E)
+
+// Legacy malloc APIs.
+@@
+expression E1, E2, E3, E4;
+@@
+-rte_malloc_socket(E1, E2, E3, E4)
++rte_malloc_onnode(E1, E2, E3, E4)
+
+@@
+expression E1, E2, E3, E4;
+@@
+-rte_zmalloc_socket(E1, E2, E3, E4)
++rte_zmalloc_onnode(E1, E2, E3, E4)
+
+@@
+expression E1, E2, E3, E4, E5;
+@@
+-rte_calloc_socket(E1, E2, E3, E4, E5)
++rte_calloc_onnode(E1, E2, E3, E4, E5)
+
+@@
+expression E1, E2, E3, E4;
+@@
+-rte_realloc_socket(E1, E2, E3, E4)
++rte_realloc_onnode(E1, E2, E3, E4)
+
+@@
+expression E;
+@@
+-rte_malloc_heap_get_socket(E)
++rte_malloc_heap_get_numa_node(E)
+
+@@
+expression E1, E2;
+@@
+-rte_malloc_get_socket_stats(E1, E2)
++rte_malloc_get_numa_stats(E1, E2)
+
+@@
+expression E;
+@@
+-rte_malloc_heap_socket_is_external(E)
++rte_malloc_heap_numa_is_external(E)
+
+@@
+@@
+-struct rte_malloc_socket_stats
++struct rte_malloc_numa_stats
+
+// Device APIs (the same pattern applies to every library that
+// exposed a device socket API).
+@@
+expression E;
+@@
+-rte_eth_dev_socket_id(E)
++rte_eth_dev_numa_node(E)
+
+@@
+expression E;
+@@
+-rte_cryptodev_socket_id(E)
++rte_cryptodev_numa_node(E)
+
+@@
+expression E;
+@@
+-rte_event_dev_socket_id(E)
++rte_event_dev_numa_node(E)
+
+@@
+expression E;
+@@
+-rte_compressdev_socket_id(E)
++rte_compressdev_numa_node(E)
+
+@@
+expression E;
+@@
+-rte_rawdev_socket_id(E)
++rte_rawdev_numa_node(E)
+
+@@
+expression E;
+@@
+-rte_ml_dev_socket_id(E)
++rte_ml_dev_numa_node(E)
--
2.55.0
More information about the dev
mailing list