Help us improve by taking our short survey: https://www.hdfgroup.org/website-survey/

| HDF5 Last Updated on 2026-03-23 The HDF5 Field Guide

Loading...
Searching...
No Matches
The HDF5 h5stat Tool

Navigate back: Main / HDF5 User Guide / Command Line Tools for HDF5 Files

# h5stat

## Introduction

With h5stat, you can dump stats from an HDF5 file.

## Usage

#### h5stat [OPTIONS] file

## Error Report Option

- –enable-error-stack Prints messages from the HDF5 error stack as they occur. Optional value 2 also prints file open errors, –enable-error-stack=2.

## Options

- –help Print a usage message and exit
- –version Print the library version number and exit
- –file Print file information
- –filemetadata Print file space information for file's metadata
- –group Print group information
- –links=N Set the threshold for the # of links when printing information for small groups. N is an integer greater than 0. The default threshold is 10.
- –groupmetadata Print file space information for groups' metadata
- –dset Print dataset information
- –dims=N Set the threshold for the dimension sizes when printing information for small datasets. N is an integer greater than 0. The default threshold is 10.
- –dsetmetadata Print file space information for datasets' metadata
- –dtypemetadata Print datasets' datatype information
- –attribute Print attribute information
- –numattrs=N Set the threshold for the number of attributes when printing information for small number of attributes. N is an integer greater than 0. The default threshold is 10.
- –freespace Print free space information
- –summary Print summary of file space information
- –page-buffer-size=N Set the page buffer cache size, N=non-negative integers
- –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'.
  If an attribute is empty, a default value will be used.
- –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

Previous Chapter h5repack - Next Chapter h5clear

Navigate back: Main / HDF5 User Guide / Command Line Tools for HDF5 Files