<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--
- Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
-
- This Source Code Form is subject to the terms of the Mozilla Public
- License, v. 2.0. If a copy of the MPL was not distributed with this
- file, You can obtain one at http://mozilla.org/MPL/2.0/.
-->
<html lang="en">
<head>
<title>lwres_gai_strerror</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
<a name="id-1"></a><div class="titlepage"></div>
<div class="refnamediv">
<h2>Name</h2>
<p>
lwres_gai_strerror
— print suitable error string
</p>
</div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<div class="funcsynopsis">
<table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr>
<td><code class="funcdef">
char *
<b class="fsfunc">gai_strerror</b>(</code></td>
<td>int <var class="pdparam">ecode</var><code>)</code>;</td>
</tr></table>
<div class="funcprototype-spacer">�</div>
</div>
</div>
<div class="refsection">
<a name="id-1.7"></a><h2>DESCRIPTION</h2>
<p><code class="function">lwres_gai_strerror()</code>
returns an error message corresponding to an error code returned by
<code class="function">getaddrinfo()</code>.
The following error codes and their meaning are defined in
</p>
<div class="variablelist"><dl class="variablelist">
<dt><span class="term"><span class="errorcode">EAI_ADDRFAMILY</span></span></dt>
<dd>
<p>
address family for hostname not supported
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_AGAIN</span></span></dt>
<dd>
<p>
temporary failure in name resolution
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_BADFLAGS</span></span></dt>
<dd>
<p>
invalid value for
<code class="constant">ai_flags</code>
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_FAIL</span></span></dt>
<dd>
<p>
non-recoverable failure in name resolution
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_FAMILY</span></span></dt>
<dd>
<p><code class="constant">ai_family</code> not supported
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_MEMORY</span></span></dt>
<dd>
<p>
memory allocation failure
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_NODATA</span></span></dt>
<dd>
<p>
no address associated with hostname
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_NONAME</span></span></dt>
<dd>
<p>
hostname or servname not provided, or not known
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_SERVICE</span></span></dt>
<dd>
<p>
servname not supported for <code class="constant">ai_socktype</code>
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_SOCKTYPE</span></span></dt>
<dd>
<p><code class="constant">ai_socktype</code> not supported
</p>
</dd>
<dt><span class="term"><span class="errorcode">EAI_SYSTEM</span></span></dt>
<dd>
<p>
system error returned in errno
</p>
</dd>
</dl></div>
<p>
The message <span class="errorname">invalid error code</span> is returned if
<em class="parameter"><code>ecode</code></em>
is out of range.
</p>
<p><code class="constant">ai_flags</code>,
<code class="constant">ai_family</code>
and
<code class="constant">ai_socktype</code>
are elements of the
<span class="type">struct addrinfo</span>
used by
<code class="function">lwres_getaddrinfo()</code>.
</p>
</div>
<div class="refsection">
<a name="id-1.8"></a><h2>SEE ALSO</h2>
<p><span class="citerefentry">
<span class="refentrytitle">strerror</span>(3)
</span>,
<span class="citerefentry">
<span class="refentrytitle">lwres_getaddrinfo</span>(3)
</span>,
<span class="citerefentry">
<span class="refentrytitle">getaddrinfo</span>(3)
</span>,
<span class="citerefentry">
<span class="refentrytitle">RFC2133</span>
</span>.
</p>
</div>
</div></body>
</html>