NAME

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

SYNOPSIS

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

        $g->enable();

        # every line of code will fire an event until

        $g->disable();

DESCRIPTION

This Devel::Events generator will fire line tracing events using DB::DB, 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.

METHODS

enable

Enable this generator instance, disabling any other instance of Devel::Events::Generator::LineTrace.

disable

Stop firing events.

line

Called by DB::DB. Used to generate the event.

CAVEATS

Apparently this must be run under perl -d. This is very strange, since Devel::Events::Generator::SubTrace doesn't need the -d flag set.

SEE ALSO

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