hdf5/tools/testfiles/textlinksrc-nodangle-1.ls
jhendersonHDF 3da0802c40
VFD plugins (#602)
* Implement support for loading of Virtual File Drivers as plugins

Fix plugin caching for VOL connector and VFD plugins

Fix plugin iteration to skip paths that can't be opened

* Enable dynamic loading of VFDs with HDF5_DRIVER environment variable

* Temporarily disable error reporting during H5F_open double file open

* Default to using HDstat in h5_get_file_size for unknown VFDs

* Use macros for some environment variables that HDF5 interprets

* Update "null" and "ctl testing" VFDs
2021-09-29 13:28:12 -05:00

77 lines
4.2 KiB
Plaintext

usage: h5ls [OPTIONS] file[/OBJECT] [file[/[OBJECT]...]
OPTIONS
-h, -?, --help Print a usage message and exit
-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.
-d, --data Print the values of datasets
--enable-error-stack
Prints messages from the HDF5 error stack as they occur.
--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
--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'.
--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
--vfd-value Value (ID) of the VFL driver to use for opening the
HDF5 file specified
--vfd-name Name of the VFL driver to use for opening the
HDF5 file specified
--vfd-info VFD-specific info to pass to the VFL driver used for
opening the HDF5 file specified
file/OBJECT
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 removed in HDF5 1.12. Use the indicated
replacement option in all work.
-E or --external Follow external links.
Replaced by --follow-symlinks.
-e, --errors Show all HDF5 error reporting
Replaced by --enable-error-stack.