|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
- Copyright (C) Internet Systems Consortium, Inc. ("ISC")
|
|
Packit Service |
ae04f2 |
-
|
|
Packit Service |
ae04f2 |
- This Source Code Form is subject to the terms of the Mozilla Public
|
|
Packit Service |
ae04f2 |
- License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
Packit Service |
ae04f2 |
- file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
Packit Service |
ae04f2 |
-
|
|
Packit Service |
ae04f2 |
- See the COPYRIGHT file distributed with this work for additional
|
|
Packit Service |
ae04f2 |
- information regarding copyright ownership.
|
|
Packit Service |
ae04f2 |
-->
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0">
|
|
Packit Service |
ae04f2 |
<info>
|
|
Packit Service |
ae04f2 |
<date>2007-06-18</date>
|
|
Packit Service |
ae04f2 |
</info>
|
|
Packit Service |
ae04f2 |
<refentryinfo>
|
|
Packit Service |
ae04f2 |
<corpname>ISC</corpname>
|
|
Packit Service |
ae04f2 |
<corpauthor>Internet Systems Consortium, Inc.</corpauthor>
|
|
Packit Service |
ae04f2 |
</refentryinfo>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<refmeta>
|
|
Packit Service |
ae04f2 |
<refentrytitle>lwres_config</refentrytitle>
|
|
Packit Service |
ae04f2 |
<manvolnum>3</manvolnum>
|
|
Packit Service |
ae04f2 |
<refmiscinfo>BIND9</refmiscinfo>
|
|
Packit Service |
ae04f2 |
</refmeta>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<docinfo>
|
|
Packit Service |
ae04f2 |
<copyright>
|
|
Packit Service |
ae04f2 |
<year>2000</year>
|
|
Packit Service |
ae04f2 |
<year>2001</year>
|
|
Packit Service |
ae04f2 |
<year>2004</year>
|
|
Packit Service |
ae04f2 |
<year>2005</year>
|
|
Packit Service |
ae04f2 |
<year>2007</year>
|
|
Packit Service |
ae04f2 |
<year>2014</year>
|
|
Packit Service |
ae04f2 |
<year>2015</year>
|
|
Packit Service |
ae04f2 |
<year>2016</year>
|
|
Packit Service |
ae04f2 |
<year>2018</year>
|
|
Packit Service |
ae04f2 |
<year>2019</year>
|
|
Packit Service |
ae04f2 |
<year>2020</year>
|
|
Packit Service |
ae04f2 |
<holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
|
Packit Service |
ae04f2 |
</copyright>
|
|
Packit Service |
ae04f2 |
</docinfo>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<refnamediv>
|
|
Packit Service |
ae04f2 |
<refname>lwres_conf_init</refname>
|
|
Packit Service |
ae04f2 |
<refname>lwres_conf_clear</refname>
|
|
Packit Service |
ae04f2 |
<refname>lwres_conf_parse</refname>
|
|
Packit Service |
ae04f2 |
<refname>lwres_conf_print</refname>
|
|
Packit Service |
ae04f2 |
<refname>lwres_conf_get</refname>
|
|
Packit Service |
ae04f2 |
<refpurpose>lightweight resolver configuration</refpurpose>
|
|
Packit Service |
ae04f2 |
</refnamediv>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<refsynopsisdiv>
|
|
Packit Service |
ae04f2 |
<funcsynopsis>
|
|
Packit Service |
ae04f2 |
<funcsynopsisinfo>#include <lwres/lwres.h></funcsynopsisinfo>
|
|
Packit Service |
ae04f2 |
<funcprototype>
|
|
Packit Service |
ae04f2 |
<funcdef>
|
|
Packit Service |
ae04f2 |
void
|
|
Packit Service |
ae04f2 |
<function>lwres_conf_init</function></funcdef>
|
|
Packit Service |
ae04f2 |
<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>
|
|
Packit Service |
ae04f2 |
</funcprototype>
|
|
Packit Service |
ae04f2 |
<funcprototype>
|
|
Packit Service |
ae04f2 |
<funcdef>
|
|
Packit Service |
ae04f2 |
void
|
|
Packit Service |
ae04f2 |
<function>lwres_conf_clear</function></funcdef>
|
|
Packit Service |
ae04f2 |
<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>
|
|
Packit Service |
ae04f2 |
</funcprototype>
|
|
Packit Service |
ae04f2 |
<funcprototype>
|
|
Packit Service |
ae04f2 |
<funcdef>
|
|
Packit Service |
ae04f2 |
lwres_result_t
|
|
Packit Service |
ae04f2 |
<function>lwres_conf_parse</function></funcdef>
|
|
Packit Service |
ae04f2 |
<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>
|
|
Packit Service |
ae04f2 |
<paramdef>const char *<parameter>filename</parameter></paramdef>
|
|
Packit Service |
ae04f2 |
</funcprototype>
|
|
Packit Service |
ae04f2 |
<funcprototype>
|
|
Packit Service |
ae04f2 |
<funcdef>
|
|
Packit Service |
ae04f2 |
lwres_result_t
|
|
Packit Service |
ae04f2 |
<function>lwres_conf_print</function></funcdef>
|
|
Packit Service |
ae04f2 |
<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>
|
|
Packit Service |
ae04f2 |
<paramdef>FILE *<parameter>fp</parameter></paramdef>
|
|
Packit Service |
ae04f2 |
</funcprototype>
|
|
Packit Service |
ae04f2 |
<funcprototype>
|
|
Packit Service |
ae04f2 |
<funcdef>
|
|
Packit Service |
ae04f2 |
lwres_conf_t *
|
|
Packit Service |
ae04f2 |
<function>lwres_conf_get</function></funcdef>
|
|
Packit Service |
ae04f2 |
<paramdef>lwres_context_t *<parameter>ctx</parameter></paramdef>
|
|
Packit Service |
ae04f2 |
</funcprototype>
|
|
Packit Service |
ae04f2 |
</funcsynopsis>
|
|
Packit Service |
ae04f2 |
</refsynopsisdiv>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<refsection><info><title>DESCRIPTION</title></info>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<para><function>lwres_conf_init()</function>
|
|
Packit Service |
ae04f2 |
creates an empty
|
|
Packit Service |
ae04f2 |
<type>lwres_conf_t</type>
|
|
Packit Service |
ae04f2 |
structure for lightweight resolver context
|
|
Packit Service |
ae04f2 |
<parameter>ctx</parameter>.
|
|
Packit Service |
ae04f2 |
</para>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<para><function>lwres_conf_clear()</function>
|
|
Packit Service |
ae04f2 |
frees up all the internal memory used by
|
|
Packit Service |
ae04f2 |
that
|
|
Packit Service |
ae04f2 |
<type>lwres_conf_t</type>
|
|
Packit Service |
ae04f2 |
structure in resolver context
|
|
Packit Service |
ae04f2 |
<parameter>ctx</parameter>.
|
|
Packit Service |
ae04f2 |
</para>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<para><function>lwres_conf_parse()</function>
|
|
Packit Service |
ae04f2 |
opens the file
|
|
Packit Service |
ae04f2 |
<parameter>filename</parameter>
|
|
Packit Service |
ae04f2 |
and parses it to initialise the resolver context
|
|
Packit Service |
ae04f2 |
<parameter>ctx</parameter>'s
|
|
Packit Service |
ae04f2 |
<type>lwres_conf_t</type>
|
|
Packit Service |
ae04f2 |
structure.
|
|
Packit Service |
ae04f2 |
</para>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<para><function>lwres_conf_print()</function>
|
|
Packit Service |
ae04f2 |
prints the
|
|
Packit Service |
ae04f2 |
<type>lwres_conf_t</type>
|
|
Packit Service |
ae04f2 |
structure for resolver context
|
|
Packit Service |
ae04f2 |
<parameter>ctx</parameter>
|
|
Packit Service |
ae04f2 |
to the
|
|
Packit Service |
ae04f2 |
<type>FILE</type>
|
|
Packit Service |
ae04f2 |
<parameter>fp</parameter>.
|
|
Packit Service |
ae04f2 |
</para>
|
|
Packit Service |
ae04f2 |
</refsection>
|
|
Packit Service |
ae04f2 |
<refsection><info><title>RETURN VALUES</title></info>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<para><function>lwres_conf_parse()</function>
|
|
Packit Service |
ae04f2 |
returns <errorcode>LWRES_R_SUCCESS</errorcode>
|
|
Packit Service |
ae04f2 |
if it successfully read and parsed
|
|
Packit Service |
ae04f2 |
<parameter>filename</parameter>.
|
|
Packit Service |
ae04f2 |
It returns <errorcode>LWRES_R_FAILURE</errorcode>
|
|
Packit Service |
ae04f2 |
if <parameter>filename</parameter>
|
|
Packit Service |
ae04f2 |
could not be opened or contained incorrect
|
|
Packit Service |
ae04f2 |
resolver statements.
|
|
Packit Service |
ae04f2 |
</para>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<para><function>lwres_conf_print()</function>
|
|
Packit Service |
ae04f2 |
returns <errorcode>LWRES_R_SUCCESS</errorcode>
|
|
Packit Service |
ae04f2 |
unless an error occurred when converting the network addresses to a
|
|
Packit Service |
ae04f2 |
numeric host address string.
|
|
Packit Service |
ae04f2 |
If this happens, the function returns
|
|
Packit Service |
ae04f2 |
<errorcode>LWRES_R_FAILURE</errorcode>.
|
|
Packit Service |
ae04f2 |
</para>
|
|
Packit Service |
ae04f2 |
</refsection>
|
|
Packit Service |
ae04f2 |
<refsection><info><title>SEE ALSO</title></info>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<para><citerefentry>
|
|
Packit Service |
ae04f2 |
<refentrytitle>stdio</refentrytitle><manvolnum>3</manvolnum>
|
|
Packit Service |
ae04f2 |
</citerefentry>,
|
|
Packit Service |
ae04f2 |
<citerefentry>
|
|
Packit Service |
ae04f2 |
<refentrytitle>resolver</refentrytitle><manvolnum>5</manvolnum>
|
|
Packit Service |
ae04f2 |
</citerefentry>.
|
|
Packit Service |
ae04f2 |
</para>
|
|
Packit Service |
ae04f2 |
</refsection>
|
|
Packit Service |
ae04f2 |
<refsection><info><title>FILES</title></info>
|
|
Packit Service |
ae04f2 |
|
|
Packit Service |
ae04f2 |
<para><filename>/etc/resolv.conf</filename>
|
|
Packit Service |
ae04f2 |
</para>
|
|
Packit Service |
ae04f2 |
</refsection>
|
|
Packit Service |
ae04f2 |
</refentry>
|