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  -  DEVEL::EVENTS::GENERATOR::SUBTRACE (3)

.ds Aq ’

NAME

Devel::Events::Generator::SubTrace - generate "executing_line" events using the perl debugger api.

CONTENTS

SYNOPSIS



        my $g = Devel::Events::Generator::SubTrace->new( handler => $h );

        $g->enable();

        # every subroutine will have two events fired, on entry and exit

        $g->disable();



DESCRIPTION

This Devel::Events generator will fire sub tracing events using DB::sub, a perl debugger hook.

Only one instance may be enabled at a given time. Use Devel::Events::Handler::Multiplex to deliver events to multiple handlers.

Subroutines inside the Devel::Events namespace or it’s children will be skipped.

EVENTS

enter_sub When the generator is enabled, this event will fire for every subroutine, just before it is executed.

Subroutines in a package starting with Devel::Events:: will not be reported.
name The name of the subroutine (or it’s overload::StrVal if it has none).
code A code reference to the subroutine.
args A copy of the arguments list. \@_ causes segfaults but [ @_ ] does not. Bummer ;-)
depth The current depth of the call stack.
wantarray The context of the call as given by wantarray

leave_sub Exactly like enter_sub, but fired just after leaving the subroutine.

  All the fields of enter_sub are passed.

Additional fields:

ret

The return value of the subroutine.

METHODS

enable Enable this generator instance, disabling any other instance of Devel::Events::Generator::SubTrace.
disable Stop firing events.
enter_sub Called by DB::sub. Sends the enter_sub event.
leave_sub Called by DB::sub. Sends the leave_sub event.

SEE ALSO

perldebguts, Devel::CallTrace, DB, Devel::ebug, perl5db.pl

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 176: You can’t have =items (as at line 182) unless the first thing after the =over is an =item
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 DEVEL::EVENTS::GENERATOR::SUBTRACE (3) 2009-01-10

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