lwres_config

## Name

lwres_conf_init, lwres_conf_clear, lwres_conf_parse, lwres_conf_print, lwres_conf_get — lightweight resolver configuration

## Synopsis

    #include <lwres/lwres.h>

`void lwres_conf_init(` | lwres_context_t * | ctx`)`;

`void lwres_conf_clear(` | lwres_context_t * | ctx`)`;

`lwres_result_t lwres_conf_parse(` | lwres_context_t * | ctx,
| const char * | filename`)`;

`lwres_result_t lwres_conf_print(` | lwres_context_t * | ctx,
| FILE * | fp`)`;

`lwres_conf_t * lwres_conf_get(` | lwres_context_t * | ctx`)`;

## DESCRIPTION

`lwres_conf_init()` creates an empty lwres_conf_t structure for lightweight resolver context `ctx`.

`lwres_conf_clear()` frees up all the internal memory used by that lwres_conf_t structure in resolver context `ctx`.

`lwres_conf_parse()` opens the file `filename` and parses it to initialise the resolver context `ctx`'s lwres_conf_t structure.

`lwres_conf_print()` prints the lwres_conf_t structure for resolver context `ctx` to the FILE `fp`.

## RETURN VALUES

`lwres_conf_parse()` returns LWRES_R_SUCCESS if it successfully read and parsed `filename`. It returns LWRES_R_FAILURE if `filename` could not be opened or contained incorrect resolver statements.

`lwres_conf_print()` returns LWRES_R_SUCCESS unless an error occurred when converting the network addresses to a numeric host address string. If this happens, the function returns LWRES_R_FAILURE.

## SEE ALSO

stdio(3), resolver(5).

## FILES

`/etc/resolv.conf`