lib::Apache::StaUtsuesr(3C)ontributed

lib::Apache::StaUtsuesr(3C)ontributed

Apache::StatINC Home Page Subroutines Index Apache::Symbol


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

Apache::StatINC Home Page Subroutines Index Apache::Symbol