dirfile_metaflush (3) Linux Manual Page
NAME
dirfile_metaflush — close a dirfile and free associated memory.
SYNOPSIS
#include <getdata.h>
-
int dirfile_metaflush(DIRFILE *dirfile);
DESCRIPTION
dirfile_metaflush() function flushes all pending metadata changes in the dirfile specified by dirfile to disk. This is accomplished by re-writing the format file fragments containing modified metadata. Format file fragments which are unchanged are not touched. This function flushes only metadata. To flush the field data as well, call dirfile_flush(3) instead.
RETURN VALUE
On success, zero is returned. On error, -1 is returned and the dirfile error is set to a non-zero error value. Possible error values are:
GD_E_BAD_DIRFILE- The supplied dirfile was invalid.
GD_E_INTERNAL_ERROR- An internal error occurred in the library while trying to perform the task. This indicates a bug in the library. Please report the incident to the maintainer.
GD_E_OPEN_INCLUDE- A temporary file could not be opened into which to write the modified metadata. The dirfile error may be retrieved by calling
get_error(3). A descriptive error string for the last error encountered can be obtained from a call toget_error_string(3).
SEE ALSO
dirfile_open(3), dirfile_flush(3), dirfile_close(3), get_error(3), get_error_string(3)