GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CATALYST::PLUGIN::STACKTRACE (3)

.ds Aq ’

NAME

Catalyst::Plugin::StackTrace - Display a stack trace on the debug screen

CONTENTS

SYNOPSIS



    use Catalyst qw/-Debug StackTrace/;



DESCRIPTION

This plugin will enhance the standard Catalyst debug screen by including a stack trace of your appliation up to the point where the error occurred. Each stack frame is displayed along with the package name, line number, file name, and code context surrounding the line number.

This plugin is only active in -Debug mode by default, but can be enabled by setting the enable config option.

CONFIGURATION

Configuration is optional and is specified in MyApp->config->{stacktrace}.

    enable

Allows you forcibly enable or disalbe this plugin, ignoring the current debug setting. If this option is defined, its value will be used.

    context

The number of context lines of code to display on either side of the stack frame line. Defaults to 3.

    reverse

By default, the stack frames are shown in from top to bottom (newest to oldest). Enabling this option reverses the stack frames so they will be displayed bottom to top, or from the callers perspective.

    verbose

This option sets the amount of stack frames you want to see in the stack trace. It defaults to 0, meaning only frames from your application’s namespace are shown. You can use levels 1 and 2 for deeper debugging.

If set to 1, the stack trace will include frames from packages outside of your application’s namespace, but not from most of the Catalyst internals. Packages ignored at this level include:



    Catalyst
    Catalyst::Action
    Catalyst::Base
    Catalyst::Dispatcher
    Catalyst::Engine::*
    Catalyst::Plugin::StackTrace
    Catalyst::Plugin::Static::Simple
    NEXT
    main



If set to 2, the stack trace will include frames from everything except this module.

INTERNAL METHODS

The following methods are extended by this plugin.
execute In execute, we create a local die handler to generate the stack trace.
finalize_error In finalize_error, we inject the stack trace HTML into the debug screen below the error message.
setup

SEE ALSO

Catalyst

AUTHORS

Andy Grundman, <andy@hybridized.org>

Matt S. Trout, <mst@shadowcatsystems.co.uk>

THANKS

The authors of CGI::Application::Plugin::DebugScreen, from which a lot of code was used.

COPYRIGHT

Copyright (c) 2005 - 2009 the Catalyst::Plugin::StackTrace AUTHORS as listed above.

LICENSE

This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CATALYST::PLUGIN::STACKTRACE (3) 2012-07-12

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.