1<!-- 2 - Copyright (C) 2004, 2005, 2007, 2014 Internet Systems Consortium, Inc. ("ISC") 3 - Copyright (C) 2000, 2001 Internet Software Consortium. 4 - 5 - Permission to use, copy, modify, and/or distribute this software for any 6 - purpose with or without fee is hereby granted, provided that the above 7 - copyright notice and this permission notice appear in all copies. 8 - 9 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH 10 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY 11 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, 12 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 13 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 14 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 15 - PERFORMANCE OF THIS SOFTWARE. 16--> 17<!-- Id --> 18<html> 19<head> 20<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 21<title>lwres_config</title> 22<meta name="generator" content="DocBook XSL Stylesheets V1.71.1"> 23</head> 24<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> 25<a name="id2476275"></a><div class="titlepage"></div> 26<div class="refnamediv"> 27<h2>Name</h2> 28<p>lwres_conf_init, lwres_conf_clear, lwres_conf_parse, lwres_conf_print, lwres_conf_get — lightweight resolver configuration</p> 29</div> 30<div class="refsynopsisdiv"> 31<h2>Synopsis</h2> 32<div class="funcsynopsis"> 33<pre class="funcsynopsisinfo">#include <lwres/lwres.h></pre> 34<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr> 35<td><code class="funcdef"> 36void 37<b class="fsfunc">lwres_conf_init</b>(</code></td> 38<td>lwres_context_t *�</td> 39<td> 40<var class="pdparam">ctx</var><code>)</code>;</td> 41</tr></table> 42<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"><tr> 43<td><code class="funcdef"> 44void 45<b class="fsfunc">lwres_conf_clear</b>(</code></td> 46<td>lwres_context_t *�</td> 47<td> 48<var class="pdparam">ctx</var><code>)</code>;</td> 49</tr></table> 50<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"> 51<tr> 52<td><code class="funcdef"> 53lwres_result_t 54<b class="fsfunc">lwres_conf_parse</b>(</code></td> 55<td>lwres_context_t *�</td> 56<td> 57<var class="pdparam">ctx</var>, </td> 58</tr> 59<tr> 60<td>�</td> 61<td>const char *�</td> 62<td> 63<var class="pdparam">filename</var><code>)</code>;</td> 64</tr> 65</table> 66<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" style="padding-bottom: 1em"> 67<tr> 68<td><code class="funcdef"> 69lwres_result_t 70<b class="fsfunc">lwres_conf_print</b>(</code></td> 71<td>lwres_context_t *�</td> 72<td> 73<var class="pdparam">ctx</var>, </td> 74</tr> 75<tr> 76<td>�</td> 77<td>FILE *�</td> 78<td> 79<var class="pdparam">fp</var><code>)</code>;</td> 80</tr> 81</table> 82<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr> 83<td><code class="funcdef"> 84lwres_conf_t * 85<b class="fsfunc">lwres_conf_get</b>(</code></td> 86<td>lwres_context_t *�</td> 87<td> 88<var class="pdparam">ctx</var><code>)</code>;</td> 89</tr></table> 90</div> 91</div> 92<div class="refsect1" lang="en"> 93<a name="id2543450"></a><h2>DESCRIPTION</h2> 94<p><code class="function">lwres_conf_init()</code> 95 creates an empty 96 <span class="type">lwres_conf_t</span> 97 structure for lightweight resolver context 98 <em class="parameter"><code>ctx</code></em>. 99 </p> 100<p><code class="function">lwres_conf_clear()</code> 101 frees up all the internal memory used by 102 that 103 <span class="type">lwres_conf_t</span> 104 structure in resolver context 105 <em class="parameter"><code>ctx</code></em>. 106 </p> 107<p><code class="function">lwres_conf_parse()</code> 108 opens the file 109 <em class="parameter"><code>filename</code></em> 110 and parses it to initialise the resolver context 111 <em class="parameter"><code>ctx</code></em>'s 112 <span class="type">lwres_conf_t</span> 113 structure. 114 </p> 115<p><code class="function">lwres_conf_print()</code> 116 prints the 117 <span class="type">lwres_conf_t</span> 118 structure for resolver context 119 <em class="parameter"><code>ctx</code></em> 120 to the 121 <span class="type">FILE</span> 122 <em class="parameter"><code>fp</code></em>. 123 </p> 124</div> 125<div class="refsect1" lang="en"> 126<a name="id2543517"></a><h2>RETURN VALUES</h2> 127<p><code class="function">lwres_conf_parse()</code> 128 returns <span class="errorcode">LWRES_R_SUCCESS</span> 129 if it successfully read and parsed 130 <em class="parameter"><code>filename</code></em>. 131 It returns <span class="errorcode">LWRES_R_FAILURE</span> 132 if <em class="parameter"><code>filename</code></em> 133 could not be opened or contained incorrect 134 resolver statements. 135 </p> 136<p><code class="function">lwres_conf_print()</code> 137 returns <span class="errorcode">LWRES_R_SUCCESS</span> 138 unless an error occurred when converting the network addresses to a 139 numeric host address string. 140 If this happens, the function returns 141 <span class="errorcode">LWRES_R_FAILURE</span>. 142 </p> 143</div> 144<div class="refsect1" lang="en"> 145<a name="id2543555"></a><h2>SEE ALSO</h2> 146<p><span class="citerefentry"><span class="refentrytitle">stdio</span>(3)</span>, 147 <span class="citerefentry"><span class="refentrytitle">resolver</span>(5)</span>. 148 </p> 149</div> 150<div class="refsect1" lang="en"> 151<a name="id2543580"></a><h2>FILES</h2> 152<p><code class="filename">/etc/resolv.conf</code> 153 </p> 154</div> 155</div></body> 156</html> 157