set socket pgrp to avoid races; block SIGURG till done;

[unix-history] / usr / src / lib / libc / net / resolver.3

diff --git a/usr/src/lib/libc/net/resolver.3 b/usr/src/lib/libc/net/resolver.3
index 6b75118..9c61e88 100644 (file)
--- a/usr/src/lib/libc/net/resolver.3
+++ b/usr/src/lib/libc/net/resolver.3
@@ -2,7 +2,7 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)resolver.3  1.2 (Berkeley) %G%
+.\"    @(#)resolver.3  1.5 (Berkeley) %G%

 .\"
 .TH RESOLVER 3 "15 November 1985"
 .UC 4
 .\"
 .TH RESOLVER 3 "15 November 1985"
 .UC 4


@@ -15,7 +15,7 @@ res_mkquery, res_send, res_init, dn_comp, dn_expand \- resolver routines
 .br
 .B #include <arpa/nameser.h>
 .br
 .br
 .B #include <arpa/nameser.h>
 .br

-.B #include <arpa/resolv.h>
+.B #include <resolv.h>

 .PP
 .B "res_mkquery(op, dname, class, type, data, datalen, newrr, buf, buflen)"
 .br
 .PP
 .B "res_mkquery(op, dname, class, type, data, datalen, newrr, buf, buflen)"
 .br


@@ -55,12 +55,11 @@ res_mkquery, res_send, res_init, dn_comp, dn_expand \- resolver routines
 .br
 .B char **dnptrs, **lastdnptr;
 .PP
 .br
 .B char **dnptrs, **lastdnptr;
 .PP

-.B dn_expand(msg, comp_dn, exp_dn, length)
+.B dn_expand(msg, msglen, comp_dn, exp_dn, length)

 .br
 .br

-.SM

 .B char *msg, *comp_dn, exp_dn;
 .br
 .B char *msg, *comp_dn, exp_dn;
 .br

-.B int length;
+.B int  msglen, length;

 .SH DESCRIPTION
 These routines are used for making, sending and interpreting packets to
 Internet domain name servers. Global information that is used by the
 .SH DESCRIPTION
 These routines are used for making, sending and interpreting packets to
 Internet domain name servers. Global information that is used by the


@@ -87,16 +86,19 @@ will continue until it finds an authoritative answer or finds an error.
 Currently this is not implemented.
 .IP RES_USEVC
 Use TCP connections for queries instead of UDP.
 Currently this is not implemented.
 .IP RES_USEVC
 Use TCP connections for queries instead of UDP.

-.IP RES_PRIMARY
-Unused currently.
+.IP RES_STAYOPEN
+Used with RES_USEVC to keep the TCP connection open between
+queries.
+This is useful only in programs that regularly do many queries.
+UDP should be the normal mode used.

 .IP RES_IGNTC
 Unused currently (ignore truncation errors, i.e., don't retry with TCP).
 .IP RES_RECURSE
 Set the recursion desired bit in queries. This is the default.
 (
 .I res_send
 .IP RES_IGNTC
 Unused currently (ignore truncation errors, i.e., don't retry with TCP).
 .IP RES_RECURSE
 Set the recursion desired bit in queries. This is the default.
 (
 .I res_send

-does not currently perform iterative queries and expects the name server
-to handle recursion. This should be fixed.)
+does not do iterative queries and expects the name server
+to handle recursion.)

 .IP RES_DEFNAMES
 Append the default domain name to single label queries. This is the default.
 .PP
 .IP RES_DEFNAMES
 Append the default domain name to single label queries. This is the default.
 .PP


@@ -107,7 +109,7 @@ domain name and the Internet address of the initial hosts
 running the name server. If this line does not exist, the host running
 the resolver is tried.
 .I Res_mkquery
 running the name server. If this line does not exist, the host running
 the resolver is tried.
 .I Res_mkquery

-is used to make a standard query message and places it in
+makes a standard query message and places it in

 .IR buf .
 .I Res_mkquery
 will return the size of the query or \-1 if the query is
 .IR buf .
 .I Res_mkquery
 will return the size of the query or \-1 if the query is


@@ -129,7 +131,7 @@ by the environment variable LOCALDOMAIN.
 is currently unused but is intended for making update messages.
 .PP
 .I Res_send
 is currently unused but is intended for making update messages.
 .PP
 .I Res_send

-is used to send a query to name servers and return an answer.
+sends a query to name servers and returns an answer.

 It will call
 .I res_init
 if RES_INIT is not set, send the query to the local name server, and
 It will call
 .I res_init
 if RES_INIT is not set, send the query to the local name server, and


@@ -173,13 +175,7 @@ is NULL, we don't try to compress names. If
 .I lastdnptr
 is NULL, we don't update the list.
 .SH FILES
 .I lastdnptr
 is NULL, we don't update the list.
 .SH FILES

-resolv.conf    Contains the default resolver information read by res_init.
-There are two types of records in this file, domain and name server.
-The domain record specifies the default domain for the resolver to use.
-You can have multiple name server records to designate the name servers 
-addresses you would like the resolver to try. By using this 
-file you don't have to have a name server actually running on your system
-and you can have a back up name server to try in the event your local server 
-is not responsive.
+/etc/resolv.conf see resolver(5)

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-named(8), RFC882, RFC883
+named(8), resolver(5), RFC882, RFC883, RFC973, RFC974,
+BIND - Operations Guide