Background:
Many times you'll need to know what's on your server, but either don't know, don't know how to find out, or don't want to bother your system administrator (again). Perl Diver v2.01 helps you by digging into your server's perl installation and giving you the information you need. Perl Diver v2.01 is a great tool for program developers who need to learn about an unfamiliar server quickly, or for people who've just moved to a new web server.

Objective:
Perl Diver v2.01 gives you a list of what's installed on your server. It gives you the location of your sendmail program, your path to perl, your environment variables and most (not all) of the Perl modules that are installed on your server.

Requirements:
To run Perl Diver v2.01, you'll need:

• Permission to run CGI scripts on your web server (How's that for obvious?)
• Perl 5.004 or higher
• UNIX based server (Though this program may work on NT, Solaris, or other server, it has not been tested.)
• The following Perl modules:
• File::Find

Installation:
Installing Perl Diver v2.01 is so easy, it's scary. Please follow these simple steps:

1. Download Perl Diver v2.01
2. Unzip the program using your favorite unzip program.
3. The first line of the program has the path to perl as

   #!/usr/bin/perl

   a common location for perl. If that is not correct for your server, open perldiver.cgi in your favorite text editor and make sure that the path to perl is correct.

   If you don't know your path to perl, telnet to your account and type

   whereis perl

   at the prompt. You will be returned the path to perl on your server. If you don't know your path to perl and don't have telnet access, ask your system administrator for your path to perl.

4. After you've made the above changes, save the file and open your favorite FTP program.
5. Upload all files in ASCII format into your cgi-bin or other executable directory.
6. Change permissions on perldiver.cgi to 755. You can either change permissions using your FTP program (if that's a feature of your FTP program) or by telnet. Please review your FTP program's documentation to learn how to do this using your FTP program. If you wish to change permissions by telnet, telnet to your account and navigate to the directory you uploaded RALB into. Type

   chmod 755 perldiver.cgi

7. Point your web browser to your installation of perldiver.cgi. If you have the required modules, uploaded the files in ascii format, have the correct path to perl on the first line, you will receive output similar to the demo.

Support:
Because PerlDiver is a freeware program, we do offer limited free support. Support Information and Options.