external/bsd/bind/dist/lib/lwres/man/lwres_gai_strerror.3

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