[svn-r14284] Description:
Add H5Lvisit_by_name() API routine to library.
Eliminated all (five!) other group traversal routines and changed them
all to use the new API routine.
Cleaned up output of h5ls & h5stat:
- Issue error when requesting recursive traversal of a file
with the "group info" flag, but no group given
- Print info about root group in all(?) appropriate situations
- Don't print "verbose" information about root group until the
root group is in the list of objects to display
(mostly because h5ls & h5stat had a different twist on traversing the
groups in a file that the other utilities)
Tested on:
FreeBSD/32 6.2 (duty) in debug mode
FreeBSD/64 6.2 (liberty) w/C++ & FORTRAN, in debug mode
Linux/32 2.6 (kagiso) w/PGI compilers, w/C++ & FORTRAN, w/threadsafe,
in debug mode
Linux/64-amd64 2.6 (smirom) w/default API=1.6.x, w/C++ & FORTRAN,
in production mode
Linux/64-ia64 2.6 (cobalt) w/Intel compilers, w/C++ & FORTRAN,
in production mode
Solaris/32 2.10 (linew) w/deprecated symbols disabled, w/C++ & FORTRAN,
w/szip filter, in production mode
Mac OS X/32 10.4.10 (amazon) in debug mode
Linux/64-ia64 2.4 (tg-login3) w/parallel, w/FORTRAN, in production mode
2007-11-25 00:49:36 +08:00
|
|
|
Error: 'recursive' option not compatible with 'group info' option!
|
|
|
|
|
|
|
|
usage: h5ls [OPTIONS] [OBJECTS...]
|
2010-06-02 23:13:13 +08:00
|
|
|
OPTIONS
|
2010-07-08 02:52:04 +08:00
|
|
|
-h, -?, --help Print a usage message and exit
|
2011-03-11 23:48:24 +08:00
|
|
|
-a, --address Print raw data address. If dataset is contiguous, address
|
|
|
|
is offset in file of beginning of raw data. If chunked,
|
|
|
|
returned list of addresses indicates offset of each chunk.
|
|
|
|
Must be used with -v, --verbose option.
|
|
|
|
Provides no information for non-dataset objects.
|
2010-07-08 02:52:04 +08:00
|
|
|
-d, --data Print the values of datasets
|
[svn-r20378] Purpose:
Bug 2182 - h5ls and h5dump: update to use --enable-error-stack among tools, also update related descriptions
Description:
Decided to use --enable-error-stack long option name only to
display error stack messages from HDF5 lib among tools.
Updated to unify option name to '--enable-error-stack' for printing
HDF5 error stack messages for HDF5 tools. h5ls and h5dump for now.
For h5ls, this replaces "-e/--errors" option, which is deprecated.
For h5dump, remove -E from help page and RM , which was added by mistake
before release1.8.7.
Help page and RM got updated.
Updated test case.
Tested:
jam (linux32-LE), amani (linux64-LE), heiwa (linuxppc64-BE), tejeda (mac32-LE), linew (solaris-BE), Windows (32-LE)
2011-03-31 00:06:14 +08:00
|
|
|
--enable-error-stack
|
|
|
|
Prints messages from the HDF5 error stack as they occur.
|
2010-07-08 02:52:04 +08:00
|
|
|
--follow-symlinks
|
|
|
|
Follow symbolic links (soft links and external links)
|
|
|
|
to display target object information.
|
|
|
|
Without this option, h5ls identifies a symbolic link
|
|
|
|
as a soft link or external link and prints the value
|
|
|
|
assigned to the symbolic link; it does not provide any
|
|
|
|
information regarding the target object or determine
|
|
|
|
whether the link is a dangling link.
|
|
|
|
--no-dangling-links
|
|
|
|
Must be used with --follow-symlinks option;
|
|
|
|
otherwise, h5ls shows error message and returns an exit
|
|
|
|
code of 1.
|
|
|
|
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 h5ls returns an exit code of 1.
|
|
|
|
-f, --full Print full path names instead of base names
|
|
|
|
-g, --group Show information about a group, not its contents
|
|
|
|
-l, --label Label members of compound datasets
|
|
|
|
-r, --recursive List all groups recursively, avoiding cycles
|
|
|
|
-s, --string Print 1-byte integer datasets as ASCII
|
|
|
|
-S, --simple Use a machine-readable output format
|
|
|
|
-wN, --width=N Set the number of columns of output
|
|
|
|
-v, --verbose Generate more verbose output
|
|
|
|
-V, --version Print version number and exit
|
|
|
|
--vfd=DRIVER Use the specified virtual file driver
|
|
|
|
-x, --hexdump Show raw data in hexadecimal format
|
[svn-r14284] Description:
Add H5Lvisit_by_name() API routine to library.
Eliminated all (five!) other group traversal routines and changed them
all to use the new API routine.
Cleaned up output of h5ls & h5stat:
- Issue error when requesting recursive traversal of a file
with the "group info" flag, but no group given
- Print info about root group in all(?) appropriate situations
- Don't print "verbose" information about root group until the
root group is in the list of objects to display
(mostly because h5ls & h5stat had a different twist on traversing the
groups in a file that the other utilities)
Tested on:
FreeBSD/32 6.2 (duty) in debug mode
FreeBSD/64 6.2 (liberty) w/C++ & FORTRAN, in debug mode
Linux/32 2.6 (kagiso) w/PGI compilers, w/C++ & FORTRAN, w/threadsafe,
in debug mode
Linux/64-amd64 2.6 (smirom) w/default API=1.6.x, w/C++ & FORTRAN,
in production mode
Linux/64-ia64 2.6 (cobalt) w/Intel compilers, w/C++ & FORTRAN,
in production mode
Solaris/32 2.10 (linew) w/deprecated symbols disabled, w/C++ & FORTRAN,
w/szip filter, in production mode
Mac OS X/32 10.4.10 (amazon) in debug mode
Linux/64-ia64 2.4 (tg-login3) w/parallel, w/FORTRAN, in production mode
2007-11-25 00:49:36 +08:00
|
|
|
|
2010-06-02 23:13:13 +08:00
|
|
|
OBJECTS
|
|
|
|
Each object consists of an HDF5 file name optionally followed by a
|
|
|
|
slash and an object name within the file (if no object is specified
|
|
|
|
within the file then the contents of the root group are displayed).
|
|
|
|
The file name may include a printf(3C) integer format such as
|
|
|
|
"%05d" to open a file family.
|
|
|
|
|
|
|
|
Deprecated Options
|
|
|
|
The following options have been deprecated in HDF5. While they remain
|
|
|
|
available, they have been superseded as indicated and may be removed
|
|
|
|
from HDF5 in the future. Use the indicated replacement option in all
|
|
|
|
new work; where possible, existing scripts, et cetera, should also be
|
|
|
|
updated to use the replacement option.
|
|
|
|
|
|
|
|
-E or --external Follow external links.
|
|
|
|
Replaced by --follow-symlinks.
|
[svn-r20378] Purpose:
Bug 2182 - h5ls and h5dump: update to use --enable-error-stack among tools, also update related descriptions
Description:
Decided to use --enable-error-stack long option name only to
display error stack messages from HDF5 lib among tools.
Updated to unify option name to '--enable-error-stack' for printing
HDF5 error stack messages for HDF5 tools. h5ls and h5dump for now.
For h5ls, this replaces "-e/--errors" option, which is deprecated.
For h5dump, remove -E from help page and RM , which was added by mistake
before release1.8.7.
Help page and RM got updated.
Updated test case.
Tested:
jam (linux32-LE), amani (linux64-LE), heiwa (linuxppc64-BE), tejeda (mac32-LE), linew (solaris-BE), Windows (32-LE)
2011-03-31 00:06:14 +08:00
|
|
|
-e, --errors Show all HDF5 error reporting
|
|
|
|
Replaced by --enable-error-stack.
|