diff options
Diffstat (limited to 'lib/lwres/man/lwres_hstrerror.3')
-rw-r--r-- | lib/lwres/man/lwres_hstrerror.3 | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/lib/lwres/man/lwres_hstrerror.3 b/lib/lwres/man/lwres_hstrerror.3 new file mode 100644 index 0000000..831e523 --- /dev/null +++ b/lib/lwres/man/lwres_hstrerror.3 @@ -0,0 +1,110 @@ +.\" 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_hstrerror +.\" Author: +.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> +.\" Date: 2007-06-18 +.\" Manual: BIND9 +.\" Source: ISC +.\" Language: English +.\" +.TH "LWRES_HSTRERROR" "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_herror, lwres_hstrerror \- lightweight resolver error message generation +.SH "SYNOPSIS" +.sp +.ft B +.nf +#include <lwres/netdb\&.h> +.fi +.ft +.HP \w'void\ lwres_herror('u +.BI "void lwres_herror(const\ char\ *" "s" ");" +.HP \w'const\ char\ *\ lwres_hstrerror('u +.BI "const char * lwres_hstrerror(int\ " "err" ");" +.SH "DESCRIPTION" +.PP +\fBlwres_herror()\fR +prints the string +\fIs\fR +on +\fBstderr\fR +followed by the string generated by +\fBlwres_hstrerror()\fR +for the error code stored in the global variable +\fBlwres_h_errno\fR\&. +.PP +\fBlwres_hstrerror()\fR +returns an appropriate string for the error code gievn by +\fIerr\fR\&. The values of the error codes and messages are as follows: +.PP +\fBNETDB_SUCCESS\fR +.RS 4 +Resolver Error 0 (no error) +.RE +.PP +\fBHOST_NOT_FOUND\fR +.RS 4 +Unknown host +.RE +.PP +\fBTRY_AGAIN\fR +.RS 4 +Host name lookup failure +.RE +.PP +\fBNO_RECOVERY\fR +.RS 4 +Unknown server error +.RE +.PP +\fBNO_DATA\fR +.RS 4 +No address associated with name +.RE +.SH "RETURN VALUES" +.PP +The string +Unknown resolver error +is returned by +\fBlwres_hstrerror()\fR +when the value of +\fBlwres_h_errno\fR +is not a valid error code\&. +.SH "SEE ALSO" +.PP +\fBherror\fR(3), +\fBlwres_hstrerror\fR(3)\&. +.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 |