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

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