← Back to branch summary

~andreserl/ubuntu/lucid/bind9/bind9-apport-533601

« back to all changes in this revision

Viewing changes to lib/lwres/man/lwres_hstrerror.html

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2006-01-05 12:29:28 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060105122928-oih7ttkkmpb90q8q
Tags: 1:9.3.2-1
* New upstream
* use lsb-base for start/stop messages in init.d.
* switch to debhelper 4

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/lwres/man/lwres_hstrerror.html
1
1
<!--
2
 
 - Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
3
 
 - Copyright (C) 2001  Internet Software Consortium.
4
 
 -
 
2
 - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
 
3
 - Copyright (C) 2000, 2001 Internet Software Consortium.
 
4
 - 
5
5
 - Permission to use, copy, modify, and distribute this software for any
6
6
 - purpose with or without fee is hereby granted, provided that the above
7
7
 - copyright notice and this permission notice appear in all copies.
8
 
 -
 
8
 - 
9
9
 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10
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,
 
11
 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12
12
 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13
13
 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14
14
 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15
15
 - PERFORMANCE OF THIS SOFTWARE.
16
16
-->
17
 
 
18
 
<!-- $Id: lwres_hstrerror.html,v 1.5.2.1.4.2 2004/08/22 23:39:04 marka Exp $ -->
19
 
 
20
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
21
 
<HTML
22
 
><HEAD
23
 
><TITLE
24
 
>lwres_hstrerror</TITLE
25
 
><META
26
 
NAME="GENERATOR"
27
 
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
28
 
><BODY
29
 
CLASS="REFENTRY"
30
 
BGCOLOR="#FFFFFF"
31
 
TEXT="#000000"
32
 
LINK="#0000FF"
33
 
VLINK="#840084"
34
 
ALINK="#0000FF"
35
 
><H1
36
 
><A
37
 
NAME="AEN1"
38
 
></A
39
 
>lwres_hstrerror</H1
40
 
><DIV
41
 
CLASS="REFNAMEDIV"
42
 
><A
43
 
NAME="AEN8"
44
 
></A
45
 
><H2
46
 
>Name</H2
47
 
>lwres_herror, lwres_hstrerror&nbsp;--&nbsp;lightweight resolver error message generation</DIV
48
 
><DIV
49
 
CLASS="REFSYNOPSISDIV"
50
 
><A
51
 
NAME="AEN12"
52
 
></A
53
 
><H2
54
 
>Synopsis</H2
55
 
><DIV
56
 
CLASS="FUNCSYNOPSIS"
57
 
><P
58
 
></P
59
 
><A
60
 
NAME="AEN13"
61
 
></A
62
 
><PRE
63
 
CLASS="FUNCSYNOPSISINFO"
64
 
>#include &lt;lwres/netdb.h&gt;</PRE
65
 
><P
66
 
><CODE
67
 
><CODE
68
 
CLASS="FUNCDEF"
69
 
>void
70
 
lwres_herror</CODE
71
 
>(const char *s);</CODE
72
 
></P
73
 
><P
74
 
><CODE
75
 
><CODE
76
 
CLASS="FUNCDEF"
77
 
>const char *
78
 
lwres_hstrerror</CODE
79
 
>(int err);</CODE
80
 
></P
81
 
><P
82
 
></P
83
 
></DIV
84
 
></DIV
85
 
><DIV
86
 
CLASS="REFSECT1"
87
 
><A
88
 
NAME="AEN23"
89
 
></A
90
 
><H2
91
 
>DESCRIPTION</H2
92
 
><P
93
 
><CODE
94
 
CLASS="FUNCTION"
95
 
>lwres_herror()</CODE
96
 
> prints the string
97
 
<VAR
98
 
CLASS="PARAMETER"
99
 
>s</VAR
100
 
> on <SPAN
101
 
CLASS="TYPE"
102
 
>stderr</SPAN
103
 
> followed by the string
104
 
generated by <CODE
105
 
CLASS="FUNCTION"
106
 
>lwres_hstrerror()</CODE
107
 
> for the error code
108
 
stored in the global variable <CODE
109
 
CLASS="CONSTANT"
110
 
>lwres_h_errno</CODE
111
 
>.</P
112
 
><P
113
 
><CODE
114
 
CLASS="FUNCTION"
115
 
>lwres_hstrerror()</CODE
116
 
> returns an appropriate string
117
 
for the error code gievn by <VAR
118
 
CLASS="PARAMETER"
119
 
>err</VAR
120
 
>.  The values of
 
17
<!-- $Id: lwres_hstrerror.html,v 1.5.2.1.4.9 2005/10/13 02:33:57 marka Exp $ -->
 
18
<html>
 
19
<head>
 
20
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 
21
<title>lwres_hstrerror</title>
 
22
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
 
23
</head>
 
24
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
 
25
<a name="id2463721"></a><div class="titlepage"></div>
 
26
<div class="refnamediv">
 
27
<h2>Name</h2>
 
28
<p>lwres_herror, lwres_hstrerror &#8212; lightweight resolver error message generation</p>
 
29
</div>
 
30
<div class="refsynopsisdiv">
 
31
<h2>Synopsis</h2>
 
32
<div class="funcsynopsis">
 
33
<pre class="funcsynopsisinfo">#include &lt;lwres/netdb.h&gt;</pre>
 
34
<p><code class="funcdef">
 
35
void
 
36
<b class="fsfunc">lwres_herror</b>(</code>const char *s<code>)</code>;</p>
 
37
<p><code class="funcdef">
 
38
const char *
 
39
<b class="fsfunc">lwres_hstrerror</b>(</code>int err<code>)</code>;</p>
 
40
</div>
 
41
</div>
 
42
<div class="refsect1" lang="en">
 
43
<a name="id2525859"></a><h2>DESCRIPTION</h2>
 
44
<p>
 
45
<code class="function">lwres_herror()</code> prints the string
 
46
<em class="parameter"><code>s</code></em> on <span class="type">stderr</span> followed by the string
 
47
generated by <code class="function">lwres_hstrerror()</code> for the error code
 
48
stored in the global variable <code class="constant">lwres_h_errno</code>.
 
49
</p>
 
50
<p>
 
51
<code class="function">lwres_hstrerror()</code> returns an appropriate string
 
52
for the error code gievn by <em class="parameter"><code>err</code></em>.  The values of
121
53
the error codes and messages are as follows:
122
54
 
123
 
<P
124
 
></P
125
 
><DIV
126
 
CLASS="VARIABLELIST"
127
 
><DL
128
 
><DT
129
 
><SPAN
130
 
CLASS="ERRORCODE"
131
 
>NETDB_SUCCESS</SPAN
132
 
></DT
133
 
><DD
134
 
><P
135
 
><SPAN
136
 
CLASS="ERRORNAME"
137
 
>Resolver Error 0 (no error)</SPAN
138
 
></P
139
 
></DD
140
 
><DT
141
 
><SPAN
142
 
CLASS="ERRORCODE"
143
 
>HOST_NOT_FOUND</SPAN
144
 
></DT
145
 
><DD
146
 
><P
147
 
><SPAN
148
 
CLASS="ERRORNAME"
149
 
>Unknown host</SPAN
150
 
></P
151
 
></DD
152
 
><DT
153
 
><SPAN
154
 
CLASS="ERRORCODE"
155
 
>TRY_AGAIN</SPAN
156
 
></DT
157
 
><DD
158
 
><P
159
 
><SPAN
160
 
CLASS="ERRORNAME"
161
 
>Host name lookup failure</SPAN
162
 
></P
163
 
></DD
164
 
><DT
165
 
><SPAN
166
 
CLASS="ERRORCODE"
167
 
>NO_RECOVERY</SPAN
168
 
></DT
169
 
><DD
170
 
><P
171
 
><SPAN
172
 
CLASS="ERRORNAME"
173
 
>Unknown server error</SPAN
174
 
></P
175
 
></DD
176
 
><DT
177
 
><SPAN
178
 
CLASS="ERRORCODE"
179
 
>NO_DATA</SPAN
180
 
></DT
181
 
><DD
182
 
><P
183
 
><SPAN
184
 
CLASS="ERRORNAME"
185
 
>No address associated with name</SPAN
186
 
></P
187
 
></DD
188
 
></DL
189
 
></DIV
190
 
></P
191
 
></DIV
192
 
><DIV
193
 
CLASS="REFSECT1"
194
 
><A
195
 
NAME="AEN65"
196
 
></A
197
 
><H2
198
 
>RETURN VALUES</H2
199
 
><P
200
 
>The string <SPAN
201
 
CLASS="ERRORNAME"
202
 
>Unknown resolver error</SPAN
203
 
> is returned by
204
 
<CODE
205
 
CLASS="FUNCTION"
206
 
>lwres_hstrerror()</CODE
207
 
>
 
55
</p>
 
56
<div class="variablelist"><dl>
 
57
<dt><span class="term"><span class="errorcode">NETDB_SUCCESS</span></span></dt>
 
58
<dd><p>
 
59
<span class="errorname">Resolver Error 0 (no error)</span>
 
60
</p></dd>
 
61
<dt><span class="term"><span class="errorcode">HOST_NOT_FOUND</span></span></dt>
 
62
<dd><p>
 
63
<span class="errorname">Unknown host</span>
 
64
</p></dd>
 
65
<dt><span class="term"><span class="errorcode">TRY_AGAIN</span></span></dt>
 
66
<dd><p>
 
67
<span class="errorname">Host name lookup failure</span>
 
68
</p></dd>
 
69
<dt><span class="term"><span class="errorcode">NO_RECOVERY</span></span></dt>
 
70
<dd><p>
 
71
<span class="errorname">Unknown server error</span>
 
72
</p></dd>
 
73
<dt><span class="term"><span class="errorcode">NO_DATA</span></span></dt>
 
74
<dd><p>
 
75
<span class="errorname">No address associated with name</span>
 
76
</p></dd>
 
77
</dl></div>
 
78
<p>
 
79
</p>
 
80
</div>
 
81
<div class="refsect1" lang="en">
 
82
<a name="id2525971"></a><h2>RETURN VALUES</h2>
 
83
<p>
 
84
The string <span class="errorname">Unknown resolver error</span> is returned by
 
85
<code class="function">lwres_hstrerror()</code>
208
86
when the value of
209
 
<CODE
210
 
CLASS="CONSTANT"
211
 
>lwres_h_errno</CODE
212
 
>
213
 
is not a valid error code.</P
214
 
></DIV
215
 
><DIV
216
 
CLASS="REFSECT1"
217
 
><A
218
 
NAME="AEN71"
219
 
></A
220
 
><H2
221
 
>SEE ALSO</H2
222
 
><P
223
 
><SPAN
224
 
CLASS="CITEREFENTRY"
225
 
><SPAN
226
 
CLASS="REFENTRYTITLE"
227
 
>herror</SPAN
228
 
>(3)</SPAN
229
 
>,
 
87
<code class="constant">lwres_h_errno</code>
 
88
is not a valid error code.
 
89
</p>
 
90
</div>
 
91
<div class="refsect1" lang="en">
 
92
<a name="id2525990"></a><h2>SEE ALSO</h2>
 
93
<p>
 
94
<span class="citerefentry"><span class="refentrytitle">herror</span>(3)</span>,
230
95
 
231
 
<SPAN
232
 
CLASS="CITEREFENTRY"
233
 
><SPAN
234
 
CLASS="REFENTRYTITLE"
235
 
>lwres_hstrerror</SPAN
236
 
>(3)</SPAN
237
 
>.</P
238
 
></DIV
239
 
></BODY
240
 
></HTML
241
 
>
 
96
<span class="citerefentry"><span class="refentrytitle">lwres_hstrerror</span>(3)</span>.
 
97
</p>
 
98
</div>
 
99
</div></body>
 
100
</html>