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
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.
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.
Changes from 1.14.1 to 1.14.2
This section lists interface-level changes and other user-visible changes in behavior in the transition from HDF5 Release 1.14.1 to Release 1.14.2.
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
Following are the new APIs introduced in HDF5-1.14.2.
In the C Interface (main library)
| Function | Description |
|---|---|
| Performs a series of scalar reads. | |
Performs a vector read if vector reads are supported, or a series of scalar reads, | |
| Performs a series of scalar writes. | |
| Performs a vector write if vector writes are supported, or a series of scalar writes, otherwise. | |
| H5Pget_fapl_ros3_token | Returns session/security token of the ros3 file access property list |
| H5Pset_fapl_ros3_token | Modifies the file access property list to use the H5FD_ROS3 driver |
Changes from 1.14.0 to 1.14.1
This section lists interface-level changes and other user-visible changes in behavior in the transition from HDF5 Release 1.14.0 to Release 1.14.1.
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
Following are the new APIs introduced in HDF5-1.14.1.
In the C Interface (main library)
| Function | Description |
|---|---|
| H5PGET_MODIFY_WRITE_BUF | Retrieves the "modify write buffer" property |
| H5PGET_NO_SELECTION_IO_CAUSE | Retrieves the cause for not performing selection or vector I/O on the last parallel I/O call |
| H5PGET_SELECTION_IO | Retrieves the selection I/O mode |
| H5PSET_MODIFY_WRITE_BUF | Allows the library to modify the contents of the write buffer |
| H5PSET_SELECTION_IO | Sets the selection I/O mode |
In the Fortran Interface
| Function | Description |
|---|---|
| h5pget_modify_write_buf_f | Retrieves the "modify write buffer" property |
| h5pget_selection_io_f | Retrieves the selection I/O mode |
| h5pset_modify_write_buf_f | Allows the library to modify the contents of the write buffer |
| h5pset_selection_io_f | Sets the selection I/O mode |
Changes from 1.12.2 to 1.14.0
HDF5 version 1.14.0 introduces the following new features:
- Asynchronous I/O operations
- New tools h5dwalk and h5delete
- Subfiling VFD
- Onion VFD
- Multi Dataset I/O
Users might find these names familiar already and that is because they were introduced in the experimental series 1.13.
In addition, this version provides many new C APIs and other user-visible changes in behavior in the transition from HDF5 Release 1.12.2 to Release 1.14.0. HDF5 1.14.0 adds no new API calls that require use of the API Compatibility Macros for the main library. Some calls have been removed or have had their signature change, however.
New and Changed Functions, Classes, Subroutines, Wrappers, and Macros
In the C Interface (main library)
Following are the new APIs introduced in HDF5-1.14.0.
| Procedure / Function | Fortran | Description or Change |
|---|---|---|
N | Asynchronous version of H5Aclose | |
N | Asynchronous version of H5Acreate | |
N | Asynchronous version of H5Acreate_by_name | |
N | Asynchronous version of H5Aexists | |
N | Asynchronous version of H5Aexists_by_name | |
N | Asynchronous version of H5Aopen | |
N | Asynchronous version of H5Aopen_by_idx | |
N | Asynchronous version of H5Aopen_by_name | |
N | Asynchronous version of H5Aread | |
N | Asynchronous version of H5Arename | |
N | Asynchronous version of H5Arename_by_name | |
N | Asynchronous version of H5Awrite | |
| N | Iterate over all chunks of a chunked dataset | |
| N | Asynchronous version of H5Dclose | |
| N | Asynchronous version of H5Dcreate | |
| N | Asynchronous version of H5Dget_space | |
| N | Asynchronous version of H5Dopen | |
| N | Asynchronous version of H5Dread | |
| N | Reads raw data from a set of datasets into the provided buffers | |
| N | Asynchronous version of H5Dread_multi | |
| N | Asynchronous version of H5Dset_extent | |
| N | Asynchronous version of H5Dwrite | |
| N | Writes raw data from a set buffers to a set of datasets | |
| N | Asynchronous version of H5Dwrite_multi | |
| N | Appends one error stack to another, optionally closing the source stack | |
| N | Attempt to cancel operations in an event set | |
| N | Terminates access to an event set | |
| N | Creates an event set | |
| N | Convenience routine to free an array of H5ES_err_info_t structs | |
| N | Retrieves number of events in an event set | |
| N | Retrieves the number of failed operations | |
| N | Retrieves information about failed operations | |
| N | Checks for failed operations | |
| N | Retrieves the accumulative operation counter for an event set | |
| N | Registers a callback to invoke when an operation completes within an event set | |
| N | Registers a callback to invoke when a new operation is inserted into | |
| N | Waits for operations in event set to complete | |
| N | Gets the number of revisions | |
| N | Gets the onion info from the file access property list | |
| N | Sets the onion info for the file access property list | |
| N | Asynchronous version of H5Fclose | |
| N | Asynchronous version of H5Fcreate | |
| N | Asynchronous version of H5Fflush | |
| N | Asynchronous version of H5Fopen | |
| N | Asynchronous version of H5Freopen | |
| N | Asynchronous version of H5Gclose | |
| N | Asynchronous version of H5Gcreate | |
| N | Asynchronous version of H5Gget_info | |
| N | Asynchronous version of H5Gget_info_by_idx | |
| N | Asynchronous version of H5Gget_info_by_name | |
| N | Asynchronous version of H5Gopen | |
| N | Registers a "future" object under a type and returns an ID for it | |
| N | Asynchronous version of H5Lcreate_hard | |
| N | Asynchronous version of H5Lcreate_soft | |
| N | Asynchronous version of H5Ldelete | |
| N | Asynchronous version of H5Ldelete_by_idx | |
| N | Asynchronous version of H5Lexists | |
| N | Asynchronous version of H5Literate | |
| N | Asynchronous version of H5Oclose | |
| N | Asynchronous version of H5Ocopy | |
| N | Asynchronous version of H5Oflush | |
| N | Asynchronous version of H5Oget_info_by_name | |
| N | Asynchronous version of H5Oopen | |
| N | Asynchronous version of H5Oopen_by_idx | |
| N | Asynchronous version of H5Orefresh | |
| N | Retrieves a string representation of the configuration for the driver set on the given FAPL | |
| N | Query the capability flags for the VOL connector that will be used with this file access property list (FAPL) | |
| N | Sets a hyperslab file selection for a dataset I/O operation | |
| N | Sets a file driver according to a given driver name | |
| N | Sets a file driver according to a given driver value (ID) | |
| N | Registers a callback for the library to invoke when it's closing | |
| N | Checks whether the HDF5 library is closing | |
| N | Asynchronous version of H5Ropen_attr | |
| N | Asynchronous version of H5Ropen_object | |
| N | Asynchronous version of H5Ropen_region | |
| N | Asynchronous version of H5Tclose | |
| N | Asynchronous version of H5Tcommit2 | |
| N | Asynchronous version of H5Topen2 | |
--- Last Modified: August 29, 2023 | 09:35 AM