[src/netbsd-1-4]: src/dist/bind/man Pull up revisions 1.1-1.2 (new) (requeste...

[he <he%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/7f9820bf0bc5
branches:  netbsd-1-4
changeset: 469812:7f9820bf0bc5
user:      he <he%NetBSD.org@localhost>
date:      Sat Dec 04 17:10:16 1999 +0000

description:
Pull up revisions 1.1-1.2 (new) (requested by christos and veego):
  Update to BIND 8.2.2-P5.

diffstat:

 dist/bind/man/named.8      |   444 ++++++++
 dist/bind/man/named.conf.5 |  2358 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 2802 insertions(+), 0 deletions(-)

diffs (truncated from 2810 to 300 lines):

diff -r c492a95a8988 -r 7f9820bf0bc5 dist/bind/man/named.8
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/dist/bind/man/named.8     Sat Dec 04 17:10:16 1999 +0000
@@ -0,0 +1,444 @@
+.\"     $NetBSD: named.8,v 1.2.2.2 1999/12/04 17:10:16 he Exp $
+.\"
+.\" ++Copyright++ 1985, 1996
+.\" -
+.\" Copyright (c) 1985, 1996
+.\"    The Regents of the University of California.  All rights reserved.
+.\" 
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\" 
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\" -
+.\" Portions Copyright (c) 1993 by Digital Equipment Corporation.
+.\" 
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies, and that
+.\" the name of Digital Equipment Corporation not be used in advertising or
+.\" publicity pertaining to distribution of the document or software without
+.\" specific, written prior permission.
+.\" 
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
+.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS.   IN NO EVENT SHALL DIGITAL EQUIPMENT
+.\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
+.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
+.\" 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.
+.\" -
+.\" --Copyright--
+.\"
+.\"    @(#)named.8     6.6 (Berkeley) 2/14/89
+.\"
+.Dd February 1, 1996
+.Dt NAMED 8 
+.Os BSD 4
+.Sh NAME
+.Nm named 
+.Nd Internet domain name server (DNS)
+.Sh SYNOPSIS
+.Nm NAMED
+.Op Fl d Ar debuglevel
+.Op Fl p Ar port# 
+.Oo Fl Po 
+.Cm b Ns \&| Ns Cm c
+.Pc
+.Ar config_file
+.Oc
+.Op Fl f q r v
+.Op Fl u Ar user_name
+.Op Fl g Ar group_name
+.Op Fl t Ar directory
+.Op Fl w Ar directory
+.Op Ar config_file
+.Sh DESCRIPTION
+.Ic Named
+is the Internet domain name server.
+See RFC's 1033, 1034, and 1035 for more information on the Internet
+name-domain system.  Without any arguments,
+.Ic named
+will read the default configuration file
+.Pa /etc/named.conf ,
+read any initial data, and listen for queries.  A 
+.Ar config_file
+argument given at the end of the command line will override any
+.Ar config_file
+specified by using the
+.Dq Fl b
+or
+.Dq Fl c
+flags.
+.Pp
+.Sy NOTE:
+Several of 
+.Nm named Ns 's
+options, and much more of its behaviour, can be controlled in the configuration 
+file.  Please refer to the configuration file guide included with this 
+.Sy BIND
+distribution for further information.
+.Pp
+Options are:
+.Bl -tag -width Fl
+.It Fl d Ar debuglevel
+Print debugging information.
+The 
+.Ar debuglevel 
+is a number determines the level of messages printed.  If negative,
+.Ar debuglevel
+is set to 
+.Dq 1 .
+.Pp
+.Sy NOTE:
+The new debugging framework is considerably more sophisticated than it
+was in older versions of 
+.Nm NAMED .
+The configuration file's
+.Dq Li logging
+statement allows for multiple, distinct levels of debugging for each of
+a large set of categories of events (such as queries, transfers in or out,
+etc.).  Please refer to the configuration file guide included with this 
+.Sy BIND
+distribution for further information about these extensive new capabilities.
+.It Fl p Ar port#
+Use the specified remote port number; this is the port number to which 
+.Nm NAMED
+will send queries.  The default value is the standard port number, i.e.,
+the port number returned by 
+.Xr getservbyname 3 
+for service 
+.Dq Li domain .
+.Pp
+.Sy NOTE:
+Previously, the syntax
+.Dq Fl p Ar port# Ns Op Ar \&/localport#
+was supported; the first port was that used when contacting 
+.Em remote 
+servers, and the second one was the service port bound by the 
+.Em local 
+instance of
+.Nm NAMED .
+The current usage is equivalent to the old usage without the 
+.Ar localport#
+specified; this functionality can be specified with the 
+.Dq Li listen-on
+clause of the configuration file's
+.Dq Li options
+statement.
+.It Xo Fl Po 
+.Cm b Ns \&| Ns Cm c
+.Pc Ar config_file
+.Xc
+Use an alternate 
+.Ar config_file ;
+this argument is overridden by any 
+.Ar config_file
+which is specified at the end of the command line.
+The default value is
+.Pa /etc/named.conf .
+.It Fl f
+Run this process in the foreground; don't 
+.Xr fork 2
+and daemonize.  (The default is to daemonize.)
+.It Fl q
+Trace all incoming queries if 
+.Nm NAMED 
+has been compiled with
+.Li QRYLOG 
+defined.  
+.Pp
+.Sy NOTE: 
+This option is deprecated in favor of the
+.Dq Li queries
+.Em logging category 
+of the configuration file's
+.Dq Li logging 
+statement; for more information, please refer to the configuration file guide 
+included with this distribution of 
+.Sy BIND .
+.It Fl r
+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: 
+This option can be overridden by and is deprecated in favor of the
+.Dq Li recursion 
+clause of the configuration file's
+.Dq Li options
+statement.
+.It Fl v
+Report the version and exit. 
+.It Fl u Ar user_name
+Specifies the user the server should run as after it initializes.  The value
+specified may be either a username or a numeric user id.  If the
+.Dq Fl g
+flag is not specified, then the group id used will be the primary group of
+the user specified (initgroups() is called, so all of the user's groups will
+be available to the server).
+.Pp
+.It Fl g Ar group_name
+Specifies the group the server should run as after it initializes.  The value
+specified may be either a groupname or a numeric group id.
+.Pp
+.It Fl t Ar directory
+Specifies the directory the server should chroot() into as soon as it is
+finshed processing command line arguments.
+.Pp
+.It Fl w Ar directory
+Sets the working directory of the server.  The
+.Dq Li directory 
+clause of the configuration file's
+.Dq Li options
+statement overrides any value specified on the command line.
+The default working directory is the current directory
+.Pq Dq \&. .
+.El
+.Pp
+Any additional argument is taken as the name of the configuration file, for
+compatibility with older implementations; as noted above, this argument
+overrides any
+.Ar config_file
+specified by the use of the
+.Dq Fl b
+or 
+.Dq Fl c
+flags.  If no further argument is given, then the default configuration file
+is used
+.Pq Pa /etc/named.conf .
+.Ss Master File Format
+The master file consists of control information and a list of resource
+records for objects in the zone of the forms:
+.Bd -literal -offset indent
+$INCLUDE <filename> <opt_domain>
+$ORIGIN <domain>
+$TTL <ttl>
+<domain> <opt_ttl> <opt_class> <type> <resource_record_data>
+.Ed
+.Pp
+where:
+.Bl -tag -width "opt_domain  " 
+.It Ar domain
+is 
+.Dq Li \&. 
+for root, 
+.Dq Li @ 
+for the current origin, or a standard domain name. If
+.Ar domain
+is a standard domain name that does 
+.Em not 
+end with 
+.Dq Li \&. , 
+the current origin is appended to the domain. Domain names ending with 
+.Dq Li \&.
+are unmodified.
+.It Ar opt_domain
+This field is used to define an origin for the data in an included file.
+It is equivalent to placing an 
+.Li $ORIGIN 
+statement before the first line of the included file.  The field is optional.
+Neither the 
+.Ar opt_domain
+field nor 
+.Li $ORIGIN 
+statements in the included file modify the current origin for this file.
+.It Ar ttl
+A integer number that sets the default time-to-live for future records without
+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
+warning is generated.
+.It Ar opt_class
+The object address type; currently only one type is supported,
+.Dv IN ,
+for objects connected to the DARPA Internet. 
+.It Ar type
+This field contains one of the following tokens; the data expected in the
+.Ar resource_record_data
+field is in parentheses:
+.Bl -tag -width "HINFO    "  -offset indent
+.It Dv A
+a host address (dotted-quad IP address)
+.It Dv NS
+an authoritative name server (domain)
+.It Dv MX
+a mail exchanger (domain), preceded by a preference value (0..32767),
+with lower numeric values representing higher logical preferences.
+.It Dv CNAME
+the canonical name for an alias (domain)
+.It Dv SOA
+marks the start of a zone of authority (domain of originating host,