Forwarded: Mon, 23 Jun 1997 20:22:08 -0700
Forwarded: "halley "
Received: from seiden.com (seiden.com [207.88.176.68]) 
	by gw.home.vix.com (8.8.4/) via SMTP id OAA28822
        for <bind-bugs@vix.com>; Sat, 14 Jun 1997 14:18:00 -0700
        env-from (mis@seiden.com)
Received: by seiden.com (4.1/1.39)
	id AA12966; Sat, 14 Jun 97 14:17:57 PDT
From: mis@seiden.com (Mark Seiden)
Message-Id: <9706142117.AA12966@seiden.com>
Subject: revised contrib/CATALOGUE
To: bind-bugs@vix.com
Date: Sat, 14 Jun 1997 14:17:56 -0700 (PDT)
X-Mailer: ELM [version 2.4ME+ PL25 (25)]
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

greetings.

i finally got upset with the contrib hierarchy, and catalogued it.

what do you think about moving a lot of the ancient 4.x-specific stuff
to old?

what do you think about providing some opinions on what's useful,
what's merely redundant, and what's totally obsolete?  (i mean, it's
hard to distinguish at this point between the n tools for flat-file to
zone data conversion.)

what do you think about a functional index?  categories like
debugging
administration


here's what i've got, so far:


This directory is full of tools and examples that various individual
contributors have sent in.  Most of them are actually in live production
use somewhere, though they are not of "publication" quality (which is 
why they are here instead of in comp.sources.unix).  Most of them are
not documented other than with comments in the sources.  All of them
are fairly clever.

Use at your own risk.  Neither the U C Regents or Digital Equipment
Corporation asserts compilation copyright on any of the works in this
directory; copyright, if any, rests with the contributors whose names appear
in the source files.  No warranty is expressed or implied by the U C
Regents or Digital Equipment Corporation.  Void where prohibited by law.
Contents may have settled during shipping.

------------------------------------------------------------------------------
The following is a short description of the items contained in contrib/
------------------------------------------------------------------------------
arlib
	Library routines for doing asynchronous DNS lookups, from Darren Reed.

ckdns
	cron script to check some details about domains 
	listed as primary or secondary in named.boot, and notify about 
	anomalies. From Jim Knutson.

decwrl/
	mkdb.pl
	     builds .data and .zone files from a hosts(5) file.
	gethost.c
	hup-named.c
	mkservers.pl
	*.data 
	     Actual running files in the pa.dec.com domain (as of 
	     April, 1993, that is), so in pre-bind 8.1 format.

dnsparse/
	Some tools (dnsparse) for manipulating Domain Name System
	master files, and for converting to /etc/hosts format (dns2host).  
	Also tools (simphosts, sorthosts) for dealing with host tables.
	From Marion Hakanson.

dnswalk
	dnswalk is a DNS debugger.  It performs zone transfers of specified
	domains, and checks the database in numerous ways for internal
	consistency, as well as accuracy.  From David Barr.

doc
	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.
	From Brad Knowles.

getkeyby
	A library routine, getkeybyname(), which permits cryptographic
	keys to be obtained from DNSm from wherever people have
	published them.  From John Gilmore.

host
	query nameserver about domain names and zones.
	From Eric Wassenaar.

hostmaint
	ndrev.c
	   takes a forward map, and creates PTR records based on the A records.
	   From Douglas E. Nelson.
	bunch of undocumented, nonportable awk scripts, and a driver Makefile 
	which ftps or rdists .txt files, awks them, builds other text files.

inaddrtool
	A tool usable to read email messages containing RIPE-105 database
	objects to test or change in-addr.arpa delegations. 
	From David Kessens.

lamers
	A lame delegation notifier. From Kimmo Suominen.

misc/
	bstat
	  bind statistics display tool. From Paul Albitz.

	cachebuild
 	  Builds a new root cache file for you, by querying any 
	  root name server it can still talk to. From Paul Balyoz.

	checkdns
	  A script to check forward/reverse mapping consistency.
	  From Hans van Staveren.

	checker 
	A pointer to code, at ftp://caldera.usc.edu/pub/checker
	The Checker Project is an attempt to build onto named the ability to 
	scan the incoming query traffic looking for client machines having
	problems getting their requests satisfied.  C code builds a database 
	from the nameserver query and response traffic.  Whenever a query 
	or response is passed through the checker code its timing and 
	response code is checked against some historical parameters 
	to see if the client's activity falls within some behavioral 
	patterns previously identified with some broken resolver 
	or nameserver implementations.  Reports include such things as: 
	activity summary, client address sorted by number of different 
	queries, query name sorted by number of requests, and client 
	addresses that have had behaviors that fall within the predefined 
	patterns. From Stephen B. Miller, Peter Danzig and Anant Kumar.
	
	checksoa.pl
	  check SOA serial numbers given a local(?) named.boot file.

	comparezones
	  This script compares the contents of two zone files, excluding the
	  second line (serial) and all comments. From Philip Hazel.
	
	ctldns
	  a shell script to control server functions by sending the
          signals whose names you don't want to remember. Similar function
	  to ndc. From Randy Bush.

	ddt
	  a pointer to "domain debug tools".

	dns-peers
	  a pointer to tools which facilitates agreements between providers 
	  to serve lists of zones managed by each primary provider.

	dns-setup.doc
	  a 1993 description of how to set up a primary domain server.

	dnsfind
	  a perl routine (frontend to dig) akin to perl's find -- it calls
	  a user-supplied dnswanted routine with values from all DNS
	  resource records set into global variables. From Tim Cook.

	dnsrpt
	   reports on hosts by name and address in a format like hosts(5).
	   checks that A and PTR records match. From Don Lewis.

	dnstools
	   Build and distribute all zone data and /etc/hosts based 
	   on a single input file. From Eric Murray.

	getcidrzone 
	   generate zone and include files for classless in-addr delegation.
	   From Mathias Koerber.
	
	graphstats
	   awk and sed frontends to xgraph to analyze syslog XSTATS statistics.
	   From Nigel Campbell.

	hostent
	   Displays the hostent structure for a given hostname or ip address.
	   From Phil Blanchfield.

	makezones
	   Script to checks forward zone data, generate inverse data.
	   From Philip Hazel.

	ndrev
	   takes a forward map, and creates PTR records based on the A records.
	   From Douglas E. Nelson.

	netbsd-shlib
	   makefile diffs for building shared libraries for BIND 4.9.3
	   on SunOS 4.x and NetBSD 1.x.  (obsolete?)

	nscount
	   asks a server for NS records	and counts them. From Paolo Bevilacqua.

	reload
	   Similar function as ctldns (q.v.) and ndc.  From Mark Andrews.

	resparse
	   pointer to c routines to parse the results of a 
	   res_query/res_search call.  From Dave Shield.

	settransfer*
	   various diffs to bind 4.9.x to implement "transfer".

	soa-easy
	   a tool for automatic generation of SOA serial numbers based
	   on RCS headers.  From Tim Cook.

	update-rootcache
	    see cachebuild.  From Fred Condo.

	update-soa
	    automatically update serial number in SOA. From Craig Leres.

	update_bindcache
	    see cachebuild. fetches data from ns.internic.net and does
	    some validation.  From Joachim Astel.

	updatedns
	    /etc/hosts to zonefiles converter from George D M Ross.

	xdns-info
	    pointer to library that builds/parses DNS packets.

	xstats-reporter
	    script that produces stats from named XSTATS variables.
	    also see graphstats. From Benoit Grange.

msql
	Patches for bind 4.9.3 to use msql for zone data storage.
	Front-ends to the msql dbms for zone and host data administration. 
	You can (add, remove, edit, list) (zone data, host records).
	From Chris Seawood, David Hughes, Paul Vixie.

multizdb
	patches to 4.9.3 to support multiple zones per database file.
	From Bill Carpenter.

named-lint
	a basic bison parser for 4.x zone data.

next-step
	next patches?

ninit
	named init program.  restarts named if it exits or hangs, and 
	sends it a signal every 5 minutes to dump stats. From Theodore Ts'o.

nslint
	a lint program which performs consistency checks on DNS files.  
	from Craig Leres.

nutshell
	canon.perl
	get_cache
	sum_debug
	check_del
	bind_debug
	ip_to_name
	check_soa
	h2n
	tools referred to in chapter 6-9, 11, 13 of Albitz and Liu.

old
	old versions of contrib code.

os2/emx
	files related to the os/2 EMX port of bind.	

rfc1101

tic
	DNS and NIS management tools from Texas Internet Consulting.

tplb
	notes on load balancing DNS from Tp Brisco.

trnamed
	find broken resolvers from named.run output. From Mike Minnich.

ucsd
	code used to automatically maintain the AMPR.ORG hierarchy.
	From Brian Kantor.

umich/
	dnsstats - A shell script which processes the logging produced by
	named when it has been built with QRYLOG defined and started with
	the "-q" flag.

	lame-delegation/

		LISA-VI-paper.ps - A PostScript copy of a paper written by
		Bryan Beecher for the USENIX LISA VI conference describing
		lame delegations and the following software.

		lamer-message - A template used by lamers.sh when sending mail.

		lamers.sh - A shell script which processes the logging produced
		by named when it has been built with LAME_DELEGATIONS defined.
		It sends mail to hostmasters with lame delegations, and
		generates a report handy for spotting one's own lame 
		delegations, or posting to comp.protocols.tcp-ip.domains.

	zt - A shell script which performs zone transfers.  It has a handy
	flag which allows it to perform recursive zone transfers.



-- 
mark seiden, mis@seiden.com, 1-(415) 592 8559 (voice)

