table of contents
other versions
- wheezy 0.7.3-6
- jessie 0.7.3-6+b2
- testing 0.9.4-1
- unstable 0.9.4-1
- experimental 0.10.0-1
gd_close(3) | GETDATA | gd_close(3) |
NAME¶
gd_close, gd_discard — close a dirfile and free associated memory.SYNOPSIS¶
#include <getdata.h>int
gd_close(DIRFILE *dirfile);
int
gd_discard(DIRFILE *dirfile);
DESCRIPTION¶
The gd_close() function first calls gd_flush(3) (with field_code set to NULL) to flush all metadata changes to disk and to close all file handles associated with dirfile. It then frees memory associated with the DIRFILE object. If dirfile is NULL, nothing happens, and the call succeeds.RETURN VALUE¶
gd_close() and gd_discard() return zero on success. On error, they do not de-allocate dirfile and set the dirfile error to a non-zero error value. Possible error values are:- GD_E_FLUSH
- A temporary file could not be opened into which to write the modified metadata, or renaming the temporary file over the original fragment failed.
- GD_E_RAW_IO
- An error occurred while trying to flush or close one or more open raw files. In this case, another call to gd_close() or gd_discard() may be attempted.
SEE ALSO¶
gd_cbopen(3), gd_dirfile_standards(3), gd_error(3), gd_error_string(3), gd_flush(3), gd_invalid_dirfile(3), gd_open(3)20 October 2010 | Version 0.7.0 |