Last modified: 8 December 2015

Name: H5Fenable_mdc_flushes

Signature:
herr_t H5Fenable_mdc_flushes( hid_t file_id )

Purpose:
Returns a file’s metadata cache to the standard eviction and flushing algorithm.

Description:
The H5O/H5Fenable/disable_mdc_flushes() and associated H5Xflush() functions can be used to control the flushing of entries from a file’s metadata cache. Metadata cache entries can be controlled at both the individual HDF5 object level (datasets, groups, committed datatypes) and the entire metadata cache level. This function allows a file’s dirty metadata entries to be flushed from the cache by the usual cache eviction/flush policy.

Note:
Only HDF5 file identifiers (obtained from H5Fopen() or H5Fcreate()) may be passed to this function. To restore flushes on individual HDF5 objects, use H5Oenable_mdc_flushes instead.

Passing in a hid_t identifier that represents any other HDF5 entity is considered an error.

A file will be returned to the default flushing algorithm when closed.

A file’s cache entries will not necessarily be flushed when the cache is returned to the default algorithm.


Parameters:
hid_t file_id    IN: An HDF5 file identifier.

Returns:
Returns a non-negative value if successful; otherwise returns a negative value.

Fortran Interface:
None

See Also:



History:
Release     Change
1.10.0 C function introduced with this release.