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