---***   Thanks for trying out who_am_i.pl  version 1.0a ***---

Descripton:

This script allows visitors to your site to check their IP address, 
domain name, and browser. If it is used as a server side include (SSI)
it will also return the referer page.

With this readme file you should have received:
	who_am_i.pl		the cgi script referred to as the pl file
	who_am_i.shtml		the html page which calls the script
	gnu.html		the GNU general public license
		

Copyright:

	Copyright information is contained in the header of the pl file
	which may be read by opening up the file in a text editor like 
	the one you are using to read this.
	
	This software is covered by the GNU General Public License which
	you should have received along with the software.


Installation:

1. SSI
2. Without SSI

1. Installation with SSI
	a.) The first line of the who_am_1.pl script reads: #!/usr/bin/perl,
	however if your server has a non standard path to perl you must
	replace /usr/bin/perl with the correct path. To locate perl on your
	server type: 'which perl'(without the quotes) at your shell prompt.
	[note] /usr/local/bin/perl is very common.

	b.) Two variables: $heading and $datepath are user setable and are 
	located just below the header in the pl file. $heading determines 
	the greeting at the top of the output page. $datepath is the path 
	to the date command on your server. It normally reads:
	$datepath = "/bin/date"; but may be different on your server. 
	Type: 'which date' at the Unix shell prompt to locate it on your 
	server.
	Note: be careful not to omit the semicolons at the end of each line.
	
	c.) Transfer the who_am_i.pl file to a directory from which you can
	run cgi. On some servers your cgi script must be in the cgi-bin 
	directory in order to be executed. Make sure that you upload the
	script with your uploading software set to ASCII or Text mode NOT 
	Binary mode.


	d.) Make sure the permission to execute the file is set. On Unix
	servers you can telnet to the server, cd to the directory where the
	file is located, and type:  chmod 755 who_am_i.pl

	e.) Transfer the who_am_i.shtml file to the same directory as the pl
	file. If you need to place it in another directory you must change
	the <!--#exec cgi="who_am_i.pl"--> line by replacing the file name 
	(in quotes) with the new path to the file.

	To run the script just use your browser to access the 
	who_am_i.shtml file.

2.Non SSI Installation
	a.) Delete the second to last line in the who_am_i.pl file:
	it should look like this: print "<br>referer: $referer <br>";
	(the referer info cannot be obtained without SSI)

	b.) Follow steps a.) through (d.) above.

	c.) Place a link to the pl file on a page on your site.

	To run the file click on the link that you have created to it.

Support:

	I can offer only limited support for this software and only for
	an indefinite period of time. Please carefully read this file
	and visit the home page http://theaction.com/scripts before 
	contacting me for help. If your problem involves html rather 
	than cgi, please consult some of the numerous sources of info 
	on the web first.

Feedback:

	All comments, bug discoveries, reports, and other feedback should
	be directed to scripts@theaction.com
	
	Please include the script name and version # in all correspondence.	

	If you find that this script works/doesn't work on an OS or server 
	not listed on the web site. Please let me know the OS and server
	names and versions.