diff options
author | Peter Tribble <peter.tribble@gmail.com> | 2020-12-31 10:47:42 +0000 |
---|---|---|
committer | Peter Tribble <peter.tribble@gmail.com> | 2021-01-01 11:55:01 +0000 |
commit | 0a554e9f2c0d440dc40a97fae2d18f1d428ca786 (patch) | |
tree | 6581d89db7e760d8893bbfc2ffb8e8cbb7212acd /usr/src/man/man3resolv | |
parent | 9f76c6ed5b6ee0cc0bf631daca15ac3dc5fc70c4 (diff) | |
download | illumos-gate-0a554e9f2c0d440dc40a97fae2d18f1d428ca786.tar.gz |
13404 man page spelling errors
Reviewed by: Ryan Zezeski <ryan@oxide.computer>
Reviewed by: Robert Mustacchi <rm@fingolfin.org>
Approved by: Richard Lowe <richlowe@richlowe.net>
Diffstat (limited to 'usr/src/man/man3resolv')
-rw-r--r-- | usr/src/man/man3resolv/resolver.3resolv | 23 |
1 files changed, 2 insertions, 21 deletions
diff --git a/usr/src/man/man3resolv/resolver.3resolv b/usr/src/man/man3resolv/resolver.3resolv index f54bda17d1..cf5b7037da 100644 --- a/usr/src/man/man3resolv/resolver.3resolv +++ b/usr/src/man/man3resolv/resolver.3resolv @@ -1,7 +1,7 @@ '\" te .\" Portions Copyright 1989 AT&T Portions Copyright (c) 1985, 1995 Regents of the University of California. .\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved -.TH RESOLVER 3RESOLV "April 9, 2016" +.TH RESOLVER 3RESOLV "December 28, 2020" .SH NAME resolver, res_ninit, fp_resstat, res_hostalias, res_nquery, res_nsearch, res_nquerydomain, res_nmkquery, res_nsend, res_nclose, res_nsendsigned, @@ -9,7 +9,6 @@ dn_comp, dn_expand, hstrerror, res_init, res_query, res_search, res_mkquery, res_send, herror, res_getservers, res_setservers, res_ndestroy \- resolver routines .SH SYNOPSIS -.LP .nf BIND 8.2.2 Interfaces .fi @@ -163,7 +162,6 @@ Deprecated Interfaces .fi .SH DESCRIPTION -.LP These routines are used for making, sending, and interpreting query and reply messages with Internet domain name servers. .sp @@ -326,7 +324,6 @@ the header would be updated. .RE .SS "\fBres_ninit()\fR, \fBres_init()\fR" -.LP The \fBres_ninit()\fR and \fBres_init()\fR routines read the configuration file, if any is present, to get the default domain name, search list and the Internet address of the local name server(s). See \fBresolv.conf\fR(4). If no @@ -345,7 +342,6 @@ are inherited from the configuration file's \fBoptions\fR command. See \fBRES_OPTIONS\fR environment variable. Initialization normally occurs on the first call to one of the other resolver routines. .SS "\fBres_nquery()\fR, \fBres_query()\fR" -.LP The \fBres_nquery()\fR and \fBres_query()\fR functions provide interfaces to the server query mechanism. They construct a query, send it to the local server, await a response, and make preliminary checks on the reply. The query @@ -364,12 +360,11 @@ by the previous query. \fIanswer\fR must be large enough to receive a maximum \fBUDP\fR response from the server or parts of the \fIanswer\fR will be silently discarded. The default maximum \fBUDP\fR response size is 512 bytes. .SS "\fBres_nsearch()\fR, \fBres_search()\fR" -.LP The \fBres_nsearch()\fR and \fBres_search()\fR routines make a query and await a response, just like like \fBres_nquery()\fR and \fBres_query()\fR. In addition, they implement the default and search rules controlled by the \fBRES_DEFNAMES\fR and \fBRES_DNSRCH\fR options. They return the length of the -first successful reply which is stored in \fIanswer\fR. On error, they reurn +first successful reply which is stored in \fIanswer\fR. On error, they return -1. .sp .LP @@ -381,12 +376,10 @@ by the previous query. \fIanswer\fR must be large enough to receive a maximum \fBUDP\fR response from the server or parts of the \fIanswer\fR will be silently discarded. The default maximum \fBUDP\fR response size is 512 bytes. .SS "\fBres_nquerydomain()\fR" -.LP The \fBres_nquerydomain()\fR function calls \fBres_query()\fR on the concatenation of \fIname\fR and \fIdomain\fR, removing a trailing dot from \fIname\fR if \fIdomain\fR is \fINULL\fR. .SS "\fBres_nmkquery()\fR, \fBres_mkquery()\fR" -.LP These routines are used by \fBres_nquery()\fR and \fBres_query()\fR. The \fBres_nmkquery()\fR and \fBres_mkquery()\fR functions construct a standard query message and place it in \fIbuf\fR. The routine returns the \fIsize\fR of @@ -395,7 +388,6 @@ the query, or -1 if the query is larger than \fIbuflen\fR. The query type <\fBarpa/nameser.h\fR>. The domain name for the query is given by \fIdname\fR. \fInewrr\fR is currently unused but is intended for making update messages. .SS "\fBres_nsend()\fR, \fBres_send()\fR, \fBres_nsendsigned()\fR" -.LP The \fBres_nsend()\fR, \fBres_send()\fR, and \fBres_nsendsigned()\fR routines send a pre-formatted query that returns an \fIanswer\fR. The routine calls \fBres_ninit()\fR or \fBres_init()\fR. If \fBRES_INIT\fR is not set, the @@ -414,26 +406,21 @@ by the previous query. \fIanswer\fR must be large enough to receive a maximum \fBUDP\fR response from the server or parts of the \fIanswer\fR will be silently discarded. The default maximum \fBUDP\fR response size is 512 bytes. .SS "\fBfp_resstat()\fR" -.LP The function \fBfp_resstat()\fR prints out the active flag bits in \fIstatp\fR->\fBoptions\fR preceded by the text "\fB;; res options:\fR" on \fIfile\fR. .SS "\fBres_hostalias()\fR" -.LP The function \fBres_hostalias()\fR looks up \fIname\fR in the file referred to by the \fBHOSTALIASES\fR environment variable and returns the fully qualified host name. If \fIname\fR is not found or an error occurs, \fBNULL\fR is returned. \fBres_hostalias()\fR stores the result in \fIbuf\fR. .SS "\fBres_nclose()\fR" -.LP The \fBres_nclose()\fR function closes any open files referenced through \fIstatp\fR. .SS "\fBres_ndestroy()\fR" -.LP The \fBres_ndestroy()\fR function calls \fBres_nclose()\fR, then frees any memory allocated by \fBres_ninit()\fR referenced through \fIstatp\fR. .SS "\fBdn_comp()\fR" -.LP The \fBdn_comp()\fR function compresses the domain name \fIexp_dn\fR and stores it in \fIcomp_dn\fR. The \fBdn_comp()\fR function returns the size of the compressed name, or \fB\(mi1\fR if there were errors. \fIlength\fR is the size @@ -451,7 +438,6 @@ labels inserted into the message by \fBdn_comp()\fR as the name is compressed. If \fIdnptrs\fR is \fINULL\fR, names are not compressed. If \fIlastdnptr\fR is \fINULL\fR, \fBdn_comp()\fR does not update the list of labels. .SS "\fBdn_expand()\fR" -.LP The \fBdn_expand()\fR function expands the compressed domain name \fIcomp_dn\fR to a full domain name. The compressed name is contained in a query or reply message. \fImsg\fR is a pointer to the beginning of that message. The @@ -459,7 +445,6 @@ uncompressed name is placed in the buffer indicated by \fIexp_dn\fR, which is of size \fIlength\fR. The \fBdn_expand()\fR function returns the size of the compressed name, or \fB\(mi1\fR if there was an error. .SS "\fBhstrerror()\fR, \fBherror()\fR" -.LP The variables \fIstatp->res_h_errno\fR and \fI_res.res_h_errno\fR and external variable \fIh_errno\fR are set whenever an error occurs during a resolver operation. The following definitions are given in <\fBnetdb.h\fR>: @@ -486,7 +471,6 @@ message corresponding to the value of \fIh_errno\fR. The \fBhstrerror()\fR function returns a string, which is the message text that corresponds to the value of the \fIerr\fR parameter. .SS "\fBres_setservers()\fR, \fBres_getservers()\fR" -.LP The functions \fBres_getservers()\fR and \fBres_setservers()\fR are used to get and set the list of servers to be queried. .SH FILES @@ -499,7 +483,6 @@ resolver configuration file .RE .SH ATTRIBUTES -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -517,7 +500,6 @@ T} .TE .SH SEE ALSO -.LP \fBdomainname\fR(1M), \fBgethostbyname\fR(3NSL), \fBlibresolv\fR(3LIB), \fBresolv.conf\fR(4), \fBattributes\fR(5) .sp @@ -545,7 +527,6 @@ November 1987. Vixie, Paul, Dunlap, Kevin J., Karels, Michael J. \fIName Server Operations Guide for BIND\fR. Internet Software Consortium, 1996. .SH NOTES -.LP When the caller supplies a work buffer, for example the \fIanswer\fR buffer argument to \fBres_nsend()\fR or \fBres_send()\fR, the buffer should be aligned on an eight byte boundary. Otherwise, an error such as a \fBSIGBUS\fR may |