Last modified: 8 December 2015
Name: H5Fdisable_mdc_flushes
Signature:
  `herr_t H5Fdisable_mdc_flushes( hid_t file_id )`
Purpose:
  Globally prevents dirty metadata entries from being flushed from the metadata cache to storage.
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 prevents a file’s dirty metadata entries from being flushed from the cache by the usual cache eviction/flush policy. Instead, users must manually flush the cache or entries for individual objects via `H5F/H5D/H5G/H5T/H5Oflush()` calls.
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.

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

  Misuse of this function can cause the cache to exhaust available memory.

  Prevention only pertains to new or dirty metadata entries. Clean entries can still be evicted from the cache.

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:

- H5Odisable_mdc_flushes
- H5Oenable_mdc_flushes
- H5Oare_mdc_flushes_disabled
- H5Fenable_mdc_flushes
- H5Fare_mdc_flushes_disabled
- H5Fget_mdc_flush_disabled_obj_ids

- H5Dflush
- H5Drefresh
- H5Gflush
- H5Grefresh
- H5Oflush
- H5Orefresh
- H5Tflush
- H5Trefresh

- H5DOappend
- H5Fstart_swmr_write
- H5Pget_append_flush
- H5Pset_append_flush
- H5Pget_object_flush_cb
- H5Pset_object_flush_cb

History:

  Release | Change
  1.10.0 | C function introduced with this release.