Last modified: 25 October 2011
Name: H5garbage_collect
Signature:
  herr_t `H5garbage_collect`(void)

Purpose:
  Garbage collects on all free-lists of all types.

Description:
  `H5garbage_collect` walks through all the garbage collection routines of the library, freeing any unused memory.

  It is not required that `H5garbage_collect` be called at any particular time; it is only necessary in certain situations where the application has performed actions that cause the library to allocate many objects. The application should call `H5garbage_collect` if it eventually releases those objects and wants to reduce the memory used by the library from the peak usage required.

  The library automatically garbage collects all the free lists when the application ends.

Parameters:
  None.

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

Fortran90 Interface: h5garbage_collect_f

History:

  Release | Fortran90
  1.4.5 | Function introduced in this release.
  1.8.8 | Fortran subroutine updated in this release.