lwres_config.html revision c651f15b30f1dae5cc2f00878fb5da5b3a35a468
1fdd2470b625a58b57d0b155e6caf8c4fc0afe8aAutomatic Updater - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews - Copyright (C) 2000, 2001 Internet Software Consortium.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Permission to use, copy, modify, and distribute this software for any
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - purpose with or without fee is hereby granted, provided that the above
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - copyright notice and this permission notice appear in all copies.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - PERFORMANCE OF THIS SOFTWARE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!-- $Id: lwres_config.html,v 1.10 2005/04/07 03:50:01 marka Exp $ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_config</TITLE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinNAME="GENERATOR"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFENTRY"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinBGCOLOR="#FFFFFF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinTEXT="#000000"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinLINK="#0000FF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinVLINK="#840084"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinALINK="#0000FF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_config</H1
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFNAMEDIV"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_conf_init, lwres_conf_clear, lwres_conf_parse, lwres_conf_print, lwres_conf_get -- lightweight resolver configuration</DIV
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFSYNOPSISDIV"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>Synopsis</H2
852ccdd42a71550c974111b49415204ffeca6573Automatic UpdaterCLASS="FUNCSYNOPSIS"
852ccdd42a71550c974111b49415204ffeca6573Automatic UpdaterCLASS="FUNCSYNOPSISINFO"
852ccdd42a71550c974111b49415204ffeca6573Automatic UpdaterCLASS="FUNCDEF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinlwres_conf_init</CODE
852ccdd42a71550c974111b49415204ffeca6573Automatic Updater>(lwres_context_t *ctx);</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="FUNCDEF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinlwres_conf_clear</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>(lwres_context_t *ctx);</CODE
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsCLASS="FUNCDEF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_result_t
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinlwres_conf_parse</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>(lwres_context_t *ctx, const char *filename);</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="FUNCDEF"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_result_t
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinlwres_conf_print</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>(lwres_context_t *ctx, FILE *fp);</CODE
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsCLASS="FUNCDEF"
58d9e9169e7ab4355a0b0bfc13bc616bc5247dfeAutomatic Updater>lwres_conf_t *
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrewslwres_conf_get</CODE
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews>(lwres_context_t *ctx);</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFSECT1"
acb72d5e2c83b597332e3eb0c7d59e1142f1adfdMark Andrews>DESCRIPTION</H2
852ccdd42a71550c974111b49415204ffeca6573Automatic UpdaterCLASS="FUNCTION"
852ccdd42a71550c974111b49415204ffeca6573Automatic Updater>lwres_conf_init()</CODE
852ccdd42a71550c974111b49415204ffeca6573Automatic Updatercreates an empty
852ccdd42a71550c974111b49415204ffeca6573Automatic Updater>lwres_conf_t</SPAN
852ccdd42a71550c974111b49415204ffeca6573Automatic Updaterstructure for lightweight resolver context
852ccdd42a71550c974111b49415204ffeca6573Automatic UpdaterCLASS="PARAMETER"
acb72d5e2c83b597332e3eb0c7d59e1142f1adfdMark AndrewsCLASS="FUNCTION"
acb72d5e2c83b597332e3eb0c7d59e1142f1adfdMark Andrews>lwres_conf_clear()</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinfrees up all the internal memory used by
38417cbfb1a328c20b5b723b8584a02c57f88897Automatic Updater>lwres_conf_t</SPAN
38417cbfb1a328c20b5b723b8584a02c57f88897Automatic Updaterstructure in resolver context
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="PARAMETER"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="FUNCTION"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_conf_parse()</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinopens the file
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="PARAMETER"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>filename</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinand parses it to initialise the resolver context
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="PARAMETER"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_conf_t</SPAN
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinstructure.</P
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="FUNCTION"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_conf_print()</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_conf_t</SPAN
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinstructure for resolver context
b05bdb520d83f7ecaad708fe305268c3420be01dMark AndrewsCLASS="PARAMETER"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="PARAMETER"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFSECT1"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>RETURN VALUES</H2
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="FUNCTION"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>lwres_conf_parse()</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="ERRORCODE"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>LWRES_R_SUCCESS</SPAN
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinif it successfully read and parsed
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="PARAMETER"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>filename</CODE
71c66a876ecca77923638d3f94cc0783152b2f03Mark AndrewsCLASS="ERRORCODE"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>LWRES_R_FAILURE</SPAN
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="PARAMETER"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>filename</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeincould not be opened or contained incorrect
852ccdd42a71550c974111b49415204ffeca6573Automatic Updaterresolver statements.</P
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsCLASS="FUNCTION"
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews>lwres_conf_print()</CODE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="ERRORCODE"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>LWRES_R_SUCCESS</SPAN
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinunless an error occurred when converting the network addresses to a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austeinnumeric host address string.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinIf this happens, the function returns
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsCLASS="ERRORCODE"
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews>LWRES_R_FAILURE</SPAN
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFSECT1"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>SEE ALSO</H2
bea931e17b7567f09107f93ab7e25c7f00abeb9cMark AndrewsCLASS="CITEREFENTRY"
852ccdd42a71550c974111b49415204ffeca6573Automatic UpdaterCLASS="REFENTRYTITLE"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="CITEREFENTRY"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFENTRYTITLE"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein>resolver</SPAN
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="REFSECT1"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCLASS="FILENAME"