/contrib/bind9/lib/lwres/man/lwres_gai_strerror.3

  1.\" Copyright (C) 2004, 2005, 2007, 2012 Internet Systems Consortium, Inc. ("ISC")
  2.\" Copyright (C) 2000, 2001 Internet Software Consortium.
  3.\" 
  4.\" Permission to use, copy, modify, and/or distribute this software for any
  5.\" purpose with or without fee is hereby granted, provided that the above
  6.\" copyright notice and this permission notice appear in all copies.
  7.\" 
  8.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  9.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
 10.\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
 11.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
 12.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
 13.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 14.\" PERFORMANCE OF THIS SOFTWARE.
 15.\"
 16.\" $Id$
 17.\"
 18.hy 0
 19.ad l
 20.\"     Title: lwres_gai_strerror
 21.\"    Author: 
 22.\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>
 23.\"      Date: Jun 30, 2000
 24.\"    Manual: BIND9
 25.\"    Source: BIND9
 26.\"
 27.TH "LWRES_GAI_STRERROR" "3" "Jun 30, 2000" "BIND9" "BIND9"
 28.\" disable hyphenation
 29.nh
 30.\" disable justification (adjust text to left margin only)
 31.ad l
 32.SH "NAME"
 33lwres_gai_strerror \- print suitable error string
 34.SH "SYNOPSIS"
 35.nf
 36#include <lwres/netdb.h>
 37.fi
 38.HP 20
 39.BI "char * gai_strerror(int\ " "ecode" ");"
 40.SH "DESCRIPTION"
 41.PP
 42\fBlwres_gai_strerror()\fR
 43returns an error message corresponding to an error code returned by
 44\fBgetaddrinfo()\fR. The following error codes and their meaning are defined in
 45\fIinclude/lwres/netdb.h\fR.
 46.PP
 47\fBEAI_ADDRFAMILY\fR
 48.RS 4
 49address family for hostname not supported
 50.RE
 51.PP
 52\fBEAI_AGAIN\fR
 53.RS 4
 54temporary failure in name resolution
 55.RE
 56.PP
 57\fBEAI_BADFLAGS\fR
 58.RS 4
 59invalid value for
 60\fBai_flags\fR
 61.RE
 62.PP
 63\fBEAI_FAIL\fR
 64.RS 4
 65non\-recoverable failure in name resolution
 66.RE
 67.PP
 68\fBEAI_FAMILY\fR
 69.RS 4
 70\fBai_family\fR
 71not supported
 72.RE
 73.PP
 74\fBEAI_MEMORY\fR
 75.RS 4
 76memory allocation failure
 77.RE
 78.PP
 79\fBEAI_NODATA\fR
 80.RS 4
 81no address associated with hostname
 82.RE
 83.PP
 84\fBEAI_NONAME\fR
 85.RS 4
 86hostname or servname not provided, or not known
 87.RE
 88.PP
 89\fBEAI_SERVICE\fR
 90.RS 4
 91servname not supported for
 92\fBai_socktype\fR
 93.RE
 94.PP
 95\fBEAI_SOCKTYPE\fR
 96.RS 4
 97\fBai_socktype\fR
 98not supported
 99.RE
100.PP
101\fBEAI_SYSTEM\fR
102.RS 4
103system error returned in errno
104.RE
105The message
106invalid error code
107is returned if
108\fIecode\fR
109is out of range.
110.PP
111\fBai_flags\fR,
112\fBai_family\fR
113and
114\fBai_socktype\fR
115are elements of the
116\fBstruct addrinfo\fR
117used by
118\fBlwres_getaddrinfo()\fR.
119.SH "SEE ALSO"
120.PP
121\fBstrerror\fR(3),
122\fBlwres_getaddrinfo\fR(3),
123\fBgetaddrinfo\fR(3),
124\fBRFC2133\fR().
125.SH "COPYRIGHT"
126Copyright \(co 2004, 2005, 2007, 2012 Internet Systems Consortium, Inc. ("ISC")
127.br
128Copyright \(co 2000, 2001 Internet Software Consortium.
129.br