Last modified: 13 April 2016
Name: H5Oenable_mdc_flushes
Signature:
  `herr_t H5Oenable_mdc_flushes( hid_t object_id )`
Purpose:
  Enables flushing of dirty metadata entries from a file’s metadata cache.
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.

  This function allows an object or cache’s dirty metadata entries to be flushed from the cache by the usual cache eviction/flush policy.

  Metadata cache entries can be controlled at both the individual HDF5 object level (datasets, groups, committed datatypes) and the entire metadata cache level.

Note:
  HDF5 objects include datasets, groups, and committed datatypes. Only `hid_t` identifiers that represent these objects can be passed to the function.

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

  It is an error to pass an HDF5 file identifier (obtained from `H5Fopen()` or `H5Fcreate()`) to this function. Use `H5Fenable_mdc_flushes` instead.

  Using this function on an object that has not had flushes disabled is considered an error. The state of an object can be determined with `H5Oare_flushes_disabled()`.

  Individual objects can be returned to the default flush algorithm with this function after `H5Fdisable_mdc_flushes()` has been used to globally prevent flushes.

  An object will be returned to the default flush algorithm when it is closed.

  All objects will be returned to the default flush algorithm when the file is closed.

  An object’s entries will not necessarily be flushed as a result of calling this function.

Parameters:

  `hid_t object_id` | IN: Identifier of the object that will have flushes re-enabled. See the above notes for restrictions.

Returns:
  Returns a non-negative value if successful; otherwise returns a negative value.
Fortran Interface:
  None
See Also:

- H5Odisable_mdc_flushes
- H5Oare_mdc_flushes_disabled
- H5Fdisable_mdc_flushes
- 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.