NAME

Apache::Status - Embedded interpreter status information

SYNOPSIS

 <Location /perl-status>
 SetHandler  perl-script
 PerlHandler Apache::Status
 </Location>

DESCRIPTION

The Apache::Status module provides some information about the status of the Perl interpreter embedded in the server.

Configure like so:

 <Location /perl-status>
 SetHandler  perl-script
 PerlHandler Apache::Status
 </Location>

Other modules can "plugin" a menu item like so:

 Apache::Status->menu_item(
    'DBI' => "DBI connections", #item for Apache::DBI module
    sub {
        my($r,$q) = @_; #request and CGI objects
        my(@strings);
        push @strings,  "blobs of html";
        return \@s;     #return an array ref
    }
 ) if Apache->module("Apache::Status"); #only if Apache::Status is loaded

OPTIONS

StatusDumper

When browsing symbol tables, the values of arrays, hashes ans calars can be viewed via Data::Dumper if this configuration variable is set to On:

 PerlSetVar StatusDumper On

StatusPeek

With this option On and the Apache::Peek module installed, functions and variables can be viewed ala Devel::Peek style:

 PerlSetVar StatusPeek On

StatusGraph

When StatusDumper is enabled, another link "OP Tree Graph" will be present with the dump if this configuration variable is set to On:

 PerlSetVar StatusGraph

This requires the B module (part of the Perl compiler kit) and B::Graph (version 0.03 or higher) module to be installed along with the dot program.

Dot is part of the graph visualization toolkit from AT&T: http://www.research.att.com/sw/tools/graphviz/).

WARNING: Some graphs may produce very large images, some graphs may produce no image if B::Graph's output is incorrect.

Dot

Location of the dot program for StatusGraph, if other than /usr/bin or /usr/local/bin

GraphDir

Directory where StatusGraph should write it's temporary image files. Default is $ServerRoot/logs/b_graphs

PREREQUISITES

The Devel::Symdump module, version 2.00 or higher.

SEE ALSO

perl(1), Apache(3), Devel::Symdump(3), Data::Dumper(3), B(3), B::Graph(3)

AUTHOR

Doug MacEachern