Process.h revision 24943d2ee8bfaa7cf5893e4709143924157a5c1e
124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//===-- Process.h -----------------------------------------------*- C++ -*-===// 224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// The LLVM Compiler Infrastructure 424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// This file is distributed under the University of Illinois Open Source 624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// License. See LICENSE.TXT for details. 724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//===----------------------------------------------------------------------===// 924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef liblldb_Process_h_ 1124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#define liblldb_Process_h_ 1224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// C Includes 1424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// C++ Includes 1524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include <list> 1624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Other libraries and framework includes 1824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Project includes 1924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/lldb-private.h" 2024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Broadcaster.h" 2124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Error.h" 2224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Event.h" 2324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/ThreadSafeValue.h" 2424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/ThreadSafeSTLMap.h" 2524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/PluginInterface.h" 2624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Breakpoint/BreakpointSiteList.h" 2724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 2824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ObjCObjectPrinter.h" 2924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ThreadList.h" 3024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/UnixSignals.h" 3124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 3324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 3524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 3624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 3724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 3824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 3924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 4024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 4124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 4224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public PluginInterface 4324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 4424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 4524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 4724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 4924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 5024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 5124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 5224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 5324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 5424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 5524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 5624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDERR = (1 << 3), 5724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 5824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 5924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 6024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 6124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 6224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 6324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 6424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 6524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 6624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 6724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 6824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 6924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 7024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 7124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 7224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 7324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 7424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 7524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 7624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 7724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 7824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 7924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 8024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 8124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 8224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 8324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 8424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 8524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 8624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 8724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 8824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 8924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 9024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 9124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 9224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 9324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 9424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 9524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 9624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 9724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessSP() const; 9824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 9924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 10024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState() const; 10124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 10224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 10324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestarted () const; 10424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 10524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 10624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 10724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 10824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 10924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 11024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 11124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 11224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 11324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 11424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 11524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 11624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 11724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 11824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 11924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 12024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 12124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 12224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 12324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 12424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 12524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 12624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 12724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 12824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 12924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 13024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 13124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 13224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 13324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval(); 13424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 13524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 13624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestarted (bool new_value); 13724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 13824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 13924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 14024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 14124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_update_state; 14224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 14324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 14424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 14524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 14624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 14724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 14824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 14924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 15124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 15224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 15424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 15524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 15624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 15724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 15924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 16024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 16124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 16224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 16324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 16424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 16524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 16624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 16724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 16824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 16924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 17024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 17124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 17224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 17324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 17424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 17524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 17624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 17724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 17824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 17924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static Process* 18024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner FindPlugin (Target &target, const char *plugin_name, Listener &listener); 18124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 18224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 18324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 18424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 18624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 18724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 18824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 18924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 19024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 19124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 19224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 19324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 19424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 19524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 19624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 19724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 19824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 19924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 20024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 20124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 20224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 20324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 20424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 20524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 20624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 20724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Each plug-in is given a chance to say wether it can debug 20824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 20924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 21024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 21124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 21224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 21324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 21424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 21524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 21624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CanDebug (Target &target) = 0; 21724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 21824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 21924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 22024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 22124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 22224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 22324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 22424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 22524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 22624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 22724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 22824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 22924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 23024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 23124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 23224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 23324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 23424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 23524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 23624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 23724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 23824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 23924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 24024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 24124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 24224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 24324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 24424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 24524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 24624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 24724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 24824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 24924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 25024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 25124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 25224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 25324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 25424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 25524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 25624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 25724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 25824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 25924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 26024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 26124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 26224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 26324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 26424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 26524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 26624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 26724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 26824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 26924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 27024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 27124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 27224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Launch (char const *argv[], 27324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *envp[], 27424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdin_path, 27524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdout_path, 27624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stderr_path); 27724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 27824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 27924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 28024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 28124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 28224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillAttach (lldb::pid_t) 28324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoAttach (lldb::pid_t) will 28424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 28524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 28624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 28724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 28824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 28924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 29024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 29124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 29224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 29324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 29424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 29524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (lldb::pid_t pid); 29624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 29824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process by process name. 29924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 30024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 30124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call 30224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::WillAttach (const char *) and if that returns \b 30324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, Process::DoAttach (const char *) will be called to 30424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// actually do the attach. If DoAttach returns \b true, then 30524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DidAttach() will be called. 30624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 30724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 30824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A process name to match against the current process list. 30924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 31024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 31124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 31224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 31324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 31424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 31524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (const char *process_name, bool wait_for_launch); 31624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 31724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 31824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetAddressByteSize(); 31924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 32124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 32224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 32324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 32424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 32524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 32624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 32724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 32824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 32924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 33024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 33124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 33224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 33324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 33424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 33524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 33624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 33724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 33824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 33924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 34024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 34124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 34224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 34324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 34424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 34524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 34624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 34724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 34824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 34924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 35024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 35124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 35224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 35324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 35424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 35524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 35624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 35724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 35824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 35924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 36024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 36124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 36224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 36324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 36424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 36524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 36624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 36724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 36824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 36924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 37024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 37124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 37224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 37324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 37424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 37524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 37624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 37724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 37824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 37924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 38024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 38124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 38224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 38324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 38424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 38524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 38624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 38724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 38824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 38924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 39024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 39124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 39224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 39324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 39424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 39524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 39624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 39724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 39824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 39924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 40024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Resume (); 40124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 40224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 40324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 40424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 40524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 40624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 40724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 40824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 40924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 41024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 41124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 41224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 41324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 41424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 41524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 41624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 41724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 41824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 41924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 42024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 42124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 42224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 42324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 42424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 42524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 42624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 42724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 42824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 42924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 43024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 43124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 43224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 43324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 43424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 43524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 43624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 43724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 43824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 43924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 44024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 44124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 44224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 44324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 44424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 44524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 44624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 44724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 44824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 44924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 45024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 45124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 45224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetUnixSignals (); 45324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 45424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 45524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 45624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 45724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 45824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 45924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 46024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 46124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 46224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 46324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 46424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 46524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 46624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 46724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 46824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 46924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillAttach (lldb::pid_t pid) 47024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 47124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 47224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 47324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 47424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 47524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 47624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 47724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 47824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 47924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 48024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 48124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 48224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 48324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 48424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillAttach (const char *process_name, bool wait_for_launch) 48524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 48624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 48724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 48824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 48924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 49024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 49124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 49224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 49324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 49424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 49524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 49624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 49724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 49824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 49924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 50024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAttach (lldb::pid_t pid) = 0; 50124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 50224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 50324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 50424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 50524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 50624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 50724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 50824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 50924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 51024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 51124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 51224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 51324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 51424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 51524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 51624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 51724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 51824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAttach (const char *process_name, bool wait_for_launch) 51924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 52024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 52124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 52224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 52324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 52424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 52524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 52624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 52724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 52824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 52924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 53024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 53124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 53224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 53324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 53424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 53524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 53624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 53724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 53824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 53924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 54024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 54124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 54224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 54324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 54424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 54524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 54624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 54724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 54824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 54924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 55024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 55124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 55224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 55324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 55424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 55524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 55624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 55724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 55824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 55924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 56024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 56124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 56224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 56324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 56424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 56524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 56624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 56724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 56824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 56924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 57024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 57124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 57224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 57324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 57424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 57524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 57624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 57724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 57824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 57924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 58024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 58124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 58224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 58324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 58424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 58524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 58624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 58724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 58824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 58924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoLaunch (Module* module, 59024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *argv[], 59124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *envp[], 59224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdin_path, 59324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdout_path, 59424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stderr_path) = 0; 59524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 59624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 59724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 59824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 59924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 60024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 60124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 60224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 60324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 60424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 60524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 60624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 60724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 60824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 60924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 61024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 61124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 61224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 61324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 61424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 61524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 61624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 61724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 61824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 61924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 62024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 62124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 62224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 62324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 62424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 62524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 62624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 62724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 62824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 62924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 63024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 63124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 63224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 63324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 63424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 63524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 63624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 63724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoResume () = 0; 63824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 63924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 64024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 64124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 64224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 64324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 64424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 64524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 64624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 64724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 64824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 64924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 65024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 65124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 65224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 65324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 65424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 65524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 65624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 65724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 65824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 65924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 66024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 66124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 66224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 66324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 66424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 66524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 66624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 66724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 66824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 66924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoHalt () = 0; 67024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 67124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 67224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 67324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 67424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 67524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 67624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 67724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 67824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 67924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 68024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 68124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 68224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 68324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 68424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 68524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 68624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 68724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 68824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 68924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 69024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 69124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 69224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 69324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 69424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 69524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 69624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 69724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 69824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 69924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 70024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 70124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 70224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 70324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDetach () = 0; 70424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 70524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 70624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 70724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 70824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 70924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 71024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 71124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 71224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 71324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 71424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 71524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 71624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 71724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 71824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 71924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 72024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 72124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 72224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 72324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 72424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 72524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 72624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 72724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 72824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 72924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 73024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 73124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 73224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 73324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 73424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 73524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoSignal (int signal) = 0; 73624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 73724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 73824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 73924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 74024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 74124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 74224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 74324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 74424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 74524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 74624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 74724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 74824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 74924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 75024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 75124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 75224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 75324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 75424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 75524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 75624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 75724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 75824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 75924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 76024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 76124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 76224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 76324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 76424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 76524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 76624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 76724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 76824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 76924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 77024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 77124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 77224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 77324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 77424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 77524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 77624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 77724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 77824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 77924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 78024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 78124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 78224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 78324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetTarget (); 78424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 78524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 78624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 78724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 78824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 78924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 79024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 79124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 79224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 79324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetTarget () const; 79424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 79524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 79624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 79724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 79824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 79924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 80024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 80124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 80224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 80324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 80424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 80524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 80624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 80724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class CommandObjectProcessLaunch; 80824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class ProcessEventData; 80924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class CommandObjectBreakpointCommand; 81024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 81124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 81224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 81324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 81424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 81524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 81624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 81724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 81824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 81924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 82024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 82124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 82224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 82324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 82424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 82524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 82624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 82724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 82824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 82924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 83024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 83124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 83224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 83324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 83424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 83524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 83624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 83724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 83824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 83924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 84024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 84124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 84224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 84324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 84424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 84524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the number of times this process has posted a stop event. 84624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 84724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 84824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of times this process has stopped while being 84924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debugged. 85024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 85124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 85224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStopID () const; 85324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 85424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 85524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 85624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 85724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 85824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 85924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 86024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 86124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 86224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 86324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 86424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 86524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 86624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 86724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 86824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 86924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 87024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 87124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 87224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 87324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 87424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 87524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 87624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 87724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 87824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 87924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 88024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 88124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 88224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 88324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 88424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 88524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 88624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 88724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 88824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 88924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 89024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 89124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 89224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 89324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 89424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 89524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 89624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 89724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 89824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 89924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 90024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 90124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 90224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 90324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 90424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 90524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 90624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 90724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 90824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 90924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 91024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 91124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 91224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 91324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 91424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 91524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 91624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 91724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 91824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 91924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 92024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 92124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 92224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 92324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 92424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 92524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 92624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 92724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 92824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 92924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 93024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 93124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 93224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 93324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 93424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 93524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 93624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 93724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 93824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 93924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 94024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 94124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 94224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 94324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 94424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 94524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 94624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 94724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 94824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 94924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 95024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 95124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 95224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 95324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 95424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 95524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 95624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 95724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 95824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 95924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 96024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 96124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 96224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 96324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 96424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) = 0; 96524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 96624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 96724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 96824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 96924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 97024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 97124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 97224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 97324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 97424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 97524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 97624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 97724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 97824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 97924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 98024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 98124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 98224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 98324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 98424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 98524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 98624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 98724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 98824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 98924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 99024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 99124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 99224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 99324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 99424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 99524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 99624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 99724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 99824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 99924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 100024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 100124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 100224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 100324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 100424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 100524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 100624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 100724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 100824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 100924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 101024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 101124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAllocateMemory (size_t size, uint32_t permissions, Error &error) = 0; 101224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 101324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 101424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 101524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 101624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 101724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 101824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 101924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 102024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 102124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 102224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 102324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 102424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 102524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 102624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 102724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 102824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 102924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 103024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 103124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 103224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 103424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 103524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 103624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 103724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 103924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 104024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 104124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 104224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 104324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 104424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 104524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 104624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 104724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 104824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 104924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 105024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 105124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 105224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDeallocateMemory (lldb::addr_t ptr) = 0; 105324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 105424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 105524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 105624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 105724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 105824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 105924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 106024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 106124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 106224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 106324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 106424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 106524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 106624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 106724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 106824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 106924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 107024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 107124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 107224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 107324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 107424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 107524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 107624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 107724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 107824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 107924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 108024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 108124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 108224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 108324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 108424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 108524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 108624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 108724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 108824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 108924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 109024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 109124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 109224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 109324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDOUT (char *buf, size_t buf_size, Error &error) 109424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 109524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdout unsupported"); 109624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 109724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 109824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 110024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 110124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 110224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 110324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 110424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 110524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 110624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 110724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 110824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 110924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 111024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 111124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 111224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 111324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 111424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 111524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 111624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 111724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 111824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 111924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 112024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 112124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 112224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDERR (char *buf, size_t buf_size, Error &error) 112324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 112424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stderr unsupported"); 112524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 112624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 112724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 112824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 112924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 113024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 113124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 113224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 113324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 113424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 113524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 113624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 113724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 113824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 113924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site) = 0; 114024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 114124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 114224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpoint (BreakpointSite *bp_site) = 0; 114324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 114424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 114524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpoint (BreakpointSite *bp_site) = 0; 114624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 114724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 114824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 114924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 115024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 115124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 115224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 115324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 115424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 115524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 115624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 115724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 115824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 115924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 116024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 116124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 116224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 116324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 116424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 116524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 116624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 116724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 116824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 116924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 117024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 117124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 117224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 117324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t 117424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CreateBreakpointSite (lldb::BreakpointLocationSP &owner, 117524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 117624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 117724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 117824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 117924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 118024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 118124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 118224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 118324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 118424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 118524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 118624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 118724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 118824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 118924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 119024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 119124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 119224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 119324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 119424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 119524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 119624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 119724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 119824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableWatchpoint (WatchpointLocation *bp_loc); 119924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 120024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 120124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableWatchpoint (WatchpointLocation *bp_loc); 120224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 120324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 120424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 120524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 120624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t 120724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UpdateThreadListIfNeeded () = 0; 120824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 120924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 121024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetThreadList (); 121124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ThreadList & 121324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetThreadList () const; 121424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 121624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 121724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 121924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 122024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 122124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 122224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 122324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 122424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 122524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessToStop (const TimeValue *timeout); 122624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 122724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 122824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 122924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 123024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 123124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 123224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 123324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 123424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 123524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 123624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 123724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 123824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 123924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 124024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 124124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 124224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 124324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 124424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 124524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 124624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 124724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 124824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 124924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 125024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 125124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Gets the byte order for this process. 125224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 125324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 125424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A valid ByteOrder enumeration, or eByteOrderInvalid. 125524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 125624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::ByteOrder 125724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetByteOrder () const = 0; 125824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 125924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ConstString & 126024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetTargetTriple () 126124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 126224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return m_target_triple; 126324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 126424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ABI * 126624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 126724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual DynamicLoader * 126924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetDynamicLoader (); 127024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 127224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSectionLoadAddress (const Section *section) const; 127324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 127524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResolveLoadAddress (lldb::addr_t load_addr, Address &so_addr) const; 127624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 127824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SectionLoaded (const Section *section, lldb::addr_t load_addr); 127924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 128024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // The old load address should be specified when unloading to ensure we get 128124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // the correct instance of the section as a shared library could be loaded 128224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // at more than one location. 128324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 128424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SectionUnloaded (const Section *section, lldb::addr_t load_addr); 128524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 128624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Unload all instances of a section. This function can be used on systems 128724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // that don't support multiple copies of the same shared library to be 128824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // loaded at the same time. 128924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 129024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SectionUnloaded (const Section *section); 129124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 129224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 129324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 129424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 129524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 129624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 129724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 129824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Target * 129924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CalculateTarget (); 130024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 130124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Process * 130224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CalculateProcess (); 130324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 130424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Thread * 130524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CalculateThread (); 130624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 130724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual StackFrame * 130824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CalculateStackFrame (); 130924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 131124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Calculate (ExecutionContext &exe_ctx); 131224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP 131424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSP (); 131524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ObjCObjectPrinter & 131724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetObjCObjectPrinter(); 131824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 132024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef ThreadSafeSTLMap<lldb::addr_t, const Section *> SectionLoadColl; 132124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 132224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 132324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 132424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 132524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SectionLoadColl m_section_load_info; ///< A mapping of all currently loaded sections. 132624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 132724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 132824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 132924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 133024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 133124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 133224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 133324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_stop_id; ///< A count of many times the process has stopped. 133424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 133524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 133624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 133724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 133824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 133924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 134024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend 134124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ///< to insert in the target. 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 134324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ConstString m_target_triple; 134424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 134524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ObjCObjectPrinter m_objc_object_printer; 134624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 134724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 134824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 134924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 135124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 135424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 135524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 135724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 135824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 136024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StartPrivateStateThread (); 136124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 136324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 136424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 136624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 136724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 136924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 137024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 137124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 137224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 137324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 137424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 137524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 137624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 137724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 137824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 137924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 138124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 138224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 138424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CompleteAttach (); 138524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 138824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 138924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 139124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 139224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 139424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 139524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 139724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 139824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 139924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 140024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 140224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 140324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 140524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 140624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 140724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 140824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 140924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 141024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 141124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 141224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 141324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 141424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 141524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 1416