
			   Domtools Web 1.0.0

	A supplemental software package to the Domtools utilities
	Copyright (C) 1993-1999 Paul A. Balyoz <pab@domtools.com>


This directory is the source area for the Domtools Web Page, which is a set of
web forms and CGI scripts that ask you to enter things like domain names and
IP addresses, and performs Domtools functions on them, converting the output
to a normal web page.

This is the development directory.  To install it you need to edit
the Makefile and configure it for your site.  Then type "make install".

NOTE: The nph-domtools.cgi script CANNOT be run as-is, you *MUST* install it
      by using the Makefile to expand all the macros!  (see above)

nph-domtools.cgi creates a log file in a lib directory (see Makefile)
which records each time the cgi-script is launched, what site launched
it, and what their query string was (if any).  This file grows without
bounds, so you probably want to rotate it every few days/weeks.

Output lines look like:

  08/25/1998 03:19:18 query by 203.120.90.44 [203.120.90.44], no zone specified
  08/25/1998 03:20:49 query by 203.120.90.44 [203.120.90.44], zone hk.super.net.
  08/25/1998 03:23:48 query by 203.120.90.44 [203.120.90.44], zone pacific.net.sg.
  08/25/1998 04:48:17 query by 202.219.194.64 [202.219.194.64], no zone specified
  08/25/1998 05:45:27 query by 193.159.218.214 [193.159.218.214], no zone specified
  08/25/1998 05:49:22 query by 193.159.218.214 [193.159.218.214], zone nrw.de.

Some web servers will show the domain name to the left of the [] part.

"no zone specified" means the person just got to the page for the first time,
so it drew the initial "enter a domain to search" page.

To modify the defaults of 4 simultaneous sessions with 10 minute limit each,
edit the variables near the top in the nph-domtools.cgi script.


REQUIRES

	Perl 5		http://www.perl.org/
	Domtools	http://www.domtools.com/dns/
	cgi-lib.pl	(included; also available on the Internet)
	Apache httpd	http://www.apache.org/

    You can use this script with any web server, however, non-Apache servers
    will probably not do the partial-page-drawing as the domain is being scanned --
    it may leave the browser window empty until the entire domain tool run has
    completed (or gives up and displays an error, if you have to go thru a lame
    http proxy server that has an HTTP session time limit!)

    The CGI script currently checks for other occurrences of itself running on
    the same system by looking at the process table thru the /proc file system
    as implemented by RedHat Linux.  Other Linux systems may work the same way,
    but probably not a lot of other operating systems.  If you use other flavors
    of Unix, you may have to hack nph-domtools.cgi for this mechanism to work right.


COMMERCIAL USE / PRIVATE USE

If you use this package to offer Domtools services to your customers such as if you
are an ISP or a web-hosting site, we need to work out a reasonable fee.
Please contact me at the address below for details.

If you use this package to analyze zone files internally, you can do so for free.


WARRANTY

This software includes absolutely no warranty or support whatsoever.
But you can always send me mail and I'll respond if I can.


FILES

  README		This file.
  CHANGES		Change history for this software package.
  BUGS			List of bugs in this version of this software package.
  Makefile		Makefile for installing this package.
  makebutton		Shell script that builds each button gif image from a
			text file source using ImageMagick utilities.
  nph-domtools		The Domtools CGI script itself.
  cgi-lib.pl		Very useful perl library for CGI scripts,
			distributed by someone else on the Internet
			(new version probably available out there somewhere)
  domtoolsstat		Interactive utility to let you see the last 10 or so
			sites that ran a domain tool, what domain they specified
			and when, and how many sessions are currently active.
  index.shtml		Server-side-include HTML web page that should be the
			default page in the domtools web page directory.
			Edit it as needed.  Can be used as index.html.
  *.button		Text that goes into the button graphics (*.gif).
  invispixel.gif	Invisible 1pixel X 1pixel gif image, useful for tabbing
			things over by any amount (graphical web browsers only)
  left-arrow.gif	Big green ray-traced left-arrow I made for links that say
			"previous page".
  graypixel.gif		Gray 1pixel X 1pixel gif image, used by createbuttons.
			Not used by web pages.
  template.gif		Temporary working image that createbuttons uses.
			Not used by web pages.
  *.gif			All the button gif images built by createbuttons.

--
Paul Balyoz                           pab@domtools.com
Domtools Consulting              or:  pbalyoz@jammed.com
Phoenix Arizona, USA
