mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-12-15 07:40:23 +08:00
af749bafb7
Add --no-dangling-links option to h5ls. Description: Related to "Bug 1830 - Following an dangling external link in h5ls should set non-zero return code." If --no-dangling-links option is specified and any dangling link is found, return exit code 1 (error). Tested: jam, amani and heiwa
57 lines
2.8 KiB
Plaintext
57 lines
2.8 KiB
Plaintext
#############################
|
|
output for 'h5ls -w80 -r -g tgroup.h5'
|
|
#############################
|
|
Error: 'recursive' option not compatible with 'group info' option!
|
|
|
|
usage: h5ls [OPTIONS] [OBJECTS...]
|
|
OPTIONS
|
|
-h, -?, --help Print a usage message and exit
|
|
-a, --address Print addresses for raw data
|
|
-d, --data Print the values of datasets
|
|
-e, --errors Show all HDF5 error reporting
|
|
--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
|
|
|
|
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.
|