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_dirfile_standards(3) | GETDATA | gd_dirfile_standards(3) |
NAME¶
gd_dirfile_standards — change or report the current Dirfile Standards Version for a DirFileSYNOPSIS¶
#include <getdata.h>int
gd_dirfile_standards(DIRFILE *dirfile, int version );
DESCRIPTION¶
The gd_dirfile_standards() version updates the current Standards Version for the open dirfile dirfile to the value specified by version, if possible, and then reports the current Standards Version. Metadata written to disk for dirfile will conform to the current Standards Version.- GD_VERSION_EARLIEST
- Specifies the current Standards Version should be set to the earliest version to which the loaded dirfile conforms.
- GD_VERSION_CURRENT
- Specifies that the current Standards Version should not be changed. In this case, this function simply reports the current Standards Version.
- GD_VERSION_LATEST
- Specifies the current Standards Version should be set to the latest version to which the loaded dirfile conforms.
RETURN VALUE¶
On success, gd_dirfile_standards() returns the current Standards Version of the loaded dirfile, after possibly having been updated by the call. This will be a number between zero and GD_DIRFILE_STANDARDS_VERSION inclusive. On error, -1 is returned and the dirfile error is set to a non-zero error value, and the current Standards Version is not changed. Possible error values are:- GD_E_BAD_DIRFILE
- The supplied dirfile was invalid.
- GD_E_BAD_VERSION
- The loaded dirfile did not conform to the specified version. Or the dirfile conforms to no known Standards Version.
NOTES¶
This function only changes the current Standards Version of the loaded dirfile. It does not update the any format specification fragments on disk to conform to the specified Standards Version. To do that, use gd_metaflush(3) or gd_rewrite_fragment(3).SEE ALSO¶
gd_open(3), gd_metaflush(3), gd_rewrite_fragment(3)15 October 2010 | Version 0.7.0 |