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

FreeBSD Manual Pages

  
 
  

home | help
Devel::Events::GeneratUserSContributed PeDevel::Events::Generator::SubTrace(3)

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

VERSION
       version 0.09

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

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-03Devel::Events::Generator::SubTrace(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | EVENTS | METHODS | 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::SubTrace&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help