OS Manuals

/usr/bin/h5ls

hdf5 tools

From hdf5-tools 2.2.0-r4 (os), captured 2026-11-05 by running h5ls --help (exit 0). permalink

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
                   Print 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
   --page-buffer-size=N Set the page buffer cache size, N=non-negative integers
   --vfd=DRIVER    Use the specified virtual file driver
   -x, --hexdump   Show raw data in hexadecimal format
   --endpoint-url=P Supply S3 endpoint url information to "ros3" vfd.
                   P is the AWS service endpoint.
                   Has no effect if vfd flag not set to "ros3".
   --s3-cred=C     Supply S3 authentication information to "ros3" vfd.
                   Accepts tuple of "(<aws-region>,<access-id>,<access-key>)" or
                   "(<aws-region>,<access-id>,<access-key>,<session-token>)".
                   If absent or C->"(,,)" 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
                   If none of the above options are used to specify a VOL, then
                   the VOL named by HDF5_VOL_CONNECTOR (or the native VOL connector,
                   if that environment variable is unset) will be used
   --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.
Options (26)
OptionDescriptionSource
-h, -?, --helpPrint a usage message and exithelp
-a, --addressPrint raw data address.help
-d, --dataPrint the values of datasetshelp
--enable-error-stackPrint messages from the HDF5 error stack as they occur.help
--follow-symlinksFollow symbolic links (soft links and external links) to display target object information.help
--no-dangling-linksMust be used with --follow-symlinks option;help
-f, --fullPrint full path names instead of base nameshelp
-g, --groupShow information about a group, not its contentshelp
-l, --labelLabel members of compound datasetshelp
-s, --stringPrint 1-byte integer datasets as ASCIIhelp
-S, --simpleUse a machine-readable output formathelp
-wN, --width NSet the number of columns of outputhelp
-v, --verboseGenerate more verbose outputhelp
-V, --versionPrint version number and exithelp
--vfd DRIVERUse the specified virtual file driverhelp
-x, --hexdumpShow raw data in hexadecimal formathelp
--s3-cred CSupply S3 authentication information to "ros3" vfd.help
--hdfs-attrs ASupply configuration information to Hadoop VFD.help
--vol-valueValue (ID) of the VOL connector to use for opening the HDF5 file specifiedhelp
--vol-nameName of the VOL connector to use for opening the HDF5 file specifiedhelp
--vol-infoVOL-specific info to pass to the VOL connector used for opening the HDF5 file specified If none of the above options are used to specify a VOL, then the VOL named by HDF5_VOL_CONNECTOR (or the native…help
--vfd-valueValue (ID) of the VFL driver to use for opening the HDF5 file specifiedhelp
--vfd-nameName of the VFL driver to use for opening the HDF5 file specifiedhelp
--vfd-infoVFD-specific info to pass to the VFL driver used for opening the HDF5 file specifiedhelp
-E, --externalFollow external links.help
-e, --errorsShow all HDF5 error reporting Replaced by --enable-error-stack.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.