Differences From Artifact [da39a3ee5e]:

• File lc_cleanup.3.in — part of check-in [cff8496e42] at 2004-11-24 23:13:23 on branch trunk — Added an optional dependency to libopennet. If libopennet is used fopen_net is used instead of fopen. Made lc_process_file() a publicly callable function. Added a (blank!) man page for it. Made lc_cleanup() a publicly callable function, and removed calls to it from lc_process(). Added a (blank!) man page for it. (user: rkeene, size: 0) [annotate] [blame] [check-ins using]
• File lc_geterrno.3.in — part of check-in [6a0a10a0ab] at 2004-10-24 14:26:31 on branch trunk — Lots of improvements to libconfig: We now process the command line arguments ourselves rather than using getopt(). We now process Apache-style config files. Began work on documentation. Many more bug fixes (user: rkeene, size: 0) [annotate] [blame] [check-ins using]
• File lc_geterrstr.3.in — part of check-in [6a0a10a0ab] at 2004-10-24 14:26:31 on branch trunk — Lots of improvements to libconfig: We now process the command line arguments ourselves rather than using getopt(). We now process Apache-style config files. Began work on documentation. Many more bug fixes (user: rkeene, size: 0) [annotate] [blame] [check-ins using]
• File lc_process.3.in — part of check-in [6a0a10a0ab] at 2004-10-24 14:26:31 on branch trunk — Lots of improvements to libconfig: We now process the command line arguments ourselves rather than using getopt(). We now process Apache-style config files. Began work on documentation. Many more bug fixes (user: rkeene, size: 0) [annotate] [blame] [check-ins using]
• File lc_process_file.3.in — part of check-in [cff8496e42] at 2004-11-24 23:13:23 on branch trunk — Added an optional dependency to libopennet. If libopennet is used fopen_net is used instead of fopen. Made lc_process_file() a publicly callable function. Added a (blank!) man page for it. Made lc_cleanup() a publicly callable function, and removed calls to it from lc_process(). Added a (blank!) man page for it. (user: rkeene, size: 0) [annotate] [blame] [check-ins using]
• File lc_register_callback.3.in — part of check-in [6a0a10a0ab] at 2004-10-24 14:26:31 on branch trunk — Lots of improvements to libconfig: We now process the command line arguments ourselves rather than using getopt(). We now process Apache-style config files. Began work on documentation. Many more bug fixes (user: rkeene, size: 0) [annotate] [blame] [check-ins using]
• File lc_register_var.3.in — part of check-in [6a0a10a0ab] at 2004-10-24 14:26:31 on branch trunk — Lots of improvements to libconfig: We now process the command line arguments ourselves rather than using getopt(). We now process Apache-style config files. Began work on documentation. Many more bug fixes (user: rkeene, size: 0) [annotate] [blame] [check-ins using]

To Artifact [1a58c9eea6]:

• File lc_cleanup.3.in — part of check-in [80d18a8d82] at 2004-12-18 10:05:59 on branch trunk — Win32 support fixed. Added a new man page (lc_cleanup) (user: rkeene, size: 1686) [annotate] [blame] [check-ins using]

>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>

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
71
72
73

.TH LC_GETERRNO 3 "25 Oct 04" "@PACKAGE_STRING@"
.SH NAME
lc_cleanup \- Clean up internal structures after processing data.

.SH SYNOPSIS
.B #include <libconfig.h>
.sp
.BI "void lc_cleanup(void);"

.SH DESCRIPTION
The
.BR lc_cleanup (3)
function cleans up the internal structures created by calling
.BR lc_register_var (3)
or
.BR lc_register_callback (3)
and returns the memory to the application.  It is not strictly required, however memory concious programmers will still want to call this after finishing processing configuration files.

After you call
.BR lc_cleanup (3)
calling
.BR lc_process (3)
or
.BR lc_process_file (3)
will generally cause errors since the registered variables and callbacks have been unregistered.

.SH EXAMPLE
.nf
#include <libconfig.h>
#include <stdlib.h>
#include <stdio.h>

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(argc, argv, "example", LC_CONF_APACHE,
	                      NULL);

	lc_cleanup();

	if (lc_p_ret != 0) {
		fprintf(stderr, "Error processing configuration: \\
		        %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);
}
.fi

.SH "SEE ALSO"
.BR lc_register_var (3),
.BR lc_register_callback (3),
.BR lc_geterrstr (3),
.BR lc_geterrno (3),
.BR lc_process_file (3),
.BR lc_process (3)