NAME
Devel::Debug::Server - communication module for debuging processes
VERSION
version 0.007
SYNOPSIS
#on command-line
#... first launch the debug server (only once)
tom@house:debugServer.pl
server is started...#now launch your script(s) to debug
tom@house:debugAgent.pl path/to/scriptToDebug.pl#in case you have arguments
tom@house:debugAgent.pl path/to/scriptToDebug.pl arg1 arg2 ...#now you can send debug commands with the Devel::Debug::Server::Client module $debugData = Devel::Debug::Server::Client::refreshData(); #$debugData contains all debugging processes infos
#get the debug infos for process $processToDebugPID $processInfos = $debugData->{processesInfo}{$processToDebugPID};
#check if process is halted if($processInfos->{halted} == 1){ print("process is halted.\n"); }
#check if process is finished
if($processInfos->{finished} == 1){
print("process is finished.\n");
}#set a breakpoint on line 9 Devel::Debug::Server::Client::breakPoint($pathToPerlFile,9); #remove breakpoint line 14 Devel::Debug::Server::Client::removeBreakPoint($scriptPath,14);
#now run the process Devel::Debug::Server::Client::run($processToDebugPID)
#return from current subroutine Devel::Debug::Server::Client::return($processToDebugPID);
#eval an expression in the process context Devel::Debug::Server::Client::eval($processToDebugPID,'$variable = 0');
#now time to do one step Devel::Debug::Server::Client::step($processToDebugPID);
#suspend a running process Devel::Debug::Server::Client::suspend($processToDebug);
DESCRIPTION
This module provide a server for debugging multiples perl processes.
Lots of debugging modules a available for perl (graphical and non graphical), their are all directly attached to the debugged script. This implies the following limitation : - it is not easy to debug multiple processes (10 processes implies 10 debugging shell windows) - it is not easy to debug forking processes - it is not easy to automate breakpoints. breakpoints should be set again at each script execution (and automation is not trivial)
This module aims at providing an debugging engine so that we can provide a debugger equivalent the jvm one where you can observe and halt each jvm thread as you want but working with perl processes instead of jvm threads. Every debugging processes connect to the debugging server providing runtime informations and receiving breakpoint list to set.
This module aims at providing a convenient base be to develop one or more GUI client to control this debug server.
Currently there are no GUI clients available.
A first version of the server is now available.
One can launch one server and debug as many processes as he wants : - all debugging informations are centralized by the server - all debugging commands are sent by the server when it receives a client request
For example, the tests script "01-debug-script.t" launch a debug server and 3 processes. All processes are being debugged at the same time (breakpoints are set for all processes).
Limitations : Works only for linux systems (should be possible to make it works for windows) No GUI client available today. It doesn't manage for now forking processes.
AUTHOR
Jean-Christian HASSLER <hasslerjeanchristian@gmail.com>
COPYRIGHT AND LICENSE
This software is copyright (c) 2012 by Jean-Christian HASSLER.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.