1LSTOPO(1)                            hwloc                           LSTOPO(1)
2
3
4

NAME

6       lstopo, lstopo-no-graphics, hwloc-ls - Show the topology of the system
7

SYNOPSIS

9       lstopo [ options ]... [ filename ]
10
11       lstopo-no-graphics [ options ]... [ filename ]
12
13       hwloc-ls [ options ]... [ filename ]
14
15       Note that hwloc(7) provides a detailed explanation of the hwloc system;
16       it should be read before reading this man page
17

OPTIONS

19       --of <format>, --output-format <format>
20              Enforce the output in the given format.  See the OUTPUT  FORMATS
21              section below.
22
23       -i <file>, --input <file>
24              Read  topology  from XML file <file> (instead of discovering the
25              topology on the local machine).  If <file> is "-", the  standard
26              input  is used.  XML support must have been compiled in to hwloc
27              for this option to be usable.
28
29       -i <directory>, --input <directory>
30              Read topology from <directory> instead of discovering the topol‐
31              ogy  of  the local machine.  On Linux, the directory may contain
32              the topology files gathered from another machine  topology  with
33              hwloc-gather-topology.   On  x86,  the  directory  may contain a
34              cpuid dump gathered with hwloc-gather-cpuid.
35
36       -i <specification>, --input <specification>
37              Simulate a fake hierarchy (instead of discovering  the  topology
38              on  the local machine). If <specification> is "node:2 pu:3", the
39              topology will contain two NUMA nodes with 3 processing units  in
40              each of them.  The <specification> string must end with a number
41              of PUs.
42
43       --if <format>, --input-format <format>
44              Enforce the input in the given format, among xml, fsroot,  cpuid
45              and synthetic.
46
47       --export-xml-flags <flags>
48              Enforce  flags  when  exporting to the XML format.  Flags may be
49              given as numeric values or as a  comma-separated  list  of  flag
50              names  that  are  passed  to hwloc_topology_export_xml().  Those
51              names may be substrings of actual flag names as long as a single
52              one  matches.   A  value  of  1 (or v1) reverts to the format of
53              hwloc v1.x.  The default is 0 (or none).
54
55       --export-synthetic-flags <flags>
56              Enforce flags when exporting to the synthetic format.  Flags may
57              be  given as numeric values or as a comma-separated list of flag
58              names  that  are  passed  to  hwloc_topology_export_synthetic().
59              Those  names may be substrings of actual flag names as long as a
60              single one matches.  A value of 2 (or no_attr)  reverts  to  the
61              format  of hwloc v1.9.  A value of 3 (or no_ext,no_attr) reverts
62              to the original minimalistic format (before v1.9).  The  default
63              is 0 (or none).
64
65       -v --verbose
66              Include  additional  detail.  The hwloc-info tool may be used to
67              display even more information about specific objects.
68
69       -s --silent
70              Reduce the amount of details to show.
71
72       --distances
73              Only display distance matrices.
74
75       --memattrs
76              Only display memory  attributes.   All  of  them  are  displayed
77              (while  the  default textual output selects memory attribute de‐
78              tails depending on the verbosity level).
79
80       --cpukinds
81              Only display CPU kinds.
82
83       -f --force
84              If the destination file already exists, overwrite it.
85
86       -l --logical
87              Display hwloc logical indexes of all objects, with prefix  "L#".
88              By  default,  both logical and physical/OS indexes are displayed
89              for PUs and NUMA nodes, logical only for cores, dies  and  pack‐
90              ages, and no index for other types.
91
92       -p --physical
93              Display  OS/physical  indexes  of all objects, with prefix "P#".
94              By default, both logical and physical/OS indexes  are  displayed
95              for  PUs  and NUMA nodes, logical only for cores, dies and pack‐
96              ages, and no index for other types.
97
98       -c --cpuset
99              Display the cpuset of each object.
100
101       -C --cpuset-only
102              Only display the cpuset of each object; do not display  anything
103              else about the object.
104
105       --taskset
106              Show  CPU  set  strings  in the format recognized by the taskset
107              command-line program instead of hwloc-specific  CPU  set  string
108              format.   This  option  should  be  combined  with  --cpuset  or
109              --cpuset-only, otherwise it will imply --cpuset.
110
111       --only <type>
112              Only show objects of the given type in the textual output.
113
114       --filter <type>:<kind>, --filter <type>
115              Filter objects of type <type>, or  of  any  type  if  <type>  is
116              "all".  "io", "cache" and "icache" are also supported.
117
118              <kind> specifies the filtering behavior.  If "none" or not spec‐
119              ified, all objects of the given type are removed.  If "all", all
120              objects  are  kept  as  usual.  If "structure", objects are kept
121              when they bring structure to the topology.  If "important" (only
122              applicable  to  I/O),  only  important  objects  are  kept.  See
123              hwloc_topology_set_type_filter() for more details.
124
125              hwloc supports filtering any type except  PUs  and  NUMA  nodes.
126              lstopo  also offers PU and NUMA node filtering by hiding them in
127              the graphical and textual outputs, but any  object  included  in
128              them  (for instance Misc) will be hidden as well.  Note that PUs
129              and NUMA nodes may not be ignored in the XML output.  Note  also
130              that  the  top-level  object type cannot be ignored (usually Ma‐
131              chine or System).
132
133       --ignore <type>
134              This is the old way to specify --filter <type>:none.
135
136       --no-smt
137              Ignore PUs.  This is identical to --filter PU:none.
138
139       --no-caches
140              Do not show caches.  This is identical to --filter cache:none.
141
142       --no-useless-caches
143              This is identical to --filter cache:structure.
144
145       --no-icaches
146              This is identical to --filter icache:none.
147
148       --disallowed
149              Include objects disallowed by administrative limitations.
150
151       --allow <all|local|0xff|nodeset=0xf0>
152              Include objects disallowed by  administrative  limitations  (im‐
153              plies --disallowed) and also change the set of allowed ones.
154
155              If local is given, only objects available to the current process
156              are allowed (default behavior when loading from the native oper‐
157              ating  system  backend).   It  may be useful if the topology was
158              created by another process (with  different  administrative  re‐
159              strictions  such  as  Linux Cgroups) and loaded here loaded from
160              XML or synthetic.  This case implies --thissystem.
161
162              If all, all objects are allowed.
163
164              If a bitmap is given as a hexadecimal string, it is used as  the
165              set of allowed PUs.
166
167              If a bitmap is given after prefix nodeset=, it is the set of al‐
168              lowed NUMA nodes.
169
170       --flags <flags>
171              Enforce topology flags.  Flags may be given as numeric values or
172              as  a  comma-separated  list  of  flag  names that are passed to
173              hwloc_topology_set_flags().  Those names may  be  substrings  of
174              actual  flag names as long as a single one matches, for instance
175              disallowed,thissystem_allowed.  The default is 8 (or import).
176
177       --merge
178              Do not show levels that do not have a hierarchical impact.  This
179              sets  HWLOC_TYPE_FILTER_KEEP_STRUCTURE  for  all  object  types.
180              This is identical to --filter all:structure.
181
182       --no-factorize --no-factorize=<type>
183              Never factorize identical objects in the graphical output.
184
185              If an object type is given, only factorizing of these objects is
186              disabled.   This  only applies to normal CPU-side objects, it is
187              independent from PCI collapsing.
188
189       --factorize --factorize=[<type>,]<N>[,<L>[,<F>]
190              Factorize identical children in the graphical output (enabled by
191              default).
192
193              If <N> is specified (4 by default), factorizing only occurs when
194              there are strictly more than N identical children.  If  <L>  and
195              <F>  are specified, they set the numbers of first and last chil‐
196              dren to keep after factorizing.
197
198              If an object type is given, only factorizing of these objects is
199              configured.   This only applies to normal CPU-side object, it is
200              independent from PCI collapsing.
201
202       --no-collapse
203              Do not collapse identical PCI devices.   By  default,  identical
204              sibling  PCI  devices  (such  as many virtual functions inside a
205              single physical device) are collapsed.
206
207       --no-cpukinds
208              Do not show different kinds of CPUs in the graphical output.  By
209              default, when supported, different types of lines, thickness and
210              bold font may be used to display PU boxes of different kinds.
211
212       --restrict <cpuset>
213              Restrict the topology to the given cpuset.
214
215       --restrict nodeset=<nodeset>
216              Restrict the topology to the given nodeset,  unless  --restrict-
217              flags specifies something different.
218
219       --restrict binding
220              Restrict  the topology to the current process binding.  This op‐
221              tion requires the use of the actual current machine topology (or
222              any  other  topology  with --thissystem or with HWLOC_THISSYSTEM
223              set to 1 in the environment).
224
225       --restrict-flags <flags>
226              Enforce flags when restricting the topology.  Flags may be given
227              as  numeric  values  or  as a comma-separated list of flag names
228              that are passed to hwloc_topology_restrict().  Those  names  may
229              be  substrings  of  actual  flag  names  as long as a single one
230              matches, for instance bynodeset,memless.  The default is  0  (or
231              none).
232
233       --no-io
234              Do  not  show  any  I/O  device or bridge.  This is identical to
235              --filter io:none.  By default, common devices (GPUs, NICs, block
236              devices, ...) and interesting bridges/switches are shown.
237
238       --no-bridges
239              Do  not show any I/O bridge except hostbridges.  This is identi‐
240              cal to --filter bridge:none.  By default, common devices  (GPUs,
241              NICs,  block  devices, ...) and interesting bridges/switches are
242              shown.
243
244       --whole-io
245              Show all I/O devices and bridges.  This is identical to --filter
246              io:all.   By default, only common devices (GPUs, NICs, block de‐
247              vices, ...) and interesting bridges/switches are shown.
248
249       --thissystem
250              Assume that the selected backend provides the topology  for  the
251              system  on  which we are running.  This is useful when loading a
252              custom topology such as an XML file and using --restrict binding
253              or --allow all.
254
255       --pid <pid>
256              Detect  topology  as  seen  by process <pid>, i.e. as if process
257              <pid> did the discovery itself.  Note that this can for instance
258              change  the  set  of allowed processors.  Also show this process
259              current CPU and Memory binding by marking the corresponding  PUs
260              and NUMA nodes (in Green in the graphical output, see the COLORS
261              section below, or by appending (binding)  to  the  verbose  text
262              output).   If  0  is  given  as pid, the current binding for the
263              lstopo process will be shown.
264
265       --ps --top
266              Show existing processes as misc objects in the output. To  avoid
267              uselessly  cluttering  the  output,  only processes that are re‐
268              stricted to some part of the machine are shown.  On Linux,  ker‐
269              nel threads are not shown.  If many processes appear, the output
270              may become hard to read anyway, making the hwloc-ps program more
271              practical.
272
273       --children-order <order>
274              Change the order of the different kinds of children with respect
275              to their parent in the graphical output.
276
277              The default order is memoryabove: it  displays  memory  children
278              above  other  children  (and above the parent if it is a cache).
279              PUs are therefore below their local NUMA nodes, like  hwloc  1.x
280              did.
281
282              If  the  order is changed to plain, lstopo displays the topology
283              in a basic manner that strictly matches the actual tree:  memory
284              children  are  listed  below  their  parent  just like any other
285              child.  PUs are therefore on the side of their local NUMA nodes,
286              below a common ancestor.
287
288              See also the GRAPHICAL OUTPUT section below.
289
290       --fontsize <size>
291              Set the size of text font in the graphical output.
292
293              The default is 10.
294
295              Boxes   are   scaled   according   to   the   text   size.   The
296              LSTOPO_TEXT_XSCALE environment variable may be used  to  further
297              scale the width of boxes (its default value is 1.0).
298
299              The --fontsize option is ignored in the ASCII backend.
300
301       --gridsize <size>
302              Set the margin between elements in the graphical output.
303
304              The default is 7. It was 10 prior to hwloc 2.1.
305
306              This option is ignored in the ASCII backend.
307
308       --linespacing <size>
309              Set the spacing between lines of text in the graphical output.
310
311              The default is 4.
312
313              The  option  was  included in --gridsize prior to hwloc 2.1 (and
314              its default was 10).
315
316              This option is ignored in the ASCII backend.
317
318       --thickness <size>
319              Set the thickness of lines and boxes in the graphical output.
320
321              The default is 1.
322
323              This option is ignored in the ASCII backend.
324
325       --horiz, --horiz=<type1,...>
326              Force a horizontal graphical layout instead of nearly 4/3  ratio
327              in  the  graphical  output.  If a comma-separated list of object
328              types is given, the layout only  applies  to  the  corresponding
329              container objects.  Ignored for bridges since their children are
330              always vertically aligned.
331
332       --vert, --vert=<type1,...>
333              Force a vertical graphical layout instead of nearly 4/3 ratio in
334              the graphical output.  If a comma-separated list of object types
335              is given, the layout only applies to the corresponding container
336              objects.
337
338       --rect, --rect=<type1,...>
339              Force  a  rectangular  graphical layout with nearly 4/3 ratio in
340              the graphical output.  If a comma-separated list of object types
341              is given, the layout only applies to the corresponding container
342              objects.  Ignored for bridges since their  children  are  always
343              vertically aligned.
344
345       --no-text, --no-text=<type1,...>
346              Do  not display any text in boxes in the graphical output.  If a
347              comma-separated list of object types is given, text is  disabled
348              for the corresponding objects.  This is mostly useful for remov‐
349              ing text from Group objects.
350
351       --text, --text=<type1,...>
352              Display text in boxes in the graphical output (default).   If  a
353              comma-separated list of object types is given, text is reenabled
354              for the corresponding objects (if  it  was  previously  disabled
355              with --no-text).
356
357       --no-index, --no-index=<type1,...>
358              Do not show object indexes in the graphical output.  If a comma-
359              separated list of object types is given,  indexes  are  disabled
360              for the corresponding objects.
361
362       --index, --index=<type1,...>
363              Show  object  indexes  in  the graphical output (default).  If a
364              comma-separated list of object types is given, indexes are reen‐
365              abled  for  the  corresponding  objects (if they were previously
366              disabled with --no-index).
367
368       --no-attrs, --no-attrs=<type1,...>
369              Do not show object attributes (such as memory size, cache  size,
370              PCI  bus ID, PCI link speed, etc.)  in the graphical output.  If
371              a comma-separated list of object types is given, attributes  are
372              disabled for the corresponding objects.
373
374       --attrs, --attrs=<type1,...>
375              Show object attributes (such as memory size, cache size, PCI bus
376              ID, PCI link speed, etc.)  in the  graphical  output  (default).
377              If  a  comma-separated list of object types is given, attributes
378              are reenabled for the corresponding objects (if they were previ‐
379              ously disabled with --no-attrs).
380
381       --no-legend
382              Remove all text legend lines at the bottom of the graphical out‐
383              put.
384
385       --no-default-legend
386              Remove default text legend lines at the bottom of the  graphical
387              output.   User-added  legend  lines  with --append-legend or the
388              "lstopoLegend" info are still displayed if any.
389
390       --append-legend <line>
391              Append the line of text to the  bottom  of  the  legend  in  the
392              graphical output.  If adding multiple lines, each line should be
393              given separately by passing this option multiple  times.   Addi‐
394              tional  legend  lines  may also be specified inside the topology
395              using the "lstopoLegend" info attributes on  the  topology  root
396              object.
397
398       --binding-color none
399              Do  not  colorize PUs and NUMA nodes according to the binding in
400              the graphical output.
401
402       --disallowed-color none
403              Do not colorize disallowed PUs and NUMA nodes in  the  graphical
404              output.
405
406       --top-color <none|#xxyyzz>
407              Do  not colorize task objects in the graphical output when --top
408              is given, or change the background color.
409
410       --version
411              Report version and exit.
412
413       -h --help
414              Display help message and exit.
415

DESCRIPTION

417       lstopo and lstopo-no-graphics are capable of displaying  a  topological
418       map  of  the system in a variety of different output formats.  The only
419       difference between lstopo and lstopo-no-graphics is that graphical out‐
420       puts  are  only supported by lstopo, to reduce dependencies on external
421       libraries.  hwloc-ls is identical to lstopo-no-graphics.
422
423       The filename specified directly implies the output format that will  be
424       used;  see the OUTPUT FORMATS section, below.  Output formats that sup‐
425       port color will indicate specific characteristics about individual CPUs
426       by their color; see the COLORS section, below.
427

OUTPUT FORMATS

429       By  default, if no output filename is specific, the output is sent to a
430       graphical window if possible in the current environment (DISPLAY  envi‐
431       ronment variable set on Unix, etc.).  Otherwise, a text summary is dis‐
432       played in the console.
433
434       The filename on the command line usually determines the format  of  the
435       output.   There  are a few filenames that indicate specific output for‐
436       mats and devices (e.g., a filename of "-" will output a text summary to
437       stdout), but most filenames indicate the desired output format by their
438       suffix (e.g., "topo.png" will output a PNG-format file).
439
440       The format of the output may also be  changed  with  "--of".   For  in‐
441       stance, "--of pdf" will generate a PDF-format file on the standard out‐
442       put, while "--of fig toto" will output a Xfig-format file named "toto".
443
444       The list of currently supported formats is given below. Any of them may
445       be used with "--of" or as a filename suffix.
446
447       default
448              Send  the  output to a window or to the console depending on the
449              environment.
450
451       console
452              Send a text summary to stdout.  Binding or unallowed  processors
453              are  only annotated in this mode if verbose; see the COLORS sec‐
454              tion, below.
455
456       ascii  Output an ASCII art representation of the map  (formerly  called
457              txt).   If  outputting  to stdout and if colors are supported on
458              the terminal, the output will be colorized.
459
460       tikz or tex
461              Output a LaTeX tikzpicture representation of the map that can be
462              compiled with a LaTeX compiler.
463
464       fig    Output a representation of the map that can be loaded in Xfig.
465
466       svg    Output a SVG representation of the map, using Cairo (by default,
467              if supported) or a native SVG  backend  (fallback,  always  sup‐
468              ported).  See cairosvg and nativesvg below.
469
470       cairosvg or svg(cairo)
471              If  lstopo  was  compiled  with the proper support, output a SVG
472              representation of the map using Cairo.
473
474       nativesvg or svg(native)
475              Output a SVG representation of the  map  using  the  native  SVG
476              backend.  It may be less pretty than the Cairo output, but it is
477              always supported, and SVG objects have attributes for  identify‐
478              ing  and manipulating them.  See dynamic_SVG_example.html for an
479              example.
480
481       pdf    If lstopo was compiled with the proper support, lstopo outputs a
482              PDF representation of the map.
483
484       ps     If lstopo was compiled with the proper support, lstopo outputs a
485              Postscript representation of the map.
486
487       png    If lstopo was compiled with the proper support, lstopo outputs a
488              PNG representation of the map.
489
490       synthetic
491              If  the  topology is symmetric (which requires that the root ob‐
492              ject has its symmetric_subtree field set), lstopo outputs a syn‐
493              thetic  description string.  This output may be reused as an in‐
494              put synthetic topology description later.   See  also  the  Syn‐
495              thetic  topologies section in the documentation.  Note that Misc
496              and I/O devices are ignored during this export.
497
498       xml    If lstopo was compiled with the proper support,  lstopo  outputs
499              an  XML representation of the map.  It may be reused later, even
500              on another machine, with lstopo --input, the HWLOC_XMLFILE envi‐
501              ronment variable, or the hwloc_topology_set_xml() function.
502
503
504       The following special names may be used:
505
506       -      Send a text summary to stdout.
507
508       /dev/stdout
509              Send  a  text  summary to stdout.  It is effectively the same as
510              specifying "-".
511
512       -.<format>
513              If the entire filename is "-.<format>",  lstopo  behaves  as  if
514              "--of  <format>  -"  was  given, which means a file of the given
515              format is sent to the standard output.
516
517
518       See the output of "lstopo --help" for a specific list of what graphical
519       output formats are supported in your hwloc installation.
520

GRAPHICAL OUTPUT

522       The graphical output is made of nested boxes representing the inclusion
523       of objects in the hierarchy of resources.  Usually a Machine  box  con‐
524       tains  one  or several Package boxes, that contain multiple Core boxes,
525       with one or several PUs each.
526
527
528   Caches
529       Caches are displayed in a slightly different manner because they do not
530       actually include computing resources such as cores.  For instance, a L2
531       Cache shared by a pair of Cores is drawn as a Cache box on top  of  two
532       Core boxes (instead of having Core boxes inside the Cache box).
533
534
535   NUMA nodes and Memory-side Caches
536       By  default, NUMA nodes boxes are drawn on top of their local computing
537       resources.  For instance, a processor Package containing one NUMA  node
538       and  four  Cores is displayed as a Package box containing the NUMA node
539       box above four Core boxes.  If a NUMA node is local to  the  L3  Cache,
540       the  NUMA  node  is  displayed above that Cache box.  All this specific
541       drawing strategy for memory objects may be disabled by passing command-
542       line option --children-order plain.
543
544       If multiple NUMA nodes are attached to the same parent object, they are
545       displayed inside an additional unnamed memory box.
546
547       If some Memory-side Caches exist in front of some NUMA nodes, they  are
548       drawn as boxes immediately above them.
549
550
551   PCI bridges, PCI devices and OS devices
552       The PCI hierarchy is not drawn as a set of included boxes but rather as
553       a tree of bridges (that may actually be switches)  with  links  between
554       them.   The  tree  starts with a small square on the left for the host‐
555       bridge or root complex.  It ends with PCI device boxes  on  the  right.
556       Intermediate  PCI  bridges/switches  may  appear  as  additional  small
557       squares in the middle.
558
559       PCI devices on the right of the tree are boxes containing their PCI bus
560       ID  (such  as  00:02.3).  They may also contain sub-boxes for OS device
561       objects such as a network interface eth0 or a CUDA GPU cuda0.
562
563       The datarate of a PCI link may be written (in  GB/s)  right  below  its
564       drawn line (if the operating system and/or libraries are able to report
565       that information).  This  datarate  is  the  currently  configured  PCI
566       datarate.   It  may change during execution since some devices are able
567       to slow their PCI links down when idle.
568
569       When there is a single link (horizontal line) on the  right  of  a  PCI
570       bridge,  it  means  that  a single device or bridge is connected on the
571       secondary PCI bus behind that bridge.  When there is a  vertical  line,
572       it means that multiple devices and/or bridges are connected to the same
573       secondary PCI bus.
574
575

COLORS

577       Individual CPUs and NUMA nodes are colored in the graphical output for‐
578       mats to indicate different characteristics:
579
580       Green  The  topology  is  reported  as  seen by a specific process (see
581              --pid), and the given CPU or NUMA node is in this process CPU or
582              Memory binding mask.
583
584       White  The  CPU or NUMA node is in the allowed set (see below).  If the
585              topology is reported as seen by a specific process (see  --pid),
586              the object is also not in this process binding mask.
587
588       Red    The CPU or NUMA node is not in the allowed set (see below).
589
590       The "allowed set" is the set of CPUs or NUMA nodes to which the current
591       process is allowed to bind.  The allowed set is usually  either  inher‐
592       ited  from the parent process or set by administrative qpolicies on the
593       system.  Linux cpusets are one example of limiting the allowed set  for
594       a process and its children to be less than the full set of CPUs or NUMA
595       nodes on the system.
596
597       Different processes may therefore have different CPUs or NUMA nodes  in
598       the  allowed  set.  Hence, invoking lstopo in different contexts and/or
599       as different users may display different colors for the same individual
600       CPUs  (e.g.,  running  lstopo in one context may show a specific CPU as
601       red, but running lstopo in a different context may show the same CPU as
602       white).
603
604       Some  lstopo output modes, e.g. the console mode (default non-graphical
605       output), do not support colors at all.  The console mode  displays  the
606       above characteristics by appending text to each PU line if verbose mes‐
607       sages are enabled.
608

CUSTOM COLORS

610       The color of each object in the graphical output  may  be  enforced  by
611       specifying  a  "lstopoStyle"  info attribute in that object.  Its value
612       should be a semi-colon separated list  of  "<attribute>=#rrggbb"  where
613       rr,  gg  and  bb  are the RGB components of a color, each between 0 and
614       255, in hexadecimal (00 to ff).  <attribute> may be
615
616       Background
617              Sets the background color of the main object box.
618
619       Text   Sets the color of the text showing the object name, type, index,
620              etc.
621
622       Text2  Sets  the  color of the additional text near the object, for in‐
623              stance the link speed behind a PCI bridge.
624
625       The "lstopoStyle" info may be added to a temporarily-saved XML  topolo‐
626       gies  with hwloc-annotate, or with hwloc_obj_add_info().  For instance,
627       to display all core objects in blue (with white names):
628
629           lstopo save.xml
630           hwloc-annotate save.xml save.xml core:all info  lstopoStyle  "Back‐
631       ground=#0000ff;Text=#ffffff"
632           lstopo -i save.xml
633

LAYOUT

635       In  its  graphical output, lstopo uses simple rectangular heuristics to
636       try to achieve a 4/3 ratio between width and height.  Although the  hi‐
637       erarchy  of resources is properly reflected, the exact physical organi‐
638       zation (NUMA distances, rings, complete graphs, etc.) is currently  ig‐
639       nored.   The layout of a level may be changed with --vert, --horiz, and
640       --rect.
641
642       The position of memory children with respect to other children  objects
643       may be changed using --children-order.
644

EXAMPLES

646       To display the machine topology in textual mode:
647
648           lstopo-no-graphics
649
650       To display the machine topology in ascii-art mode:
651
652           lstopo-no-graphics -.ascii
653
654       To  display  in  graphical  mode (assuming that the DISPLAY environment
655       variable is set to a relevant value):
656
657           lstopo
658
659       To export the topology to a PNG file:
660
661           lstopo file.png
662
663       To export an XML file on a machine and later display the  corresponding
664       graphical output on another machine:
665
666           machine1$ lstopo file.xml
667           <transfer file.xml from machine1 to machine2>
668           machine2$ lstopo --input file.xml
669
670       To  save the current machine topology to XML and later reload it faster
671       while still considering it as the current machine:
672
673          $ lstopo file.xml
674          <...>
675          $ lstopo --input file.xml --thissystem
676
677       To restrict an XML topology to only physical processors 0, 1, 4 and 5:
678
679           lstopo --input file.xml --restrict 0x33 newfile.xml
680
681       To restrict an XML topology to only numa node whose logical index is 1:
682
683           lstopo --input file.xml --restrict  $(hwloc-calc  --input  file.xml
684       node:1) newfile.xml
685
686       To display a summary of the topology:
687
688           lstopo -s
689
690       To get more details about the topology:
691
692           lstopo -v
693
694       To only show cores:
695
696           lstopo --only core
697
698       To show cpusets:
699
700           lstopo --cpuset
701
702       To only show the cpusets of package:
703
704           lstopo --only package --cpuset-only
705
706       Simulate  a  fake  hierarchy; this example shows with 2 NUMA nodes of 2
707       processor units:
708
709           lstopo --input "node:2 2"
710
711       To count the number of logical processors in the system
712
713          lstopo --only pu | wc -l
714
715       To append the kernel release and version to the graphical legend:
716
717          lstopo --append-legend "Kernel release: $(uname -r)" --append-legend
718       "Kernel version: $(uname -v)"
719
720

SEE ALSO

722       hwloc(7), hwloc-info(1), hwloc-bind(1), hwloc-annotate(1), hwloc-ps(1),
723       hwloc-gather-topology(1), hwloc-gather-cpuid(1)
724
725
726
727
7282.4.1                            Feb 11, 2021                        LSTOPO(1)
Impressum