Page tree

 Release Information



Applications that were created with earlier HDF5 releases may not compile with 1.12 by default.

The API Compatibility Macros in HDF5 allow users to work around this issue. Users can specify a compatibility macro mapping for the version of HDF5 that an application was built with. For example, a 1.10 application can be built with 1.12 using either an application or library mapping as follows:

  • To compile an application built with a version of HDF5 that includes deprecated symbols (the default), make sure to pass -DH5_USE_110_API to the compiler. For example (C), you can specify h5cc -DH5_USE_110_API (autotools) and cmake -DCMAKE_C_FLAGS="-DH5_USE_110_API" (CMake).
  • To build an HDF5 library with the 1.10 APIs you must set DEFAULT_API_VERSION to v110 when configuring. For example, with autotools specify --with-default-api-version=v110 and with CMake set -DDEFAULT_API_VERSION:STRING=v110 in the HDF5options.cmake file when using the CMake source release (CMake-hdf5-1.12.1*).

However, users will not be able to take advantage of some of the new features in 1.12 if using these compatibility mappings.

See the Migrating from HDF5 1.10 to HDF5 1.12 page and video for more information.

Location of Software:

FileTypeCommentInstall InstructionsMd5 Checksum
hdf5-1.12.1.tar.gz Source release

Unix Gzipped source tar file. 

release_docs/ directory in source hdf5-1.12.1.md5
hdf5-1.12.1.tar.bz2 Source release

Unix Bzipped source tar file. 

release_docs/ directory in source   " Source releaseWindows zip filerelease_docs/ directory in source   "
CMake-hdf5-1.12.1.tar.gz CMake source release

File to build HDF5 with CMake (Unix).  See Methods to obtain (below).

Building HDF5 with CMake   " CMake source release File to build HDF5 with CMake on Windows
Building HDF5 with CMake    "
Ready to use BinariesBinary FilePre-built binary distributions for Unix and Windows  
HDF5 PluginsBinary FilePre-built HDF5 plugin distributions for Unix and WindowsInformation on HDF5 Filter Plugins 


Methods to obtain  (gz file)
  • firefox – Download file and then run:  gzip <distribution>.tar.gz | tar xzf -
  • chrome –  Download file and then run:  gzip -cd <distribution>.tar.gz | tar xvf -
  • wget – wget<distribution>.tar.gz
                gzip -cd <distribution>.tar.gz | tar xvf -

Doxygen Generated Reference Manual

The new HDF5 C-API documentation based on Doxygen is available at

Included are all core library functions documented in the current documentation with the exception of H5P[g,s]et_fapl_[hdfs,ros3].

Note that the Fortran-API is NOT included in this release, and will be included in a future release.  Online versions can be found at these URLs:

This documentation is WORK-IN-PROGRESS. That’s why all existing documentation will remain accessible for the foreseeable future.

Since this portion of the HDF5 documentation is now part of the source code, it gets the same treatment as code. In other words, issues, inaccuracies, corrections should be reported as issues in GitHub (, and pull requests will be reviewed and accepted as any other code changes.


Tested Platforms and Configuration Features

NOTE:  HDF5-1.12 requires MPI 3.

See the Supported Platforms section in the Release Notes for details.


Known Problems

A bug in the cray-mpich compiler had caused an HDF5 serial test to fail for the function H5Pset_data_transform. The bug description can be found here:
The issue has been reported to OLCF and the workaround has been applied.

--- Last Modified: April 26, 2022 | 03:34 PM