This document is designed to help developers maintain HDF5-based applications as they are used with successive releases of HDF5. To that end, this document lists the changes at each release (For a description of the major new features that were introduced, please see New Features in HDF5 Release 1.10.)
This page provides information on the changes that a maintenance developer needs to be aware of between successive releases of HDF5, such as:
- New or changed features or tools
- Syntax and behavioral changes in the existing application programming interface (the API)
- Certain types of changes in configuration or build processes
Bug Note that bug fixes and performance enhancements in the C library are automatically picked up by the C++, Fortran, and Java libraries.
The following information is included below.
- Compatiblity and Performance Issues
- Release 1.10.7 versus 1.10.6
- Release 1.10.6 versus 1.10.5
- Release 1.10.4 versus Release 1.10.3
- Release 1.10.3 versus Release 1.10.2
| Anchor | ||||
|---|---|---|---|---|
|
Not all HDF5-1.10 releases are compatible. Users should NOT be using 1.10 releases prior to HDF5-1.10.3. See the compatibility matrix below for details on compatibility between 1.10 releases:
| Release | 1.10.5+ | 1.10.4 | 1.10.3 | 1.10.2 | 1.10.1 | 1.10.0-patch1 | 1.10.0 |
|---|---|---|---|---|---|---|---|
| 1.10.5+ | Yes | Yes | No | No | No | No | |
| 1.10.4 | Yes | Yes | No | No | No | No | |
| 1.10.3 | Yes | Yes | No | No | No | No | |
| 1.10.2 | No | No | No | No | No | No |
The following images show how performance has changed from release to release.
The release notes also list changes made to the library, but these notes tend to be more at a more detail-oriented level. The release notes may include new features, bugs fixed, supported configuration features, platforms on which the library has been tested, and known problems. The release note files are listed below and can be found at the top level of the HDF5 source code tree in the release_docs directory of the distributed HDF5 source code.
Technical notes regarding the current release of the HDF5 library ( | ||
| Release information for all HDF5-1.10 releases | |
| Development history between the HDF5-1.8.0 and HDF5-1.10.0 releases | |
| 10
| Release information for HDF5-1.8.0 through HDF5-1.8.17 releases |
| Technical notes starting with HDF5-1.0.0 and ending with HDF5-1.8.0-rc3 (the state of the code prior to the HDF5-1.8.0 release) |
Information for the following releases is included:
| Anchor | ||||
|---|---|---|---|---|
|
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
In the C Interface (main library)
The following are new C functions in this release:
| Function | Description |
|---|---|
| H5P_GET_FAPL_SPLITTER | Retrieves information for a splitter file access property list |
| H5P_SET_FAPL_SPLITTER | Sets the file access property list to use the splitter driver |
| H5P_GET_FILE_LOCKING | Gets the file locking property values |
| H5P_SET_FILE_LOCKING | Sets the file locking property values |
| H5_GET_ALLOC_STATS | Gets the memory allocation statistics for the library |
| H5_GET_FREE_LIST_SIZES | Gets the current size of the free lists used to manage memory |
| H5S_COMBINE_HYPERSLAB | Performs an operation on a hyperslab and an existing selection and returns the resulting selection |
| H5S_COMBINE_SELECT | Combines two hyperslab selections with an operation, returning a dataspace with the resulting selection |
| H5S_MODIFY_SELECT | Refines a hyperslab selection with an operation using a second hyperslab to modify it |
| H5S_SELECT_ADJUST | Adjusts a selection by subtracting an offset |
| H5S_SELECT_COPY | Copies a selection from one dataspace to another |
| H5S_SELECT_INTERSECT_BLOCK | Checks if current selection intersects with a block |
| H5S_SELECT_PROJECT_INTERSECTION | Projects the intersection of two source selections to a destination selection |
| H5S_SELECT_SHAPE_SAME | Checks if two selections are the same shape |
In the C++ Wrapper
The following C++ wrappers were added:
| Wrapper | Description |
|---|---|
| FileAccPropList::getFileLocking | See H5P_GET_FILE_LOCKING for details |
| FileAccPropList::setFileLocking | See H5P_SET_FILE_LOCKING for details |
Compatibility Notes and Reports
See the API compatibility report for the HDF5 library between 1.10.6 and 1.10.7 for information regarding compatibility with the previous release. The API Compatibility Report page includes all 1.10 compatibility reports.
| Anchor | ||||
|---|---|---|---|---|
|
...
6 versus
...
1.10.5
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
In the C Interface (main library)
The following are new C functions in this release:
| Function | Description |
|---|---|
| H5P_GET_FAPL_HDFS | Gets the information of the given Read-Only HDFS virtual file driver |
| H5P_GET_FAPL_ROS3 | Gets the information of the given Read-Only S3 virtual file driver |
| H5P_SET_FAPL_HDFS | Sets up Read-Only HDFS virtual file driver |
| H5P_SET_FAPL_ROS3 | Sets up Read-Only S3 virtual file driver |
In the C++ Wrapper
The following C++ wrapper was added:
| Wrapper | Description |
|---|---|
| LinkCreatPropList::getCreateIntermediateGroup ( ) const | See H5P_GET_CREATE_INTERMEDIATE_GROUP |
| LinkCreatPropList::setCreateIntermediateGroup ( bool crt_intmd_group ) const | See H5P_SET_CREATE_INTERMEDIATE_GROUP |
Compatibility Notes and Reports
See the API Compatibility Report for information regarding compatibility with previous releases.
| Anchor | ||||
|---|---|---|---|---|
|
...
5 versus
...
1.10.
...
Release 1.10.0 of March 2016 versus Release 1.8.16
...
4, 1.10.3, and 1.10.2
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
In the C Interface (main library)
The following are new C functions in this release:
| Function | Description |
|---|---|
| H5D_GET_CHUNK_INFO | Retrieves information about a chunk specified by the chunk index |
| H5D_GET_CHUNK_INFO_BY_COORD | Retrieves information about a chunk specified by its coordinates |
| H5D_GET_NUM_CHUNKS | Retrieves number of chunks that have nonempty intersection with a specified selection |
Retrieves the setting for determining whether the specified file does or does not create minimized dataset object headers | |
Sets the flag to create minimized dataset object headers | |
Retrieves the setting for determining whether the specified DCPL does or does not create minimized dataset object headers | |
Sets the flag to create minimized dataset object headers |
The following changed in this release:
| Function | Description |
|---|---|
H5O_GET_INFO, H5O_GET_INFO_BY_NAME, H5O_GET_INFO_BY_IDX, H5O_VISIT, H5O_VISIT_BY_NAME | In 1.10.3 the original functions were versioned to H5Oget_info*1 and H5Ovisit*1 and the macros H5Oget_info* and H5Ovisit* were created. This broke the API compatibility for a maintenance release. In HDF5-1.10.5, the macros introduced in HDF5-1.10.3 were removed. The H5Oget_info*1 and H5Ovisit*1 APIs were copied to H5Oget_Info* and H5Ovisit*. As an example, H5Oget_info and H5Oget_info1 are identical in this release. |
In the C++ Wrapper
The following C++ wrapper was added:
| C++ Wrapper | Description |
|---|---|
H5Object::visit() | Wrapper for the C API H5O_VISIT2. Recursively visit elements reachable from an HDF5 object and perform a common set of operations across all of those elements. See H5O_VISIT2 for more information on this function. |
In the Fortran Wrapper
The following Fortran wrappers were added or changed:
| Fortran Wrapper | Description |
|---|---|
h5fget_dset_no_attrs_hint_f h5fset_dset_no_attrs_hint_f h5pget_dset_no_attrs_hint_f h5pset_dset_no_attrs_hint_f | Wrappers for the dataset object header minimization calls. See H5F_GET_DSET_NO_ATTRS_HINT, H5F_SET_DSET_NO_ATTRS_HINT, H5P_GET_DSET_NO_ATTRS_HINT, and H5P_SET_DSET_NO_ATTRS_HINT. |
h5ovisit_f h5oget_info_by_name_f h5oget_info h5oget_info_by_idx h5ovisit_by_name_f | Added new Fortran 'fields' optional parameter. See H5O_VISIT2, H5O_GET_INFO_BY_NAME2, H5O_GET_INFO2, H5O_GET_INFO_BY_IDX2, and H5O_VISIT_BY_NAME2. |
The following Fortran utility function was added:
| Function | Description |
|---|---|
| h5gmtime | converts (C) 'time_t' structure to Fortran DATE AND TIME storage format |
A new Fortran derived type was added:
| Derived Type | Description |
|---|---|
| c_h5o_info_t | This is interoperable with C's h5o_info_t. This is needed for callback functions which pass C's h5o_info_t data type definition. See the Fortran signature for H5O_GET_INFO2. |
In the Java wrapper
The following Java wrappers were added or changed:
| Java Wrapper | Description |
|---|---|
| H5Fset_libver_bounds | See the C API H5F_SET_LIBVER_BOUNDS for information on this function |
H5Fget_dset_no_attrs_hint H5Fset_dset_no_attrs_hint H5Pget_dset_no_attrs_hint H5Pset_dset_no_attrs_hint | Wrappers for the dataset object header minimization calls See H5F_GET_DSET_NO_ATTRS_HINT, H5F_SET_DSET_NO_ATTRS_HINT, H5P_GET_DSET_NO_ATTRS_HINT, and H5P_SET_DSET_NO_ATTRS_HINT for more information on these APIs. |
Compatibility Notes and Reports
See these API Compatibility Reports for 1.10 for information regarding compatibility with previous releases. Reports are available comparing HDF5-1.10.5 vs 1.10.2, HDF5-1.10.5 vs 1.10.3, and HDF5-1.10.5 vs 1.10.4.
| Anchor | ||||
|---|---|---|---|---|
|
See the API compatibility Report for information regarding compatibility with previous releases
| Anchor | ||||
|---|---|---|---|---|
|
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
In the C Interface (main library)
The following are new C functions in this release:
| Function | Description |
|---|---|
| H5D_READ_CHUNK | Moved from HDF5 High Level Optimizations library to core library |
| H5D_WRITE_CHUNK | Moved from HDF5 High Level Optimizations library to core library |
| The function H5O_GET_INFO was moved to H5O_GET_INFO1, and the macro H5O_GET_INFO was created that can be mapped to either H5O_GET_INFO1 or H5O_GET_INFO2. For HDF5-1.10 and earlier releases, H5O_GET_INFO is mapped to H5O_GET_INFO1 by default. | |
| The function H5O_GET_INFO_BY_IDX was moved to H5O_GET_INFO_BY_IDX1, and the macro H5O_GET_INFO_BY_IDX was created that can be mapped to either H5O_GET_INFO_BY_IDX1 or H5O_GET_INFO_BY_IDX2. For HDF5-1.10 and earlier releases, H5O_GET_INFO_BY_IDX is mapped to H5O_GET_INFO_BY_IDX1 by default. | |
| The function H5O_GET_INFO_BY_NAME was moved to H5O_GET_INFO_BY_NAME1, and the macro H5O_GET_INFO_BY_NAME was created that can be mapped to either H5O_GET_INFO_BY_NAME1 or H5O_GET_INFO_BY_NAME2. For HDF5-1.10 and earlier releases, H5O_GET_INFO_BY_NAME is mapped to H5O_GET_INFO_BY_NAME1 by default. | |
| The function H5O_VISIT was moved to H5O_VISIT1, and the macro H5O_VISIT was created that can be mapped to either H5O_VISIT1 or H5O_VISIT2. For HDF5-1.10 and earlier releases, H5O_VISIT is mapped to H5O_VISIT1 by default. | |
| The function H5O_VISIT_BY_NAME was moved to H5O_VISIT_BY_NAME1, and the macro H5O_VISIT_BY_NAME was created that can be mapped to either H5O_VISIT_BY_NAME1 or H5O_VISIT_BY_NAME2. For HDF5-1.10 and earlier releases, H5O_VISIT_BY_NAME is mapped to H5O_VISIT_BY_NAME1 by default. |
In the C High Level Interface
The following C functions were deprecated in this release:
| Function | Description |
|---|---|
| H5DO_READ_CHUNK | Deprecated, moved to H5D_READ_CHUNK |
| H5DO_WRITE_CHUNK | Deprecated, moved to H5D_WRITE_CHUNK |
In the C++ Wrapper
Several C++ wrappers were added or modified to provide additional support. See the API Compatibility Report for details.
Compatibility Notes and Report
See the API Compatibility Report for information regarding compatibility with previous releases.
| Anchor | ||||
|---|---|---|---|---|
|
This section lists interface-level changes and other user-visible changes in behavior in the transition from HDF5 Release 1.10.1 to Release 1.10.2.
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
In the C Interface (main library)
...
--enable-error-stack | Enable the error stack |
Compatibility Notes and Report
The following interface compatibility report provides a full list of the changed symbols:
...
...
...
for information regarding compatibility with previous releases.
| Anchor | ||||
|---|---|---|---|---|
|
...
| Retrieves the maximum size for the page buffer and the minimum percentage for metadata and raw data pages. |
| Sets the maximum size for the page buffer and the minimum percentage for metadata and raw data pages. |
| Retrieves statistics about page access when it is enabled. |
| Resets the page buffer statistics. |
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
In the C Interface (main library)
...
Compatibility report for Release 1.10.1 versus Release 1.10.0-patch1
| Bitbucket Server file | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
API compatibility report for the HDF5 Library between 1.10.1 and 1.10.0-patch1 versions on
See API Compatibility Reports for 1.10 for information regarding compatibility with previous releases.
| Anchor | ||||
|---|---|---|---|---|
|
...
Compatibility report for Release 1.10.0 versus Release 1.8.16
See API compatibility report for the HDF5 Library between Compatibility Reports for 1.10.0 and 1.8.16 versions on x86 for information regarding compatibility with previous releases.
Comments regarding the report
...