@@ -1,61 +1,25 @@ .TH LC_GETERRSTR 3 "25 Oct 04" "@PACKAGE_STRING@" .SH NAME -lc_geterrstr \- Retrieve a human readable error message. +lc_geterrstr \- Set an error message from a callback. .SH SYNOPSIS .B #include .sp -.BI "char *lc_geterrstr(void);" +.BI "void lc_seterrstr(const char *" errstr ");" .SH DESCRIPTION The +.BR lc_seterrstr (3) +function sets a human readable error message to be returned by .BR lc_geterrstr (3) -function returns a string describing the last error code set. - -.SH EXAMPLE -.nf -#include -#include -#include - -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: %s.\\n", - lc_geterrstr()); - 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 +function when an error is returned from a callback function. The value is ignored if the error is not related to a callback. .SH "SEE ALSO" +.BR libconfig (3), .BR lc_register_var (3), .BR lc_register_callback (3), .BR lc_geterrno (3), +.BR lc_geterrstr (3), .BR lc_cleanup (3), .BR lc_process_file (3), .BR lc_process (3)