Skip to content

Commit 7a920d0

Browse files
authored
Include VDS changes in CHANGELOG (#5877)
* Add CHANGELOG note for delayed layout copy * Add link to shared strings CHANGELOG
1 parent d775fa0 commit 7a920d0

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

release_docs/CHANGELOG.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,8 @@ For releases prior to version 2.0.0, please see the release.txt file and for mor
2525

2626
## Performance Enhancements:
2727

28-
- 30% faster opening and 25% faster closing of virtual datasets.
29-
- Reduced memory overhead via shared name strings and optimized spatial search algorithms for virtual datasets.
28+
- [30% faster opening](https://github.com/HDFGroup/hdf5/blob/develop/release_docs/CHANGELOG.md#layoutcopydelay) and [25% faster closing](https://github.com/HDFGroup/hdf5/blob/develop/release_docs/CHANGELOG.md#fileformat) of virtual datasets.
29+
- [Reduced memory overhead](https://github.com/HDFGroup/hdf5/blob/develop/release_docs/CHANGELOG.md#fileformat) via shared name strings and optimized spatial search algorithms for virtual datasets.
3030

3131
## Significant Advancements:
3232

@@ -226,6 +226,8 @@ Calling `H5Pset_fapl_ros3()` now has the side effect of setting the page buffer
226226

227227
The Virtual Dataset Global Heap Block format has been updated to version 1 to support shared string storage for source filenames and dataset names, reducing file size when multiple mappings reference the same sources. This new format is only used when the HDF5 library version bounds lower bound is set to 2.0 or later.
228228

229+
Use of the shared strings option for Virtual Datasets reduces memory overhead and optimizes dataset close operations.
230+
229231
### The `H5Dread_chunk()` signature has changed
230232

231233
A new parameter, `nalloc`, has been added to `H5Dread_chunk()`. This parameter contains a pointer to a variable that holds the size of the buffer buf. If *nalloc is not large enough to hold the entire chunk being read, no data is read. On exit, the value of this variable is set to the buffer size needed to read the chunk.
@@ -453,6 +455,12 @@ Simple example programs showing how to use complex number datatypes have been ad
453455

454456
Similar to the above. Setting the connector on a non-FAPL had no effect on library behavior, and the connector ID and information could not be read back from that plist later.
455457

458+
### Optimized Virtual Dataset opens by delaying layout copy<a name="layoutcopydelay"></a>
459+
460+
On dataset open, the dataset performed an internal copy of the layout in order to populate its internal DCPL. For virtual datasets, this added a significant amount of overhead to the open operation.
461+
462+
This layout copy is now delayed until either a user requests the DCPL, or until the start of an operation that needs to read the layout from the DCPL.
463+
456464
## Parallel Library
457465

458466
### Added H5FDsubfiling_get_file_mapping() API function for subfiling VFD

0 commit comments

Comments
 (0)