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

NAME

6       hwloc-diff - Compute differences between two XML topologies
7

SYNOPSIS

9       hwloc-diff [options] <input1.xml> <input2.xml>
10
11       hwloc-diff [options] <input1.xml> <input2.xml> <output.xml>
12

OPTIONS

14       --refname <name>
15                 Use  <name>  as  the identifier for the reference topology in
16                 the output XML difference.  It is meant to tell which  topol‐
17                 ogy  should  be  used when applying the resulting difference.
18                 hwloc-patch may use that name to automatically load the rele‐
19                 vant  reference  topology  XML.   By default, <input1.xml> is
20                 used without its full path.
21
22       --version Report version and exit.
23
24       -h --help Display help message and exit.
25

DESCRIPTION

27       hwloc-diff computes the  difference  between  two  XML  topologies  and
28       stores  the result into <output.xml> if any, or dumps it to stdout oth‐
29       erwise.
30
31       The output difference may later be applied  to  another  topology  with
32       hwloc-patch.
33
34       hwloc-compress-dir  may be used for computing the diffs between all XML
35       files in a directory.
36
37       NOTE: If some application-specific userdata were been exported  to  the
38       input  XMLs, they will be ignored and discarded from the output because
39       hwloc has no way to understand and compare them.
40
41       NOTE: It is highly recommended that you read the hwloc(7) overview page
42       before  reading  this  man  page.   Most  of  the concepts described in
43       hwloc(7) directly apply to the hwloc-diff utility.
44

EXAMPLES

46       hwloc-diff's operation is best described through several examples.
47
48       Compute the difference between two XML topologies and output it to std‐
49       out:
50
51           $ hwloc-diff fourmi023.xml fourmi024.xml
52           Found 11 differences, exporting to stdout
53           <?xml version="1.0" encoding="UTF-8"?>
54           ...
55
56       Output the difference to file diff.xml instead:
57
58           $ hwloc-diff fourmi023.xml fourmi024.xml diff.xml
59           Found 11 differences, exporting to diff.xml
60
61       When the difference is too complex to be represented:
62
63           $ hwloc-diff fourmi023.xml avakas-frontend1.xml
64           Found 1 differences, including 1 too complex ones.
65           Cannot export differences to stdout
66
67       Directly  compute the difference between two topologies and apply it to
68       another one:
69
70           $   hwloc-diff   fourmi023.xml    fourmi024.xml    |    hwloc-patch
71       fourmi025.xml -
72
73

RETURN VALUE

75       Upon  successful execution, hwloc-diff outputs the difference.  The re‐
76       turn value is 0.
77
78       If the difference is too complex to be represented,  an  error  is  re‐
79       turned and the output is not generated.
80
81       hwloc-diff  also  returns  nonzero if any kind of error occurs, such as
82       (but not limited to) failure to parse the command line.
83

SEE ALSO

85       hwloc(7), lstopo(1), hwloc-patch(1), hwloc-compress-dir(1)
86
87
88
89
902.10.0                           Dec 04, 2023                    HWLOC-DIFF(1)
Impressum