contrib/bind-9.2.4rc7/lib/lwres/man/lwres_hstrerror.3

   1 .\" Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
   2 .\" Copyright (C) 2000, 2001  Internet Software Consortium.
   3 .\"
   4 .\" Permission to use, copy, modify, and 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: lwres_hstrerror.3,v 1.13.2.2 2004/03/15 04:45:03 marka Exp $
  17 .\"
  18 .TH "LWRES_HSTRERROR" "3" "Jun 30, 2000" "BIND9" ""
  19 .SH NAME
  20 lwres_herror, lwres_hstrerror \- lightweight resolver error message generation
  21 .SH SYNOPSIS
  22 \fB#include <lwres/netdb.h>
  23 .sp
  24 .na
  25 void
  26 lwres_herror(const char *s);
  27 .ad
  28 .sp
  29 .na
  30 const char *
  31 lwres_hstrerror(int err);
  32 .ad
  33 \fR
  34 .SH "DESCRIPTION"
  35 .PP
  36 \fBlwres_herror()\fR prints the string
  37 \fIs\fR on \fBstderr\fR followed by the string
  38 generated by \fBlwres_hstrerror()\fR for the error code
  39 stored in the global variable lwres_h_errno.
  40 .PP
  41 \fBlwres_hstrerror()\fR returns an appropriate string
  42 for the error code gievn by \fIerr\fR. The values of
  43 the error codes and messages are as follows:
  44 .TP
  45 \fBNETDB_SUCCESS\fR
  46 \fBResolver Error 0 (no error)\fR
  47 .TP
  48 \fBHOST_NOT_FOUND\fR
  49 \fBUnknown host\fR
  50 .TP
  51 \fBTRY_AGAIN\fR
  52 \fBHost name lookup failure\fR
  53 .TP
  54 \fBNO_RECOVERY\fR
  55 \fBUnknown server error\fR
  56 .TP
  57 \fBNO_DATA\fR
  58 \fBNo address associated with name\fR
  59 .SH "RETURN VALUES"
  60 .PP
  61 The string \fBUnknown resolver error\fR is returned by
  62 \fBlwres_hstrerror()\fR
  63 when the value of
  64 lwres_h_errno
  65 is not a valid error code.
  66 .SH "SEE ALSO"
  67 .PP
  68 \fBherror\fR(3),
  69 \fBlwres_hstrerror\fR(3).