The following are the sections on this page:
- File Space Management Strategies
- File Space Management User’s Guide (not yet available)
- HDF5 Library APIs
The HDF5 library uses three mechanisms to manage space in an HDF5 file. They are:
There are four file space-handling strategies available to users that use these mechanisms:
This strategy has always been available in HDF5 and is the default. The mechanisms used for this strategy are free-space managers, aggregators, and virtual file drivers.
The current HDF5 file space allocation accumulates small pieces of metadata and raw data in aggregator blocks. However, these blocks are not page aligned and vary widely in sizes. The paged aggregation feature provides efficient paged access of these small pieces of metadata and raw data. It accumulates metadata and raw data into well-aligned pages called file space pages. The library defines a default file space page size but a user can set the page size via a new public routine.
See the RFC on this feature for complete details.
With this strategy the library will request space from either the metadata or raw data aggregator depending on the file space type. If the request is not satisfied, the library will request space from the virtual file driver.
The mechanisms used for this strategy are aggregators and virtual file drivers. It does not use the free-space manager.
This strategy will request space from the virtual file driver. The only mechanism used is the virtual file driver. It does not use the free-space manager.
(This document is not yet available.)
The APIs listed below from the HDF5 Reference Manual provide a means for users to directly manage the file space management feature.
|Retrieves free-space section information for a file|
|Returns the amount of free space in a file|
|Returns global information for a file|
| ||Retrieves the File Space Strategy for a file creation property list|
| ||Sets the File Space Strategy for a file creation property list|
| ||Retrieves the file space page size for paged aggregation|
| ||Sets the file space page size for paged aggregation|
The tools listed below have been modified to preserve or modify file freepace information appropriately when processing files employing this feature.