Perl Diver
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
B
Module
Pod2
.gitignore
README.html
README.md
perldiver.conf
perldiver.pl
perldiver.zip

README.md

Perl Diver 2.33

Name

Perl Diver

Description

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.

Perl Diver was originally offered by (since defunct) ScriptSolutions.~~~~com (see Credits & Acknowledgements) and is again available on GitHub @ https://github.com/mrrena/perldiver per the terms of the original (and ongoing) license.

A supporting blog post Perl Diver 2.33: Download and Installation provides a screenshot and additional information on how to hide Perl Diver from search engines using a robots.txt file and password protecting your perldiver directory using Apache's htpasswd.

Installation

If you have git access:

 # as ssh
 git clone git://github.com/mrrena/perldiver
 # as https
 git clone https://github.com/mrrena/perldiver

Otherwise, PerlDiver is installed simply by unzipping and uploading all files in the distribution zip 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.pl needs to have execute permissions turned on. You can do this by running the command chmod +x perldiver.pl 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 (FTP): you will need to set them to 755.

Files in this Distribution

1. perldiver.pl

The executable program.

2. perldiver.conf

Configuration settings. Several sections in Perl Diver display information based on settings in this file. See Customizing Perl Diver below for details.

3. B/Utils.pm

A Perl module required by Module::Info.

4. B/Module/Info.pm

A Perl module required by Module::Info.

5. Module/Info.pm

A Perl module used to provide details about a module.

6. Pod/Html2.pm

A modified version of Pod::Html.

Sections

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.

Main

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).

Environment Variables

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.

This section displays all environment variables that are available for your server.

Perl Default Values

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.

Perl Config - Summary

Displays a summary of the major Perl configuration values.

Perl Config - Full

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).

Installed Modules

This section will list all modules that are include 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).

View Module Details & Documentation

Module Details

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.

  1. Name Just the name of the module.

  2. Version Number, if any. Divines the value of $VERSION. Module::Info uses the same method as ExtUtils::MakeMaker and all caveats therein apply.

  3. Include Directory Include directory in which this module was found.

  4. File The absolute path to the module.

  5. Is Core Shows you if this module is included in the Perl distribution. 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.

  1. Packages Inside Looks for any explicit 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.

  2. Modules Used Returns a list of all modules and files which may be 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.

  3. Subroutines

  4. Superclasses

  5. Subroutines Called

  6. Dynamic Method Calls

The remaining 2 options are to find the module and its documentation. See Changing Urls for instructions on how to change the urls to which these links point.

Customizing Perl Diver

Changing Appearance

All colors, fonts, and font sizes are controlled by a style sheet in perldiver.conf. Make style sheet changes to the style variable.

Changing Urls

CPAN and Perl Documentation links

By default, CPAN modules link to http://search.cpan.org and Perl documentation links to http://perldoc.perl.org. 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.

Rename perldiver.pl

By default, Perl Diver is named perldiver.pl. 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.pl 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.

Default Settings

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

Extending Perl Diver is easy, but not for the faint at heart. Simple follow the examples in perldiver.conf to build your own.

Add command line output

65 =  {
    'List Directory',
    sub { Tr( td( pre( `ls -la`) ) ) },
    'show' = 1,
    'Just a sample of extending Perl Diver with command output.'
},

Dependencies

PerlDiver requires the following modules to be installed.

CGI

Standard module included in Perl distribution.

File::Find

Standard module included in Perl distribution.

Config

Module created when Perl is installed.

Pod::Html2

Included with PerlDiver.

Module::Info

Included with PerlDiver.

Pod2::Html

A modified version of Pod::Html by Tom Christiansen. Included with PerlDiver. This should be considered extremely beta. It will not break PerlDiver, but may alter the output of the module documentation. Please report inconsistencies to programmer~~~~@~~~~scriptsolutions.~~~~com https://github.com/mrrena/perldiver/issues.

Caveats

Module details is not supported on Win32 systems.

License

This script is free software; you are free to redistribute it and/or modify it under the same terms as Perl itself: (Artistic License, Artistic License 2, and/or GPL, v.1 or any later).

Changes

2012 changes forward: (github) perldiver Commits

2.032 - Added testing to module detail input. See http~~~~://~~~~www~~~~.scriptsolutions.~~~~com/support/showflat.pl (Internet Archive Wayback Machine Link) 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)

Support

For support of this script, please post your issue at https://github.com/mrrena/perldiver/issues.

Credits & Acknowledgements

Copyright 1997-2006, Creative Fundamentals, Inc. http~~~~://~~~~creativefundamentals.~~~~com dba ScriptSolutions http~~~~://~~~~scriptsolutions.~~~~com)