tools/contrib: Add tasksetcpu.py to show the CPU allocation grid

Signed-off-by: Jose J Palacios-Perez <[email protected]>

Author: perezjosibm

src/tools/contrib/README.rst

@@ -8,3 +8,21 @@ Please do not assume any level of support.  Your mileage may vary.
 
 Each file's header must include a tracker number and an author signed-off-by
 line.
+
+
+- balance-cpu.py. An utility to distribute the Seastar reactor threads over the
+  (physical) CPU cores, according to two strategies:
+  - OSD-based (default): allocates all the reactors of the same OSD in the same 
+    NUMA socket,
+  - NUMA socket: distributes the reactors of each OSD evenly in the NUMA sockets
+    (normally two), so every OSD ends up with reactors running on both NUMA sockets.
+
+- lscpu.py. A Python module to parse the output of  ``lscpu --json`` into a dictionary
+  which is used by balance-cpu and tasksetcpu.py.
+
+- tasksetcpu.py. an utility to print a grid showing the current CPU core allocation
+  of Seastar reactors. Useful to validate that the allocation strategy is correct.
+
+For further details, please see *BalanceCPUCrimson.md* in doc/dev/crimson.
+
+