1 /**********************************************************************
2 Copyright (c) 2000, 2002 IBM Corp. and others.
3 All rights reserved. This program and the accompanying materials
4 are made available under the terms of the Common Public License v1.0
5 which accompanies this distribution, and is available at
6 http://www.eclipse.org/legal/cpl-v10.html
9 Vicente Fernando - www.alfersoft.com.ar - Initial implementation
10 Christian Perkonig - remote debug
11 **********************************************************************/
12 package net.sourceforge.phpdt.internal.debug.core;
14 import java.io.BufferedReader;
15 import java.io.IOException;
16 import java.io.OutputStream;
17 import java.util.Vector;
18 import java.util.Collections;
20 import net.sourceforge.phpdt.internal.debug.core.model.PHPDBGEvalString;
21 import net.sourceforge.phpdt.internal.debug.core.model.PHPStackFrame;
22 import net.sourceforge.phpdt.internal.debug.core.model.PHPVariable;
23 import net.sourceforge.phpdt.internal.debug.core.model.PHPValue;
25 import org.eclipse.core.runtime.IStatus;
26 import org.eclipse.core.runtime.Status;
27 import org.eclipse.debug.core.DebugException;
30 * The interface object are created by the proxy
33 public class PHPDBGInterface {
35 public boolean sessionEnded = false;
36 public int sessType = -1;
37 public int BPUnderHit = 0;
38 public String sessID = new String ();
40 private int[] LastBPRead = new int[10];
41 private Vector DBGBPList = new Vector ();
42 private Vector DBGVarList = new Vector ();
43 private PHPStackFrame[] DBGStackList;
44 private Vector DBGMods = new Vector (); // The module names and their numbers
45 private Vector stackListOld = new Vector ();
46 private BufferedReader in;
47 private OutputStream os; // The stream which goes to DBG
48 private boolean shouldStop = false;
49 private String evalRet = new String ("");
50 private String serGlobals = new String ("");
51 private int rawCounter = 1000; // An rawData frame ID counter
52 private PHPDBGProxy proxy = null;
53 private int lastCmd = -1;
55 private boolean stopOnError = false;
56 private char[] lastCommand = new char[4];
59 * @param in The input stream (communication from DBG).
60 * @param os The output stream (communication to DBG).
61 * @param proxy The proxy to which this interface belongs.
63 public PHPDBGInterface (BufferedReader in, OutputStream os, PHPDBGProxy proxy) {
73 * @param mod_name The module (source file) to which we add the breakpoint.
74 * @param line The line where the breakpoint is set.
75 * @return Breakpoint ID ???.
77 public int addBreakpoint (String mod_name, int line) throws IOException {
78 return setBreakpoint (mod_name, "", line, PHPDBGBase.BPS_ENABLED + PHPDBGBase.BPS_UNRESOLVED, 0, 0, 0, 0, 0);
83 * @param mod_name The module (source file) to which we add the breakpoint.
84 * @param line The line where the breakpoint is set.
85 * @param bpNo The breakpoint ID ???.
87 public void removeBreakpoint (String mod_name, int line, int bpNo) throws IOException {
88 setBreakpoint (mod_name, "", line, PHPDBGBase.BPS_DISABLED, 0, 0, 0, bpNo, 0);
92 * Is this method used anywhere?
95 public void requestDBGVersion () throws IOException {
96 PHPDBGPacket DBGPacket; // A DBG message packet
97 PHPDBGFrame DBGFrame; // A frame within a DBG packet
99 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_REQUEST); // A request for DBG
100 DBGFrame = new PHPDBGFrame (PHPDBGBase.FRAME_VER); // We want the version of DBG
102 DBGPacket.addFrame (DBGFrame); // Add the 'what we want' to the DBG packet
104 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
108 DBGPacket.sendPacket (os); // Send the request to DBG
112 * Called by the proxy
115 public void getSourceTree () throws IOException {
116 PHPDBGPacket DBGPacket; // A DBG message packet
117 PHPDBGFrame DBGFrame; // A frame within a DBG packet
119 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_REQUEST); // A request for DBG
120 DBGFrame = new PHPDBGFrame (PHPDBGBase.FRAME_SRC_TREE); // We want a source tree from DBG
122 DBGPacket.addFrame (DBGFrame); // Add the 'what we want' to the DBG packet
124 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
128 DBGPacket.sendPacket (os); // Send the request to DBG
130 waitResponse (1000); // Wait for the DBG response (1 second)
131 flushAllPackets (); // Read and process the response from DBG
135 * Is this method called from anywhere?
137 * @param modName The modul (filename).
139 public void addDBGModName (String modName) throws IOException {
140 PHPDBGPacket DBGPacket; // A DBG message packet
141 PHPDBGFrame DBGFrame; // A frame within a DBG packet
143 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_REQUEST); // A request for DBG
144 DBGFrame = new PHPDBGFrame (PHPDBGBase.FRAME_RAWDATA); // We want Module name from DBG
146 rawCounter++; // Increment the rawData ID counter
147 DBGFrame.addInt (rawCounter); // FRAME_RAWDATA ID
148 DBGFrame.addInt (modName.length () + 1); // The length of rawdata string (incl. null char termination)
149 DBGFrame.addString (modName); // The file name (module name)
150 DBGFrame.addChar ('\0'); // Add the C-String null termination
152 DBGPacket.addFrame (DBGFrame);
154 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
158 DBGPacket.sendPacket (os);
162 * This method is called for adding or removing breakpoints.
164 * @param mod_name The module name (file name).
165 * @param condition Info about the condition when to break (not used at the moment).
166 * @param line The breakpoints line.
167 * @param state Info whether this breakpoint has to be dis- or enabled.
168 * @param istep Always 0.
169 * @param hitcount Always 0.
170 * @param skiphits Always 0.
171 * @param bpno The breakpoint ID.
172 * @param isunderhit ???
175 private int setBreakpoint (String mod_name, String condition, int line, int state, int istemp, int hitcount, int skiphits, int bpno, int isunderhit) throws IOException {
176 PHPDBGPacket DBGPacket;
177 PHPDBGFrame DBGFrame1;
178 PHPDBGFrame DBGFrame2;
181 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_REQUEST);
182 DBGFrame1 = new PHPDBGFrame (PHPDBGBase.FRAME_BPS);
183 DBGFrame2 = new PHPDBGFrame (PHPDBGBase.FRAME_RAWDATA);
185 modNo = getModByName (mod_name); // Get the module ID by name
187 if (modNo >= 0) { // Did we find a module ID for the module name?
188 DBGFrame1.addInt (modNo); // Add the module ID to frame 1
190 DBGFrame1.addInt (0); // mod number (0 use file name)
193 DBGFrame1.addInt (line); // line number
195 if (modNo >= 0) { // Did we find a module ID for the module name?
196 DBGFrame1.addInt (0); // use mod number
199 DBGFrame1.addInt (rawCounter); // ID of FRAME_RAWDATA to send file name
202 DBGFrame1.addInt (state); // state BPS_*
203 DBGFrame1.addInt (istemp); // istep
204 DBGFrame1.addInt (hitcount); // hit count
205 DBGFrame1.addInt (skiphits); // skip hits
206 DBGFrame1.addInt (0); // ID of condition
207 DBGFrame1.addInt (bpno); // breakpoint number
208 DBGFrame1.addInt (isunderhit); // is under hit
210 if (modNo < 0) { // Did we find a module ID for the module name?
211 DBGFrame2.addInt (rawCounter); // FRAME_RAWDATA ID
212 DBGFrame2.addInt (mod_name.length() + 1); // length of rawdata (+ null char)
213 DBGFrame2.addString (mod_name); // file name
214 DBGFrame2.addChar ('\0'); // null char
216 DBGPacket.addFrame (DBGFrame2); // First add file name data
219 DBGPacket.addFrame (DBGFrame1); // Second add command data
221 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
225 DBGPacket.sendPacket (os); // Send the request to DBG
229 waitResponse (1000); // Wait for the DBG response (1 second)
230 flushAllPackets (); // Read and process the response from DBG
232 return LastBPRead[8]; // Return what ???
238 private void clearLastBP () {
241 for (i = 0; i < LastBPRead.length; i++) {
249 private void copyToLastBP (int[] BPBody) {
252 for (i = 0; i < LastBPRead.length; i++) {
253 LastBPRead[i] = BPBody[i];
260 public void continueExecution () throws IOException {
261 PHPDBGPacket DBGPacket;
264 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_CONTINUE);
266 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
270 DBGPacket.sendPacket (os); // Send the request to DBG
272 lastCommand = PHPDBGBase.DBGA_CONTINUE; // Store the info about the command we sent
278 public void pauseExecution () throws IOException {
279 PHPDBGPacket DBGPacket;
281 DBGPacket = new PHPDBGPacket (PHPDBGBase.IntToChar4 (PHPDBGBase.DBGC_PAUSE));
283 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
287 DBGPacket.sendPacket (os); // Send the request to DBG
293 private int getBPUnderHit () {
296 int[] dbg_bpl_body = new int[10];
298 for (i = 0; i < DBGBPList.size (); i++) { // look for bp under hit
299 dbg_bpl_body = (int[]) DBGBPList.get (i);
301 if (dbg_bpl_body[9] == 1) {
302 BPUnder = dbg_bpl_body[8];
309 public int getLastCmd()
319 public void setLastCmd (int cmd)
327 public void stepInto () throws IOException {
328 PHPDBGPacket DBGPacket;
331 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_STEPINTO);
333 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
337 DBGPacket.sendPacket (os); // Send the request to DBG
339 lastCommand = PHPDBGBase.DBGA_STEPINTO; // Store the info about the command we sent
345 public void stepOver () throws IOException {
346 PHPDBGPacket DBGPacket;
349 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_STEPOVER);
351 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
355 DBGPacket.sendPacket (os); // Send the request to DBG
357 lastCommand = PHPDBGBase.DBGA_STEPOVER; // Store the info about the command we sent
363 public void stepOut () throws IOException {
364 PHPDBGPacket DBGPacket;
367 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_STEPOUT);
369 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
373 DBGPacket.sendPacket (os); // Send the request to DBG
375 lastCommand = PHPDBGBase.DBGA_STEPOUT; // Store the info about the command we sent
381 public void stopExecution () throws IOException {
382 PHPDBGPacket DBGPacket;
385 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_STOP);
387 if (proxy.getSocket ().isClosed ()) { // Can we communiate with DBG?
391 DBGPacket.sendPacket (os); // Send the request to DBG
395 * This method is called by the proxy.
396 * It sends a request to DBG to get the current variables
397 * with their values. It waits for the response and processes
398 * the input from DBG.
400 * @param stack The stackframe for which we want the variables.
401 * @return The array of variables
403 public Vector getVariables (PHPStackFrame stack) throws IOException, DebugException {
404 PHPDBGPacket DBGPacket;
405 PHPDBGFrame DBGFrame1;
406 PHPDBGEvalString evalStr;
408 DBGPacket = new PHPDBGPacket (PHPDBGBase.DBGA_REQUEST); //
409 DBGFrame1 = new PHPDBGFrame (PHPDBGBase.FRAME_EVAL); //
411 DBGFrame1.addInt (0); // istr = raw data ID
412 DBGFrame1.addInt (1); // scope_id = -1 means current location, 0 never used, +1 first depth
414 DBGPacket.addFrame (DBGFrame1); // Add command data
416 if (proxy.getSocket ().isClosed ()) { // Do we have a socket for DBG communication?
417 return null; // No, then leave here
420 DBGPacket.sendPacket (os); // Send the request to DBG
422 waitResponse (1000); // Wait for the DBG response (1 second)
423 flushAllPackets (); // Read and process the response from DBG
425 evalStr = new PHPDBGEvalString (stack, serGlobals); // Process serialized variables
426 DBGVarList = evalStr.getVariables ();
428 if (DBGVarList.size () > 0) { // Did we get back variables?
429 PHPVariable var = (PHPVariable) DBGVarList.get (0); // Yes, then get the first PHPVariable
430 PHPValue val = (PHPValue) var.getValue (); // Get the value
432 if (var.getName ().equals ("")) { // Is the root node an empty node (usually it is)
433 DBGVarList = val.getChildVariables (); // Then remove the empty node.
434 // With removing the empty root node, it wouldn't be necessary to
435 // set the name to an empty string. So the code below is just for
436 // info or in case the users want to have the empty root node.
438 // The eclipse variable view cannot handle Variables which have an empty name
439 // when it comes to variable tree restore operation. Without a name, no restore!
440 var.setName (" "); // Give a name to the variable root node. Even if it is only a space :-)
441 } // TODO the best would be to remove the empty root node, but this would
442 // require a understanding and reworking of the PHPDBGEvalstring class.
445 return DBGVarList; // Return the variables as list
452 public void log(String logString) throws IOException, DebugException {
453 PHPDBGPacket DBGPacket= new PHPDBGPacket(PHPDBGBase.DBGA_REQUEST);
454 PHPDBGFrame DBGFrame1= new PHPDBGFrame(PHPDBGBase.FRAME_LOG);
455 PHPDBGFrame DBGFrame2= new PHPDBGFrame(PHPDBGBase.FRAME_RAWDATA);
458 DBGFrame1.addInt(rawCounter); // ilog
459 DBGFrame1.addInt(1); // type
460 DBGFrame1.addInt(0); // mod_no
461 DBGFrame1.addInt(0); // line_no
462 DBGFrame1.addInt(0); // imod_name
463 DBGFrame1.addInt(0); // ext_info
465 DBGFrame2.addInt(rawCounter); // FRAME_RAWDATA ID
466 DBGFrame2.addInt(logString.length() + 1); // length of rawdata (+ null char)
467 DBGFrame2.addString(logString); // log string
468 DBGFrame2.addChar('\0'); // null char
470 // Add raw data first
471 DBGPacket.addFrame(DBGFrame2);
473 DBGPacket.addFrame(DBGFrame1);
475 if (proxy.getSocket ().isClosed ()) { // Do we have a socket for DBG communication?
476 return; // No, then leave here
479 DBGPacket.sendPacket(os);
485 public PHPVariable[] evalBlock(PHPStackFrame stack, String evalString) throws IOException, DebugException {
486 PHPDBGPacket DBGPacket= new PHPDBGPacket(PHPDBGBase.DBGA_REQUEST);
487 PHPDBGFrame DBGFrame1= new PHPDBGFrame(PHPDBGBase.FRAME_EVAL);
488 PHPDBGFrame DBGFrame2= new PHPDBGFrame(PHPDBGBase.FRAME_RAWDATA);
491 DBGFrame1.addInt(rawCounter); // istr = raw data ID
492 DBGFrame1.addInt(1); // scope_id = -1 means current location, 0 never used, +1 first depth
494 DBGFrame2.addInt(rawCounter); // FRAME_RAWDATA ID
495 DBGFrame2.addInt(evalString.length() + 1); // length of rawdata (+ null char)
496 DBGFrame2.addString(evalString); // eval block
497 DBGFrame2.addChar('\0'); // null char
499 // Add raw data first
500 DBGPacket.addFrame(DBGFrame2);
502 DBGPacket.addFrame(DBGFrame1);
504 if (proxy.getSocket ().isClosed ()) { // Do we have a socket for DBG communication?
505 return null; // No, then leave here
507 DBGPacket.sendPacket(os);
512 PHPDBGEvalString evalStr=new PHPDBGEvalString(stack,evalRet);
514 return evalStr.getVars();
519 * Read and process everthing we got from DBG
521 public void flushAllPackets () throws IOException {
522 while (readResponse() != 0);
526 * Get the modules name by its number
528 * @param modNo The number (id) of the module
529 * @return The name of the module
531 public String getModByNo (int modNo) {
535 for (i = 0; i < DBGMods.size (); i++) { // For all the modules we have within the array
536 dbg_mod = (PHPDBGMod) DBGMods.get (i); // Get the module
538 if (dbg_mod.getNo () == modNo) { // Is the module from the array the module we want?
539 return dbg_mod.getName (); // Yes, return the name of the module
543 return ""; // If nothing was found return emtpy string
548 * @param modName The name of the module for which we want the ID
550 * - The ID of the module
551 * - -1 if nothing was found
553 private int getModByName (String modName) {
557 for (i = 0; i < DBGMods.size (); i++) { // For all the modules we have within the array
558 dbg_mod = (PHPDBGMod) DBGMods.get (i); // Get the module
560 if (dbg_mod.getName ().equalsIgnoreCase (modName)) { // Is the module from the array the module we want?
561 return dbg_mod.getNo (); // Yes, return the name of the module
565 return -1; // If nothing was found return -1
569 * Return the string for the given frame number
571 * @param framesInfo The buffer which is to read
572 * @param frameNo The frame number
575 private String getRawFrameData (char[] framesInfo, int frameNo) {
576 int nextFrame = 0; // The current read position within the buffer
577 int[] dbg_frame = new int[2]; // The two frame header numbers
579 while (nextFrame < framesInfo.length) { // As long we have something within the buffer
580 dbg_frame[0] = PHPDBGBase.Char4ToInt (framesInfo, nextFrame); // The frame type
581 dbg_frame[1] = PHPDBGBase.Char4ToInt (framesInfo, nextFrame + 4); // The frame size
583 nextFrame += 8; // The current read position
585 if (dbg_frame[1] == 0) { // If frame size is 0
586 return ""; // return an emtpy string
589 switch (dbg_frame[0]) { // Switch for the frame type
590 case PHPDBGBase.FRAME_RAWDATA: // The only frame type we are interrested in
591 if (frameNo == PHPDBGBase.Char4ToInt (framesInfo, nextFrame)) { // Is it correct number of the frame
594 toRead = PHPDBGBase.Char4ToInt (framesInfo, nextFrame + 4); // The size of the string
596 return String.copyValueOf (framesInfo, nextFrame + 8, toRead); // Copy frame content to String and return
601 nextFrame += dbg_frame[1]; // Go for the next frame (add the length of the current one)
604 return ""; // We did not found any FRAM_RAWDATA, so return an emtpy strin
609 * The stackList contains the currently read stackframes which were sent
610 * from DBG. The DBG interface holds a list of the active stack frames.
611 * This method replicates the 'static' stackframe list with the DBG stackframe list
612 * Replication is done in the following way:
614 * <li> It looks for new stackframes within the DBG stackframe list and
615 * adds them to the 'static' list.
616 * <li> It looks for stackframes within the 'static' list, and removes them
617 * from the 'static' list in case the do not appear within the DBG list.
618 * <li> It looks for stackframes which are already existent and replicates the
619 * line number and the index number.
620 * <li> At the end the 'static' stackfram list has to be sorted by the stackframes
624 * Removes the unused stackframes from the list, or adds stackframes which
625 * are not yet in the list.
630 private void updateStackFrameList (Vector stackList) {
633 PHPStackFrame stackFrameNew;
634 PHPStackFrame stackFrameOld;
635 PHPStackFrame[] newStackList;
637 for (i = 0; i < stackList.size (); i++) { // For all stackList entries
638 stackFrameNew = (PHPStackFrame) stackList.get(i);
640 for (n = 0; n < stackListOld.size (); n++) { // For all StackFrames in the StackFrame list
641 stackFrameOld = (PHPStackFrame) stackListOld.get (n); //
643 if (stackFrameNew.getDescription ().equals (stackFrameOld.getDescription ())) { // Did we find the sent stackframe within the list of old stackframes?
644 stackFrameOld.setLineNumber (stackFrameNew.getLineNumber ());
645 stackFrameOld.setIndex (stackFrameNew.getIndex ());
647 break; // Yes, then break;
651 if (n == stackListOld.size ()) { // Did not find the new stackframe within the list
652 stackListOld.add (stackFrameNew); // then add the new stackframe
656 // And now for removing unused stackframes from list
658 for (n = 0; n < stackListOld.size (); n++) { // For all StackFrames in the StackFrame list
659 stackFrameOld = (PHPStackFrame) stackListOld.get (n); //
661 for (i = 0; i < stackList.size (); i++) { // For all stackList entries
662 stackFrameNew = (PHPStackFrame) stackList.get (i);
664 if (stackFrameNew.getDescription ().equals (stackFrameOld.getDescription ())) { // Did we find the sent stackframe within the list of old stackframes?
665 break; // Yes, then break;
669 if (i == stackList.size ()) { // Did not find the old stackframe within the list of new ones
670 stackListOld.remove (n); // then remove the old stackframe from list
671 n -= 1; // Adjust the stack list index
675 Collections.sort (stackListOld); // Sort the 'static' stackframe list by the stackframe index numbers.
677 newStackList = new PHPStackFrame[stackListOld.size ()];
678 newStackList = (PHPStackFrame[]) stackListOld.toArray (newStackList);
679 DBGStackList = newStackList;
683 * Read the response from DBG and process the frame
686 * - The received command
687 * - or 0 if something was wrong
689 public int readResponse () throws IOException {
690 int bytesToRead = 0; // The number of byte to read for the current DBG block
691 int nextFrame = 0; // The current read position within entirePack
695 boolean errorStack = false;
696 char[] dbg_header_struct_read = new char[16]; // The buffer for the first 16 bytes of a block
697 int[] dbg_header_struct = new int[4]; // The first four numbers (long) of a block
698 int[] dbg_bpl_tmp = new int[10];
699 int[] dbg_frame = new int[2];
700 int[] dbg_eval_tmp = new int[3];
701 int[] dbg_src_tree_tmp = new int[4]; //
702 int[] dbg_error_tmp = new int[2];
703 Vector rawList = new Vector();
704 Vector stackList = new Vector(); // Intermediate stacklist which is build up in FRAME_STACK frame
710 while (readInput (dbg_header_struct_read, 16) != 0) { // Read 16 byte from input stream
711 dbg_header_struct[0] = PHPDBGBase.Char4ToInt (dbg_header_struct_read, 0); // Debug sync header
712 dbg_header_struct[1] = PHPDBGBase.Char4ToInt (dbg_header_struct_read, 4); // Command
713 dbg_header_struct[2] = PHPDBGBase.Char4ToInt (dbg_header_struct_read, 8); //
714 dbg_header_struct[3] = PHPDBGBase.Char4ToInt (dbg_header_struct_read, 12); // Bytes within this block
716 if (dbg_header_struct[0] != 0x5953) { // Check DBG sync bytes
717 return 0; // Wrong header
720 cmdReceived = dbg_header_struct[1]; // Get the command
721 setLastCmd (cmdReceived); // Store the info about the current command
722 bytesToRead = dbg_header_struct[3]; // Get the number of bytes to read for this block
724 //System.out.println("Response Received: " + cmdReceived);
725 char[] entirePack = new char[bytesToRead]; // Store the block data into buffer 'entirePack'
727 if (bytesToRead > 0) { // If there is something within the frame
728 if (readInput (entirePack, bytesToRead) < bytesToRead) { // Read the frame into the buffer
729 return 0; // We did not read enough bytes, error
733 nextFrame = 0; // Start with the first frame
735 while (nextFrame < bytesToRead) { // As long as we have something within this block
736 dbg_frame[0] = PHPDBGBase.Char4ToInt (entirePack, nextFrame); // The name of the frame
737 dbg_frame[1] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 4); // The size of the frame
738 nextFrame += 8; // The next read position
740 if (dbg_frame[1] == 0) { // Something within the frame?
741 return 0; // Nothing to read, error
744 switch (dbg_frame[0]) {
745 case PHPDBGBase.FRAME_STACK:
746 int[] dbg_stack_new = new int[4]; //
748 dbg_stack_new[0] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 0); // Source line number
749 dbg_stack_new[1] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 4); // Module number
750 dbg_stack_new[2] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 8); // Scope id
751 dbg_stack_new[3] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 12); // ID of description string
753 if ((dbg_stack_new[1] != 0) && !errorStack) {
754 PHPStackFrame newStack;
757 newStack = new PHPStackFrame (null, // The thread
758 getModByNo (dbg_stack_new[1]), // The name of the module (file)
759 dbg_stack_new[0], // The source line number
761 getRawFrameData (entirePack, // Get the string from this packet
762 dbg_stack_new[3]), // The frame ID for which we want the string
763 dbg_stack_new[1]); // The module number
764 stackList.add (newStack);
770 case PHPDBGBase.FRAME_SOURCE: // Nothing to be done here
771 break; // TODO: what's with that frame? Something interesting
773 case PHPDBGBase.FRAME_SRC_TREE: //
774 dbg_src_tree_tmp[0] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 0); // The parent module number
775 dbg_src_tree_tmp[1] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 4); // The parent line number (not used)
776 dbg_src_tree_tmp[2] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 8); // The module number
777 dbg_src_tree_tmp[3] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 12); // The filename number
779 if (getModByNo (dbg_src_tree_tmp[2]).equals ("")) {
782 fileName = new String (getRawFrameData (entirePack, dbg_src_tree_tmp[3])); // Get the filename
784 if (fileName.length () > 0) { // If we have a filename
785 fileName = fileName.substring (0, fileName.length () - 1); // Remove '\0' char
788 if (dbg_src_tree_tmp[2] != 0) { // If there is a module number
791 modNew = new PHPDBGMod (dbg_src_tree_tmp[2], fileName); // Create a module object
793 DBGMods.add (modNew); // And store it to array
798 case PHPDBGBase.FRAME_RAWDATA: // Nothing to be done here
799 break; // FRAME_RAWDATA are processed within getRawFrameData
801 case PHPDBGBase.FRAME_ERROR: // An error frame
802 errorStack = true; // Yes, we have an error stack
803 dbg_error_tmp[0] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 0); // Error type
804 dbg_error_tmp[1] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 4); // Error message ID
806 String error = "\n"; //
808 switch (dbg_error_tmp[0]) { // Switch on error type
809 case PHPDBGBase.E_ERROR: error += "[Error]"; break;
810 case PHPDBGBase.E_WARNING: error += "[Warning]"; break;
811 case PHPDBGBase.E_PARSE: error += "[Parse Error]"; break;
812 case PHPDBGBase.E_NOTICE: error += "[Notice]"; break;
813 case PHPDBGBase.E_CORE_ERROR: error += "[Core Error]"; break;
814 case PHPDBGBase.E_CORE_WARNING: error += "[Core Warning]"; break;
815 case PHPDBGBase.E_COMPILE_ERROR: error += "[Compile Error]"; break;
816 case PHPDBGBase.E_COMPILE_WARNING: error += "[Compile Warning]"; break;
817 case PHPDBGBase.E_USER_ERROR: error += "[User Error]"; break;
818 case PHPDBGBase.E_USER_WARNING: error += "[User Warning]"; break;
819 case PHPDBGBase.E_USER_NOTICE: error += "[User Notice]"; break;
820 default: error += "[Unexpected Error]"; break;
824 error += new String (getRawFrameData (entirePack, dbg_error_tmp[1])); // Add the error string for this error message ID
826 if (error.length () > 0) { // If we have a error message
827 error = error.substring (0, error.length () - 1); // Remove '\0' char
830 error += "\n"; // Append a CR
832 PHPDebugCorePlugin.log (new DebugException (new Status (IStatus.WARNING,
833 PHPDebugCorePlugin.PLUGIN_ID,
837 // To print errors on the console, I must execute a code in the
838 // php context, that write the stderr... I didn't found a better way
839 // TODO: Find a better way????
841 // String codeExec= "";
842 // codeExec= "fwrite(fopen('php://stderr', 'w'),\\\"" + error + "\\\");";
844 // evalBlock("eval(\"" + codeExec + "\");");
845 // } catch (DebugException e) {
846 // PHPDebugCorePlugin.log(e);
849 if (!stopOnError) { // Is always false (Did not see where this is set to true!?)
850 if (lastCommand.equals (PHPDBGBase.DBGA_CONTINUE)) { // If last command for PHP was a 'continue',
851 continueExecution (); // send continue again
852 } else if (lastCommand.equals (PHPDBGBase.DBGA_STEPINTO)) { // If last command for PHP was a 'step into',
853 stepInto (); // send 'step into' again
854 } else if (lastCommand.equals (PHPDBGBase.DBGA_STEPOUT)) { // If last command for PHP was a 'step out',
855 stepOut (); // send 'step out' again
856 } else if (lastCommand.equals (PHPDBGBase.DBGA_STEPOVER)) { // If last command for PHP was a 'step over',
857 stepOver (); // send 'step over' again
862 case PHPDBGBase.FRAME_EVAL:
865 evalString = new String ("");
866 dbg_eval_tmp[0] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 0); // istr
867 dbg_eval_tmp[1] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 4); // iresult
868 dbg_eval_tmp[2] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 8); // ierror
870 evalRet = getRawFrameData (entirePack, dbg_eval_tmp[1]); //
871 evalString = getRawFrameData (entirePack, dbg_eval_tmp[0]); //
872 serGlobals = evalRet; //
875 case PHPDBGBase.FRAME_BPS: //
878 case PHPDBGBase.FRAME_BPL:
881 dbg_bpl_new = new int[10];
882 dbg_bpl_new[0] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 0);
883 dbg_bpl_new[1] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 4);
884 dbg_bpl_new[2] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 8);
885 dbg_bpl_new[3] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 12);
886 dbg_bpl_new[4] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 16);
887 dbg_bpl_new[5] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 20);
888 dbg_bpl_new[6] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 24);
889 dbg_bpl_new[7] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 28);
890 dbg_bpl_new[8] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 32);
891 dbg_bpl_new[9] = PHPDBGBase.Char4ToInt (entirePack, nextFrame + 36);
893 // look if breakpoint already exists in vector
894 for (i = 0; i < DBGBPList.size (); i++) {
895 dbg_bpl_tmp = (int[]) DBGBPList.get (i);
897 if (dbg_bpl_tmp[8] == dbg_bpl_new[8]) {
898 DBGBPList.remove (i);
904 // add breakpoint to vector
905 DBGBPList.add (dbg_bpl_new);
906 copyToLastBP (dbg_bpl_new);
909 if (getModByNo (dbg_bpl_new[0]).equals ("")) {
912 fileName = new String (getRawFrameData (entirePack, dbg_bpl_new[2]));
914 if (fileName.length () > 0) { // If we have filename
915 fileName = fileName.substring (0, fileName.length () - 1); // Remove '\0' char
918 if (dbg_bpl_new[0] != 0) {
921 modNew = new PHPDBGMod (dbg_bpl_new[0], fileName);
923 DBGMods.add (modNew);
928 case PHPDBGBase.FRAME_VER:
931 case PHPDBGBase.FRAME_SID:
932 sid = PHPDBGBase.Char4ToInt(entirePack, nextFrame + 0);
935 case PHPDBGBase.FRAME_SRCLINESINFO:
938 case PHPDBGBase.FRAME_SRCCTXINFO:
941 case PHPDBGBase.FRAME_LOG:
944 case PHPDBGBase.FRAME_PROF:
947 case PHPDBGBase.FRAME_PROF_C:
950 case PHPDBGBase.FRAME_SET_OPT:
954 nextFrame += dbg_frame[1]; // go to next frame
957 // Now process command
958 switch(cmdReceived) {
959 case PHPDBGBase.DBGC_REPLY:
962 case PHPDBGBase.DBGC_STARTUP:
965 case PHPDBGBase.DBGC_END:
969 case PHPDBGBase.DBGC_BREAKPOINT:
970 BPUnderHit = getBPUnderHit ();
971 updateStackFrameList (stackList);
974 case PHPDBGBase.DBGC_STEPINTO_DONE:
975 case PHPDBGBase.DBGC_STEPOVER_DONE:
976 case PHPDBGBase.DBGC_STEPOUT_DONE:
977 case PHPDBGBase.DBGC_EMBEDDED_BREAK:
978 case PHPDBGBase.DBGC_PAUSE:
980 updateStackFrameList (stackList);
983 case PHPDBGBase.DBGC_ERROR:
985 updateStackFrameList (stackList);
988 case PHPDBGBase.DBGC_LOG:
991 case PHPDBGBase.DBGC_SID:
996 return cmdReceived; // Return the command we received with this block
1003 public PHPStackFrame[] getStackList() {
1004 return DBGStackList;
1008 * Reads from input buffer (response sent from DBG) the given number of chars
1009 * into frame buffer.
1011 * @param buffer The frame buffer where to store the read data from DBG.
1012 * @param bytes The number of bytes (chars) which are to read from input stream.
1013 * @return The number of bytes actually read.
1015 private int readInput (char[] buffer, int bytes) throws IOException {
1016 int bytesRead = 0; // Reset the bytes read counter
1018 for (int i = 0; i < bytes; i++) { // For the number of bytes we should read
1019 if (in.ready ()) { // If input stream is ready for reading
1020 buffer[i] = (char) (in.read () & 0x00FF); // Read a char and store only the least significant 8-bits
1021 bytesRead++; // Increment the bytes read counter
1023 else { // Input stream is not ready
1024 break; // Break the loop
1028 return bytesRead; // Return the number of bytes actually read
1032 * PHPProxy could stop the waiting for a response with this method.
1035 public void setShouldStop () {
1036 this.shouldStop = true;
1040 * @param milliseconds The maximum time in milliseconds we wait for something
1041 * to be send from DBG.
1042 * @return - true if something was received from DBG
1043 * - false if nothing was send from DBG within the given time
1046 public boolean waitResponse (long milliseconds) throws IOException {
1049 timeout = System.currentTimeMillis () + milliseconds; // Calculate the system time till we wait.
1051 while (System.currentTimeMillis () < timeout) { // Is waiting time running out?
1052 if (in.ready () || shouldStop) { // No, so did we get something or should we stop now
1053 break; // Yes, break the waiting
1057 return in.ready (); // true if we got something from DBG