|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
|
<H2>NAME</H2>
lc_process_file - Process a specific file
<P>
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
<B>#include <<A HREF="artifact/7c61a9805e664fde7943807af8d5e164e7cebdb6">libconfig.h</A>></B>
<P>
<B>int lc_process_file(const char *</B><I>appname</I><B>, const char *</B><I>pathname</I><B>, lc_conf_type_t </B><I>type</I><B>);</B>
<P>
<A NAME="lbAD"> </A>
<H2>DESCRIPTION</H2>
The
<B><A HREF="wiki/Manual for lc_process_file">lc_process_file</A></B>(3)
function processes exactly one configuration file. The file is specified by the
<I>pathname</I>
argument and should be in the format specified by the
<I>type</I>
argument. The
<I>appname</I>
argument should be a reasonable form of the name of the application.
<P>
<A NAME="lbAE"> </A>
<H2>RETURN VALUE</H2>
On success 0 is returned, otherwise -1 is returned.
<P>
<A NAME="lbAF"> </A>
<H2>EXAMPLE</H2>
<PRE>
#include <<A HREF="artifact/7c61a9805e664fde7943807af8d5e164e7cebdb6">libconfig.h</A>>
#include <<A HREF="file:/usr/include/stdlib.h">stdlib.h</A>>
#include <<A HREF="file:/usr/include/stdio.h">stdio.h</A>>
int main(int argc, char **argv) {
int lc_p_ret, lc_rv_ret;
char *filename = NULL;
lc_rv_ret = lc_register_var("File", LC_VAR_STRING,
&filename, 'f');
if (lc_rv_ret != 0) {
fprintf(stderr, "Error registering variable: %i.\n",
lc_geterrno());
return(EXIT_FAILURE);
}
lc_p_ret = lc_process_file("example", "/data/extra.conf",
LC_CONF_APACHE);
lc_cleanup();
if (lc_p_ret != 0) {
fprintf(stderr, "Error processing configuration file: \
%s\n", lc_geterrstr());
return(EXIT_FAILURE);
}
if (filename != NULL) {
printf("File specified was: %s\n", filename);
} else {
printf("No filename specified.\n");
}
return(EXIT_SUCCESS);
}
</PRE>
<P>
<A NAME="lbAG"> </A>
<H2>SEE ALSO</H2>
<B><A HREF="wiki/Manual">libconfig</A></B>(3),
<B><A HREF="wiki/Manual for lc_register_var">lc_register_var</A></B>(3),
<B><A HREF="wiki/Manual for lc_register_callback">lc_register_callback</A></B>(3),
<B><A HREF="wiki/Manual for lc_geterrno">lc_geterrno</A></B>(3),
<B><A HREF="wiki/Manual for lc_geterrstr">lc_geterrstr</A></B>(3),
<B><A HREF="wiki/Manual for lc_seterrstr">lc_seterrstr</A></B>(3),
<B><A HREF="wiki/Manual for lc_handle_type">lc_handle_type</A></B>(3),
<B><A HREF="wiki/Manual for lc_process">lc_process</A></B>(3),
<B><A HREF="wiki/Manual for lc_cleanup">lc_cleanup</A></B>(3)
<P>
|