lib::Apache::StaUtsuesr(3C)ontributed
NNAAMMEE
Apache::Status - Embedded interpreter status information
SSYYNNOOPPSSIISS
<Location /perl-status>
SetHandler perl-script
PerlHandler Apache::Status
</Location>
DDEESSCCRRIIPPTTIIOONN
The AAppaacchhee::::SSttaattuuss 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
OOPPTTIIOONNSS
StatusDumper
When browsing symbol tables, the values of arrays,
hashes ans calars can be viewed via DDaattaa::::DDuummppeerr if
this configuration variable is set to On:
PerlSetVar StatusDumper On
StatusPeek
With this option On and the AAppaacchhee::::PPeeeekk module
installed, functions and variables can be viewed ala
DDeevveell::::PPeeeekk style:
PerlSetVar StatusPeek On
StatusGraph
When SSttaattuussDDuummppeerr 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 ddoott program.
Dot is part of the graph visualization toolkit from
AT&T: http://www.research.att.com/sw/tools/graphviz/).
WWAARRNNIINNGG: 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
PPRREERREEQQUUIISSIITTEESS
The Devel::Symdump module, version 22..0000 or higher.
SSEEEE AALLSSOO
perl(1), Apache(3), Devel::Symdump(3), Data::Dumper(3),
B(3), B::Graph(3)
AAUUTTHHOORR
Doug MacEachern