/// <summary> /// Constructor. /// </summary> /// <param name="processGuid"> The hosting process. </param> /// <param name="engineGuid"> The GUID of the VSNDK debug engine. </param> public AD7ProgramNodeAttach(AD7Process proc, Guid engineGuid) { m_process = proc; m_processGuid = proc._processGUID; m_programID = proc._processID; m_exePath = proc._name; do { m_exePath = m_exePath.Replace("\\\\", "\\"); }while (m_exePath.IndexOf("\\\\") != -1); int i = proc._name.LastIndexOf('\\'); if ((i != -1) && (i < (proc._name.Length - 1))) { m_programName = proc._name.Substring(i + 1); } else { m_programName = proc._name; } m_engineGuid = engineGuid; }
public EventDispatcher(AD7Engine engine, AD7Process process) { m_engine = engine; m_process = process; m_gdbOutput = new GDBOutput(this); m_processingThread = new Thread(m_gdbOutput.processingGDBOutput); m_processingThread.Start(); // myWriter = new TextWriterTraceListener(System.Console.Out); // Debug.Listeners.Add(myWriter); }
/// <summary> /// Constructor. /// </summary> /// <param name="processGuid"> The hosting process. </param> /// <param name="engineGuid"> The GUID of the VSNDK debug engine. </param> public AD7ProgramNodeAttach(AD7Process proc, Guid engineGuid) { m_process = proc; m_processGuid = proc._processGUID; m_programID = proc._processID; m_exePath = proc._name; do { m_exePath = m_exePath.Replace("\\\\", "\\"); } while (m_exePath.IndexOf("\\\\") != -1); int i = proc._name.LastIndexOf('\\'); if ((i != -1) && (i < (proc._name.Length - 1))) m_programName = proc._name.Substring(i + 1); else m_programName = proc._name; m_engineGuid = engineGuid; }
/// <summary> /// Gets the list of processes running on this port. /// </summary> /// <returns> Returns the list of processes running on this port. </returns> IEnumerable <AD7Process> GetProcesses() { IDebugCoreServer2 server = null; if (m_processes.Count() != 0) { foreach (AD7Process p in m_processes) { AD7ProcessDestroyEvent ev = new AD7ProcessDestroyEvent(); SendEvent(server, this, p, null, ev, ev.getGuid()); } m_processes.Clear(); } string publicKeyPath = Environment.GetEnvironmentVariable("AppData") + @"\BlackBerry\bbt_id_rsa.pub"; string response = GDBParser.GetPIDsThroughGDB(m_IP, m_password, m_isSimulator, m_toolsPath, publicKeyPath, 7); if ((response == "TIMEOUT!") || (response.IndexOf("1^error,msg=", 0) != -1)) //found an error { if (response == "TIMEOUT!") // Timeout error, normally happen when the device is not connected. { MessageBox.Show("Please, verify if the Device/Simulator IP in \"BlackBerry -> Settings\" menu is correct and check if it is connected.", "Device/Simulator not connected or not configured properly", MessageBoxButtons.OK, MessageBoxIcon.Warning); } else if (response[29] == ':') // error: 1^error,msg="169.254.0.3:8000: The requested address is not valid in its context." { string txt = response.Substring(13, response.IndexOf(':', 13) - 13) + response.Substring(29, response.IndexOf('"', 31) - 29); string caption = ""; if (txt.IndexOf("The requested address is not valid in its context.") != -1) { txt += "\n\nPlease, verify the BlackBerry device/simulator IP settings."; caption = "Invalid IP"; } else { txt += "\n\nPlease, verify if the device/simulator is connected."; caption = "Connection failed"; } MessageBox.Show(txt, caption, MessageBoxButtons.OK, MessageBoxIcon.Warning); } response = ""; } else if (response.Contains("^done")) { response = response.Remove(response.IndexOf("^done")); string[] tempListOfProcesses = response.Split('\n'); int ind = (response[0] == '&') ? 1 : 0; // ignore the first if it starts with & (&"info pidlist") while (ind < tempListOfProcesses.Length - 1) { string process = tempListOfProcesses[ind]; int pos = process.LastIndexOf('/'); if (pos == -1) { ind++; continue; } process = process.Remove(pos).Substring(2); for (ind = ind + 1; ind < tempListOfProcesses.Length - 1; ind++) // ignore the duplicates { int pos2 = tempListOfProcesses[ind].LastIndexOf('/'); if ((pos2 <= 2) || (tempListOfProcesses[ind].Substring(2, pos2 - 2) != process)) { break; } } AD7Process proc = new AD7Process(this, process.Substring(process.IndexOf("- ") + 2), process.Remove(process.IndexOf(" "))); m_processes.Add(proc); AD7ProcessCreateEvent ev = new AD7ProcessCreateEvent(); SendEvent(server, this, proc, null, ev, ev.getGuid()); } } return(m_processes); }
/// <summary> /// Called by the SDM to indicate that a synchronous debug event, previously sent by the DE to the SDM, /// was received and processed. The only event the VSNDK Debug Engine sends in this fashion is Program Destroy. /// It responds to that event by shutting down the engine. (http://msdn.microsoft.com/en-us/library/bb160915.aspx) /// </summary> /// <param name="eventObject"> Represents the previously sent synchronous event from which the debugger should now continue. </param> /// <returns> If successful, returns S_OK; otherwise, returns an error code. </returns> int IDebugEngine2.ContinueFromSynchronousEvent(IDebugEvent2 eventObject) { try { if (eventObject is AD7ProgramDestroyEvent) { resetStackFrames(); m_process.Detach(); m_process = null; m_program.Detach(); m_program = null; m_engineCallback = null; m_breakpointManager = null; m_docContext = null; m_eventDispatcher = null; m_module = null; m_progNode = null; m_programGUID = Guid.Empty; m_threads = null; GC.Collect(); } else { Debug.Fail("Unknown synchronous event"); } } catch (Exception e) { return EngineUtils.UnexpectedException(e); } if (m_eventDispatcher != null) m_eventDispatcher.continueExecution(); return VSConstants.S_OK; }
/// <summary> /// Attach the debug engine to a program. (http://msdn.microsoft.com/en-us/library/bb145136.aspx) /// </summary> /// <param name="rgpPrograms"> Represent programs to be attached to. These are port programs. </param> /// <param name="rgpProgramNodes"> Represent program nodes, one for each program. The program nodes in this array represent /// the same programs as in pProgram. The program nodes are given so that the DE can identify the programs to attach to. </param> /// <param name="aCeltPrograms"> Number of programs and/or program nodes in the pProgram and rgpProgramNodes arrays. </param> /// <param name="ad7Callback"> The IDebugEventCallback2 object to be used to send debug events to the SDM. </param> /// <param name="dwReason"> A value from the ATTACH_REASON enumeration that specifies the reason for attaching these programs. </param> /// <returns> If successful, returns S_OK; otherwise, returns an error code. </returns> int IDebugEngine2.Attach(IDebugProgram2[] rgpPrograms, IDebugProgramNode2[] rgpProgramNodes, uint aCeltPrograms, IDebugEventCallback2 ad7Callback, enum_ATTACH_REASON dwReason) { if (aCeltPrograms != 1) { System.Diagnostics.Debug.Fail("VSNDK Debugger only supports one debug target at a time."); throw new ArgumentException(); } try { EngineUtils.RequireOk(rgpPrograms[0].GetProgramId(out m_programGUID)); m_program = rgpPrograms[0]; // It is NULL when the user attached the debugger to a running process (by using Attach to Process UI). When that // happens, some objects must be instantiated, as well as GDB must be launched. Those ones are instantiated/launched // by LaunchSuspended and ResumeProcess methods when debugging an open project. if (this.m_engineCallback == null) { VSNDK.Package.ControlDebugEngine.isDebugEngineRunning = true; m_engineCallback = new EngineCallback(this, ad7Callback); AD7ProgramNodeAttach pnt = (AD7ProgramNodeAttach)m_program; m_process = pnt.m_process; AD7Port port = pnt.m_process._portAttach; string publicKeyPath = Environment.GetEnvironmentVariable("AppData") + @"\BlackBerry\bbt_id_rsa.pub"; string progName = pnt.m_programName.Substring(pnt.m_programName.LastIndexOf('/') + 1); string exePath = ""; string processesPaths = ""; System.IO.StreamReader readProcessesPathsFile = null; // Read the file ProcessesPath.txt to try to get the file location of the executable file. try { readProcessesPathsFile = new System.IO.StreamReader(System.Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData) + @"\Research In Motion\ProcessesPath.txt"); processesPaths = readProcessesPathsFile.ReadToEnd(); readProcessesPathsFile.Close(); } catch (Exception e) { processesPaths = ""; } string searchProgName = progName + "_" + port.m_isSimulator; int begin = processesPaths.IndexOf(searchProgName + ":>"); if (begin != -1) { begin += searchProgName.Length + 2; int end = processesPaths.IndexOf("\r\n", begin); exePath = processesPaths.Substring(begin, end - begin) + progName; } else { exePath = "CannotAttachToRunningProcess"; } exePath = exePath.Replace("\\", "\\\\\\\\"); if (GDBParser.LaunchProcess(pnt.m_programID, exePath, port.m_IP, port.m_isSimulator, port.m_toolsPath, publicKeyPath, port.m_password)) { if (exePath == "CannotAttachToRunningProcess") { MessageBox.Show(progName + " is attached to the debugger. However, to be able to debug your application, you must build and deploy it from this computer first.", "No executable file with symbols found.", MessageBoxButtons.OK, MessageBoxIcon.Warning); } m_eventDispatcher = new EventDispatcher(this); m_module = new AD7Module(); m_progNode = new AD7ProgramNode(m_process._processGUID, m_process._processID, exePath, new Guid(AD7Engine.Id)); AddThreadsToProgram(); } else { GDBParser.exitGDB(); VSNDK.Package.ControlDebugEngine.isDebugEngineRunning = false; return VSConstants.E_FAIL; } } AD7EngineCreateEvent.Send(this); AD7ProgramCreateEvent.Send(this); AD7ModuleLoadEvent.Send(this, m_module, true); AD7LoadCompleteEvent.Send(this, currentThread()); // If the reason for attaching is ATTACH_REASON_LAUNCH, the DE needs to send the IDebugEntryPointEvent2 event. // See http://msdn.microsoft.com/en-us/library/bb145136%28v=vs.100%29.aspx if (dwReason == enum_ATTACH_REASON.ATTACH_REASON_LAUNCH) { AD7EntryPointEvent ad7Event = new AD7EntryPointEvent(); Guid riidEvent = new Guid(AD7EntryPointEvent.IID); uint attributes = (uint)enum_EVENTATTRIBUTES.EVENT_STOPPING | (uint)enum_EVENTATTRIBUTES.EVENT_SYNCHRONOUS; int rc = ad7Callback.Event(this, null, m_program, currentThread(), ad7Event, ref riidEvent, attributes); Debug.Assert(rc == VSConstants.S_OK); } } catch (Exception e) { return EngineUtils.UnexpectedException(e); } return VSConstants.S_OK; }
/// <summary> /// Launches a process by means of the debug engine. (http://msdn.microsoft.com/en-us/library/bb146223.aspx) /// </summary> /// <param name="pszServer"> The name of the machine in which to launch the process. Use a null value to specify the local /// machine. Or it should be the name of the server? </param> /// <param name="port"> The IDebugPort2 interface representing the port that the program will run in. </param> /// <param name="exe"> The name of the executable to be launched. </param> /// <param name="args"> The arguments to pass to the executable. May be a null value if there are no arguments. </param> /// <param name="dir"> The name of the working directory used by the executable. May be a null value if no working directory is /// required. </param> /// <param name="env"> Environment block of NULL-terminated strings, followed by an additional NULL terminator. </param> /// <param name="options"> The options for the executable. </param> /// <param name="launchFlags"> Specifies the LAUNCH_FLAGS for a session. </param> /// <param name="hStdInput"> Handle to an alternate input stream. May be 0 if redirection is not required. </param> /// <param name="hStdOutput"> Handle to an alternate output stream. May be 0 if redirection is not required. </param> /// <param name="hStdError"> Handle to an alternate error output stream. May be 0 if redirection is not required. </param> /// <param name="ad7Callback"> The IDebugEventCallback2 object that receives debugger events. </param> /// <param name="process"> Returns the resulting IDebugProcess2 object that represents the launched process. </param> /// <returns> If successful, returns S_OK; otherwise, returns an error code. </returns> int IDebugEngineLaunch2.LaunchSuspended(string pszServer, IDebugPort2 port, string exe, string args, string dir, string env, string options, enum_LAUNCH_FLAGS launchFlags, uint hStdInput, uint hStdOutput, uint hStdError, IDebugEventCallback2 ad7Callback, out IDebugProcess2 process) { Debug.Assert(m_programGUID == Guid.Empty); process = null; try { VSNDK.Package.ControlDebugEngine.isDebugEngineRunning = true; m_engineCallback = new EngineCallback(this, ad7Callback); // Read arguments back from the args string var nvc = new NameValueCollection(); NameValueCollectionHelper.LoadFromString(nvc, args); string pid = nvc.GetValues("pid")[0]; string exePath = exe; string targetIP = nvc.GetValues("targetIP")[0]; bool isSimulator = Convert.ToBoolean(nvc.GetValues("isSimulator")[0]); string toolsPath = nvc.GetValues("ToolsPath")[0]; string publicKeyPath = nvc.GetValues("PublicKeyPath")[0]; string password = null; string[] passwordArray = nvc.GetValues("Password"); if (passwordArray != null) password = passwordArray[0]; if (GDBParser.LaunchProcess(pid, exePath, targetIP, isSimulator, toolsPath, publicKeyPath, password)) { process = m_process = new AD7Process(this, port); m_eventDispatcher = new EventDispatcher(this); m_programGUID = m_process._processGUID; m_module = new AD7Module(); // m_progNode = new AD7ProgramNode(m_process.PhysID, pid, exePath, new Guid(AD7Engine.Id)); m_progNode = new AD7ProgramNode(m_process._processGUID, pid, exePath, new Guid(AD7Engine.Id)); AddThreadsToProgram(); AD7EngineCreateEvent.Send(this); return VSConstants.S_OK; } else { GDBParser.exitGDB(); VSNDK.Package.ControlDebugEngine.isDebugEngineRunning = false; return VSConstants.E_FAIL; } } catch (Exception e) { return EngineUtils.UnexpectedException(e); } }
/// <summary> /// Gets the list of processes running on this port. /// </summary> /// <returns> Returns the list of processes running on this port. </returns> IEnumerable<AD7Process> GetProcesses() { IDebugCoreServer2 server = null; if (m_processes.Count() != 0) { foreach (AD7Process p in m_processes) { AD7ProcessDestroyEvent ev = new AD7ProcessDestroyEvent(); SendEvent(server, this, p, null, ev, ev.getGuid()); } m_processes.Clear(); } string publicKeyPath = Environment.GetEnvironmentVariable("AppData") + @"\BlackBerry\bbt_id_rsa.pub"; string response = GDBParser.GetPIDsThroughGDB(m_IP, m_password, m_isSimulator, m_toolsPath, publicKeyPath, 7); if ((response == "TIMEOUT!") || (response.IndexOf("1^error,msg=", 0) != -1)) //found an error { if (response == "TIMEOUT!") // Timeout error, normally happen when the device is not connected. { MessageBox.Show("Please, verify if the Device/Simulator IP in \"BlackBerry -> Settings\" menu is correct and check if it is connected.", "Device/Simulator not connected or not configured properly", MessageBoxButtons.OK, MessageBoxIcon.Warning); } else if (response[29] == ':') // error: 1^error,msg="169.254.0.3:8000: The requested address is not valid in its context." { string txt = response.Substring(13, response.IndexOf(':', 13) - 13) + response.Substring(29, response.IndexOf('"', 31) - 29); string caption = ""; if (txt.IndexOf("The requested address is not valid in its context.") != -1) { txt += "\n\nPlease, verify the BlackBerry device/simulator IP settings."; caption = "Invalid IP"; } else { txt += "\n\nPlease, verify if the device/simulator is connected."; caption = "Connection failed"; } MessageBox.Show(txt, caption, MessageBoxButtons.OK, MessageBoxIcon.Warning); } response = ""; } else if (response.Contains("^done")) { response = response.Remove(response.IndexOf("^done")); string[] tempListOfProcesses = response.Split('\n'); int ind = (response[0] == '&') ? 1 : 0; // ignore the first if it starts with & (&"info pidlist") while (ind < tempListOfProcesses.Length - 1) { string process = tempListOfProcesses[ind]; int pos = process.LastIndexOf('/'); if (pos == -1) { ind++; continue; } process = process.Remove(pos).Substring(2); for (ind = ind + 1; ind < tempListOfProcesses.Length - 1; ind++) // ignore the duplicates { int pos2 = tempListOfProcesses[ind].LastIndexOf('/'); if ((pos2 <= 2) || (tempListOfProcesses[ind].Substring(2, pos2 - 2) != process)) break; } AD7Process proc = new AD7Process(this, process.Substring(process.IndexOf("- ") + 2), process.Remove(process.IndexOf(" "))); m_processes.Add(proc); AD7ProcessCreateEvent ev = new AD7ProcessCreateEvent(); SendEvent(server, this, proc, null, ev, ev.getGuid()); } } return m_processes; }