hwloc-diff (1) - Linux Manuals
hwloc-diff: Compute differences between two XML topologies
NAME
hwloc-diff - Compute differences between two XML topologiesSYNOPSIS
hwloc-diff [options] <input1.xml> <input2.xml>
hwloc-diff [options] <input1.xml> <input2.xml> <output.xml>
OPTIONS
- --refname <name>
- Use <name> as the identifier for the reference topology in the output XML difference. It is meant to tell which topology should be used when applying the resulting difference. hwloc-patch may use that name to automatically load the relevant reference topology XML. By default, <input1.xml> is used without its full path.
- --version
- Report version and exit.
DESCRIPTION
hwloc-diff computes the difference between two XML topologies and stores the result into <output.xml> if any, or dumps it to stdout otherwise.The output difference may later be applied to another topology with hwloc-patch.
hwloc-compress-dir may be used for computing the diffs between all XML files in a directory.
NOTE: It is highly recommended that you read the hwloc(7) overview page before reading this man page. Most of the concepts described in hwloc(7) directly apply to the hwloc-diff utility.
EXAMPLES
hwloc-diff's operation is best described through several examples.
Compute the difference between two XML topologies and output it to stdout:
Output the difference to file diff.xml instead:
When the difference is too complex to be represented:
Directly compute the difference between two topologies and apply it
to another one:
If the difference is too complex to be represented, an error is returned
and the output is not generated.
hwloc-diff also returns nonzero if any kind of error occurs, such as
(but not limited to) failure to parse the command line.
RETURN VALUE
Upon successful execution, hwloc-diff outputs the difference.
The return value is 0.