summaryrefslogtreecommitdiffstats
path: root/tools/h5diff/testfiles
diff options
context:
space:
mode:
authorJonathan Kim <jkm@hdfgroup.org>2011-07-08 15:53:10 (GMT)
committerJonathan Kim <jkm@hdfgroup.org>2011-07-08 15:53:10 (GMT)
commita3bf96ec3c0bd8e684e0c66e1bd6b92b509d0228 (patch)
treee8e9f5630993a961b6939093730946b4efd6e7d3 /tools/h5diff/testfiles
parent415d817ce6805f2c397f8c9d99b60ac418faf51a (diff)
downloadhdf5-a3bf96ec3c0bd8e684e0c66e1bd6b92b509d0228.zip
hdf5-a3bf96ec3c0bd8e684e0c66e1bd6b92b509d0228.tar.gz
hdf5-a3bf96ec3c0bd8e684e0c66e1bd6b92b509d0228.tar.bz2
[svn-r21077] Purpose:
Work for HDFFV-7600 - GMQS: h5diff - argument options -d, -p and --use-system-epsilon should be mutually exclusive. Description: Merge from HDF5 trunk r21072. Fixed h5diff to display instructive error message and exit with 1 when mutually exclusive options (-d, -p and --use-system-epsilon) are used together. Tested: jam (linux32-LE), koala (linux64-LE), heiwa (linuxppc64-BE), tejeda (mac32-LE), linew (solaris-BE), Cmake (jam)
Diffstat (limited to 'tools/h5diff/testfiles')
-rw-r--r--tools/h5diff/testfiles/h5diff_10.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_600.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_603.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_606.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_612.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_615.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_621.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_622.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_623.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_624.txt175
-rw-r--r--tools/h5diff/testfiles/h5diff_640.txt4
-rw-r--r--tools/h5diff/testfiles/h5diff_641.txt4
-rw-r--r--tools/h5diff/testfiles/h5diff_642.txt4
-rw-r--r--tools/h5diff/testfiles/h5diff_643.txt4
-rw-r--r--tools/h5diff/testfiles/h5diff_644.txt4
-rw-r--r--tools/h5diff/testfiles/h5diff_645.txt4
-rw-r--r--tools/h5diff/testfiles/h5diff_646.txt4
17 files changed, 908 insertions, 870 deletions
diff --git a/tools/h5diff/testfiles/h5diff_10.txt b/tools/h5diff/testfiles/h5diff_10.txt
index fd13a5c..a699f00 100644
--- a/tools/h5diff/testfiles/h5diff_10.txt
+++ b/tools/h5diff/testfiles/h5diff_10.txt
@@ -1,95 +1,96 @@
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_600.txt b/tools/h5diff/testfiles/h5diff_600.txt
index ecf73d8..3c3ad9f 100644
--- a/tools/h5diff/testfiles/h5diff_600.txt
+++ b/tools/h5diff/testfiles/h5diff_600.txt
@@ -1,95 +1,96 @@
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_603.txt b/tools/h5diff/testfiles/h5diff_603.txt
index 776c468..087764a 100644
--- a/tools/h5diff/testfiles/h5diff_603.txt
+++ b/tools/h5diff/testfiles/h5diff_603.txt
@@ -1,96 +1,97 @@
<-d -4> is not a valid option
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_606.txt b/tools/h5diff/testfiles/h5diff_606.txt
index 762698d..c31a67e 100644
--- a/tools/h5diff/testfiles/h5diff_606.txt
+++ b/tools/h5diff/testfiles/h5diff_606.txt
@@ -1,96 +1,97 @@
<-d 0x1> is not a valid option
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_612.txt b/tools/h5diff/testfiles/h5diff_612.txt
index c5b3464..05318bd 100644
--- a/tools/h5diff/testfiles/h5diff_612.txt
+++ b/tools/h5diff/testfiles/h5diff_612.txt
@@ -1,96 +1,97 @@
<-p -4> is not a valid option
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_615.txt b/tools/h5diff/testfiles/h5diff_615.txt
index 58d5c70..fd756b3 100644
--- a/tools/h5diff/testfiles/h5diff_615.txt
+++ b/tools/h5diff/testfiles/h5diff_615.txt
@@ -1,96 +1,97 @@
<-p 0x1> is not a valid option
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_621.txt b/tools/h5diff/testfiles/h5diff_621.txt
index 1c8f745..fd8c680 100644
--- a/tools/h5diff/testfiles/h5diff_621.txt
+++ b/tools/h5diff/testfiles/h5diff_621.txt
@@ -1,96 +1,97 @@
<-n -4> is not a valid option
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_622.txt b/tools/h5diff/testfiles/h5diff_622.txt
index 22f216f..f0d38af 100644
--- a/tools/h5diff/testfiles/h5diff_622.txt
+++ b/tools/h5diff/testfiles/h5diff_622.txt
@@ -1,96 +1,97 @@
<-n 0> is not a valid option
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_623.txt b/tools/h5diff/testfiles/h5diff_623.txt
index 5dce69c..4ab66a5 100644
--- a/tools/h5diff/testfiles/h5diff_623.txt
+++ b/tools/h5diff/testfiles/h5diff_623.txt
@@ -1,96 +1,97 @@
<-n u> is not a valid option
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_624.txt b/tools/h5diff/testfiles/h5diff_624.txt
index 863e422..f5e7ee3 100644
--- a/tools/h5diff/testfiles/h5diff_624.txt
+++ b/tools/h5diff/testfiles/h5diff_624.txt
@@ -1,96 +1,97 @@
<-n 0x1> is not a valid option
usage: h5diff [OPTIONS] file1 file2 [obj1[ obj2]]
- file1 File name of the first HDF5 file
- file2 File name of the second HDF5 file
- [obj1] Name of an HDF5 object, in absolute path
- [obj2] Name of an HDF5 object, in absolute path
+ file1 File name of the first HDF5 file
+ file2 File name of the second HDF5 file
+ [obj1] Name of an HDF5 object, in absolute path
+ [obj2] Name of an HDF5 object, in absolute path
OPTIONS
- -h, --help Print a usage message and exit.
- -V, --version Print version number and exit.
- -r, --report Report mode. Print differences.
- -v --verbose Verbose mode. Print differences information and list
- of objects.
- -vN --verbose=N Verbose mode with level. Print differences and list
- of objects.
- Level of detail depends on value of N:
- 0 : Identical to '-v' or '--verbose'.
- 1 : All level 0 information plus one-line attribute
- status summary.
- 2 : All level 1 information plus extended attribute
- status report.
- -q, --quiet Quiet mode. Do not produce output.
- --follow-symlinks Follow symbolic links (soft links and external links)
- and compare the links' target objects.
- If symbolic link(s) with the same name exist in the
- files being compared, then determine whether the
- target of each link is an existing object (dataset,
- group, or named datatype) or the link is a dangling
- link (a soft or external link pointing to a target
- object that does not yet exist).
- - If both symbolic links are dangling links, they
- are treated as being the same; by default, h5diff
- returns an exit code of 0. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If only one of the two links is a dangling link,
- they are treated as being different and h5diff
- returns an exit code of 1. If, however,
- --no-dangling-links is used with --follow-symlinks,
- this situation is treated as an error and h5diff
- returns an exit code of 2.
- - If both symbolic links point to existing objects,
- h5diff compares the two objects.
- If any symbolic link specified in the call to h5diff
- does not exist, h5diff treats it as an error and
- returns an exit code of 2.
- --no-dangling-links Must be used with --follow-symlinks option;
- otherwise, h5diff shows error message and returns
- an exit code of 2.
- Check for any symbolic links (soft links or external
- links) that do not resolve to an existing object
- (dataset, group, or named datatype). If any
- dangling link is found, this situation is treated as
- an error and h5diff returns an exit code of 2.
- -c, --compare List objects that are not comparable
- -N, --nan Avoid NaNs detection
- -n C, --count=C Print differences up to C number, C is a positive
- integer.
- -d D, --delta=D Print difference if (|a-b| > D), D is a positive
- number.
- -p R, --relative=R Print difference if (|(a-b)/b| > R), R is a positive
- number.
- --use-system-epsilon Print difference if (|a-b| > EPSILON), EPSILON is
- a system epsilon value.
- If the system epsilon is not defined, the below
- one of the following predefined values will be used:
- FLT_EPSILON = 1.19209E-07 for floating-point type
- DBL_EPSILON = 2.22045E-16 for double percision type
- --exclude-path "path" Exclude the specified path to an object when
- comparing files or groups. If a group is excluded,
- all member objects will also be excluded.
- The specified path is excluded wherever it occurs.
- This flexibility enables the same option to exclude
- either objects that exist only in one file or
- common objects that are known to differ.
+ -h, --help
+ Print a usage message and exit.
+ -V, --version
+ Print version number and exit.
+ -r, --report
+ Report mode. Print differences.
+ -v --verbose
+ Verbose mode. Print differences information and list of objects.
+ -vN --verbose=N
+ Verbose mode with level. Print differences and list of objects.
+ Level of detail depends on value of N:
+ 0 : Identical to '-v' or '--verbose'.
+ 1 : All level 0 information plus one-line attribute
+ status summary.
+ 2 : All level 1 information plus extended attribute
+ status report.
+ -q, --quiet
+ Quiet mode. Do not produce output.
+ --follow-symlinks
+ Follow symbolic links (soft links and external links and compare the)
+ links' target objects.
+ If symbolic link(s) with the same name exist in the files being
+ compared, then determine whether the target of each link is an existing
+ object (dataset, group, or named datatype) or the link is a dangling
+ link (a soft or external link pointing to a target object that does
+ not yet exist).
+ - If both symbolic links are dangling links, they are treated as being
+ the same; by default, h5diff returns an exit code of 0.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If only one of the two links is a dangling link,they are treated as
+ being different and h5diff returns an exit code of 1.
+ If, however, --no-dangling-links is used with --follow-symlinks,
+ this situation is treated as an error and h5diff returns an
+ exit code of 2.
+ - If both symbolic links point to existing objects, h5diff compares the
+ two objects.
+ If any symbolic link specified in the call to h5diff does not exist,
+ h5diff treats it as an error and returns an exit code of 2.
+ --no-dangling-links
+ Must be used with --follow-symlinks option; otherwise, h5diff shows
+ error message and returns an exit code of 2.
+ Check for any symbolic links (soft links or external links) that do not
+ resolve to an existing object (dataset, group, or named datatype).
+ If any dangling link is found, this situation is treated as an error
+ and h5diff returns an exit code of 2.
+ -c, --compare
+ List objects that are not comparable
+ -N, --nan
+ Avoid NaNs detection
+ -n C, --count=C
+ Print differences up to C. C must be a positive integer.
+ -d D, --delta=D
+ Print difference if (|a-b| > D). D must be a positive number.
+ Can not use with '-p' or '--use-system-epsilon'.
+ -p R, --relative=R
+ Print difference if (|(a-b)/b| > R). R must be a positive number.
+ Can not use with '-d' or '--use-system-epsilon'.
+ --use-system-epsilon
+ Print difference if (|a-b| > EPSILON), EPSILON is system defined value.
+ If the system epsilon is not defined,one of the following predefined
+ values will be used:
+ FLT_EPSILON = 1.19209E-07 for floating-point type
+ DBL_EPSILON = 2.22045E-16 for double precision type
+ Can not use with '-p' or '-d'.
+ --exclude-path "path"
+ Exclude the specified path to an object when comparing files or groups.
+ If a group is excluded, all member objects will also be excluded.
+ The specified path is excluded wherever it occurs.
+ This flexibility enables the same option to exclude either objects that
+ exist only in one file or common objects that are known to differ.
- When comparing files, "path" is the absolute path to
- the excluded object; when comparing groups, "path" is
- similar to the relative path from the group to the
- excluded object. This "path" can be taken from the
- first section of the output of the --verbose option.
- For example, if you are comparing the group /groupA
- in two files and you want to exclude
- /groupA/groupB/groupC in both files, the exclude
- option would read as follows:
- --exclude-path "/groupB/groupC"
+ When comparing files, "path" is the absolute path to the excluded;
+ object; when comparing groups, "path" is similar to the relative
+ path from the group to the excluded object. This "path" can be
+ taken from the first section of the output of the --verbose option.
+ For example, if you are comparing the group /groupA in two files and
+ you want to exclude /groupA/groupB/groupC in both files, the exclude
+ option would read as follows:
+ --exclude-path "/groupB/groupC"
- If there are multiple paths to an object, only the
- specified path(s) will be excluded; the comparison
- will include any path not explicitly excluded.
- This option can be used repeatedly to exclude
- multiple paths.
+ If there are multiple paths to an object, only the specified path(s)
+ will be excluded; the comparison will include any path not explicitly
+ excluded.
+ This option can be used repeatedly to exclude multiple paths.
Modes of output:
Default mode: print the number of differences found and where they occured
diff --git a/tools/h5diff/testfiles/h5diff_640.txt b/tools/h5diff/testfiles/h5diff_640.txt
new file mode 100644
index 0000000..4c956a6
--- /dev/null
+++ b/tools/h5diff/testfiles/h5diff_640.txt
@@ -0,0 +1,4 @@
+h5diff error: -d, -p and --use-system-epsilon options are mutually-exclusive;
+use no more than one.
+Try '-h' or '--help' option for more information or see the h5diff entry in the 'HDF5 Reference Manual'.
+EXIT CODE: 1
diff --git a/tools/h5diff/testfiles/h5diff_641.txt b/tools/h5diff/testfiles/h5diff_641.txt
new file mode 100644
index 0000000..4c956a6
--- /dev/null
+++ b/tools/h5diff/testfiles/h5diff_641.txt
@@ -0,0 +1,4 @@
+h5diff error: -d, -p and --use-system-epsilon options are mutually-exclusive;
+use no more than one.
+Try '-h' or '--help' option for more information or see the h5diff entry in the 'HDF5 Reference Manual'.
+EXIT CODE: 1
diff --git a/tools/h5diff/testfiles/h5diff_642.txt b/tools/h5diff/testfiles/h5diff_642.txt
new file mode 100644
index 0000000..4c956a6
--- /dev/null
+++ b/tools/h5diff/testfiles/h5diff_642.txt
@@ -0,0 +1,4 @@
+h5diff error: -d, -p and --use-system-epsilon options are mutually-exclusive;
+use no more than one.
+Try '-h' or '--help' option for more information or see the h5diff entry in the 'HDF5 Reference Manual'.
+EXIT CODE: 1
diff --git a/tools/h5diff/testfiles/h5diff_643.txt b/tools/h5diff/testfiles/h5diff_643.txt
new file mode 100644
index 0000000..4c956a6
--- /dev/null
+++ b/tools/h5diff/testfiles/h5diff_643.txt
@@ -0,0 +1,4 @@
+h5diff error: -d, -p and --use-system-epsilon options are mutually-exclusive;
+use no more than one.
+Try '-h' or '--help' option for more information or see the h5diff entry in the 'HDF5 Reference Manual'.
+EXIT CODE: 1
diff --git a/tools/h5diff/testfiles/h5diff_644.txt b/tools/h5diff/testfiles/h5diff_644.txt
new file mode 100644
index 0000000..4c956a6
--- /dev/null
+++ b/tools/h5diff/testfiles/h5diff_644.txt
@@ -0,0 +1,4 @@
+h5diff error: -d, -p and --use-system-epsilon options are mutually-exclusive;
+use no more than one.
+Try '-h' or '--help' option for more information or see the h5diff entry in the 'HDF5 Reference Manual'.
+EXIT CODE: 1
diff --git a/tools/h5diff/testfiles/h5diff_645.txt b/tools/h5diff/testfiles/h5diff_645.txt
new file mode 100644
index 0000000..4c956a6
--- /dev/null
+++ b/tools/h5diff/testfiles/h5diff_645.txt
@@ -0,0 +1,4 @@
+h5diff error: -d, -p and --use-system-epsilon options are mutually-exclusive;
+use no more than one.
+Try '-h' or '--help' option for more information or see the h5diff entry in the 'HDF5 Reference Manual'.
+EXIT CODE: 1
diff --git a/tools/h5diff/testfiles/h5diff_646.txt b/tools/h5diff/testfiles/h5diff_646.txt
new file mode 100644
index 0000000..4c956a6
--- /dev/null
+++ b/tools/h5diff/testfiles/h5diff_646.txt
@@ -0,0 +1,4 @@
+h5diff error: -d, -p and --use-system-epsilon options are mutually-exclusive;
+use no more than one.
+Try '-h' or '--help' option for more information or see the h5diff entry in the 'HDF5 Reference Manual'.
+EXIT CODE: 1