lwres_config.html revision 75c0816e8295e180f4bc7f10db3d0d880383bc1c
c63ebf815c8a874525cf18670ad74847f7fc7b26Christian Maeder - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
7d170078860d52494588609be44be963c416ecf6Christian Maeder - Copyright (C) 2000, 2001 Internet Software Consortium.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - Permission to use, copy, modify, and distribute this software for any
43b4c41fbb07705c9df321221ab9cb9832460407Christian Maeder - purpose with or without fee is hereby granted, provided that the above
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - copyright notice and this permission notice appear in all copies.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
43b4c41fbb07705c9df321221ab9cb9832460407Christian Maeder - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
f4a2a20e49f41b2afa657e5e64d9e349c7faa091Christian Maeder - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
f2f9df2e17e70674f0bf426ed1763c973ee4cde0Christian Maeder - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
c9a7e6af169a2adfb92f42331cd578065ed83a2bChristian Maeder - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
c9a7e6af169a2adfb92f42331cd578065ed83a2bChristian Maeder - PERFORMANCE OF THIS SOFTWARE.
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<!-- $Id: lwres_config.html,v 1.13 2005/05/13 03:14:12 marka Exp $ -->
a53841f6d6e86ac751c12a33dc8aadf53f59d977Klaus Luettich<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
a53841f6d6e86ac751c12a33dc8aadf53f59d977Klaus Luettich<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
68d10d143f29fcff3c637ba24f90e983995ceae6Christian Maeder<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
96646aed2ae087b942ae23f15bbe729a8f7c43d3Christian Maeder<a name="id2456836"></a><div class="titlepage"></div>
9dac90ec2be2a72e03893095461960d483fe2fc2Christian Maeder<p>lwres_conf_init, lwres_conf_clear, lwres_conf_parse, lwres_conf_print, lwres_conf_get — lightweight resolver configuration</p>
e7757995211bd395dc79d26fe017d99375f7d2a6Christian Maeder<pre class="funcsynopsisinfo">#include <lwres/lwres.h></pre>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr>
c0c2380bced8159ff0297ece14eba948bd236471Christian Maeder<b class="fsfunc">lwres_conf_init</b>(</code></td>
ad270004874ce1d0697fb30d7309f180553bb315Christian Maeder<var class="pdparam">ctx</var><code>)</code>;</td>
4cb215739e9ab13447fa21162482ebe485b47455Christian Maeder<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder<b class="fsfunc">lwres_conf_clear</b>(</code></td>
8d97ef4f234681b11bb5924bd4d03adef858d2d2Christian Maeder<var class="pdparam">ctx</var><code>)</code>;</td>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em">
f38b3687c5558128515e34fb85d8b466d22dc300Christian Maederlwres_result_t
5191fa24c532d1f67e7a642e9aece65efb8a0975Christian Maeder<b class="fsfunc">lwres_conf_parse</b>(</code></td>
1aee4aaddde105264c1faf394d88e302c05094ffChristian Maeder<var class="pdparam">filename</var><code>)</code>;</td>
f4a2a20e49f41b2afa657e5e64d9e349c7faa091Christian Maeder<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em">
d0279930f87bf39843e0bd2992a4789322662144Christian Maederlwres_result_t
8be81a0578b59f08641da7fad1479e1f9e83c6e9Kristina Sojakova<b class="fsfunc">lwres_conf_print</b>(</code></td>
ea06324815fff0b73f7524f11af3672c2389f7ecChristian Maeder<var class="pdparam">fp</var><code>)</code>;</td>
a7c27282e71cf4505026645f96d4f5cb8a284e32Christian Maeder<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr>
8a28707e9155465c6f2236a06eac6580a65c7025Christian Maederlwres_conf_t *
f04e8f3ff56405901be968fd4c6e9769239f1a9bKlaus Luettich<b class="fsfunc">lwres_conf_get</b>(</code></td>
431d34c7007a787331c4e5ec997badb0f8190fc7Christian Maeder<var class="pdparam">ctx</var><code>)</code>;</td>
6dc9bc98d0854fe2e3dd3bfc4275096a0c28ee1cChristian Maeder<a name="id2514266"></a><h2>DESCRIPTION</h2>
6dc9bc98d0854fe2e3dd3bfc4275096a0c28ee1cChristian Maeder<p><code class="function">lwres_conf_init()</code>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder creates an empty
c0c2380bced8159ff0297ece14eba948bd236471Christian Maeder structure for lightweight resolver context
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <em class="parameter"><code>ctx</code></em>.
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder<p><code class="function">lwres_conf_clear()</code>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder frees up all the internal memory used by
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder structure in resolver context
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <em class="parameter"><code>ctx</code></em>.
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder<p><code class="function">lwres_conf_parse()</code>
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder opens the file
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder <em class="parameter"><code>filename</code></em>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder and parses it to initialise the resolver context
a5e5b8c3e5c11177e5034ef2423813a5d28979edChristian Maeder <em class="parameter"><code>ctx</code></em>'s
51d769d55d88dfa88bdf54bee78d8fa85a2deba8Christian Maeder<p><code class="function">lwres_conf_print()</code>
bc8cbf12aa172bf5673b92a9e7a0151d4aa4c315Christian Maeder structure for resolver context
2d130d212db7208777ca896a7ecad619a8944971Christian Maeder <em class="parameter"><code>ctx</code></em>
2d130d212db7208777ca896a7ecad619a8944971Christian Maeder <em class="parameter"><code>fp</code></em>.
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder<a name="id2514333"></a><h2>RETURN VALUES</h2>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder<p><code class="function">lwres_conf_parse()</code>
4017ebc0f692820736d796af3110c3b3018c108aChristian Maeder returns <span class="errorcode">LWRES_R_SUCCESS</span>
a9b59eb2ce961014974276cdae0e9df4419bd212Christian Maeder if it successfully read and parsed
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder <em class="parameter"><code>filename</code></em>.
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder It returns <span class="errorcode">LWRES_R_FAILURE</span>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder if <em class="parameter"><code>filename</code></em>
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder could not be opened or contained incorrect
6a79849bed67264c396dddb3e9c184bdfc1a1bc9Christian Maeder resolver statements.
dc679edd4ca027663212afdf00926ae2ce19b555Christian Maeder<p><code class="function">lwres_conf_print()</code>
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder returns <span class="errorcode">LWRES_R_SUCCESS</span>
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder unless an error occurred when converting the network addresses to a
63f0e65a37b95621334db9ee4ba0cd9d826f5c0fChristian Maeder numeric host address string.
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder If this happens, the function returns
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder <span class="errorcode">LWRES_R_FAILURE</span>.
0be0db405c49906bd7057255069bf6df53395ac9Klaus Luettich<p><span class="citerefentry"><span class="refentrytitle">stdio</span>(3)</span>,
ca074a78b8dcccbb8c419586787882f98d0c6163Christian Maeder <span class="citerefentry"><span class="refentrytitle">resolver</span>(5)</span>.
d946c1bfdd7d58aa7c023efe864d5999eb44a61bChristian Maeder<p><code class="filename">/etc/resolv.conf</code>