1HWLOC-COMPRESS-DIR(1)                hwloc               HWLOC-COMPRESS-DIR(1)
2
3
4

NAME

6       hwloc-compress-dir - Compress a directory of XML topologies
7

SYNOPSIS

9       hwloc-compress-dir [options] <inputdir> <outputdir>
10

OPTIONS

12       -R --reverse
13              Uncompress a previously compressed directory.
14
15       -v --verbose
16              Display verbose messages.
17
18       --version
19              Report version and exit.
20
21       -h --help
22              Display help message and exit.
23

DESCRIPTION

25       hwloc-compress-dir  takes an input directory containing XML exports and
26       tries to compress it by computing topology diffs between them (with the
27       hwloc-diff  program).   Each file is copied in the output directory ei‐
28       ther as a diff if it could be compressed, or  as  its  original  entire
29       file otherwise.
30
31       hwloc-compress-dir  may recompress a directory that was previously com‐
32       pressed. All input files that are already in the output directory,  ei‐
33       ther  compressed or not, are ignored. New input files are compressed as
34       much as possible as usual.
35
36       For each file of the directory, the output filename is the same as  the
37       original  if  not  compressed,  otherwise  its  extension is changed to
38       .diff.xml.
39
40       Compressed files are based on  another  non-compressed  topology.   Its
41       name is stored in the refname topology diff attribute.
42
43       The  generated output diff files may be used with hwloc-patch just like
44       any file generated by hwloc-diff.
45

EXAMPLES

47       To compress the input files from directory in into directory out:
48
49           $ hwloc-compress-dir in out
50

RETURN VALUE

52       Upon successful execution, hwloc-compress-dir returns 0.
53
54       hwloc-compress-dir will return nonzero if any  kind  of  error  occurs,
55       such as (but not limited to) failure to parse the command line.
56

SEE ALSO

58       hwloc(7), lstopo(1), hwloc-diff(1), hwloc-patch(1)
59
60
61
62
632.5.0                            Jun 14, 2021            HWLOC-COMPRESS-DIR(1)
Impressum