|[ < ]||[ > ]||[ << ]||[ Up ]||[ >> ]||[Top]||[Contents]||[Index]||[ ? ]|
parse a configuration file
const tOptionValue* res = configFileLoad( fname );
Where the arguments are:
|fname||the file to load|
|returns||const tOptionValue*||An allocated, compound value structure|
This routine will load a named configuration file and parse the
text as a hierarchically valued option. The option descriptor
created from an option definition file is not used via this interface.
The returned value is "named" with the input file name and is of
OPARG_TYPE_HIERARCHY". It may be used in calls to
If the file cannot be loaded or processed,
NULL is returned and
errno is set. It may be set by a call to either
mmap(2) or other file system calls, or it may be:
ENOENT- the file was not found.
ENOMSG- the file was empty.
EINVAL- the file contents are invalid – not properly formed.
ENOMEM- not enough memory to allocate the needed structures.
This document was generated by Bruce Korb on May 18, 2013 using texi2html 1.82.