mod_perl logo
perl icon







previous page: Apache::Reload - Reload Perl Modules when Changed on Diskpage up: mod_perl APIsnext page: ModPerl::BuildMM -- A "subclass" of ModPerl::MM used for building mod_perl 2.0


Apache::Status - Embedded interpreter status information











Writing Apache Modules with Perl and C

Writing Apache Modules with Perl and C

By Lincoln Stein, Doug MacEachern
Embedding Perl in HTML with Mason

Embedding Perl in HTML with Mason

By Dave Rolsky, Ken Williams
Practical mod_perl

Practical mod_perl

By Stas Bekman, Eric Cholet


Table of Contents

Synopsis

  <Location /perl-status>
      SetHandler modperl
      PerlResponseHandler Apache::Status
  </Location>


TOP

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 modperl
       PerlResponseHandler Apache::Status
  </Location>

Notice that under the "modperl" core handler the Environment menu option will show only the environment under that handler. To see the environment seen by handlers running under the "perl-script" core handler, configure Apache::Status as:

  <Location /perl-status>
       SetHandler perl-script
       PerlResponseHandler 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.



TOP

Options



TOP

Prerequisites

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



TOP

Copyright

mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 1.1.



TOP

See Also

perl(1), Apache(3), Devel::Symdump(3), Data::Dumper(3), B(3), B::Graph(3), mod_perl 2.0 documentation.



TOP

Authors

Doug MacEachern with contributions from Stas Bekman







TOP
previous page: Apache::Reload - Reload Perl Modules when Changed on Diskpage up: mod_perl APIsnext page: ModPerl::BuildMM -- A "subclass" of ModPerl::MM used for building mod_perl 2.0