lwres_config.docbook revision d4ef65050feac78554addf6e16a06c6e2e0bd331
4d237bbe075b1d2c19428cd954d721d65b31f67cwrowe<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
bf52162f2d05c1fb1a107c7ef108de73f739b3edpquerna<!--
bf52162f2d05c1fb1a107c7ef108de73f739b3edpquerna - Copyright (C) 2001 Internet Software Consortium.
bf52162f2d05c1fb1a107c7ef108de73f739b3edpquerna -
86bb763be5d87c295c8844d30078da2ddb964f73rpluem - Permission to use, copy, modify, and distribute this software for any
86bb763be5d87c295c8844d30078da2ddb964f73rpluem - purpose with or without fee is hereby granted, provided that the above
ba217dc41cebc0976010ee177f8fedac782d1f6fminfrin - copyright notice and this permission notice appear in all copies.
ba217dc41cebc0976010ee177f8fedac782d1f6fminfrin -
86bb763be5d87c295c8844d30078da2ddb964f73rpluem - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
86bb763be5d87c295c8844d30078da2ddb964f73rpluem - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
ba217dc41cebc0976010ee177f8fedac782d1f6fminfrin - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
ba217dc41cebc0976010ee177f8fedac782d1f6fminfrin - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
7ba7402d405dc9e3c1083e34049ed933472ca910poirier - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
7ba7402d405dc9e3c1083e34049ed933472ca910poirier - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
7ba7402d405dc9e3c1083e34049ed933472ca910poirier - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
7ba7402d405dc9e3c1083e34049ed933472ca910poirier - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
7ba7402d405dc9e3c1083e34049ed933472ca910poirier-->
4286d2e267e788d856092bf2ccf461e7ca99570frpluem
4286d2e267e788d856092bf2ccf461e7ca99570frpluem<!-- $Id: lwres_config.docbook,v 1.2 2001/04/10 21:51:21 bwelling Exp $ -->
4286d2e267e788d856092bf2ccf461e7ca99570frpluem
4286d2e267e788d856092bf2ccf461e7ca99570frpluem<refentry>
5357892a1e367372dc2d4a315156e3e44dc5d56dpoirier<refentryinfo>
5357892a1e367372dc2d4a315156e3e44dc5d56dpoirier
5357892a1e367372dc2d4a315156e3e44dc5d56dpoirier<date>Jun 30, 2000</date>
b42af5f6edf4fe4b820288c37920a7a6fd65f1f1poirier</refentryinfo>
b42af5f6edf4fe4b820288c37920a7a6fd65f1f1poirier
b42af5f6edf4fe4b820288c37920a7a6fd65f1f1poirier<refmeta>
49cea03e96dc4707bce15d6318eb013cb8668d96minfrin<refentrytitle>lwres_config</refentrytitle>
49cea03e96dc4707bce15d6318eb013cb8668d96minfrin<manvolnum>3</manvolnum>
49cea03e96dc4707bce15d6318eb013cb8668d96minfrin<refmiscinfo>BIND9</refmiscinfo>
49cea03e96dc4707bce15d6318eb013cb8668d96minfrin</refmeta>
847b3922f7dcde6830f4aad49d29c84b4569c260minfrin
63eaa8ed62d63de0a44346b8af48e08e562db01eminfrin<refnamediv>
63eaa8ed62d63de0a44346b8af48e08e562db01eminfrin<refname>lwres_conf_init</refname>
847b3922f7dcde6830f4aad49d29c84b4569c260minfrin<refname>lwres_conf_clear</refname>
1af2b28846e2647963db788b081676884fb7df8crpluem<refname>lwres_conf_parse</refname>
1af2b28846e2647963db788b081676884fb7df8crpluem<refname>lwres_conf_print</refname>
1af2b28846e2647963db788b081676884fb7df8crpluem<refname>lwres_conf_get</refname>
845258fbf5102b8b09fe9b7f4cb4ea4c089344c3poirier<refpurpose>lightweight resolver configuration</refpurpose>
845258fbf5102b8b09fe9b7f4cb4ea4c089344c3poirier</refnamediv>
845258fbf5102b8b09fe9b7f4cb4ea4c089344c3poirier
5d36cddfe00d5c6ad18845fcc04e6f7662050fafminfrin<refsynopsisdiv>
5d36cddfe00d5c6ad18845fcc04e6f7662050fafminfrin<funcsynopsis>
5d36cddfe00d5c6ad18845fcc04e6f7662050fafminfrin<funcsynopsisinfo>#include &lt;lwres/lwres.h&gt;</funcsynopsisinfo>
20aa41f86a5b451529d26d9b901eea69989e5c0aminfrin<funcprototype>
20aa41f86a5b451529d26d9b901eea69989e5c0aminfrin<funcdef>
20aa41f86a5b451529d26d9b901eea69989e5c0aminfrinvoid
8c92aeeb75b1b393f61a3e01c495484737a0ff8cminfrin<function>lwres_conf_init</function></funcdef>
8c92aeeb75b1b393f61a3e01c495484737a0ff8cminfrin<paramdef>lwres_context_t *ctx</paramdef>
8c92aeeb75b1b393f61a3e01c495484737a0ff8cminfrin</funcprototype>
1018201f5223624476334c6e23aead02db7c4040minfrin<funcprototype>
1018201f5223624476334c6e23aead02db7c4040minfrin<funcdef>
e5db2522dbe503cbf5399094b6239c88c246a8c5poiriervoid
e5db2522dbe503cbf5399094b6239c88c246a8c5poirier<function>lwres_conf_clear</function></funcdef>
e5db2522dbe503cbf5399094b6239c88c246a8c5poirier<paramdef>lwres_context_t *ctx</paramdef>
e5db2522dbe503cbf5399094b6239c88c246a8c5poirier</funcprototype>
ad7e5e9fb8f63a5155bb392114162997505ff772minfrin<funcprototype>
ad7e5e9fb8f63a5155bb392114162997505ff772minfrin<funcdef>
ad7e5e9fb8f63a5155bb392114162997505ff772minfrinlwres_result_t
ad7e5e9fb8f63a5155bb392114162997505ff772minfrin<function>lwres_conf_parse</function></funcdef>
ad7e5e9fb8f63a5155bb392114162997505ff772minfrin<paramdef>lwres_context_t *ctx</paramdef>
ad7e5e9fb8f63a5155bb392114162997505ff772minfrin<paramdef>const char *filename</paramdef>
59cb8d601b8c44476e59310f68b9c373d8fc62a6minfrin</funcprototype>
59cb8d601b8c44476e59310f68b9c373d8fc62a6minfrin<funcprototype>
59cb8d601b8c44476e59310f68b9c373d8fc62a6minfrin<funcdef>
59cb8d601b8c44476e59310f68b9c373d8fc62a6minfrinlwres_result_t
ec8b1faa56744b338f6d6421144b56c2bb3faae6poirier<function>lwres_conf_print</function></funcdef>
ec8b1faa56744b338f6d6421144b56c2bb3faae6poirier<paramdef>lwres_context_t *ctx</paramdef>
10abdcbd7b30d957d15c61ea8100ba97a627ac95minfrin<paramdef>FILE *fp</paramdef>
10abdcbd7b30d957d15c61ea8100ba97a627ac95minfrin</funcprototype>
87e0bf269cc3386ee8e6ab561ff00770151f4f53niq<funcprototype>
87e0bf269cc3386ee8e6ab561ff00770151f4f53niq<funcdef>
87e0bf269cc3386ee8e6ab561ff00770151f4f53niqlwres_conf_t *
3c67b7956d44501360506a9f13a5011be73b30ecminfrin<function>lwres_conf_get</function></funcdef>
3c67b7956d44501360506a9f13a5011be73b30ecminfrin<paramdef>lwres_context_t *ctx</paramdef>
3c67b7956d44501360506a9f13a5011be73b30ecminfrin</funcprototype>
3c67b7956d44501360506a9f13a5011be73b30ecminfrin</funcsynopsis>
97d20d37d21b8d427a920e211858172f0a82427epoirier</refsynopsisdiv>
97d20d37d21b8d427a920e211858172f0a82427epoirier
97d20d37d21b8d427a920e211858172f0a82427epoirier<refsect1>
8e04e8ec7d682bff5e6dccdd70c082971a88cb8bniq<title>DESCRIPTION</title>
8e04e8ec7d682bff5e6dccdd70c082971a88cb8bniq<para>
8e04e8ec7d682bff5e6dccdd70c082971a88cb8bniq<function>lwres_conf_init()</function>
53c999a82fcca729dabc8a512b3fb996d61fd814niqcreates an empty
53c999a82fcca729dabc8a512b3fb996d61fd814niq<type>lwres_conf_t</type>
53c999a82fcca729dabc8a512b3fb996d61fd814niqstructure for lightweight resolver context
53c999a82fcca729dabc8a512b3fb996d61fd814niq<parameter>ctx</parameter>.
25d0f8adcab13255494a3572edff1a25f6fbeea3rpluem</para>
25d0f8adcab13255494a3572edff1a25f6fbeea3rpluem<para>
25d0f8adcab13255494a3572edff1a25f6fbeea3rpluem<function>lwres_conf_clear()</function>
25d0f8adcab13255494a3572edff1a25f6fbeea3rpluemfrees up all the internal memory used by
dd9ae259e1578c4388739c880ede97c55cec543frpluemthat
dd9ae259e1578c4388739c880ede97c55cec543frpluem<type>lwres_conf_t</type>
dd9ae259e1578c4388739c880ede97c55cec543frpluemstructure in resolver context
0938450cadc9a083d112a86bc7dd7ae34f791364trawick<parameter>ctx</parameter>.
0938450cadc9a083d112a86bc7dd7ae34f791364trawick</para>
0938450cadc9a083d112a86bc7dd7ae34f791364trawick<para>
8bed7ee6d97933b958e97e222f37154d83e384e5jorton<function>lwres_conf_parse()</function>
8bed7ee6d97933b958e97e222f37154d83e384e5jortonopens the file
8bed7ee6d97933b958e97e222f37154d83e384e5jorton<parameter>filename</parameter>
8bed7ee6d97933b958e97e222f37154d83e384e5jortonand parses it to initialise the resolver context
8bed7ee6d97933b958e97e222f37154d83e384e5jorton<parameter>ctx</parameter>'s
d33ddda47790d3295f4218f87e3a296cf51a9becmjc<type>lwres_conf_t</type>
c7d46b58052fe666c74a47bd26b6cb1e351492adrpluemstructure.
4e08c8c1a91e2887b41d8cacd3aa532355d0237drpluem</para>
7a25b029b69f169bd22718165dff3b271114f92eniq<para>
43d051c8401a1f3b4f7853cd897d3565ab814ea7poirier<function>lwres_conf_print()</function>
43d051c8401a1f3b4f7853cd897d3565ab814ea7poirierprints the
43d051c8401a1f3b4f7853cd897d3565ab814ea7poirier<type>lwres_conf_t</type>
2f34374f6e04b9094a1d13a5ed823f331ba841a3rpluemstructure for resolver context
2f34374f6e04b9094a1d13a5ed823f331ba841a3rpluem<parameter>ctx</parameter>
2f34374f6e04b9094a1d13a5ed823f331ba841a3rpluemto the
7a25b029b69f169bd22718165dff3b271114f92eniq<type>FILE</type>
7a25b029b69f169bd22718165dff3b271114f92eniq<parameter>fp</parameter>.
7a25b029b69f169bd22718165dff3b271114f92eniq</para>
2f34374f6e04b9094a1d13a5ed823f331ba841a3rpluem</refsect1>
3e6a46d2fecf446daf0e280a49fa5565f5f635eajorton<refsect1>
3e6a46d2fecf446daf0e280a49fa5565f5f635eajorton
3e6a46d2fecf446daf0e280a49fa5565f5f635eajorton<title>RETURN VALUES</title>
137e484e5f984ceff1102e1212dda8ac0413231aniq<para>
0df8f79d2324b131c36955d7e474a735a762f9eeniq<function>lwres_conf_parse()</function>
0df8f79d2324b131c36955d7e474a735a762f9eeniqreturns
0df8f79d2324b131c36955d7e474a735a762f9eeniq<errorcode>LWRES_R_SUCCESS</errorcode>
30e3e760b737f13ce800fa02c5930ade7659ba66niqif it successfully read and parsed
30e3e760b737f13ce800fa02c5930ade7659ba66niq<parameter>filename</parameter>.
30e3e760b737f13ce800fa02c5930ade7659ba66niqIt returns
80370e62044bea458bcd0545c59cb864ed117b04niq<errorcode>LWRES_R_FAILURE</errorcode>
e991c6fc032c59eb6cb751d9d382e933a53a2866niqif
e991c6fc032c59eb6cb751d9d382e933a53a2866niq<parameter>filename</parameter>
e991c6fc032c59eb6cb751d9d382e933a53a2866niqcould not be opened or contained incorrect
9a00e2d46c44c111d6952e553a2f1a61b7594eb3rpluemresolver statements.
9a00e2d46c44c111d6952e553a2f1a61b7594eb3rpluem</para>
9a00e2d46c44c111d6952e553a2f1a61b7594eb3rpluem<para>
33d9be77cc6f5fc8734e9c1f526b82d359955152rpluem<function>lwres_conf_print()</function>
9a00e2d46c44c111d6952e553a2f1a61b7594eb3rpluemreturns
33d9be77cc6f5fc8734e9c1f526b82d359955152rpluem<errorcode>LWRES_R_SUCCESS</errorcode>
da128c59ec571c4dff70f41ecba9c8a9974c6cd6niqunless an error occurred when converting the network addresses to a
172e83c0f024fe6396dd1f3ca3492fd83c304db5jimnumeric host address string.
da128c59ec571c4dff70f41ecba9c8a9974c6cd6niqIf this happens, the function returns
45932a847f237b4d8f0667b138bd3f8a15fb53ffniq<errorcode>LWRES_R_FAILURE</errorcode>.
45932a847f237b4d8f0667b138bd3f8a15fb53ffniq</para>
45932a847f237b4d8f0667b138bd3f8a15fb53ffniq</refsect1>
186e9d990f453d16826ab87a87df7b87e6e05921rpluem<refsect1>
186e9d990f453d16826ab87a87df7b87e6e05921rpluem<title>SEE ALSO</title>
186e9d990f453d16826ab87a87df7b87e6e05921rpluem<para>
186e9d990f453d16826ab87a87df7b87e6e05921rpluem<citerefentry>
6861702c2d883e5c0744d5f7528d2060671ad24dtakashi<refentrytitle>stdio</refentrytitle><manvolnum>3</manvolnum>
6861702c2d883e5c0744d5f7528d2060671ad24dtakashi</citerefentry>,
6861702c2d883e5c0744d5f7528d2060671ad24dtakashi<citerefentry>
6861702c2d883e5c0744d5f7528d2060671ad24dtakashi<refentrytitle>resolver</refentrytitle><manvolnum>5</manvolnum>
6861702c2d883e5c0744d5f7528d2060671ad24dtakashi</citerefentry>.
f1f779c42f76118102fdecbe8777b47a1fc693a7rjung</refsect1>
f1f779c42f76118102fdecbe8777b47a1fc693a7rjung<refsect1>
f1f779c42f76118102fdecbe8777b47a1fc693a7rjung<title>FILES</title>
292cb7b720095e7bb434d79ae53b02d332aeb99acovener<para>
292cb7b720095e7bb434d79ae53b02d332aeb99acovener<filename>/etc/resolv.conf</filename>
292cb7b720095e7bb434d79ae53b02d332aeb99acovener</para>
292cb7b720095e7bb434d79ae53b02d332aeb99acovener</refsect1>
137e484e5f984ceff1102e1212dda8ac0413231aniq</refentry>
137e484e5f984ceff1102e1212dda8ac0413231aniq