1HWLOC-DISTANCES(1)                   hwloc                  HWLOC-DISTANCES(1)
2
3
4

NAME

6       hwloc-distances - Displays distance matrices
7

SYNOPSIS

9       hwloc-distances [options]
10

OPTIONS

12       -l --logical
13              Display  hwloc  logical indexes (default) instead of physical/OS
14              indexes.
15
16       -p --physical
17              Display OS/physical indexes instead of hwloc logical indexes.
18
19       -i <file>, --input <file>
20              Read topology from XML file <file> (instead of  discovering  the
21              topology  on the local machine).  If <file> is "-", the standard
22              input is used.  XML support must have been compiled in to  hwloc
23              for this option to be usable.
24
25       -i <directory>, --input <directory>
26              Read  topology from the chroot specified by <directory> (instead
27              of discovering the topology on the local machine).  This  option
28              is  generally  only  available on Linux.  The chroot was usually
29              created by gathering another machine topology with hwloc-gather-
30              topology.
31
32       -i <specification>, --input <specification>
33              Simulate  a  fake hierarchy (instead of discovering the topology
34              on the local machine). If <specification> is "node:2 pu:3",  the
35              topology  will contain two NUMA nodes with 3 processing units in
36              each of them.  The <specification> string must end with a number
37              of PUs.
38
39       --if <format>, --input-format <format>
40              Enforce  the  input  in  the given format, among xml, fsroot and
41              synthetic.
42
43       --restrict <cpuset>
44              Restrict the topology to the given cpuset.
45
46       -v     Verbose messages.
47
48       --version
49              Report version and exit.
50

DESCRIPTION

52       hwloc-distances displays also distance matrices attached to the  topol‐
53       ogy.   A  breadth-first traversal of the topology is performed starting
54       from the root to find all distance matrices.
55
56       NOTE: lstopo may also display distance matrices in its verbose  textual
57       output.   However  lstopo  only  prints  matrices that cover the entire
58       topology while hwloc-distances also displays matrices that ignore  part
59       of the topology.
60

EXAMPLES

62       On a quad-socket opteron machine:
63
64           $ hwloc-distances
65           Latency matrix between 4 NUMANodes (depth 2) by logical indexes:
66             index     0     1     2     3
67                 0 1.000 1.600 2.200 2.200
68                 1 1.600 1.000 2.200 2.200
69                 2 2.200 2.200 1.000 1.600
70                 3 2.200 2.200 1.600 1.000
71

RETURN VALUE

73       Upon successful execution, hwloc-distances returns 0.
74
75       hwloc-distances  will  return nonzero if any kind of error occurs, such
76       as (but not limited to) failure to parse the command line.
77

SEE ALSO

79       hwloc(7), lstopo(1)
80
81
82
83
841.5                              Jul 30, 2012               HWLOC-DISTANCES(1)
Impressum