LC_PROCESS(3)

NAME
lc_process - Begin processing configuration files.

SYNOPSIS
#include <libconfig.h>

int lc_process(int argc, char **argv, const char *appname, lc_conf_type_t type, const char *extra);

DESCRIPTION
The lc_process(3) function begins processing of the command line arguments, environment variables, and command line options. The argc and argv parameters should be in the same format as passed to the main function of your program. The appname parameter should be a reasonable form of the name of the application. The type parameter should describe the format of the configuration file (see below). The extra parameter should list any extra configuration files to process. Valid type parameter values:

LC_CONF_SECTION
    This type of configuration file is similar to the Windows INI-file style. An example configuration file:
    	[section]
    	variable = value

LC_CONF_APACHE
    This type of configuration file is similar to the Apache configuration file. An example configuration file:
    	<Section argument>
    		variable value
    	</Section>

LC_CONF_SPACE
    This is a simple, flat configuration file. It has no section headers. An example configuration file:
    	variable value

RETURN VALUE
On success 0 is returned, otherwise -1 is returned.

EXAMPLE
#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);
}

SEE ALSO
libconfig(3), lc_register_var(3), lc_register_callback(3), lc_geterrno(3), lc_geterrstr(3), lc_seterrstr(3), lc_handle_type(3), lc_process_file(3), lc_cleanup(3)