Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Devel::Events::GeneratUserLContributed PDevel::Events::Generator::LineTrace(3)

NAME
       Devel::Events::Generator::LineTrace - Generate "executing_line" events
       using the perl debugger api

VERSION
       version 0.09

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.

EVENTS
       executing_line
	   When	the generator is enabled, this event will fire for every line
	   of code just	before it is executed.

	   Lines in a package starting with "Devel::Events::" will not be
	   reported.

	   package
	       The package the line is in.

	   file
	       The file	of the line being executed.

	   line
	       The line	number of the line being executed.

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.

       The Enbugger module can help overcome this limitation.

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

SUPPORT
       Bugs may	be submitted through the RT bug	tracker
       <https://rt.cpan.org/Public/Dist/Display.html?Name=Devel-Events>	(or
       bug-Devel-Events@rt.cpan.org <mailto:bug-Devel-Events@rt.cpan.org>).

AUTHOR
       XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENCE
       This software is	copyright (c) 2007 by XXXX XXX'XX (Yuval Kogman).

       This is free software; you can redistribute it and/or modify it under
       the same	terms as the Perl 5 programming	language system	itself.

perl v5.32.0			  2018-0Devel::Events::Generator::LineTrace(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | EVENTS | METHODS | CAVEATS | SEE ALSO | SUPPORT | AUTHOR | COPYRIGHT AND LICENCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Devel::Events::Generator::LineTrace&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help