2013-02-05 23:11:47 +08:00
|
|
|
usage: h5ls [OPTIONS] file[/OBJECT] [file[/[OBJECT]...]
|
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
|
2019-12-05 06:36:32 +08:00
|
|
|
code of 1.
|
2010-07-08 02:52:04 +08:00
|
|
|
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
|
2019-07-26 00:36:37 +08:00
|
|
|
--s3-cred=C Supply S3 authentication information to "ros3" vfd.
|
|
|
|
Accepts tuple of "(<aws-region>,<access-id>,<access-key>)".
|
|
|
|
If absent or C->"(,,)", defaults to no-authentication.
|
|
|
|
Has no effect if vfd flag not set to "ros3".
|
|
|
|
--hdfs-attrs=A Supply configuration information to Hadoop VFD.
|
|
|
|
Accepts tuple of (<namenode name>,<namenode port>,
|
|
|
|
...<kerberos cache path>,<username>,<buffer size>)
|
|
|
|
If absent or A == '(,,,,)', all default values are used.
|
|
|
|
Has no effect if vfd flag is not 'hdfs'.
|
2020-04-22 02:36:10 +08:00
|
|
|
--vol-value Value (ID) of the VOL connector to use for opening the
|
|
|
|
HDF5 file specified
|
|
|
|
--vol-name Name of the VOL connector to use for opening the
|
|
|
|
HDF5 file specified
|
|
|
|
--vol-info VOL-specific info to pass to the VOL connector used for
|
|
|
|
opening the HDF5 file specified
|
2000-11-01 00:29:57 +08:00
|
|
|
|
2013-02-05 23:11:47 +08:00
|
|
|
file/OBJECT
|
2010-06-02 23:13:13 +08:00
|
|
|
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
|
2019-12-05 06:36:32 +08:00
|
|
|
The following options have been removed in HDF5 1.12. Use the indicated
|
|
|
|
replacement option in all work.
|
2010-06-02 23:13:13 +08:00
|
|
|
|
|
|
|
-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.
|