lwres_gai_strerror.html revision 60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<!--
530eba85dbd41b8a0fa5255d3648d1440199a661slive - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
e942c741056732f50da2074b36fe59805d370650slive - Copyright (C) 2000, 2001 Internet Software Consortium
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd -
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd - Permission to use, copy, modify, and distribute this software for any
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd - purpose with or without fee is hereby granted, provided that the above
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding - copyright notice and this permission notice appear in all copies.
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding -
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd - PERFORMANCE OF THIS SOFTWARE.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd-->
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<html>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<head>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<title>lwres_gai_strerror</title>
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd</head>
7db9f691a00ead175b03335457ca296a33ddf31bnd<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<a name="id2456618"></a><div class="titlepage"></div>
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<div class="refnamediv">
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<h2>Name</h2>
d24d4c5159bcb11c25bb294926cfe7105c789ea9slive<p>lwres_gai_strerror &#8212; print suitable error string</p>
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</div>
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<div class="refsynopsisdiv">
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<h2>Synopsis</h2>
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<div class="funcsynopsis">
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<pre class="funcsynopsisinfo">#include &lt;lwres/netdb.h&gt;</pre>
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<p><code class="funcdef">
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slivechar *
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<b class="fsfunc">gai_strerror</b>(</code>int <var class="pdparam">ecode</var><code>)</code>;</p>
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</div>
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive</div>
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<div class="refsect1" lang="en">
c1ce37b2dcce132ff0abf6a15f5225a0e89af5e4slive<a name="id2512610"></a><h2>DESCRIPTION</h2>
d1e705efc6b288edbe466fd1af69d228f508361end<p><code class="function">lwres_gai_strerror()</code>
d1e705efc6b288edbe466fd1af69d228f508361end returns an error message corresponding to an error code returned by
d1e705efc6b288edbe466fd1af69d228f508361end <code class="function">getaddrinfo()</code>.
d1e705efc6b288edbe466fd1af69d228f508361end The following error codes and their meaning are defined in
d1e705efc6b288edbe466fd1af69d228f508361end <code class="filename">include/lwres/netdb.h</code>.
d1e705efc6b288edbe466fd1af69d228f508361end </p>
d1e705efc6b288edbe466fd1af69d228f508361end<div class="variablelist"><dl>
d1e705efc6b288edbe466fd1af69d228f508361end<dt><span class="term"><span class="errorcode">EAI_ADDRFAMILY</span></span></dt>
d1e705efc6b288edbe466fd1af69d228f508361end<dd><p>
d1e705efc6b288edbe466fd1af69d228f508361end address family for hostname not supported
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive </p></dd>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<dt><span class="term"><span class="errorcode">EAI_AGAIN</span></span></dt>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<dd><p>
d1e705efc6b288edbe466fd1af69d228f508361end temporary failure in name resolution
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim </p></dd>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<dt><span class="term"><span class="errorcode">EAI_BADFLAGS</span></span></dt>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<dd><p>
283c8419679dcabdd6605521b5094c7e31e44f4dslive invalid value for
283c8419679dcabdd6605521b5094c7e31e44f4dslive <code class="constant">ai_flags</code>
d1e705efc6b288edbe466fd1af69d228f508361end </p></dd>
d1e705efc6b288edbe466fd1af69d228f508361end<dt><span class="term"><span class="errorcode">EAI_FAIL</span></span></dt>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<dd><p>
d1e705efc6b288edbe466fd1af69d228f508361end non-recoverable failure in name resolution
d1e705efc6b288edbe466fd1af69d228f508361end </p></dd>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<dt><span class="term"><span class="errorcode">EAI_FAMILY</span></span></dt>
4c894c7d7c34890a8984b6cc1bcf6c19f15c4c0aniq<dd><p><code class="constant">ai_family</code> not supported
4c894c7d7c34890a8984b6cc1bcf6c19f15c4c0aniq </p></dd>
283c8419679dcabdd6605521b5094c7e31e44f4dslive<dt><span class="term"><span class="errorcode">EAI_MEMORY</span></span></dt>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<dd><p>
d1e705efc6b288edbe466fd1af69d228f508361end memory allocation failure
d1e705efc6b288edbe466fd1af69d228f508361end </p></dd>
d1e705efc6b288edbe466fd1af69d228f508361end<dt><span class="term"><span class="errorcode">EAI_NODATA</span></span></dt>
d1e705efc6b288edbe466fd1af69d228f508361end<dd><p>
d1e705efc6b288edbe466fd1af69d228f508361end no address associated with hostname
d1e705efc6b288edbe466fd1af69d228f508361end </p></dd>
d1e705efc6b288edbe466fd1af69d228f508361end<dt><span class="term"><span class="errorcode">EAI_NONAME</span></span></dt>
d1e705efc6b288edbe466fd1af69d228f508361end<dd><p>
d1e705efc6b288edbe466fd1af69d228f508361end hostname or servname not provided, or not known
d1e705efc6b288edbe466fd1af69d228f508361end </p></dd>
d1e705efc6b288edbe466fd1af69d228f508361end<dt><span class="term"><span class="errorcode">EAI_SERVICE</span></span></dt>
283c8419679dcabdd6605521b5094c7e31e44f4dslive<dd><p>
d1e705efc6b288edbe466fd1af69d228f508361end servname not supported for <code class="constant">ai_socktype</code>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi </p></dd>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi<dt><span class="term"><span class="errorcode">EAI_SOCKTYPE</span></span></dt>
ca908c21f63a71c5efa7d32bd2cfafe9a42ba1fbrbowen<dd><p><code class="constant">ai_socktype</code> not supported
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi </p></dd>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi<dt><span class="term"><span class="errorcode">EAI_SYSTEM</span></span></dt>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi<dd><p>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi system error returned in errno
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi </p></dd>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi</dl></div>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi<p>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi The message <span class="errorname">invalid error code</span> is returned if
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi <em class="parameter"><code>ecode</code></em>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi is out of range.
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi </p>
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi<p><code class="constant">ai_flags</code>,
206b5dce9e48924aa9f12ce87f14856a4cd3fb68takashi <code class="constant">ai_family</code>
d1e705efc6b288edbe466fd1af69d228f508361end and
d1e705efc6b288edbe466fd1af69d228f508361end <code class="constant">ai_socktype</code>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive are elements of the
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive <span class="type">struct addrinfo</span>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive used by
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive <code class="function">lwres_getaddrinfo()</code>.
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive </p>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive</div>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<div class="refsect1" lang="en">
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<a name="id2514259"></a><h2>SEE ALSO</h2>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive<p><span class="citerefentry"><span class="refentrytitle">strerror</span>(3)</span>,
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive <span class="citerefentry"><span class="refentrytitle">lwres_getaddrinfo</span>(3)</span>,
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive <span class="citerefentry"><span class="refentrytitle">getaddrinfo</span>(3)</span>,
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive <span class="citerefentry"><span class="refentrytitle">RFC2133</span></span>.
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive </p>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive</div>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive</div></body>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive</html>
6e49afdcb88db0a6d000bbb5d106e8e7c9cd67ceslive