summaryrefslogtreecommitdiffstats
path: root/release_docs/RELEASE.txt
diff options
context:
space:
mode:
Diffstat (limited to 'release_docs/RELEASE.txt')
-rw-r--r--release_docs/RELEASE.txt52
1 files changed, 50 insertions, 2 deletions
diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt
index c1188ae..7e42b01 100644
--- a/release_docs/RELEASE.txt
+++ b/release_docs/RELEASE.txt
@@ -102,6 +102,18 @@ New Features
Fortran Library:
----------------
+ - Add API support for Fortran MPI_F08 module definitions:
+ Adds support for MPI's MPI_F08 module datatypes: type(MPI_COMM) and type(MPI_INFO) for HDF5 APIs:
+ H5PSET_FAPL_MPIO_F, H5PGET_FAPL_MPIO_F, H5PSET_MPI_PARAMS_F, H5PGET_MPI_PARAMS_F
+ Ref. #3951
+
+ - Added Fortran APIs:
+ H5FGET_INTENT_F, H5SSEL_ITER_CREATE_F, H5SSEL_ITER_GET_SEQ_LIST_F,
+ H5SSEL_ITER_CLOSE_F, H5S_mp_H5SSEL_ITER_RESET_F
+
+ - Added Fortran Parameters:
+ H5S_SEL_ITER_GET_SEQ_LIST_SORTED_F, H5S_SEL_ITER_SHARE_WITH_DATASPACE_F
+
- Added Fortran Parameters:
H5S_BLOCK_F and H5S_PLIST_F
@@ -159,6 +171,34 @@ Bug Fixes since HDF5-1.14.3 release
===================================
Library
-------
+ - Memory usage growth issue
+
+ Starting with the HDF5 1.12.1 release, an issue (GitHub issue #1256)
+ was observed where running a simple program that has a loop of opening
+ a file, reading from an object with a variable-length datatype and
+ then closing the file would result in the process fairly quickly
+ running out of memory. Upon further investigation, it was determined
+ that this memory was being kept around in the library's datatype
+ conversion pathway cache that is used to speed up datatype conversions
+ which are repeatedly used within an HDF5 application's lifecycle. For
+ conversions involving variable-length or reference datatypes, each of
+ these cached pathway entries keeps a reference to its associated file
+ for later use. Since the file was being closed and reopened on each
+ loop iteration, and since the library compares for equality between
+ instances of opened files (rather than equality of the actual files)
+ when determining if it can reuse a cached conversion pathway, it was
+ determining that no cached conversion pathways could be reused and was
+ creating a new cache entry on each loop iteration during I/O. This
+ would lead to constant growth of that cache and the memory it consumed,
+ as well as constant growth of the memory consumed by each cached entry
+ for the reference to its associated file.
+
+ To fix this issue, the library now removes any cached datatype
+ conversion path entries for variable-length or reference datatypes
+ associated with a particular file when that file is closed.
+
+ Fixes GitHub #1256
+
- Suppressed floating-point exceptions in H5T init code
The floating-point datatype initialization code in H5Tinit_float.c
@@ -195,6 +235,15 @@ Bug Fixes since HDF5-1.14.3 release
Configuration
-------------
+ - Changed default of 'Error on HDF5 doxygen warnings' DOXYGEN_WARN_AS_ERROR option.
+
+ The default setting of DOXYGEN_WARN_AS_ERROR to 'FAIL_ON_WARNINGS' has been changed
+ to 'NO'. It was decided that the setting was too aggressive and should be a user choice.
+ The github actions and scripts have been updated to reflect this.
+
+ * HDF5_ENABLE_DOXY_WARNINGS: ON/OFF (Default: OFF)
+ * --enable-doxygen-errors: enable/disable (Default: disable)
+
- Removed an Autotools configure hack that causes problems on MacOS
A sed line in configure.ac was added in the past to paper over some
@@ -382,7 +431,7 @@ Platforms Tested
Windows 10 x64 Visual Studio 2019 w/ clang 12.0.0
with MSVC-like command-line (C/C++ only - cmake)
- Visual Studio 2019 w/ Intel C/C++ only cmake)
+ Visual Studio 2019 w/ Intel (C/C++ only - cmake)
Visual Studio 2022 w/ clang 15.0.1
with MSVC-like command-line (C/C++ only - cmake)
Visual Studio 2022 w/ Intel C/C++/Fortran oneAPI 2023 (cmake)
@@ -417,7 +466,6 @@ Known Problems
CMake files do not behave correctly with paths containing spaces.
Do not use spaces in paths because the required escaping for handling spaces
results in very complex and fragile build files.
- ADB - 2019/05/07
At present, metadata cache images may not be generated by parallel
applications. Parallel applications can read files with metadata cache