summaryrefslogtreecommitdiffstats
path: root/lib/lwres/man/lwres_gai_strerror.3
blob: c0a4afae8b4ed04912a5f6239a0fe1b384f26b9e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
.\" Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016, 2018, 2019 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/.
.\"
.hy 0
.ad l
'\" t
.\"     Title: lwres_gai_strerror
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 2007-06-18
.\"    Manual: BIND9
.\"    Source: ISC
.\"  Language: English
.\"
.TH "LWRES_GAI_STRERROR" "3" "2007\-06\-18" "ISC" "BIND9"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
lwres_gai_strerror \- print suitable error string
.SH "SYNOPSIS"
.sp
.ft B
.nf
#include <lwres/netdb\&.h>
.fi
.ft
.HP \w'char\ *\ gai_strerror('u
.BI "char * gai_strerror(int\ " "ecode" ");"
.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
include/lwres/netdb\&.h\&.
.PP
\fBEAI_ADDRFAMILY\fR
.RS 4
address family for hostname not supported
.RE
.PP
\fBEAI_AGAIN\fR
.RS 4
temporary failure in name resolution
.RE
.PP
\fBEAI_BADFLAGS\fR
.RS 4
invalid value for
\fBai_flags\fR
.RE
.PP
\fBEAI_FAIL\fR
.RS 4
non\-recoverable failure in name resolution
.RE
.PP
\fBEAI_FAMILY\fR
.RS 4
\fBai_family\fR
not supported
.RE
.PP
\fBEAI_MEMORY\fR
.RS 4
memory allocation failure
.RE
.PP
\fBEAI_NODATA\fR
.RS 4
no address associated with hostname
.RE
.PP
\fBEAI_NONAME\fR
.RS 4
hostname or servname not provided, or not known
.RE
.PP
\fBEAI_SERVICE\fR
.RS 4
servname not supported for
\fBai_socktype\fR
.RE
.PP
\fBEAI_SOCKTYPE\fR
.RS 4
\fBai_socktype\fR
not supported
.RE
.PP
\fBEAI_SYSTEM\fR
.RS 4
system error returned in errno
.RE
The message
invalid error code
is returned if
\fIecode\fR
is out of range\&.
.PP
\fBai_flags\fR,
\fBai_family\fR
and
\fBai_socktype\fR
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()\&.
.SH "AUTHOR"
.PP
\fBInternet Systems Consortium, Inc\&.\fR
.SH "COPYRIGHT"
.br
Copyright \(co 2000, 2001, 2004, 2005, 2007, 2014-2016, 2018, 2019 Internet Systems Consortium, Inc. ("ISC")
.br