NAME

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

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.

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