Perl Diver
Perl Diver is a CGI program written in Perl that will help you find out what modules are installed on your server, server paths, perl configuration settings, etc.
PerlDiver is installed simply by unzipping and uploading all files in the distribution into your cgi-bin directory. If you don't know where your cgi-bin directory is, please ask your system administrator. Be sure to upload all files in ASCII format.
After the files are uploaded, perldiver.cgi needs to have execute permissions
turned on. You can do this by running the command chmod +x perldiver.cgi
from your command line. If you don't have command line access to your web
server, then there will probably be an equivalent function in your file transfer
program.
Perl Diver comes with a base set of sections to which you can add your own (covered in Customizing Perl Diver). These sections are described below.
This section is the page that you see when you go to Perl Diver in your browser without any parameters. It shows you the paths to Perl, sendmail, operating system, etc. You can add or edit variables to this section (see Customizing Perl Diver).
In order to pass data about the information request from the server to the script, the server uses command line arguments as well as environment variables. These environment variables are set when the server executes the gateway program.
- Excerpted from http://hoohoo.ncsa.uiuc.edu/cgi/env.html
This section displays all environment variables that are available for your server.
This section shows you some basic default values, such as a list of signal handlers supported by your server, various separators, debugging support, etc. You can add to this list by editing the Perl Defaults section of the configuration file. See Customizing Perl Diver for details.
Displays a summary of the major perl configuration values.
All the information that was available to the Configure program at Perl build time (over 900 values). This section displays the entire perl configuration information in the form of the original config.sh shell variable assignment script.
All variables are linked to its description in Config.pm's documentation (using Perl Diver's Module Details function).
This section will list all modules that are included in the paths listed in
@INC. Each module is linked to a page with more information about the module
and its documentation (if any exist).
These details are extracted using the Module::Info module (found at http://search.cpan.org/search), which is included in the Perl Diver distribution. The documentation in this section is derived from the module.
$VERSION. Module::Info uses the same method as
ExtUtils::MakeMaker and all caveats therein apply.
Note that this checks perl's installation directories (see the
Perl Config - Full output for the directory listed in the installarchlib
and installprivlib setting. It's possible that the module has been altered or
upgraded from CPAN since the original Perl installation.
A non-zero number states that it is a core module.
The following details are extracted by compiling the module and examining the optree code. The module will be compiled in a separate process so that it does not disturb the current program.
These details will only show if you have perl 5.6.1 (or greater) installed and requires the B::Utils module.
If you have perl 5.6.1 or higher and see all ``None or Not Available'' responses, check your error log. Module::Info may not be finding a required module to Run.
Notes: Currently doesn't spot package changes inside subroutines. Also, the following will currently not display if your server is running Win32.
package declarations inside the module and returns a
list. Useful for finding hidden classes and functionality (like Tie::StdHandle
inside Tie::Handle).
Note: Module::Info currently does not spot package changes inside subroutines.
use'd or require'd
by this module.
Note: These modules may be conditionally loaded, but Module::Info can't tell.
It cannot find modules which might be used inside an eval.
The remaining 2 options are to find the module and its documentation. See Changing Urls for instructions on how to change the urls these links point to.
All colors, fonts, and font sizes are controlled by a style sheet in perldiver.conf. Make style sheet changes to the 'style' variable.
By default, CPAN modules link to http://search.cpan.org and Perl
documentation links to http://perldoc.com. You can change this to your
favorite mirror by editing the 'perldoc_base_url' and 'cpan_base_url'
variables in the ``Other'' section of perldiver.conf.
By default, Perl Diver is named perldiver.cgi. If you've changed this, be sure
to change the 'script_name' variable in perldiver.conf's ``Other'' section.
It's recommended to not change the name of perldiver.conf, but if you do, open
perldiver.cgi and change the following line:
do 'perldiver.conf' or die "Can't load conf file $!";
to reflect the new name/location of the configuration file. =back
You can modify or add any piece of information that appears on the
Perl Default Values page by editing the values in the ``Perl Defaults''
section. Add new data to the $defaults hashref using the format shown.
Extending Perl Diver is easy, but not for the faint at heart. Simple follow the examples in perldiver.conf to build your own.
65 => {
'name' => 'List Directory',
'subr' => sub { Tr( td( pre( `ls -la`) ) ) },
'show' => 1,
'desc' => 'Just a sample of extending Perl Diver with command output.'
},
PerlDiver requires the following modules to be installed.
This script is free software; you are free to redistribute it and/or modify it under the same terms as Perl itself.
2.032 - Added testing to module detail input. See http://www.scriptsolutions.com/support/showflat.pl for details. (20050916)
2.031 - Told Pod2::Html to shut up already. (20030420)
2.03 - Removed most superfluous warnings in perldiver and Pod2::Html. (20030419)
2.02 - Modified Module::Info to remove warnings (20030115)
2.01 - Modified Pod::Html and included it as Pod2::Html (20030103)
2.00 - Overhaul from version 1.x (20021216)
For support of this script please visit http://scriptsolutions.com/support/
Copyright 1997-2003, Creative Fundamentals, Inc. (http://creativefundamentals.com) dba ScriptSolutions (http://scriptsolutions.com)