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

DESCRIPTION

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

EXAMPLES

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

RETURN VALUE

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

SEE ALSO

83       hwloc(7), lstopo(1), hwloc-patch(1), hwloc-compress-dir(1)
84
85
86
87
881.11.12                          Dec 13, 2018                    HWLOC-DIFF(1)
Impressum