<refentry xmlns="http://docbook.org/ns/docbook" version="5.0">

<info>

<date>2007-06-18</date>

</info>

<refentryinfo>

<corpname>ISC</corpname>

<corpauthor>Internet Systems Consortium, Inc.</corpauthor>

</refentryinfo>

<refmeta>

<refentrytitle>lwres_config</refentrytitle>

<manvolnum>3</manvolnum>

<refmiscinfo>BIND9</refmiscinfo>

</refmeta>

<docinfo>

<copyright>

<year>2004</year>

<year>2005</year>

<year>2007</year>

<year>2014</year>

<year>2015</year>

<year>2016</year>

<holder>Internet Systems Consortium, Inc. ("ISC")</holder>

</copyright>

<copyright>

<year>2000</year>

<year>2001</year>

<holder>Internet Software Consortium.</holder>

</copyright>

</docinfo>

<refnamediv>

<refname>lwres_conf_init</refname>

<refname>lwres_conf_clear</refname>

<refname>lwres_conf_parse</refname>

<refname>lwres_conf_print</refname>

<refname>lwres_conf_get</refname>

<refpurpose>lightweight resolver configuration</refpurpose>

</refnamediv>

<refsynopsisdiv>

<funcsynopsis>

<funcsynopsisinfo>#include &lt;lwres/lwres.h&gt;</funcsynopsisinfo>

<funcprototype>

<funcdef>

void

<function>lwres_conf_init</function></funcdef>

<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>

</funcprototype>

<funcprototype>

<funcdef>

void

<function>lwres_conf_clear</function></funcdef>

<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>

</funcprototype>

<funcprototype>

<funcdef>

lwres_result_t

<function>lwres_conf_parse</function></funcdef>

<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>

<paramdef>const char *<parameter>filename</parameter></paramdef>

</funcprototype>

<funcprototype>

<funcdef>

lwres_result_t

<function>lwres_conf_print</function></funcdef>

<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>

<paramdef>FILE *<parameter>fp</parameter></paramdef>

</funcprototype>

<funcprototype>

<funcdef>

lwres_conf_t *

<function>lwres_conf_get</function></funcdef>

<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>

</funcprototype>

</funcsynopsis>

</refsynopsisdiv>

<refsection><info><title>DESCRIPTION</title></info>

<para><function>lwres_conf_init()</function>

creates an empty

<type>lwres_conf_t</type>

structure for lightweight resolver context

<parameter>ctx</parameter>.

</para>

<para><function>lwres_conf_clear()</function>

frees up all the internal memory used by

that

<type>lwres_conf_t</type>

structure in resolver context

<parameter>ctx</parameter>.

</para>

<para><function>lwres_conf_parse()</function>

opens the file

<parameter>filename</parameter>

and parses it to initialise the resolver context

<parameter>ctx</parameter>'s

<type>lwres_conf_t</type>

structure.

</para>

<para><function>lwres_conf_print()</function>

prints the

<type>lwres_conf_t</type>

structure for resolver context

<parameter>ctx</parameter>

to the

<type>FILE</type>

<parameter>fp</parameter>.

</para>

</refsection>

<refsection><info><title>RETURN VALUES</title></info>

<para><function>lwres_conf_parse()</function>

returns <errorcode>LWRES_R_SUCCESS</errorcode>

if it successfully read and parsed

<parameter>filename</parameter>.

It returns <errorcode>LWRES_R_FAILURE</errorcode>

if <parameter>filename</parameter>

could not be opened or contained incorrect

resolver statements.

</para>

<para><function>lwres_conf_print()</function>

returns <errorcode>LWRES_R_SUCCESS</errorcode>

unless an error occurred when converting the network addresses to a

numeric host address string.

If this happens, the function returns

<errorcode>LWRES_R_FAILURE</errorcode>.

</para>

</refsection>

<refsection><info><title>SEE ALSO</title></info>

<para><citerefentry>

<refentrytitle>stdio</refentrytitle><manvolnum>3</manvolnum>

</citerefentry>,

<citerefentry>

<refentrytitle>resolver</refentrytitle><manvolnum>5</manvolnum>

</citerefentry>.

</para>

</refsection>

<refsection><info><title>FILES</title></info>

<para><filename>/etc/resolv.conf</filename>

</para>

</refsection>

</refentry>