Tom Phoenix > Inside-1.01 > Inside

Download:
Inside-1.01.tar.gz

Annotate this POD

View/Report Bugs
Source  

This text is in POD format. You should be able to read it with the perldoc command, or any other POD reader.

NAME ^

Inside - Find out what's inside your Perl installation

DESCRIPTION ^

This program will try to report which Perl modules are available on your machine, along with some other useful information. Although it's especially made to be helpful to CGI programmers, it may be of use to other Perl users as well.

Note that I've done more than a few weird things in this code in order to make it work in some odd surroundings. The right thing to do in general is to fix the broken environments, rather than to work around them. But since the purpose of this program is to diagnose some of those broken environments, I'm breaking the rules. In short: Don't Do As This Code Does! Use the accepted techniques, instead.

You should be able to run this program on nearly any machine which has Perl, either as a CGI program or stand-alone, although not under Apache/mod_perl's non-CGI environments, like Apache::Registry or Apache::PerlRun. (The ordinary Apache CGI environment is fine, whether mod_perl is installed or not.) The only(?) thing which should need changing in the program text is the location of perl in the #!-line, the first line of the program. There's also a small Configuration section near the top of the source, if you really need to have something to fiddle with.

Of course, if you're installing this program on a webserver, your local expert may need to help you to get it running. Don't ask me to do it! :-)

FAQ ^

COPYRIGHT, DISCLAIMER, AND LICENSE ^

Copyright (C) 2000 by Tom Phoenix <rootbeer@redcat.com>.

THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

This program is free software; you can distribute it under the same terms as Perl itself. I don't recommend modifying it or distributing variant versions. In fact, I discourage modifying it, unless you're sure you know what you're doing. And if you do modify something, make sure that you've clearly labeled whatever you've done. On the other hand, if you come up with a cool or useful modification, let me know. And don't forget to periodically check CPAN for updates.

    http://www.cpan.org/authors/id/P/PH/PHOENIX/

Be cautious that, if you modify this code in any way, you do not introduce security holes. Although I have, to the best of my knowledge and ability, made this program as safe as is practicable, it may have flaws which could cause undesirable effects. Still, I don't think it's too bad: I run it myself.

AUTHOR ^

Tom Phoenix <rootbeer@redcat.com> with plenty of help from other folks, including (in no particular order) "Tolkin, Steve" <Steve.Tolkin@fmr.com>, Mark Lybrand <markyesme@home.com>, Eric Cholet <cholet@logilune.com>, Drew Simonis <care227@attglobal.net>, Tim Conrow <tim@ipac.caltech.edu>, Richard Martin Woodward <RichardWoodward@hotmail.com>, JohnShep <john@princenaseem.com>, Mike Solomon <mike.solomon@eps.ltd.uk>, Anno Siegel <anno4000@lublin.zrz.TU-Berlin.DE>, Randall Woodman <rwoodman@verio.net>, Ken MacFarlane <ksm@dca.net>, Philip Newton <pne@cpan.org>, and anyone whose name I've accidentally omitted. It wouldn't have been possible without all this help.

syntax highlighting: