88 lines
2.1 KiB
Groff
88 lines
2.1 KiB
Groff
.\"
|
|
.\" Copyright (C) 2000, 2001 Internet Software Consortium.
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
|
|
.\" DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
|
|
.\" INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
|
|
.\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
|
|
.\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
|
|
.\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
.\"
|
|
.TH "LWRES_GAI_STRERROR" "3" "Jun 30, 2000" "BIND9" ""
|
|
.SH NAME
|
|
gai_strerror \- print suitable error string
|
|
.SH SYNOPSIS
|
|
\fB#include <lwres/netdb.h>
|
|
.sp
|
|
.na
|
|
char *
|
|
gai_strerror(int ecode);
|
|
.ad
|
|
\fR
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
\fBlwres_gai_strerror()\fR
|
|
returns an error message corresponding to an error code returned by
|
|
\fBgetaddrinfo()\fR.
|
|
The following error codes and their meaning are defined in
|
|
\fIinclude/lwres/netdb.h\fR.
|
|
.TP
|
|
\fBEAI_ADDRFAMILY\fR
|
|
address family for hostname not supported
|
|
.TP
|
|
\fBEAI_AGAIN\fR
|
|
temporary failure in name resolution
|
|
.TP
|
|
\fBEAI_BADFLAGS\fR
|
|
invalid value for
|
|
ai_flags
|
|
.TP
|
|
\fBEAI_FAIL\fR
|
|
non-recoverable failure in name resolution
|
|
.TP
|
|
\fBEAI_FAMILY\fR
|
|
ai_family not supported
|
|
.TP
|
|
\fBEAI_MEMORY\fR
|
|
memory allocation failure
|
|
.TP
|
|
\fBEAI_NODATA\fR
|
|
no address associated with hostname
|
|
.TP
|
|
\fBEAI_NONAME\fR
|
|
hostname or servname not provided, or not known
|
|
.TP
|
|
\fBEAI_SERVICE\fR
|
|
servname not supported for ai_socktype
|
|
.TP
|
|
\fBEAI_SOCKTYPE\fR
|
|
ai_socktype not supported
|
|
.TP
|
|
\fBEAI_SYSTEM\fR
|
|
system error returned in errno
|
|
.PP
|
|
The message \fBinvalid error code\fR is returned if
|
|
\fIecode\fR
|
|
is out of range.
|
|
.PP
|
|
ai_flags,
|
|
ai_family
|
|
and
|
|
ai_socktype
|
|
are elements of the
|
|
\fBstruct addrinfo\fR
|
|
used by
|
|
\fBlwres_getaddrinfo()\fR.
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
\fBstrerror\fR(3),
|
|
\fBlwres_getaddrinfo\fR(3),
|
|
\fBgetaddrinfo\fR(3),
|
|
\fBRFC2133\fR.
|