d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

This commit was generated by cvs2svn to compensate for changes in r96539,

Browse Source 
which included commits to RCS files with non-trunk default branches.
This commit is contained in:
Jacques Vidrine 2002-05-13 19:33:58 +00:00
commit 733fb0d8d3
25 changed files with 360 additions and 549 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
contrib/bind/doc/html/docdef.html
View File

@ -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>

6
contrib/bind/doc/html/logging.html
View File

@ -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>

49
contrib/bind/doc/html/options.html
View File

@ -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>

6
contrib/bind/doc/html/server.html
View File

@ -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>

6
contrib/bind/doc/html/zone.html
View File

@ -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>

30
contrib/bind/doc/man/dnskeygen.1
View File

@ -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

28
contrib/bind/doc/man/dnsquery.1
View File

@ -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

11
contrib/bind/doc/man/getaddrinfo.3
View File

@ -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.

22
contrib/bind/doc/man/gethostbyname.3
View File

@ -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

14
contrib/bind/doc/man/getipnodebyname.3
View File

@ -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

4
contrib/bind/doc/man/getnameinfo.3
View File

@ -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).

11
contrib/bind/doc/man/getnetent.3
View File

@ -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

9
contrib/bind/doc/man/hostname.7
View File

@ -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@ ,

10
contrib/bind/doc/man/inet_cidr.3
View File

@ -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.

2
contrib/bind/doc/man/mailaddr.7
View File

@ -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>

6
contrib/bind/doc/man/mkdep.1
View File

@ -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

1
contrib/bind/doc/man/named-bootconf.8
View File

@ -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

6
contrib/bind/doc/man/named-xfer.8
View File

@ -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.

29
contrib/bind/doc/man/named.8
View File

@ -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

530
contrib/bind/doc/man/named.conf.5
View File

File diff suppressed because it is too large Load Diff

4
contrib/bind/doc/man/ndc.8
View File

@ -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)

36
contrib/bind/doc/man/nsupdate.8
View File

@ -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@ ,

59
contrib/bind/doc/man/resolver.3
View File

@ -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

22
contrib/bind/doc/man/resolver.5
View File

@ -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

4
contrib/bind/doc/man/tsig.3
View File

@ -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