H5Pset_file_space
(
hid_t fcpl_id
,
H5F_file_space_type_t strategy
,
hsize_t threshold
)
H5Pset_file_space
provides the means for applications to manage an HDF5 file’s
file space to meet specific needs.
H5Pset_file_space
sets the file space management strategy for the file associated with
fcpl_id
as specified in strategy
and sets the file-space threshold to threshold
.
Available strategies are described in the “Parameters:” section below.
This routine can also set the free-space section threshold to
threshold
so that the library’s free-space managers
will track only free-space sections whose size is
greater than or equal to threshold
for the file.
Passing 0
(zero) for strategy
or
thresold
indicates that the corresponding parameter’s
value should not be modified as a result of the call.
Note: The file space management strategy and/or free-space section threshold that are set via this routine cannot be changed once the file is created.
hid_t fcpl_id
|
||||||||||||||||||||
|
IN: The file creation property list identifier. | |||||||||||||||||||
H5F_file_space_type_t strategy
|
||||||||||||||||||||
IN: The strategy for file space management.
Valid values are as follows:
| ||||||||||||||||||||
hsize_t threshold
|
||||||||||||||||||||
IN: The free-space section threshold.
The library default is 1, which is to track all free-space sections.
Passing a value of zero ( |
strategy
is not one of the valid values listed
above.
fcpl_id
.
fcpl_id
.
fcpl
to
H5F_FILE_SPACE_ALL_PERSIST
.
It also sets the free-space section threshold to 10
,
which means that the library's free-space managers will track
only free-space sections whose size is greater than or equal to 10
for the file.
H5Pset_file_space(fcpl, H5F_FILE_SPACE_ALL_PERSIST, (hsize_t)10);
fcpl
to
H5F_FILE_SPACE_VFD
.
It does not change the free-space section threshold in use for
the file.
H5Pset_file_space(fcpl, H5F_FILE_SPACE_VFD, (hsize_t)0);
H5Pget_file_space
H5Fget_free_sections
H5Fget_freespace
H5Fget_info
HDF5 Guide to File Space Management (Not yet available.)
Release | Change |
1.10.0 | C function introduced in this release. |