Apache::Status

NAME
SYNOPSIS
DESCRIPTION
PREREQUISITES
SEE ALSO
AUTHOR

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 \@strings;     #return an array ref
    }
 ) if Apache->module("Apache::Status"); #only if Apache::Status is loaded

WARNING: Apache::Status must be loaded before these modules via the PerlModule or PerlRequire directives. =head1 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

StatusLexInfo

With this option On and the B::LexInfo module installed, subroutine lexical variable information can be viewed.

 PerlSetVar StatusLexInfo 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.

AUTHOR