1dirfile_metaflush(3)                GETDATA               dirfile_metaflush(3)
2
3
4

NAME

6       dirfile_metaflush — close a dirfile and free associated memory.
7

SYNOPSIS

9       #include <getdata.h>
10
11       int dirfile_metaflush(DIRFILE *dirfile);
12

DESCRIPTION

14       The  dirfile_metaflush()  function flushes all pending metadata changes
15       in the dirfile specified by dirfile to disk.  This is  accomplished  by
16       re-writing  the  format  file  fragments  containing modified metadata.
17       Format file fragments which are unchanged are not touched.
18
19       This function flushes only metadata.  To flush the field data as  well,
20       call dirfile_flush(3) instead.
21

RETURN VALUE

23       On success, zero is returned.  On error, -1 is returned and the dirfile
24       error is set to a non-zero error value.  Possible error values are:
25
26       GD_E_BAD_DIRFILE
27               The supplied dirfile was invalid.
28
29       GD_E_INTERNAL_ERROR
30               An internal error occurred in the library while trying to  per‐
31               form  the  task.   This indicates a bug in the library.  Please
32               report the incident to the maintainer.
33
34       GD_E_OPEN_INCLUDE
35               A temporary file could not be opened into which  to  write  the
36               modified metadata.
37
38       The dirfile error may be retrieved by calling get_error(3).  A descrip‐
39       tive error string for the last error encountered can be obtained from a
40       call to get_error_string(3).
41

SEE ALSO

43       dirfile_open(3),   dirfile_flush(3),   dirfile_close(3),  get_error(3),
44       get_error_string(3)
45
46
47
48Version 0.4.0                   17 October 2008           dirfile_metaflush(3)
Impressum