When datasets are created in a 1.10.x HDF5 file accessed with the latest format, the library will use the latest layout format version for the datasets. This will allow users to take advantage of new features such as virtual storage and the latest index types for chunked datasets. However, applications built with 1.8.x versions of the library will not be able to access these datasets.
When run, the tool will investigate datasets in the file
file_name. It will convert datasets as follows:
- A chunked dataset: convert the chunk indexing type to version 1 B-tree if the type is not already a version 1 B-tree
- A compact or contiguous dataset: downgrade the layout version to 3 if the layout version is not already version 3
- A virtual dataset: no action
If errors are encountered, no further conversion will be performed, and the tool will exit with failure.