diff mbox series

[v2] doc: improve lstopo tip

Message ID 20210521090616.946267-1-thomas@monjalon.net (mailing list archive)
State Accepted, archived
Headers
Series [v2] doc: improve lstopo tip |

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation success Compilation OK
ci/github-robot success github build: passed
ci/intel-Testing success Testing PASS

Commit Message

Thomas Monjalon May 21, 2021, 9:06 a.m. UTC 
  The tool lstopo from hwloc package can provide a graphical
or textual view.
In its textual form, the option --merge gives a shorter summary
which fits well with the DPDK need.

Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
---
v2: add textual output in Linux guide
---
 doc/guides/linux_gsg/build_sample_apps.rst | 13 +++++++++----
 doc/guides/nics/mlx4.rst                   |  2 +-
 doc/guides/nics/mlx5.rst                   |  2 +-
 3 files changed, 11 insertions(+), 6 deletions(-)

Comments

Thomas Monjalon May 21, 2021, 1:55 p.m. UTC | #1 
21/05/2021 11:06, Thomas Monjalon:
> The tool lstopo from hwloc package can provide a graphical
> or textual view.
> In its textual form, the option --merge gives a shorter summary
> which fits well with the DPDK need.
> 
> Signed-off-by: Thomas Monjalon <thomas@monjalon.net>

I think this option can be quite useful.

Applied
diff mbox series

Patch

diff --git a/doc/guides/linux_gsg/build_sample_apps.rst b/doc/guides/linux_gsg/build_sample_apps.rst
index 78652549a7..709b301427 100644
--- a/doc/guides/linux_gsg/build_sample_apps.rst
+++ b/doc/guides/linux_gsg/build_sample_apps.rst
@@ -138,11 +138,16 @@  This can be useful when using other processors to understand the mapping of the
 
 .. note::
 
-    A more graphical view of the logical core layout may be obtained using the ``lstopo`` Linux utility.
-    On Fedora Linux, this may be installed and run using the following command::
+   A more graphical view of the logical core layout
+   may be obtained using the ``lstopo`` Linux utility.
+   On Fedora, this may be installed and run using the following commands::
 
-        sudo yum install hwloc
-        ./lstopo
+      sudo yum install hwloc
+      lstopo
+
+   This command produces a quite short textual output::
+
+      lstopo-no-graphics --merge
 
 .. warning::
 
diff --git a/doc/guides/nics/mlx4.rst b/doc/guides/nics/mlx4.rst
index 9742ddb268..a25add7c47 100644
--- a/doc/guides/nics/mlx4.rst
+++ b/doc/guides/nics/mlx4.rst
@@ -308,7 +308,7 @@  Performance tuning
    for better performance. For VMs, verify that the right CPU
    and NUMA node are pinned according to the above. Run::
 
-        lstopo-no-graphics
+        lstopo-no-graphics --merge
 
    to identify the NUMA node to which the PCIe adapter is connected.
 
diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index 220c6e505a..83299646dd 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -1496,7 +1496,7 @@  Performance tuning
    for better performance. For VMs, verify that the right CPU
    and NUMA node are pinned according to the above. Run::
 
-        lstopo-no-graphics
+        lstopo-no-graphics --merge
 
    to identify the NUMA node to which the PCIe adapter is connected.