mirror of
https://github.com/opnsense/src.git
synced 2026-05-28 04:12:45 -04:00
Import of ISC BIND 8.3.2-T1B documentation.
This commit is contained in:
Jacques Vidrine
parent
c4dd49b64d
commit
6e0927100d
28 changed files with 436 additions and 615 deletions
|
|
@ -45,7 +45,7 @@ A quoted string which will be used as a pathname, such as
|
|||
|
||||
<DT><VAR>ip_addr</VAR>
|
||||
<DD>
|
||||
An IP address in with exactly four elements in
|
||||
An IP address with exactly four elements in
|
||||
<VAR>dotted-decimal</VAR> notation.
|
||||
|
||||
<DT><VAR>ip_port</VAR>
|
||||
|
|
@ -112,7 +112,7 @@ numbers <CODE>1</CODE> and <CODE>0</CODE>.
|
|||
|
||||
<HR>
|
||||
<ADDRESS>
|
||||
Last Updated: $Id: docdef.html,v 1.8 1999/09/15 20:28:01 cyarnell Exp $
|
||||
Last Updated: $Id: docdef.html,v 1.9 2002/04/02 00:57:47 marka Exp $
|
||||
</ADDRESS>
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
|
|
|||
|
|
@ -66,7 +66,7 @@ messages about processing of the entire configuration file, the
|
|||
<CODE>logging</CODE>statement must appear first. Even if you do not
|
||||
redirect configuration file parsing messages, we recommend
|
||||
always putting the <CODE>logging</CODE> statement first so that this
|
||||
rule need not be consciously recalled if you ever do need want the
|
||||
rule need not be consciously recalled if you ever do want the
|
||||
parser's messages relocated.
|
||||
|
||||
<H4>The <CODE>channel</CODE> phrase</H4>
|
||||
|
|
@ -182,7 +182,7 @@ time, category, severity. Here is an example where all three
|
|||
</PRE>
|
||||
|
||||
<P>There are four predefined channels that are used for
|
||||
<CODE>named</CODE>'s default logging as follows. How they are used
|
||||
default logging as follows. How they are used
|
||||
used is described in the next section, The <CODE>category</CODE> phrase.
|
||||
|
||||
<PRE>
|
||||
|
|
@ -363,7 +363,7 @@ Messages arising from response checking, such as
|
|||
|
||||
<HR>
|
||||
<ADDRESS>
|
||||
Last Updated: $Id: logging.html,v 1.12 1999/09/30 17:58:35 cyarnell Exp $
|
||||
Last Updated: $Id: logging.html,v 1.13 2002/04/02 00:57:48 marka Exp $
|
||||
</ADDRESS>
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
|
|
|||
|
|
@ -13,6 +13,7 @@
|
|||
|
||||
<PRE>
|
||||
options {
|
||||
[ hostname <VAR>hostname_string</VAR>; ]
|
||||
[ version <VAR>version_string</VAR>; ]
|
||||
[ directory <VAR>path_name</VAR>; ]
|
||||
[ named-xfer <VAR>path_name</VAR>; ]
|
||||
|
|
@ -29,7 +30,8 @@ options {
|
|||
[ host-statistics <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
[ host-statistics-max <VAR>number</VAR>; ]
|
||||
[ multiple-cnames <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
[ notify <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
[ notify ( <VAR><A HREF="docdef.html">yes_or_no</A></VAR> | explicit ) <; ]
|
||||
[ suppress-initial-notify <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
[ recursion <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
[ rfc2308-type1 <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
[ use-id-pool <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
|
|
@ -67,6 +69,7 @@ options {
|
|||
[ <A HREF="#topology">topology</A> { <VAR>address_match_list</VAR> }; ]
|
||||
[ <A HREF="#sortlist">sortlist</A> { <VAR>address_match_list</VAR> }; ]
|
||||
[ rrset-order { <VAR>order_spec</VAR> ; [ <VAR>order_spec</VAR> ; ... ] }; ]
|
||||
[ preferred-glue ( A | AAAA ); ]
|
||||
};
|
||||
</PRE>
|
||||
<HR>
|
||||
|
|
@ -80,16 +83,33 @@ first occurrence determines the actual options used,
|
|||
and a warning will be generated. If there is no options statement,
|
||||
an options block with each option set to its default will be used.</P>
|
||||
|
||||
<H4>Pathnames</H4>
|
||||
<H4>Server Information</H4>
|
||||
|
||||
<DL>
|
||||
<DT><CODE>hostname</CODE>
|
||||
<DD>
|
||||
This defaults to the hostname of the machine hosting the nameserver
|
||||
as found by gethostname().
|
||||
Its prime purpose is to be able to identify which of a number of anycast
|
||||
servers is actually answering your queries by sending a <I>txt</I>
|
||||
query for <CODE>hostname.bind</CODE> in class <I>chaos</I> to the anycast
|
||||
server and getting back a unique name.
|
||||
Setting the hostname to a empty string ("") will disable processing of
|
||||
the queries.
|
||||
|
||||
<DT><CODE>version</CODE>
|
||||
<DD>
|
||||
The version the server should report via the <VAR>ndc</VAR> command
|
||||
or via a query of name <CODE>version.bind</CODE> in class <I>chaos</I>.
|
||||
The default is the real version number of the server, but some server
|
||||
operators prefer the string <CODE>"surely you must be joking"</CODE>.
|
||||
Changing the value of this string will not prevent people from identifying
|
||||
what version you are running.
|
||||
</DL>
|
||||
|
||||
<H4>Pathnames</H4>
|
||||
|
||||
<DL>
|
||||
<DT><CODE>directory</CODE>
|
||||
<DD>
|
||||
The working directory of the server. Any non-absolute
|
||||
|
|
@ -228,10 +248,17 @@ zone the server is authoritative for changes. The use of NOTIFY
|
|||
speeds convergence between the master and its slaves. Slave servers
|
||||
that receive a NOTIFY message, and understand it, will contact the
|
||||
master server for the zone to see if they need to do a zone transfer. If
|
||||
they do, they will initiate it immediately. The <CODE>notify</CODE>
|
||||
they do, they will initiate it immediately. If <CODE>explicit</CODE>,
|
||||
the NOTIFY messages will only be sent to the addresses in the
|
||||
<CODE>also-notify</CODE> list. The <CODE>notify</CODE>
|
||||
option may also be specified in the <CODE>zone</CODE> statement, in which
|
||||
case it overrides the <CODE>options notify</CODE> statement.
|
||||
|
||||
<DT><CODE>suppress-initial-notify</CODE>
|
||||
<DD>
|
||||
If <CODE>yes</CODE>, suppress the initial notify messages when the server
|
||||
first loads. The default is <CODE>no</CODE>.
|
||||
|
||||
<DT><CODE>recursion</CODE>
|
||||
<DD>
|
||||
If <CODE>yes</CODE>, and a DNS query requests recursion, the
|
||||
|
|
@ -552,9 +579,8 @@ files</CODE> to specify the limit explicitly.
|
|||
|
||||
<DT><CODE>max-ixfr-log-size</CODE>
|
||||
<DD>
|
||||
The <CODE>max-ixfr-log-size</CODE> will be used in a future release of
|
||||
the server to limit the size of the
|
||||
transaction log kept for Incremental Zone Transfer.
|
||||
Limit the size of the transaction log kept for Incremental Zone Transfer.
|
||||
Default 0 (unlimited).
|
||||
|
||||
<DT><CODE>stacksize</CODE>
|
||||
<DD>
|
||||
|
|
@ -784,6 +810,15 @@ of:
|
|||
|
||||
<P>is used.
|
||||
|
||||
<H4>Glue Ordering</H4>
|
||||
|
||||
When running a root nameserver it is sometimes necessary to ensure that
|
||||
other nameservers that are priming are successful. This requires
|
||||
that glue A records for at least of the nameservers are returned in
|
||||
the answer to a priming query. This can be achieved by setting
|
||||
<CODE>preferred-glue A;</CODE> which will add A records before other types
|
||||
in the additional section.
|
||||
|
||||
<H4>Tuning</H4>
|
||||
|
||||
<DL>
|
||||
|
|
@ -812,7 +847,7 @@ request for the root servers to be accepted. Default 2.
|
|||
|
||||
<HR>
|
||||
<ADDRESS>
|
||||
Last Updated: $Id: options.html,v 1.43 2001/03/03 05:08:55 marka Exp $
|
||||
Last Updated: $Id: options.html,v 1.48 2002/04/25 05:27:00 marka Exp $
|
||||
</ADDRESS>
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
|
|
|||
|
|
@ -34,6 +34,10 @@ associated with a remote name server.</P>
|
|||
will mark all other addresses for that server as <CODE>bogus</CODE> when
|
||||
a match is made when looking up a server's address by name.
|
||||
|
||||
<P>If the server supports IXFR you can tell named to attempt to perform a
|
||||
IXFR style zone transfer by specifing <CODE>support-ixfr yes</CODE>.
|
||||
The default value of <CODE>support-ixfr</CODE> is <CODE>no</CODE>.
|
||||
|
||||
<P>The server supports two zone transfer methods. The first,
|
||||
<CODE>one-answer</CODE>, uses one DNS message per resource record
|
||||
transferred. <CODE>many-answers</CODE> packs as many resource records
|
||||
|
|
@ -65,7 +69,7 @@ required to be signed by this key.
|
|||
|
||||
<HR>
|
||||
<ADDRESS>
|
||||
Last Updated: $Id: server.html,v 1.11 2000/11/08 04:15:07 marka Exp $
|
||||
Last Updated: $Id: server.html,v 1.12 2001/08/10 05:12:29 marka Exp $
|
||||
</ADDRESS>
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
|
|
|||
|
|
@ -22,7 +22,7 @@ zone <VAR><A HREF="docdef.html">domain_name</A></VAR> [ ( in | hs | hesiod | cha
|
|||
[ allow-query { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
|
||||
[ allow-transfer { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
|
||||
[ dialup <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
[ notify <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
|
||||
[ notify (<VAR><A HREF="docdef.html">yes_or_no</A></VAR> | explicit ); ]
|
||||
[ also-notify { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] }; ]
|
||||
[ ixfr-base <VAR><A HREF="docdef.html">path_name</A></VAR>; ]
|
||||
[ pubkey <VAR><A HREF="docdef.html">number</A></VAR> <VAR><A HREF="docdef.html">number</A></VAR> <VAR><A HREF="docdef.html">number</A></VAR> <VAR>string</VAR>; ]
|
||||
|
|
@ -32,7 +32,7 @@ zone <VAR><A HREF="docdef.html">domain_name</A></VAR> [ ( in | hs | hesiod | cha
|
|||
type ( slave | stub );
|
||||
[ file <VAR><A HREF="docdef.html">path_name</A></VAR>; ]
|
||||
[ ixfr-base <VAR><A HREF="docdef.html">path_name</A></VAR>; ]
|
||||
masters [ port <VAR><A HREF="docdef.html">ip_port</A></VAR> ] { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] };
|
||||
masters [ port <VAR><A HREF="docdef.html">ip_port</A></VAR> ] { <VAR><A HREF="docdef.html">ip_addr</A></VAR> [key <VAR><A HREF="key.html">key_id</A></VAR>]; [ ... ] };
|
||||
[ forward ( only | first ); ]
|
||||
[ forwarders { [ <VAR><A HREF="docdef.html">ip_addr</A></VAR> ; [ <VAR>ip_addr</VAR> ; ... ] ] }; ]
|
||||
[ check-names ( warn | fail | ignore ); ]
|
||||
|
|
@ -238,7 +238,7 @@ string representing the key.
|
|||
|
||||
<HR>
|
||||
<ADDRESS>
|
||||
Last Updated: $Id: zone.html,v 1.24 2000/01/12 01:28:32 cyarnell Exp $
|
||||
Last Updated: $Id: zone.html,v 1.26 2002/04/25 05:27:02 marka Exp $
|
||||
</ADDRESS>
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $Id: dig.1,v 8.4 1999/10/15 21:29:58 vixie Exp $
|
||||
.\" $Id: dig.1,v 8.8 2001/09/24 15:21:29 marka Exp $
|
||||
.\"
|
||||
.\" ++Copyright++ 1993
|
||||
.\" -
|
||||
|
|
@ -100,7 +100,7 @@ Internet address. If this optional field is omitted,
|
|||
.Ic dig
|
||||
will attempt to use the default name server for your machine.
|
||||
.sp 1
|
||||
.Em Note:
|
||||
.Em Note :
|
||||
If a domain name is specified, this will be resolved
|
||||
using the domain name system resolver (i.e., BIND). If your
|
||||
system does not support DNS, you may
|
||||
|
|
@ -116,7 +116,7 @@ itself can be resolved. See
|
|||
.Xr resolver @FORMAT_EXT@
|
||||
for information on
|
||||
.Pa /etc/resolv.conf .
|
||||
.Sy WARNING:
|
||||
.Sy WARNING :
|
||||
Changing
|
||||
.Pa /etc/resolv.conf
|
||||
will affect both the standard resolver library and
|
||||
|
|
@ -190,7 +190,7 @@ all/any class information
|
|||
.Pp
|
||||
(See RFC 1035 for the complete list.)
|
||||
.Pp
|
||||
.Em Note:
|
||||
.Em Note :
|
||||
.Dq Ar Any
|
||||
can be used to specify a
|
||||
.Em class
|
||||
|
|
@ -323,7 +323,7 @@ environment is saved. If not, the file
|
|||
.Dq Pa DiG.env
|
||||
is created in the current working directory.
|
||||
.Pp
|
||||
.Em Note:
|
||||
.Em Note :
|
||||
.Ev LOCALDEF
|
||||
is specific to the
|
||||
.Ic dig
|
||||
|
|
@ -521,6 +521,13 @@ print TTLs
|
|||
.Bq Cm tt
|
||||
.It Xo
|
||||
.Op Cm no
|
||||
.Ns Cm trunc\ \ \ \
|
||||
.Pq Cm tr
|
||||
.Xc
|
||||
truncate origin from names
|
||||
.Bq Cm tr
|
||||
.It Xo
|
||||
.Op Cm no
|
||||
.Ns Cm cl
|
||||
.Xc
|
||||
print class info
|
||||
|
|
@ -566,6 +573,13 @@ print authoritative section
|
|||
.Xc
|
||||
print additional section
|
||||
.Bq Cm ad
|
||||
.It Xo
|
||||
.Op Cm no
|
||||
.Ns Cm dnssec\ \ \
|
||||
.Pq Cm \ddn
|
||||
.Xc
|
||||
set the DNSSEC OK bit in the OPT pseudo record
|
||||
.Bq Cm nodn
|
||||
.It Cm pfdef
|
||||
set to default print flags
|
||||
.It Cm pfmin
|
||||
|
|
@ -641,7 +655,7 @@ and
|
|||
options, above.
|
||||
.Sh FILES
|
||||
.Bl -tag -width "/etc/resolv.conf " -compact
|
||||
.It Pa /etc/resolv.conf
|
||||
.It Pa /etc/resolv.conf
|
||||
initial domain name and name server addresses
|
||||
.It Pa \./DiG.env
|
||||
default save file for default options
|
||||
|
|
@ -672,7 +686,8 @@ rather ad hoc genesis.
|
|||
.Ic Dig
|
||||
does not consistently exit nicely (with appropriate status)
|
||||
when a problem occurs somewhere in the resolver
|
||||
.Po Sy NOTE:
|
||||
.Po
|
||||
.Sy NOTE :
|
||||
most of the common exit cases are handled
|
||||
.Pc .
|
||||
This is particularly annoying when running in
|
||||
|
|
|
|||
|
|
@ -13,26 +13,26 @@
|
|||
.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
|
||||
.\" SOFTWARE.
|
||||
.\"
|
||||
.\" $Id: dnskeygen.1,v 8.5 1999/02/23 05:20:18 vixie Exp $
|
||||
.\" $Id: dnskeygen.1,v 8.8 2002/04/22 04:27:19 marka Exp $
|
||||
.\"
|
||||
.Dd December 2, 1998
|
||||
.Dt DNSKEYGEN @CMD_EXT_U@
|
||||
.Os BSD 4
|
||||
.Sh NAME
|
||||
.Nm dnskeygen
|
||||
.Nd generate public, private, and shared secret keys for DNS Security
|
||||
.Nd "generate public, private, and shared secret keys for DNS Security"
|
||||
.Sh SYNOPSIS
|
||||
.Nm dnskeygen
|
||||
.Oo Fl
|
||||
.Op Cm DHR
|
||||
.Oo
|
||||
.Fl Op Cm DHR
|
||||
.Ar size
|
||||
.Oc
|
||||
.Op Fl F
|
||||
.Fl Op Cm zhu
|
||||
.Op Cm Fl a
|
||||
.Op Cm Fl c
|
||||
.Op Cm Fl p Ar num
|
||||
.Op Cm Fl s Ar num
|
||||
.Op Fl Cm zhu
|
||||
.Op Fl Cm a
|
||||
.Op Fl Cm c
|
||||
.Op Fl Cm p Ar num
|
||||
.Op Fl Cm s Ar num
|
||||
.Fl n Ar name
|
||||
.Sh DESCRIPTION
|
||||
.Ic Dnskeygen
|
||||
|
|
@ -61,7 +61,7 @@ key.
|
|||
.Dq size
|
||||
must be between 512 and 4096.
|
||||
.It Fl F
|
||||
.Ic (RSA only)
|
||||
.Ic ( RSA only )
|
||||
Use a large exponent for key generation.
|
||||
.It Fl z Fl h Fl u
|
||||
These flags define the type of key being generated: Zone (DNS validation) key,
|
||||
|
|
@ -77,8 +77,8 @@ Indicates that the key
|
|||
be used for encryption.
|
||||
.It Fl p Ar num
|
||||
Sets the key's protocol field to
|
||||
.Ar num
|
||||
; the default is
|
||||
.Ar num ;
|
||||
the default is
|
||||
.Ic 3
|
||||
(DNSSEC) if
|
||||
.Dq Fl z
|
||||
|
|
@ -95,12 +95,12 @@ is specified and
|
|||
(ANY).
|
||||
.It Fl s Ar num
|
||||
Sets the key's strength field to
|
||||
.Ar num;
|
||||
.Ar num ;
|
||||
the default is
|
||||
.Sy 0.
|
||||
.Sy 0 .
|
||||
.It Fl n Ar name
|
||||
Sets the key's name to
|
||||
.Ar name.
|
||||
.Ar name .
|
||||
.El
|
||||
.Ss DETAILS
|
||||
.Ic Dnskeygen
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $Id: dnsquery.1,v 8.3 1999/01/08 18:54:21 vixie Exp $
|
||||
.\" $Id: dnsquery.1,v 8.4 2001/08/08 07:49:58 marka Exp $
|
||||
.\"
|
||||
.\"Copyright (c) 1995,1996,1999 by Internet Software Consortium
|
||||
.\"
|
||||
|
|
@ -63,25 +63,25 @@ address
|
|||
nameserver
|
||||
.It Ar CNAME
|
||||
canonical name
|
||||
.It Ar PTR
|
||||
.It Ar PTR
|
||||
domain name pointer
|
||||
.It Ar SOA
|
||||
.It Ar SOA
|
||||
start of authority
|
||||
.It Ar WKS
|
||||
.It Ar WKS
|
||||
well-known service
|
||||
.It Ar HINFO
|
||||
host information
|
||||
.It Ar MINFO
|
||||
mailbox information
|
||||
.It Ar MX
|
||||
.It Ar MX
|
||||
mail exchange
|
||||
.It Ar RP
|
||||
.It Ar RP
|
||||
responsible person
|
||||
.It Ar MG
|
||||
.It Ar MG
|
||||
mail group member
|
||||
.It Ar AFSDB
|
||||
.It Ar AFSDB
|
||||
DCE or AFS server
|
||||
.It Ar ANY
|
||||
.It Ar ANY
|
||||
wildcard
|
||||
.El
|
||||
.Pp
|
||||
|
|
@ -91,13 +91,13 @@ Note that any case may be used. (Default:
|
|||
The class of resource records of interest.
|
||||
Classes include:
|
||||
.Bl -tag -width "CHAOS " -compact -offset indent
|
||||
.It Ar IN
|
||||
.It Ar IN
|
||||
Internet
|
||||
.It Ar HS
|
||||
.It Ar HS
|
||||
Hesiod
|
||||
.It Ar CHAOS
|
||||
Chaos
|
||||
.It Ar ANY
|
||||
.It Ar ANY
|
||||
wildcard
|
||||
.El
|
||||
.Pp
|
||||
|
|
@ -135,9 +135,9 @@ The name of the host (or domain) of interest.
|
|||
.Bl -tag -width "<arpa/nameser.h> " -compact
|
||||
.It Pa /etc/resolv.conf
|
||||
to get the default ns and search lists
|
||||
.It Pa <arpa/nameser.h>
|
||||
.It Pa <arpa/nameser.h>
|
||||
list of usable RR types and classes
|
||||
.It Pa <resolv.h>
|
||||
.It Pa <resolv.h>
|
||||
list of resolver flags
|
||||
.El
|
||||
.Sh DIAGNOSTICS
|
||||
|
|
|
|||
|
|
@ -30,7 +30,7 @@
|
|||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" From: @(#)gethostbyname.3 8.4 (Berkeley) 5/25/95
|
||||
.\" $Id: getaddrinfo.3,v 8.1 1999/01/11 21:30:51 vixie Exp $
|
||||
.\" $Id: getaddrinfo.3,v 8.3 2001/12/28 04:24:15 marka Exp $
|
||||
.\"
|
||||
.Dd May 25, 1995
|
||||
.Dt GETADDRINFO @LIB_NETWORK_EXT@
|
||||
|
|
@ -97,9 +97,7 @@ A
|
|||
.Pf non Dv -NULL
|
||||
.Fa nodename
|
||||
string can be either a node name or a numeric host address string
|
||||
.Po
|
||||
i.e., a dotted-decimal IPv4 address or an IPv6 hex address
|
||||
.Pc .
|
||||
(i.e., a dotted-decimal IPv4 address or an IPv6 hex address).
|
||||
A
|
||||
.Pf non Dv -NULL
|
||||
.Fa servname
|
||||
|
|
@ -218,7 +216,8 @@ call to
|
|||
.Pq for a connection-oriented protocol
|
||||
or either
|
||||
.Fn connect ,
|
||||
.Fn sendto , or
|
||||
.Fn sendto ,
|
||||
or
|
||||
.Fn sendmsg
|
||||
.Pq for a connectionless protocol .
|
||||
In this case, if the
|
||||
|
|
@ -356,6 +355,6 @@ The
|
|||
.Fn getaddrinfo
|
||||
function is defined IEEE POSIX 1003.1g draft specification,
|
||||
and documented in ``Basic Socket Interface Extensions for IPv6''
|
||||
.Pq RFC2133 .
|
||||
(RFC2133).
|
||||
.Sh BUGS
|
||||
The text was shamelessly copied from RFC2133.
|
||||
|
|
|
|||
|
|
@ -31,19 +31,19 @@
|
|||
.Sh SYNOPSIS
|
||||
.Fd #include <netdb.h>
|
||||
.Ft extern int
|
||||
.Fa h_errno;
|
||||
.Fa h_errno ;
|
||||
.Pp
|
||||
.Ft struct hostent *
|
||||
.Fn gethostbyname "char *name";
|
||||
.Fn gethostbyname "char *name"
|
||||
.Ft struct hostent *
|
||||
.Fn gethostbyname2 "char *name" "int af";
|
||||
.Fn gethostbyname2 "char *name" "int af"
|
||||
.Ft struct hostent *
|
||||
.Fn gethostbyaddr "char *addr" "int len, type";
|
||||
.Fn gethostbyaddr "char *addr" "int len, type"
|
||||
.Ft struct hostent *
|
||||
.Fn gethostent
|
||||
.Fn sethostent "int stayopen";
|
||||
.Fn sethostent "int stayopen"
|
||||
.Fn endhostent
|
||||
.Fn herror "char *string";
|
||||
.Fn herror "char *string"
|
||||
.Sh DESCRIPTION
|
||||
.Fn Gethostbyname ,
|
||||
.Fn gethostbyname2 ,
|
||||
|
|
@ -140,21 +140,17 @@ Otherwise, queries are performed using UDP datagrams.
|
|||
.Fn Endhostent
|
||||
closes the TCP connection.
|
||||
.Sh ENVIRONMENT
|
||||
.Bl -tag -width "HOSTALIASES " -compress
|
||||
.Bl -tag -width "HOSTALIASES " -compact
|
||||
.It Ev HOSTALIASES
|
||||
Name of file containing
|
||||
.Pq Ar host alias , full hostname
|
||||
pairs.
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width "HOSTALIASES " -compress
|
||||
.Bl -tag -width "HOSTALIASES " -compact
|
||||
.It Pa /etc/hosts
|
||||
See
|
||||
.Xr hosts @FORMAT_EXT@ .
|
||||
.It Ev HOSTALIASES
|
||||
Name of file containing
|
||||
.Pq Ar host alias , full hostname
|
||||
pairs.
|
||||
.El
|
||||
.Sh DIAGNOSTICS
|
||||
.Pp
|
||||
|
|
@ -222,7 +218,7 @@ when
|
|||
is built to use only the routines to lookup in
|
||||
.Pa /etc/hosts
|
||||
and not the name server:
|
||||
.Bd -filled -offset indent
|
||||
.Bd -ragged -offset indent
|
||||
.Pp
|
||||
.Fn Gethostent
|
||||
reads the next line of
|
||||
|
|
|
|||
|
|
@ -43,11 +43,11 @@
|
|||
.Fd #include <netdb.h>
|
||||
.Pp
|
||||
.Ft struct hostent *
|
||||
.Fn getipnodebyname "const char *name" "int af" "int flags" "int *error";
|
||||
.Fn getipnodebyname "const char *name" "int af" "int flags" "int *error"
|
||||
.Ft struct hostent *
|
||||
.Fn getipnodebyaddr "const void *addr" "size_t len" "int af" "int *error";
|
||||
.Fn getipnodebyaddr "const void *addr" "size_t len" "int af" "int *error"
|
||||
.Ft void
|
||||
.Fn freehostent "struct hostent *he";
|
||||
.Fn freehostent "struct hostent *he"
|
||||
.Sh DESCRIPTION
|
||||
.Fn Getipnodebyname ,
|
||||
and
|
||||
|
|
@ -166,21 +166,17 @@ should not be passed to
|
|||
.Fn freehostent
|
||||
as they are pointers to static areas.
|
||||
.Sh ENVIRONMENT
|
||||
.Bl -tag -width "HOSTALIASES " -compress
|
||||
.Bl -tag -width "HOSTALIASES " -compact
|
||||
.It Ev HOSTALIASES
|
||||
Name of file containing
|
||||
.Pq Ar host alias , full hostname
|
||||
pairs.
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width "HOSTALIASES " -compress
|
||||
.Bl -tag -width "HOSTALIASES " -compact
|
||||
.It Pa /etc/hosts
|
||||
See
|
||||
.Xr hosts @FORMAT_EXT@ .
|
||||
.It Ev HOSTALIASES
|
||||
Name of file containing
|
||||
.Pq Ar host alias , full hostname
|
||||
pairs.
|
||||
.El
|
||||
.Sh DIAGNOSTICS
|
||||
.Pp
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $Id: getnameinfo.3,v 8.1 1999/01/11 21:30:51 vixie Exp $
|
||||
.\" $Id: getnameinfo.3,v 8.2 2001/12/28 04:24:16 marka Exp $
|
||||
.\"
|
||||
.\"Copyright (c) 1998,1999 by Internet Software Consortium
|
||||
.\"
|
||||
|
|
@ -100,4 +100,4 @@ The
|
|||
.Fn getaddrinfo
|
||||
function is defined IEEE POSIX 1003.1g draft specification,
|
||||
and documented in ``Basic Socket Interface Extensions for IPv6''
|
||||
.Pq RFC2133 .
|
||||
(RFC2133).
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $Id: getnetent.3,v 8.4 1999/01/08 18:54:23 vixie Exp $
|
||||
.\" $Id: getnetent.3,v 8.6 2001/12/28 04:24:17 marka Exp $
|
||||
.\"
|
||||
.\"Copyright (c) 1995,1996,1999 by Internet Software Consortium
|
||||
.\"
|
||||
|
|
@ -30,11 +30,11 @@
|
|||
.Ft struct netent *
|
||||
.Fn getnetent
|
||||
.Ft struct netent *
|
||||
.Fn getnetbyname "char name";
|
||||
.Fn getnetbyname "char name"
|
||||
.Ft struct netent *
|
||||
.Fn getnetbyaddr "unsigned long net" "int type";
|
||||
.Fn getnetbyaddr "unsigned long net" "int type"
|
||||
.Ft void
|
||||
.Fn setnetent "int stayopen";
|
||||
.Fn setnetent "int stayopen"
|
||||
.Ft void
|
||||
.Fn endnetent
|
||||
.Sh DESCRIPTION
|
||||
|
|
@ -145,7 +145,8 @@ The
|
|||
.Fn "setnetent" ,
|
||||
and
|
||||
.Fn "endnetent"
|
||||
functions appeared in 4.2BSD.
|
||||
functions appeared in
|
||||
.Bx 4.2 .
|
||||
.Sh BUGS
|
||||
The data space used by these functions is static; if future use requires the
|
||||
data, it should be copied before any subsequent calls to these functions
|
||||
|
|
|
|||
|
|
@ -50,7 +50,7 @@
|
|||
.\" SOFTWARE.
|
||||
.\" -
|
||||
.\" --Copyright--
|
||||
.\" $Id: host.1,v 8.4 2000/02/29 03:50:47 vixie Exp $
|
||||
.\" $Id: host.1,v 8.6 2001/08/10 00:14:47 cyarnell Exp $
|
||||
.Dd December 15, 1994
|
||||
.Dt HOST @CMD_EXT_U@
|
||||
.Os BSD 4
|
||||
|
|
@ -72,7 +72,7 @@
|
|||
.Ic Host
|
||||
looks for information about Internet hosts. It gets this information
|
||||
from a set of interconnected servers that are spread across the
|
||||
country. By default, it simply converts between host names and
|
||||
world. By default, it simply converts between host names and
|
||||
Internet addresses. However, with the
|
||||
.Dq Fl t
|
||||
or
|
||||
|
|
@ -251,7 +251,7 @@ will give a complete download of the zone data for rutgers.edu,
|
|||
in the official master file format. (However the SOA record is
|
||||
listed twice, for arcane reasons.)
|
||||
.Pp
|
||||
.Sy NOTE:
|
||||
.Sy NOTE :
|
||||
.Dq Fl l
|
||||
is implemented by
|
||||
doing a complete zone transfer and then filtering out the information
|
||||
|
|
@ -275,21 +275,17 @@ host name. The name file must be contained in the
|
|||
.Ev HOSTALIASES
|
||||
environment variable.
|
||||
.Sh ENVIRONMENT
|
||||
.Bl -tag -width "/etc/resolv.conf " -compress
|
||||
.Bl -tag -width "/etc/resolv.conf " -compact
|
||||
.It Ev HOSTALIASES
|
||||
Name of file containing
|
||||
.Pq Ar host alias , full hostname
|
||||
pairs.
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width "/etc/resolv.conf " -compress
|
||||
.Bl -tag -width "/etc/resolv.conf " -compact
|
||||
.It Pa /etc/resolv.conf
|
||||
See
|
||||
.Xr resolver @FORMAT_EXT@ .
|
||||
.It Ev HOSTALIASES
|
||||
Name of file containing
|
||||
.Pq Ar host alias , full hostname
|
||||
pairs.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr @INDOT@named @SYS_OPS_EXT@ ,
|
||||
|
|
|
|||
|
|
@ -147,7 +147,7 @@ If the name was not previously tried
|
|||
threshold or did not contain a dot), then the name as
|
||||
originally provided is attempted.
|
||||
.Sh ENVIRONMENT
|
||||
.Bl -tag -width "/etc/resolv.conf " -compress
|
||||
.Bl -tag -width "/etc/resolv.conf "
|
||||
.It Ev LOCALDOMAIN
|
||||
Affects domains appended to partial hostnames.
|
||||
.It Ev HOSTALIASES
|
||||
|
|
@ -156,14 +156,11 @@ Name of file containing
|
|||
pairs.
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width "/etc/resolv.conf " -compress
|
||||
.Bl -tag -width "/etc/resolv.conf " -compact
|
||||
.It Pa /etc/resolv.conf
|
||||
See
|
||||
.Xr resolve @FORMAT_EXT@ .
|
||||
.It Ev HOSTALIASES
|
||||
Name of file containing
|
||||
.Pq Ar host alias , full hostname
|
||||
pairs.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr gethostbyname @LIB_NETWORK_EXT@ ,
|
||||
.Xr resolver @FORMAT_EXT@ ,
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $Id: inet_cidr.3,v 8.2 1999/01/08 18:54:24 vixie Exp $
|
||||
.\" $Id: inet_cidr.3,v 8.3 2001/08/08 07:50:06 marka Exp $
|
||||
.\"
|
||||
.\"Copyright (c) 1998,1999 by Internet Software Consortium
|
||||
.\"
|
||||
|
|
@ -44,13 +44,13 @@ converts an address from network to presentation format.
|
|||
.Pp
|
||||
.Ft af
|
||||
describes the type of address that is being passed in
|
||||
.Ft src.
|
||||
.Ft src .
|
||||
.\"Currently defined types are AF_INET and AF_INET6.
|
||||
Currently only AF_INET is supported.
|
||||
.Pp
|
||||
.Ft src
|
||||
is an address in network byte order, its length is determined from
|
||||
.Ft af.
|
||||
.Ft af .
|
||||
.Pp
|
||||
.Ft bits
|
||||
specifies the number of bits in the netmask unless it is -1 in which case
|
||||
|
|
@ -71,13 +71,13 @@ Check errno for reason.
|
|||
converts and address from presentation format, with optional CIDR
|
||||
reperesentation, to network format.
|
||||
The resulting address is zero filled if there were insufficint bits in
|
||||
.Ft src.
|
||||
.Ft src .
|
||||
.Pp
|
||||
.Ft af
|
||||
describes the type of address that is being passed in via
|
||||
.Ft src
|
||||
and determines the size of
|
||||
.Ft dst.
|
||||
.Ft dst .
|
||||
.Pp
|
||||
.Ft src
|
||||
is an address in presentation format.
|
||||
|
|
|
|||
|
|
@ -122,7 +122,7 @@ Under some circumstances it may be necessary to route a message through
|
|||
several hosts to get it to the final destination. Normally this routing
|
||||
is done automatically, but sometimes it is desirable to route the message
|
||||
manually. Addresses which show these relays are termed
|
||||
.Dq route-addrs.
|
||||
.Dq route-addrs .
|
||||
These use the syntax:
|
||||
.Bd -ragged -offset indent-two
|
||||
.Li <@hosta,@hostb:user@hostc>
|
||||
|
|
|
|||
|
|
@ -26,7 +26,7 @@
|
|||
.Op Fl ap
|
||||
.Op Fl f Ar depend_file
|
||||
.Op Ar flags
|
||||
.Ar file ...
|
||||
.Ar
|
||||
.Sh DESCRIPTION
|
||||
.Ic Mkdep
|
||||
takes a set of flags for the C compiler and a list
|
||||
|
|
@ -73,9 +73,7 @@ C module.
|
|||
The
|
||||
.Dq Fl a
|
||||
option causes appending to the output file, so that multiple
|
||||
.Xo Ic mkdep
|
||||
.Ns 's
|
||||
.Xc
|
||||
.Ic mkdep Ns 's
|
||||
may be run from a single
|
||||
.Pa Makefile .
|
||||
.Sh SEE ALSO
|
||||
|
|
|
|||
|
|
@ -48,7 +48,6 @@
|
|||
.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
|
||||
.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
|
||||
.\" SOFTWARE.
|
||||
|
||||
.Dd November 19, 1998
|
||||
.Dt NAMED-BOOTCONF 8
|
||||
.Os NetBSD
|
||||
|
|
|
|||
|
|
@ -89,9 +89,7 @@
|
|||
.Op Fl p Ar port#
|
||||
.Op Fl S
|
||||
.Ar nameserver
|
||||
.Op Ar [ Sy axfr
|
||||
|
|
||||
.Op Sy ixfr ]
|
||||
.Op Sy axfr | ixfr
|
||||
.Sh DESCRIPTION
|
||||
.Ic Named-xfer
|
||||
is an ancillary program executed by
|
||||
|
|
@ -161,7 +159,7 @@ for more information.
|
|||
Additional arguments are taken as name server addresses in so-called
|
||||
.Dq dotted-quad
|
||||
syntax
|
||||
.Em only;
|
||||
.Em only ;
|
||||
no host name are allowed here. At least one address must be specified.
|
||||
Any additional addresses will be tried, in order, if the first one fails
|
||||
to transfer to us successfully.
|
||||
|
|
|
|||
|
|
@ -92,7 +92,7 @@ or
|
|||
.Dq Fl c
|
||||
flags.
|
||||
.Pp
|
||||
.Sy NOTE:
|
||||
.Sy NOTE :
|
||||
Several of
|
||||
.Nm named Ns 's
|
||||
options, and much more of its behaviour, can be controlled in the configuration
|
||||
|
|
@ -111,7 +111,7 @@ is a number determines the level of messages printed. If negative,
|
|||
is set to
|
||||
.Dq 1 .
|
||||
.Pp
|
||||
.Sy NOTE:
|
||||
.Sy NOTE :
|
||||
The new debugging framework is considerably more sophisticated than it
|
||||
was in older versions of
|
||||
.Nm @INDOT@named .
|
||||
|
|
@ -131,7 +131,7 @@ the port number returned by
|
|||
for service
|
||||
.Dq Li domain .
|
||||
.Pp
|
||||
.Sy NOTE:
|
||||
.Sy NOTE :
|
||||
Previously, the syntax
|
||||
.Dq Fl p Ar port# Ns Op Ar \&/localport#
|
||||
was supported; the first port was that used when contacting
|
||||
|
|
@ -169,7 +169,7 @@ has been compiled with
|
|||
.Li QRYLOG
|
||||
defined.
|
||||
.Pp
|
||||
.Sy NOTE:
|
||||
.Sy NOTE :
|
||||
This option is deprecated in favor of the
|
||||
.Dq Li queries
|
||||
.Em logging category
|
||||
|
|
@ -183,7 +183,7 @@ Turns recursion off in the server. Answers can come only from local
|
|||
(primary or secondary) zones. This can be used on root servers.
|
||||
The default is to use recursion.
|
||||
.Pp
|
||||
.Sy NOTE:
|
||||
.Sy NOTE :
|
||||
This option can be overridden by and is deprecated in favor of the
|
||||
.Dq Li recursion
|
||||
clause of the configuration file's
|
||||
|
|
@ -242,7 +242,7 @@ where:
|
|||
.Bl -tag -width "opt_domain "
|
||||
.It Ar domain
|
||||
is
|
||||
.Dq Li \&.
|
||||
.Dq Li .\&
|
||||
for root,
|
||||
.Dq Li @
|
||||
for the current origin, or a standard domain name. If
|
||||
|
|
@ -252,7 +252,7 @@ is a standard domain name that does
|
|||
end with
|
||||
.Dq Li \&. ,
|
||||
the current origin is appended to the domain. Domain names ending with
|
||||
.Dq Li \&.
|
||||
.Dq Li .\&
|
||||
are unmodified.
|
||||
.It Ar opt_domain
|
||||
This field is used to define an origin for the data in an included file.
|
||||
|
|
@ -270,7 +270,7 @@ an explicit ttl.
|
|||
.It Ar opt_ttl
|
||||
An optional integer number for the time-to-live field.
|
||||
If not set the ttl is taken from the last $TTL statement.
|
||||
If no $TTL statement has occured then the SOA minimum value is used and a
|
||||
If no $TTL statement has occurred then the SOA minimum value is used and a
|
||||
warning is generated.
|
||||
.It Ar opt_class
|
||||
The object address type; currently only one type is supported,
|
||||
|
|
@ -310,7 +310,7 @@ Resource records normally end at the end of a line,
|
|||
but may be continued across lines between opening and closing parentheses.
|
||||
Comments are introduced by semicolons and continue to the end of the line.
|
||||
.Pp
|
||||
.Sy NOTE:
|
||||
.Sy NOTE :
|
||||
There are other resource record types not shown here. You should
|
||||
consult the
|
||||
.Sy BIND
|
||||
|
|
@ -400,19 +400,21 @@ Saves any modified dynamic zones to the file system, and shuts down the server.
|
|||
Turns on debugging; each
|
||||
.Dv SIGUSR1
|
||||
increments debug level.
|
||||
.Po Dv SIGEMT
|
||||
.Po
|
||||
.Dv SIGEMT
|
||||
on older systems without
|
||||
.Dv SIGUSR1 .
|
||||
.Pc
|
||||
.It Dv SIGUSR2
|
||||
Turns off debugging completely.
|
||||
.Po Dv SIGFPE
|
||||
.Po
|
||||
.Dv SIGFPE
|
||||
on older systems without
|
||||
.Dv SIGUSR2 .
|
||||
.Pc
|
||||
.It Dv SIGWINCH
|
||||
Toggles logging of all incoming queries via
|
||||
.Xr syslog @SYS_OPS_EXT@
|
||||
.Xr syslog @LIB_C_EXT@
|
||||
(requires server to have been built with the
|
||||
.Li QRYLOG
|
||||
option).
|
||||
|
|
@ -431,12 +433,13 @@ debug output
|
|||
nameserver statistics data
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr named.conf @FORMAT_EXT@ ,
|
||||
.Xr gethostbyname @LIB_NETWORK_EXT@ ,
|
||||
.Xr hostname @DESC_EXT@ ,
|
||||
.Xr kill @CMD_EXT@ ,
|
||||
.Xr resolver @LIB_NETWORK_EXT@ ,
|
||||
.Xr resolver @FORMAT_EXT@ ,
|
||||
.Xr signal @SYSCALL_EXT@ ,
|
||||
.Xr signal @LIB_C_EXT@ ,
|
||||
RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035, RFC 1123,
|
||||
RFC 2308
|
||||
.Dq Name Server Operations Guide for Sy BIND
|
||||
|
|
|
|||
File diff suppressed because it is too large
Load diff
|
|
@ -94,7 +94,7 @@ Exit from
|
|||
command interpreter.
|
||||
.It Ar /trace
|
||||
Toggle tracing (see
|
||||
.Fl -t
|
||||
.Fl t
|
||||
description above).
|
||||
.It Ar /debug
|
||||
Toggle debugging (see
|
||||
|
|
@ -125,7 +125,7 @@ mode, there is no
|
|||
command and the
|
||||
.Ar restart
|
||||
command just tells the name server to
|
||||
.Xr execvp 2
|
||||
.Xr execvp @LIB_C_EXT@
|
||||
itself.
|
||||
.Sh AUTHOR
|
||||
Paul Vixie (Internet Software Consortium)
|
||||
|
|
|
|||
|
|
@ -170,7 +170,7 @@ command.
|
|||
Connects with the finger server on the current host.
|
||||
The current host is defined when a previous lookup for a host
|
||||
was successful and returned address information (see the
|
||||
.Dq Ic set querytype=A
|
||||
.Dq Ic set querytype Ns = Ns Dv A
|
||||
command).
|
||||
The
|
||||
.Ar name
|
||||
|
|
@ -223,12 +223,13 @@ Sorts and lists the output of previous
|
|||
command(s) with
|
||||
.Xr more @CMD_EXT@ .
|
||||
.It Ic help
|
||||
.It Ic ?
|
||||
.It Ic ?\&
|
||||
Prints a brief summary of commands.
|
||||
.It Ic exit
|
||||
Exits the program.
|
||||
.It Xo Ic set Ar keyword
|
||||
.Ns Op = Ns Ar value
|
||||
.It Xo
|
||||
.Ic set
|
||||
.Ar keyword Ns Op = Ns Ar value
|
||||
.Xc
|
||||
This command is used to change state information that affects the lookups.
|
||||
Valid keywords are:
|
||||
|
|
@ -237,7 +238,7 @@ Valid keywords are:
|
|||
Prints the current values of the frequently-used options to
|
||||
.Ic set .
|
||||
Information about the current default server and host is also printed.
|
||||
.It Ic class= Ns Ar value
|
||||
.It Ic class Ns = Ns Ar value
|
||||
Change the query class to one of:
|
||||
.Bl -tag -width "HESIOD "
|
||||
.It Dv IN
|
||||
|
|
@ -256,8 +257,8 @@ The class specifies the protocol group of the information.
|
|||
.Dv IN ;
|
||||
abbreviation =
|
||||
.Ic cl )
|
||||
.It Xo Op Ic no
|
||||
.Ns Ic debug
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic debug
|
||||
.Xc
|
||||
Turn debugging mode on. A lot more information is printed about the
|
||||
packet sent to the server and the resulting answer.
|
||||
|
|
@ -265,18 +266,16 @@ packet sent to the server and the resulting answer.
|
|||
(Default =
|
||||
.Ic nodebug ;
|
||||
abbreviation =
|
||||
.Xo Op Ic no
|
||||
.Ns Ic deb )
|
||||
.Xc
|
||||
.It Xo Op Ic no
|
||||
.Ns Ic d2
|
||||
.Oo Ic no Oc Ns Ic deb )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic d2
|
||||
.Xc
|
||||
Turn exhaustive debugging mode on.
|
||||
Essentially all fields of every packet are printed.
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic nod2 )
|
||||
.It Ic domain= Ns Ar name
|
||||
.It Ic domain Ns = Ns Ar name
|
||||
Change the default domain name to
|
||||
.Ar name .
|
||||
The default domain name is appended to a lookup request depending on the
|
||||
|
|
@ -300,10 +299,17 @@ command to display the list.
|
|||
.Xr hostname @CMD_EXT@ ,
|
||||
.Pa /etc/resolv.conf ,
|
||||
or
|
||||
.Ev LOCALDOMAIN;
|
||||
.Ev LOCALDOMAIN ;
|
||||
abbreviation =
|
||||
.Ic do )
|
||||
.It Ic srchlist= Ns Ar name1/name2/...
|
||||
.It Xo
|
||||
.Sm off
|
||||
.Ic srchlist No =
|
||||
.Ar name1 No /
|
||||
.Ar name2 No /
|
||||
.Ar ...
|
||||
.Sm on
|
||||
.Xc
|
||||
Change the default domain name to
|
||||
.Ar name1
|
||||
and the domain search list
|
||||
|
|
@ -329,11 +335,11 @@ command to display the list.
|
|||
.Xr hostname @CMD_EXT@ ,
|
||||
.Pa /etc/resolv.conf ,
|
||||
or
|
||||
.Ev LOCALDOMAIN;
|
||||
.Ev LOCALDOMAIN ;
|
||||
abbreviation =
|
||||
.Ic srchl )
|
||||
.It Xo Op Ic no
|
||||
.Ns Ic defname
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic defname
|
||||
.Xc
|
||||
If set, append the default domain name to a single-component lookup request
|
||||
(i.e., one that does not contain a period).
|
||||
|
|
@ -341,11 +347,9 @@ If set, append the default domain name to a single-component lookup request
|
|||
(Default =
|
||||
.Ic defname ;
|
||||
abbreviation =
|
||||
.Xo Op Ic no
|
||||
.Ns Ic defname )
|
||||
.Xc
|
||||
.It Xo Op Ic no
|
||||
.Ns Ic search
|
||||
.Oo Ic no Oc Ns Ic defname )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic search
|
||||
.Xc
|
||||
If the lookup request contains at least one period but
|
||||
.Em doesn't
|
||||
|
|
@ -355,18 +359,16 @@ to the request until an answer is received.
|
|||
(Default =
|
||||
.Ic search ;
|
||||
abbreviation =
|
||||
.Xo Op Ic no
|
||||
.Ns Ic sea )
|
||||
.Xc
|
||||
.It Ic port= Ns Ar value
|
||||
.Oo Ic no Oc Ns Ic sea )
|
||||
.It Ic port Ns = Ns Ar value
|
||||
Change the default TCP/UDP name server port to
|
||||
.Ar value .
|
||||
.Pp
|
||||
(Default = 53;
|
||||
abbreviation =
|
||||
.Ic \&po )
|
||||
.It Ic querytype= Ns Ar value
|
||||
.It Ic type= Ns Ar value
|
||||
.It Ic querytype Ns = Ns Ar value
|
||||
.It Ic type Ns = Ns Ar value
|
||||
Change the type of information query to one of:
|
||||
.Bl -tag -width "HINFO "
|
||||
.It Dv A
|
||||
|
|
@ -397,15 +399,16 @@ the supported well-known services.
|
|||
.El
|
||||
.Pp
|
||||
Other types
|
||||
.Pq Dv ANY, AXFR, MB, MD, MF, NULL
|
||||
.Dv ( ANY , AXFR , MB ,
|
||||
.Dv MD , MF , NULL )
|
||||
are described in the RFC-1035 document.
|
||||
.Pp
|
||||
(Default =
|
||||
.Dv A ;
|
||||
abbreviations =
|
||||
.Ic q , ty )
|
||||
.It Xo Op Ic no
|
||||
.Ns Ic recurse
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic recurse
|
||||
.Xc
|
||||
Tell the name server to query other servers if it does not have the
|
||||
information.
|
||||
|
|
@ -413,10 +416,8 @@ information.
|
|||
(Default =
|
||||
.Ic recurse ;
|
||||
abbreviation =
|
||||
.Xo Op Ic no
|
||||
.Ns Ic rec )
|
||||
.Xc
|
||||
.It Ic retry= Ns Ar number
|
||||
.Oo Ic no Oc Ns Ic rec )
|
||||
.It Ic retry Ns = Ns Ar number
|
||||
Set the number of retries to
|
||||
.Ar number .
|
||||
When a reply to a request is not received within a certain
|
||||
|
|
@ -427,7 +428,7 @@ The retry value controls how many times a request is resent before giving up.
|
|||
.Pp
|
||||
(Default = 4, abbreviation =
|
||||
.Ic ret )
|
||||
.It Ic root= Ns Ar host
|
||||
.It Ic root Ns = Ns Ar host
|
||||
Change the name of the root server to
|
||||
.Ar host .
|
||||
This affects the
|
||||
|
|
@ -438,35 +439,31 @@ command.
|
|||
.Ic ns.internic.net. ;
|
||||
abbreviation =
|
||||
.Ic ro )
|
||||
.It Ic timeout= Ns Ar number
|
||||
.It Ic timeout Ns = Ns Ar number
|
||||
Change the initial timeout interval for waiting for a reply to
|
||||
.Ar number
|
||||
seconds. Each retry doubles the timeout period.
|
||||
.Pp
|
||||
(Default = 5 seconds; abbreviation =
|
||||
.Ic ti )
|
||||
.It Xo Op Ic no
|
||||
.Ns Ic vc
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic vc
|
||||
.Xc
|
||||
Always use a virtual circuit when sending requests to the server.
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic novc ;
|
||||
abbreviation =
|
||||
.Xo Op Ic no
|
||||
.Ns Ic v )
|
||||
.Oo Ic no Oc Ns Ic v )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic ignoretc
|
||||
.Xc
|
||||
.It Xo Op Ic no
|
||||
.Ns Ic ignoretc
|
||||
.Xc
|
||||
Ignore packet truncation errors.
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic noignoretc ;
|
||||
abbreviation =
|
||||
.Xo Op Ic no
|
||||
.Ns Ic ig )
|
||||
.Xc
|
||||
.Oo Ic no Oc Ns Ic ig )
|
||||
.El
|
||||
.El
|
||||
.Sh DIAGNOSTICS
|
||||
|
|
@ -476,9 +473,11 @@ Possible errors are:
|
|||
.It Li Timed out
|
||||
The server did not respond to a request after a certain amount of
|
||||
time (changed with
|
||||
.Dq Ic set timeout= Ns Ar value )
|
||||
.Dq Ic set timeout Ns = Ns Ar value )
|
||||
and a certain number of retries (changed with
|
||||
.Dq Ic set retry= Ns Ar value ) .
|
||||
.Do
|
||||
.Ic set retry Ns = Ns Ar value
|
||||
.Dc ) .
|
||||
.It Li \&No response from server
|
||||
No name server is running on the server machine.
|
||||
.It Li \&No records
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $Id: nsupdate.8,v 8.6 2000/10/30 23:06:57 cyarnell Exp $
|
||||
.\" $Id: nsupdate.8,v 8.8 2002/04/22 04:38:04 marka Exp $
|
||||
.\"
|
||||
.\"Copyright (c) 1999 by Internet Software Consortium
|
||||
.\"
|
||||
|
|
@ -22,9 +22,9 @@
|
|||
.Nd update Internet name servers interactively
|
||||
.Sh SYNOPSIS
|
||||
.Nm nsupdate
|
||||
.Op Fl Ar k keydir:keyname
|
||||
.Op Fl Ar d
|
||||
.Op Fl Ar v
|
||||
.Op Fl k Ar keydir:keyname
|
||||
.Op Fl d
|
||||
.Op Fl v
|
||||
.Op Ar filename
|
||||
.Sh DESCRIPTION
|
||||
.Ic Nsupdate
|
||||
|
|
@ -81,18 +81,14 @@ will be performed.
|
|||
.Ic Nsupdate
|
||||
understands the following input record formats:
|
||||
.Pp
|
||||
|
||||
.Bl -hang
|
||||
|
||||
.It Ic prereq nxdomain Va domain-name
|
||||
Requires that no RR of any type exists with name
|
||||
.Va domain-name .
|
||||
|
||||
.It Ic prereq yxdomain Va domain-name
|
||||
Requires that at least one RR named
|
||||
.Va domain-name
|
||||
must exist.
|
||||
|
||||
.It Xo
|
||||
.Ic prereq nxrrset Va domain-name Op class
|
||||
.Va type
|
||||
|
|
@ -101,11 +97,10 @@ Requires that no RR exists of the specified
|
|||
.Va type
|
||||
and
|
||||
.Va domain-name .
|
||||
|
||||
.It Xo
|
||||
.Ic prereq yxrrset
|
||||
.Va domain-name Op class
|
||||
.Va type Op data...
|
||||
.Va domain-name Op Va class
|
||||
.Va type Op Va data...
|
||||
.Xc
|
||||
Requires that a RR exists of the specified
|
||||
.Va type
|
||||
|
|
@ -114,11 +109,10 @@ and
|
|||
If
|
||||
.Va data
|
||||
is specified, it must match exactly.
|
||||
|
||||
.It Xo
|
||||
.Ic update delete
|
||||
.Va domain-name Op class
|
||||
.Va Op type Op data...
|
||||
.Va domain-name Op Va class
|
||||
.Op Va type Op Va data...
|
||||
.Xc
|
||||
Deletes RRs named
|
||||
.Va domain-name .
|
||||
|
|
@ -128,19 +122,16 @@ If
|
|||
.Va data )
|
||||
is specified,
|
||||
only matching records will be deleted.
|
||||
|
||||
.It Xo
|
||||
.Ic update add
|
||||
.Va domain-name ttl Op class
|
||||
.Va domain-name ttl Op Va class
|
||||
.Va type data...
|
||||
.Xc
|
||||
Adds a new RR with specified
|
||||
.Va ttl , type ,
|
||||
and
|
||||
.Va data .
|
||||
|
||||
.El
|
||||
|
||||
.Sh EXAMPLES
|
||||
The following example illustrates the interactive use of
|
||||
.Ic nsupdate
|
||||
|
|
@ -156,7 +147,6 @@ $ nsupdate
|
|||
> update delete test.example.com A
|
||||
> update add test.example.com 3600 A 10.1.1.1
|
||||
>
|
||||
|
||||
.Ed
|
||||
.Pp
|
||||
In this example, a CNAME alias is added to the database
|
||||
|
|
@ -168,7 +158,6 @@ $ nsupdate
|
|||
> prereq nxrrset www.example.com CNAME
|
||||
> update add www.example.com 3600 CNAME test.example.com
|
||||
>
|
||||
|
||||
.Ed
|
||||
.Pp
|
||||
In this example, the nsupdate will be signed with the key "mykey", which
|
||||
|
|
@ -177,20 +166,15 @@ is in the directory "/var/named/keys".
|
|||
$ nsupdate -k /var/named/keys:mykey
|
||||
> update add ftp.example.com 60 A 192.168.5.1
|
||||
>
|
||||
|
||||
.Ed
|
||||
|
||||
.Sh DIAGNOSTICS
|
||||
.Bl -hang
|
||||
|
||||
.It Qq send error
|
||||
Typically indicates that the authoritative nameservers could not be reached
|
||||
|
||||
.It Qq failed update packet
|
||||
Typically indicates that the nameserver has rejected the update,
|
||||
either because the nameserver doesn't support dynamic update,
|
||||
or due to an authentication failure
|
||||
|
||||
.It Qq res_mkupdate: packet size = Va size
|
||||
(and no other messages)
|
||||
The update was successfully received and authenticated by the nameserver.
|
||||
|
|
@ -203,8 +187,8 @@ and examine the status field in the nameserver's reply.
|
|||
.Sh FILES
|
||||
.Bl -hang
|
||||
.It Pa /etc/resolv.conf
|
||||
.El
|
||||
initial domain name and name server addresses
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr @INDOT@named @SYS_OPS_EXT@ ,
|
||||
.Xr resolver @LIB_NETWORK_EXT@ ,
|
||||
|
|
|
|||
|
|
@ -16,7 +16,7 @@
|
|||
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
.\"
|
||||
.\" @(#)resolver.3 6.5 (Berkeley) 6/23/90
|
||||
.\" $Id: resolver.3,v 8.13 2000/12/05 02:37:33 vixie Exp $
|
||||
.\" $Id: resolver.3,v 8.16 2001/12/28 04:24:20 marka Exp $
|
||||
.\"
|
||||
.Dd July 4, 2000
|
||||
.Dt RESOLVER @LIB_NETWORK_EXT_U@
|
||||
|
|
@ -59,7 +59,7 @@
|
|||
.Fd #include <netinet/in.h>
|
||||
.Fd #include <arpa/nameser.h>
|
||||
.Fd #include <resolv.h>
|
||||
.Ft typedef struct __res_state *res_state;
|
||||
.Vt typedef struct __res_state *res_state ;
|
||||
.Pp
|
||||
.Fn res_ninit "res_state statp"
|
||||
.Fn res_ourserver_p "const res_state statp" "const struct sockaddr_in *addr"
|
||||
|
|
@ -69,18 +69,28 @@
|
|||
.Fn res_nquery "res_state statp" "const char *dname" "int class" "int type" "u_char *answer" "int anslen"
|
||||
.Fn res_nsearch "res_state statp" "const char *dname" "int class" "int type" "u_char * answer" "int anslen"
|
||||
.Fn res_nquerydomain "res_state statp" "const char *name" "const char *domain" "int class" "int type" "u_char *answer" "int anslen"
|
||||
.Fn res_nmkquery "res_state statp, int op, const char *dname" "int class" "int type" "const u_char *data" "int datalen" "const u_char *newrr" "u_char *buf" "int buflen"
|
||||
.Fo res_nmkquery
|
||||
.Fa "res_state statp"
|
||||
.Fa "int op"
|
||||
.Fa "const char *dname"
|
||||
.Fa "int class"
|
||||
.Fa "int type"
|
||||
.Fa "const u_char *data"
|
||||
.Fa "int datalen"
|
||||
.Fa "const u_char *newrr"
|
||||
.Fa "u_char *buf"
|
||||
.Fa "int buflen"
|
||||
.Fc
|
||||
.Fn res_nsend "res_state statp" "const u_char *msg" "int msglen" "u_char *answer" "int anslen"
|
||||
.Fn res_nupdate "res_state statp" "ns_updrec *rrecp_in"
|
||||
.Fn res_nmkupdate "res_state statp" "ns_updrec *rrecp_in" "u_char *buf" "int buflen"
|
||||
.Fn res_nclose "res_state statp"
|
||||
.Fn res_nsendsigned "res_state statp" "const u_char *msg" "int msglen" "ns_tsig_key *key" "u_char *answer" "int anslen"
|
||||
.Fn res_findzonecut "res_state statp" "const char *dname" "ns_class class" "int options" "char *zname" "size_t zsize" "struct in_addr *addrs" "int naddrs"
|
||||
.Fn dn_comp "const char *exp_dn" "u_char *comp_dn" "int length" "u_char **dnptrs, **lastdnptr"
|
||||
.Fn dn_expand "const u_char *msg, *eomorig, *comp_dn" "char *exp_dn" "int length"
|
||||
.Fn dn_comp "const char *exp_dn" "u_char *comp_dn" "int length" "u_char **dnptrs" "u_char **lastdnptr"
|
||||
.Fn dn_expand "const u_char *msg" "const u_char *eomorig" "const u_char *comp_dn" "char *exp_dn" "int length"
|
||||
.Fn hstrerror "int err"
|
||||
.Sh DEPRECATED
|
||||
.nr nS 1
|
||||
.Ss DEPRECATED
|
||||
.Fd #include <sys/types.h>
|
||||
.Fd #include <netinet/in.h>
|
||||
.Fd #include <arpa/nameser.h>
|
||||
|
|
@ -90,10 +100,20 @@
|
|||
.Fn fp_nquery "const u_char *msg" "int msglen" "FILE *fp"
|
||||
.Fn p_query "const u_char *msg" "FILE *fp"
|
||||
.Fn hostalias "const char *name"
|
||||
.Fn res_query "const char *dname" "int class, type" "u_char *answer" "int anslen"
|
||||
.Fn res_search "const char *dname" "int class, type" "u_char *answer" "int anslen"
|
||||
.Fn res_query "const char *dname" "int class" "int type" "u_char *answer" "int anslen"
|
||||
.Fn res_search "const char *dname" "int class" "int type" "u_char *answer" "int anslen"
|
||||
.Fn res_querydomain "const char *name" "const char *domain" "int class" "int type" "u_char *answer" "int anslen"
|
||||
.Fn res_mkquery "int op" "const char *dname, int class, type" "const char *data" "int datalen" "struct rrec *newrr" "u_char *buf" "int buflen"
|
||||
.Fo res_mkquery
|
||||
.Fa "int op"
|
||||
.Fa "const char *dname"
|
||||
.Fa "int class"
|
||||
.Fa "int type"
|
||||
.Fa "const char *data"
|
||||
.Fa "int datalen"
|
||||
.Fa "struct rrec *newrr"
|
||||
.Fa "u_char *buf"
|
||||
.Fa "int buflen"
|
||||
.Fc
|
||||
.Fn res_send "const u_char *msg" "int msglen" "u_char *answer" "int anslen"
|
||||
.Fn res_update "ns_updrec *rrecp_in"
|
||||
.Fn res_close "void"
|
||||
|
|
@ -163,7 +183,7 @@ has been called).
|
|||
Print debugging messages.
|
||||
.It Dv RES_AAONLY
|
||||
Accept authoritative answers only.
|
||||
should continue until it finds an authoritative answer or finds an error.
|
||||
Should continue until it finds an authoritative answer or finds an error.
|
||||
Currently this is not implemented.
|
||||
.It Dv RES_USEVC
|
||||
Use TCP connections for queries instead of UDP datagrams.
|
||||
|
|
@ -226,6 +246,18 @@ This option causes
|
|||
.Fn res_nsendsigned
|
||||
to leave the message unchanged after TSIG verification; otherwise the TSIG
|
||||
record would be removed and the header updated.
|
||||
.It Dv RES_NOTLDQUERY
|
||||
This option causes
|
||||
.Fn res_nsearch
|
||||
to not attempt to resolve a unqualified name as if it were a top level
|
||||
domain (TLD).
|
||||
This option can cause problems if the site has "localhost" as a TLD rather
|
||||
than having localhost on one or more elements of the search list.
|
||||
This option has no effect if neither
|
||||
.Dv RES_DEFNAMES
|
||||
or
|
||||
.Dv RES_DNSRCH
|
||||
is set.
|
||||
.El
|
||||
.Pp
|
||||
The
|
||||
|
|
@ -409,7 +441,8 @@ The functions
|
|||
/
|
||||
.Fn hostalias
|
||||
lookup up name in the file referred to by the
|
||||
.Ev HOSTALIASES files return a fully qualified hostname if found or NULL if
|
||||
.Ev HOSTALIASES
|
||||
files return a fully qualified hostname if found or NULL if
|
||||
not found or an error occurred.
|
||||
.Fn res_hostalias
|
||||
uses
|
||||
|
|
@ -559,7 +592,7 @@ value of the
|
|||
parameter.
|
||||
.Sh FILES
|
||||
.Bl -tag -width "/etc/resolv.conf "
|
||||
.It Pa /etc/resolv.conf
|
||||
.It Pa /etc/resolv.conf
|
||||
See
|
||||
.Xr resolver @FORMAT_EXT@ .
|
||||
.El
|
||||
|
|
|
|||
|
|
@ -14,7 +14,7 @@
|
|||
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
.\"
|
||||
.\" @(#)resolver.5 5.9 (Berkeley) 12/14/89
|
||||
.\" $Id: resolver.5,v 8.6 1999/05/21 00:01:02 vixie Exp $
|
||||
.\" $Id: resolver.5,v 8.9 2001/12/28 04:24:21 marka Exp $
|
||||
.\"
|
||||
.Dd November 11, 1993
|
||||
.Dt RESOLVER @FORMAT_EXT_U@
|
||||
|
|
@ -146,14 +146,14 @@ name server before retrying the query via a different name server. Measured in
|
|||
seconds, the default is
|
||||
.Dv RES_TIMEOUT
|
||||
(see
|
||||
.Pa <resolv.h> ).
|
||||
.Pa <resolv.h> ) .
|
||||
.It Li attempts: Ns Ar n
|
||||
sets the number of times the resolver will send a query to its name servers
|
||||
before giving up and returning an error to the calling application. The
|
||||
default is
|
||||
.Dv RES_DFLRETRY
|
||||
(see
|
||||
.Pa <resolv.h> ).
|
||||
.Pa <resolv.h> ) .
|
||||
.It Li rotate
|
||||
sets
|
||||
.Dv RES_ROTATE
|
||||
|
|
@ -178,6 +178,22 @@ This has the effect of trying a AAAA query before an A query inside the
|
|||
.Ft gethostbyname
|
||||
function, and of mapping IPv4 responses in IPv6 ``tunnelled form'' if no
|
||||
AAAA records are found but an A record set exists.
|
||||
.It Li no-tld-query
|
||||
sets
|
||||
.Dv RES_NOTLDQUERY
|
||||
in
|
||||
.Ft _res.options .
|
||||
This option causes
|
||||
.Fn res_nsearch
|
||||
to not attempt to resolve a unqualified name as if it were a top level
|
||||
domain (TLD).
|
||||
This option can cause problems if the site has "localhost" as a TLD rather
|
||||
than having localhost on one or more elements of the search list.
|
||||
This option has no effect if neither
|
||||
.Dv RES_DEFNAMES
|
||||
or
|
||||
.Dv RES_DNSRCH
|
||||
is set.
|
||||
.El
|
||||
.El
|
||||
.Pp
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $Id: tsig.3,v 8.2 1999/01/08 18:54:28 vixie Exp $
|
||||
.\" $Id: tsig.3,v 8.3 2001/08/08 07:50:19 marka Exp $
|
||||
.\"
|
||||
.\"Copyright (c) 1995-1999 by Internet Software Consortium
|
||||
.\"
|
||||
|
|
@ -80,7 +80,7 @@ and
|
|||
.Fn ns_verify_tcp
|
||||
are used to sign/verify TCP messages that may be split into multiple packets,
|
||||
such as zone transfers, and
|
||||
.Fn ns_sign_tcp_init,
|
||||
.Fn ns_sign_tcp_init ,
|
||||
.Fn ns_verify_tcp_init
|
||||
initialize the state structure necessary for TCP operations.
|
||||
.Fn ns_find_tsig
|
||||
|
|
|
|||
Loading…
Reference in a new issue