
/*
** Distributed with 'doc' Version 2.2.2 from <Brad Knowles> 20010514
*/

UPDATED RELEASE: 2.2.2 (2001/05/14)

Merged changes from previous private-only version of doc 2.1.5 into
the 2.2.1 version I received from Jim Griffin.

=====================================================

UPDATED RELEASE: 2.2.1 (20010330)

Updated contact information.  Modified 'doc' shell script and 
supporting awk programs to accommodate changes in command line
options (+pfset) and reply format (SOA) introduced with BIND 9.+.
Corrected list of DiG error status returns and modified 'diff'
commands to ignore changes in amount of white space, blank lines,
or case.

=====================================================

UPDATED RELEASE: 2.1.5 (2001/05/13)

There have been a couple of updates since this file was last
modified.  This script has now been modified to work with the "dig"
utility that comes with BIND version 8, as opposed to the version
of "dig" that came with BIND 4 (primarily just changing some
arguments that are used/recognized).

In addition, I've updated references to addresses and dates, and
I've added a feature whereby we check to see if any of the nameservers
we encounter support the "version.bind" record (new with BIND 8),
and if so we log the contents of their response to our query.

This is likely to be the last release of doc for BIND 8, as BIND
9 has been out a while, and we need to modify the code yet once
again, because the arguments to dig have changed yet once again.
So far, all efforts to produce a unified version of doc that can
deal with any version of dig have failed.

=====================================================

UPDATED RELEASE: 2.1.2 (7/12/95)

Updated all references to employers and email addresses, resulting
from a recent change in employment.  Verified that recent code changes
in the way BIND 4.9.3-BETA20 (up to 4.9.3-BETA24) reports certain
information does not break doc.

=====================================================

UPDATED RELEASE: 2.1.1 (5/27/95)

Added code to handle more robustly parent (delegating) domains that
are not one level up from the domain being tested.

Added code to force entire domain string to be all lower case, since
the DNS is not case-sensitive (and keeping the case caused some
comparisons to fail).

=====================================================

UPDATED RELEASE: 2.1 (2/16/95)

Took over maintenance of DOC from previous authors.

Added code to do the equivalent of a "sort | uniq" on the NS records
returned by dig.  Otherwise, the ADDAUTH option of recent versions of
BIND could return a set of nameservers in the DATA section as well as
the AUTHORITY section, and unnecessary checking would be performed.

=====================================================

UPDATED RELEASE: 2.0.1 (9/12/90)

Includes fixes for two portability bugs:

  1) On some systems (e.g. SunOS 4.1), the shell exit code is an unsigned
     8 bit value.  This differs from the development environment where
     negative values were also returned.  This affected values
     returned by auxiliary files: doc1.awk & doc3.awk.

  2) Some shells did not handle things like "@ cnt2++ " correctly.
     Variable names were changed where appropriate.

=====================================================

Greetings,

This is a the second public release of Doc - Version 2.1.
Doc (domain obscenity control) is a program which diagnoses
misbehaving domains by sending queries off to the appropriate
DNS nameservers, and performing simple analysis on the responses.

IMPORTANT: Doc requires version 2.0 of the DNS query tool `dig`
           (domain internet groper).

Files contained in this distribution:

README       - You're looking at it.
INFO         - Documents current procedure
doc.8        - man page
doc.txt      - ASCII man page
doc          - Shell script for automated domain test
doc1.awk     - simple awk file used by `doc`
doc3.awk     - simple awk file used by `doc`
doc4.awk     - simple awk file used by `doc`
RFC.XXXX     - Draft of RFC about Automated Domain testing
log.isi.edu. - Sample run for isi.edu. domain


Required files NOT in the distribution:

Dig (Version 2.0) - DNS query program required to run `doc`
                    Available via anonymous ftp from:
                    venera.isi.edu.  pub/dig.2.0.tar.Z


SETUP/CONFIGURATION

'Doc' is a csh script, so no complex porting effort will be required.
Other than the first few aliases and pointers to directories that you
will edit in the 'doc' shell file itself, no changes should be necessary.


Doc-V.2.1 is an initial implementation of an automated domain testing
tool.  We expect considerable design modification and implementation
changes to be made as experience is gained through use in the
Internet.  At some point, we expect the design to stabilize and a
production version, implemented in something other than the current
UNIX-tool patchwork, to be released.

Comments and discussion are very much welcome.

Brad Knowles (BKnowles@aol.net)
