NAME

Debug::Client - client side code for perl debugger

SYNOPIS

 use Debug::Client;
 my $debugger = Debug::Client->new(host => $host, port => $port);
 $debugger->listen;

 # this is the point where the external script need to be launched
 # first setting 
     # $ENV{PERLDB_OPTS} = "RemotePort=$host:$port"
 # then running
     # perl -d script

 my $out = $debugger->get;

 $out = $debugger->step_in;

 $out = $debugger->step_over;


 my ($module, $file, $row, $content, $prompt) = $debugger->step_in;
 my ($module, $file, $row, $content, $prompt, $return_value) = $debugger->step_out;
 my ($value, $prompt) = $debugger->get_value('$x');

 $debugger->run();         # run till end of breakpoint or watch
 $debugger->run( 42 );     # run till line 42  (c in the debugger)
 $debugger->run( 'foo' );  # tun till beginning of sub

 $debugger->execute_code

 $debugger->set_breakpoint( "file", 23 ); # 	set breakpoint on file, line

Other planned methods:

$debugger->set_breakpoint( "file", 23, COND ); # 	set breakpoint on file, line, on condition
$debugger->set_breakpoint( "file", subname, [COND] )

$debugger->set_watch
$debugger->remove_watch
$debugger->remove_breakpoint

$debugger->get_stack_trace

$debugger->watch_variable   (to make it easy to display values of variables)

DESCRIPTION

buffer

return the content of the buffer since the last command

$debugger->buffer;

See Also

GRID::Machine::remotedebugtut

COPYRIGHT

Copyright 2008 Gabor Szabo. http://www.szabgab.com/

LICENSE

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

WARRANTY

There is no warranty whatsoever. If you lose data or your hair because of this program, that's your problem.

CREDITS and THANKS

Originally started out from the remoteport.pl script from Pro Perl Debugging written by Richard Foley.