Process.h revision 75c703dd8b492bad25a987b96853626641ae7246
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" 206e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice#include "lldb/Interpreter/Args.h" 216e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice#include "lldb/Interpreter/Options.h" 2224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Broadcaster.h" 23861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice#include "lldb/Core/Communication.h" 2424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Error.h" 2524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Event.h" 267508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham#include "lldb/Core/StringList.h" 2724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/ThreadSafeValue.h" 2824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/PluginInterface.h" 296e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice#include "lldb/Core/UserSettingsController.h" 3024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Breakpoint/BreakpointSiteList.h" 31a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan#include "lldb/Expression/ClangPersistentVariables.h" 32f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan#include "lldb/Expression/IRDynamicChecks.h" 3324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 3424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ThreadList.h" 3524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/UnixSignals.h" 3624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 3824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 39f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice 40f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Ticetypedef enum ProcessPlugins 41f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice{ 42f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice eMacosx, 43f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice eRemoteDebugger 44f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice} ProcessPlugins; 45f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice 46f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice 476e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeclass ProcessInstanceSettings : public InstanceSettings 486e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice{ 496e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticepublic: 506e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 51004afcb95736e97d071b1dd9b5254800e11e581cCaroline Tice ProcessInstanceSettings (UserSettingsController &owner, bool live_instance = true, const char *name = NULL); 526e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 536e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings (const ProcessInstanceSettings &rhs); 546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 556e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 566e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ~ProcessInstanceSettings (); 576e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings& 596e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice operator= (const ProcessInstanceSettings &rhs); 606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 626e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 636e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice UpdateInstanceSettingsVariable (const ConstString &var_name, 646e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *index_value, 656e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *value, 666e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &instance_name, 676e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const SettingEntry &entry, 686e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice lldb::VarSetOperationType op, 696e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Error &err, 706e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 716e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 72bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice bool 736e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice GetInstanceSettingsValue (const SettingEntry &entry, 746e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &var_name, 755bc8c97d62b2e399bd90fb7e00c903d7887412abCaroline Tice StringList &value, 76bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice Error *err); 776e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 786e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 79238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const Args & 80238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetRunArguments () const 81238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 82238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_run_args; 83238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 84238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 85238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 86238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetRunArguments (const Args &args) 87238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 88238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_run_args = args; 89238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 90238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 91638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton void 92638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton GetHostEnvironmentIfNeeded (); 93638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton 94238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton size_t 95638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton GetEnvironmentAsArgs (Args &env); 96238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 97238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 98238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardInputPath () const 99238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 100238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_input_path.empty()) 101238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 102238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_input_path.c_str(); 103238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 104238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 105238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 106238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardInputPath (const char *path) 107238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 108238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 109238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_input_path.assign (path); 110238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 111238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 112238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 113238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 114238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_input_path); 115238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 116238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 117238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 118238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 119238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardOutputPath () const 120238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 121238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_output_path.empty()) 122238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 123238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_output_path.c_str(); 124238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 125238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 126238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 127238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardOutputPath (const char *path) 128238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 129238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 130238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_output_path.assign (path); 131238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 132238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 133238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 134238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 135238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_output_path); 136238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 137238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 138238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 139238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 140238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardErrorPath () const 141238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 142238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_error_path.empty()) 143238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 144238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_error_path.c_str(); 145238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 146238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 147238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 148238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardErrorPath (const char *path) 149238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 150238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 151238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_error_path.assign (path); 152238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 153238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 154238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 155238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 156238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_error_path); 157238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 158238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 159238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 160238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton bool 161238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetDisableASLR () const 162238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 163238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_disable_aslr; 164238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 165238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 166238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 167238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetDisableASLR (bool b) 168238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 169238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_disable_aslr = b; 170238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 171bd666017403e102e0ca435d6da585ff979f83598Caroline Tice 172bd666017403e102e0ca435d6da585ff979f83598Caroline Tice bool 173bd666017403e102e0ca435d6da585ff979f83598Caroline Tice GetDisableSTDIO () const 174bd666017403e102e0ca435d6da585ff979f83598Caroline Tice { 175bd666017403e102e0ca435d6da585ff979f83598Caroline Tice return m_disable_stdio; 176bd666017403e102e0ca435d6da585ff979f83598Caroline Tice } 177bd666017403e102e0ca435d6da585ff979f83598Caroline Tice 178bd666017403e102e0ca435d6da585ff979f83598Caroline Tice void 179bd666017403e102e0ca435d6da585ff979f83598Caroline Tice SetDisableSTDIO (bool b) 180bd666017403e102e0ca435d6da585ff979f83598Caroline Tice { 181bd666017403e102e0ca435d6da585ff979f83598Caroline Tice m_disable_stdio = b; 182bd666017403e102e0ca435d6da585ff979f83598Caroline Tice } 183238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 1846e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprotected: 1856e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1866e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 1876e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, 1886e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 1896e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1900021c97fbd17e38113d2e76b93c94ee05213ee45Johnny Chen const ConstString 1916e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CreateInstanceName (); 1926e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 193c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 1946e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice RunArgsVarName (); 1956e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 196c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 1976e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice EnvVarsVarName (); 1986e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 199c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 200638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton InheritHostEnvVarName (); 201638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton 202638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton static const ConstString & 2036e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice InputPathVarName (); 2046e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 205c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2066e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice OutputPathVarName (); 2076e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 208c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2096e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ErrorPathVarName (); 2106e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 211c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2126e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice PluginVarName (); 2136e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 214c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2156e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice DisableASLRVarName(); 2166e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 217bd666017403e102e0ca435d6da585ff979f83598Caroline Tice static const ConstString & 218bd666017403e102e0ca435d6da585ff979f83598Caroline Tice DisableSTDIOVarName (); 219bd666017403e102e0ca435d6da585ff979f83598Caroline Tice 2206e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprivate: 2216e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 222238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton typedef std::map<std::string, std::string> dictionary; 2236e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Args m_run_args; 224238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton dictionary m_env_vars; 2256e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_input_path; 2266e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_output_path; 2276e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_error_path; 228f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice ProcessPlugins m_plugin; 2296e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool m_disable_aslr; 230bd666017403e102e0ca435d6da585ff979f83598Caroline Tice bool m_disable_stdio; 231638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton bool m_inherit_host_env; 232638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton bool m_got_host_env; 2336e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice}; 2346e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 2356e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 23624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 23724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 23824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 23924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 24024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 24124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 24224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 24324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 2446e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public PluginInterface, 2456e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public ProcessInstanceSettings 24624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 24724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 248d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Inghamfriend class ClangFunction; // For WaitForStateChangeEventsPrivate 24924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 25024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 25124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 25224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 25324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 25424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 25524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 25624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 25724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 25824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 25924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 260e28824e0b988221c7eedf8e3d212527d2bdac6a7Eli Friedman eBroadcastBitSTDERR = (1 << 3) 26124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 26224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 26324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 26424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 26524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 26624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 26724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 26824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 269360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 27024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 27124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 27224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 27324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 27424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 27524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 27624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 27724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 27824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 27924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 28024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 28124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 28224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 28324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 28424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 28524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 28624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 28724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 2883ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham friend class Process; 2893ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 29024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 29124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 29224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 29324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 29524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 29724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 29824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 30024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 30124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 30224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 3033ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetProcessSP() const 3043ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 3053ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_process_sp; 3063ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 30724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 3083ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetState() const 3093ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 3103ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_state; 3113ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 31224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 3133ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetRestarted () const 3143ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 3153ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_restarted; 3163ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 3173ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool 3183ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterrupted () const 3193ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 3203ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_interrupted; 3213ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 32224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 32424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 32524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 32724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 32824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 33024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 33124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 33224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 33324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 33424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 33524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 33624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 33724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 33824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 33924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 34024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 34124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 34224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 34324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 34424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 3453ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterruptedFromEvent (const Event *event_ptr); 3463ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 3473ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static void 3483ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterruptedInEvent (Event *event_ptr, bool new_value); 3493ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 3503ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static bool 35124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 35224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 35324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 35424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 35524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 3563ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetUpdateStateOnRemoval() 3573ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 3583ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_update_state = true; 3593ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 36024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 3613ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetRestarted (bool new_value) 3623ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 3633ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_restarted = new_value; 3643ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 3653ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham void 3663ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterrupted (bool new_value) 3673ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 3683ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_interrupted = new_value; 3693ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 37024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 37124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 37224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 37324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 37424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_update_state; 3753ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool m_interrupted; 37624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 37724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 37824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 3796e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 380d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton class SettingsController : public UserSettingsController 3816e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice { 3826e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public: 3836e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 384d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton SettingsController (); 3856e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3866e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 387d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton ~SettingsController (); 3886e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3896e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry global_settings_table[]; 3906e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry instance_settings_table[]; 3916e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3926e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice protected: 3936e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3946e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice lldb::InstanceSettingsSP 395d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton CreateInstanceSettings (const char *instance_name); 3966e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3976e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static lldb::OptionEnumValueElement g_plugins[]; 3986e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3996e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice private: 4006e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 4016e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice // Class-wide settings. 4026e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 403d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton DISALLOW_COPY_AND_ASSIGN (SettingsController); 4046e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice }; 4056e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 40624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 40724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 408990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 409990de7bb41d3afec6b789155408ff322187d8682Greg Clayton Initialize (); 410990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 411990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 412990de7bb41d3afec6b789155408ff322187d8682Greg Clayton Terminate (); 413990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 414990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static lldb::UserSettingsControllerSP & 415990de7bb41d3afec6b789155408ff322187d8682Greg Clayton GetSettingsController (); 4166e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 4171ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice void 4181ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice UpdateInstanceName (); 4191ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice 420395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 42124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 42224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 42324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 42424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 42524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 42624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 42724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 42824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 42924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 43024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 43124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 43224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 43324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 43424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 43524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 43624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 43724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 43824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 43924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 44024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 44124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 44224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 44324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 44424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 44524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 44624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 44724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 44824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 44924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 45024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 45124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 45224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 45324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static Process* 45424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner FindPlugin (Target &target, const char *plugin_name, Listener &listener); 45524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 45624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 45724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 45824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 45924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 46024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 46124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 46224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 46324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 46424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 46524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 46624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 46724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 46824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 46924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 47024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 47124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 47224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 47324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 47424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 47524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 47624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 47724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 478395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton lldb::ByteOrder 479395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetByteOrder () const; 480395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 481395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton uint32_t 482395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetAddressByteSize () const; 483395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 48424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 48524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 48624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 487fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 48824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 48924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 49024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 49124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 49224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 49324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 49424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 49524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 49624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CanDebug (Target &target) = 0; 49724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 49824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 49924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 50024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 50124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 50224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 50324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 50424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 50524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 50624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 50724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 50824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 50924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 51024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 51124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 51224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 51324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 51424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 51524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 51624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 51724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 51824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 51924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 52024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 52124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 52224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 52324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 52424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 52524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 52624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 52724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 52824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 52924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 53024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 53124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 532452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 533452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 534452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 53524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 53624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 53724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 53824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 53924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 54024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 54124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 54224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 54324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 54424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 54524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 54624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 54724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 54824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 54924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 550de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 551de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 552de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 55324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 55424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 55524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 55624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 55724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 55824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Launch (char const *argv[], 55924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *envp[], 560452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton uint32_t launch_flags, 56124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdin_path, 56224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdout_path, 563de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton const char *stderr_path, 564de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton const char *working_directory); 56524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 56624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 56724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 56824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 56924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 57024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillAttach (lldb::pid_t) 57124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoAttach (lldb::pid_t) will 57224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 57324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 57424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 57524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 57624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 57724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 57824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 57924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 58024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 58124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 58224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 58324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (lldb::pid_t pid); 58424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 58524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 58624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process by process name. 58724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 58824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 58924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call 59024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::WillAttach (const char *) and if that returns \b 59124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, Process::DoAttach (const char *) will be called to 59224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// actually do the attach. If DoAttach returns \b true, then 59324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DidAttach() will be called. 59424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 59524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 59624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A process name to match against the current process list. 59724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 59824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 59924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 60024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 60124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 60224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 60324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (const char *process_name, bool wait_for_launch); 6047508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 605e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 606e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton ConnectRemote (const char *remote_url); 6077508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 6087508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// List the processes matching the given partial name. 6097508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6107508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// FIXME: Is it too heavyweight to create an entire process object to do this? 6117508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// The problem is for remote processes we're going to have to set up the same transport 6127508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// to get this data as to actually attach. So we need to factor out transport 6137508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// and process before we can do this separately from the process. 6147508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6157508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[in] name 6167508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// A partial name to match against the current process list. 6177508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6187508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[out] matches 6197508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// The list of process names matching \a name. 6207508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6217508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[in] pids 6227508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// A vector filled with the pids that correspond to the names in \a matches. 6237508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6247508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @return 6257508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Returns the number of matching processes. 6267508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 6277508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 6287508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham virtual uint32_t 6297508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham ListProcessesMatchingName (const char *name, StringList &matches, std::vector<lldb::pid_t> &pids); 6307508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 6317508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 6327508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Find the architecture of a process by pid. 6337508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6347508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// FIXME: See comment for ListProcessesMatchingName. 6357508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6367508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[in] pid 6377508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// A pid to inspect. 6387508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6397508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @return 6407508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Returns the architecture of the process or an invalid architecture if the process can't be found. 6417508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 6427508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham virtual ArchSpec 6437508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham GetArchSpecForExistingProcess (lldb::pid_t pid); 6447508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 6457508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 6467508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Find the architecture of a process by name. 6477508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6487508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// FIXME: See comment for ListProcessesMatchingName. 6497508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6507508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[in] process_name 6517508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// The process name to inspect. 6527508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 6537508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @return 6547508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Returns the architecture of the process or an invalid architecture if the process can't be found. 6557508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 6567508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham virtual ArchSpec 6577508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham GetArchSpecForExistingProcess (const char *process_name); 65824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 65924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 66024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 66124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 66224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 66324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 66424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 66524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 66624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 66724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 66824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 66924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 67024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 67124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 67224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 67324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 67424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 67524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 67624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 67724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 6780baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Load a shared library into this process. 6790baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 6800baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Try and load a shared library into the current process. This 6810baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// call might fail in the dynamic loader plug-in says it isn't safe 6820baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// to try and load shared libraries at the moment. 6830baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 6840baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[in] image_spec 6850baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// The image file spec that points to the shared library that 6860baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// you want to load. 6870baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 6880baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[out] error 6890baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// An error object that gets filled in with any errors that 6900baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// might occur when trying to load the shared library. 6910baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 6920baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @return 6930baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// A token that represents the shared library that can be 6940baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// later used to unload the shared library. A value of 6950baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// LLDB_INVALID_IMAGE_TOKEN will be returned if the shared 6960baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// library can't be opened. 6970baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 6980baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual uint32_t 6990baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton LoadImage (const FileSpec &image_spec, Error &error); 7000baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 7010baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual Error 7020baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton UnloadImage (uint32_t image_token); 7030baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 7040baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 70524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 70624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 70724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 70824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 70924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 71024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 71124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 71224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 71324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 71424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 71524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 71624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 71724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 71824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 71924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 72024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 72124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 72224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 72324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 72424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 72524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 72624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 72724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 72824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 72924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 73024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 73124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 73224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 73324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 73424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 73524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 73624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 73724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 73824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 73924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 74024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 74124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 74224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 74324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 74424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 74524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 74624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 74724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 74824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 74924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 75024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 75124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 75224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 75324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 75424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 75524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 75624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 75724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 75824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 75924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 76024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 76124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 76224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 76324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 76424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 7653ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 76624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Resume (); 76724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 76824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 76924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 77024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 77124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 77224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 7733ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// If the process is successfully halted, a eStateStopped 7743ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// process event with GetInterrupted will be broadcast. If false, we will 7753ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// halt the process with no events generated by the halt. 77624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 77724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 7783ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// Returns an error object. If the error is empty, the process is halted. 7793ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// otherwise the halt has failed. 78024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 7813ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 78224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 78324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 78424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 78524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 78624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 78724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 78824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 78924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 79024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 79124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 79224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 7933ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 79424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 79524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 79624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 79724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 79824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 79924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 80024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 80124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 80224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 80324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 80424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 80524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 8063ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 80724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 80824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 80924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 81024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 81124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 81224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 81324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 81424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 81524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 81624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 81724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 8183ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 81924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 82024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 82124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 822395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetUnixSignals () 823395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 824395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_unix_signals; 825395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 82624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 82724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 82824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 82924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 83024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 83124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 83224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 83324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 83424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 83524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 83624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 83724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 83824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 83924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 84024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 84154e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 84224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 84324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 84424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 84524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 84624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 84724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 84824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 84924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 85024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 85124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 85224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 85324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 85424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 85524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 85654e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 85724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 85824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 85924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 86024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 861e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 862e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton DoConnectRemote (const char *remote_url) 863e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton { 864e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton Error error; 865e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton error.SetErrorString ("remote connections are not supported"); 866e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton return error; 867e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton } 868e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton 86924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 87024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 87124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 87224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 87324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 87424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 87524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 87624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 87724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 87824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 87924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 88054e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithID (lldb::pid_t pid) = 0; 88124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 88224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 88324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 88424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 88524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 88624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 88724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 88824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 88924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 89024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 89124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 89224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 89324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 89424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 89524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 89624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 89724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 89854e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithName (const char *process_name, bool wait_for_launch) 89924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 90024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 90124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 90224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 90324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 90424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 90524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 90624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 90724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 90824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 90924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 91024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 91124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 91224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 91324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 91424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 91524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 91624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 91724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 91824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 91924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 92024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 92124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 92224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 92324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 92424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 92524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 92624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 92724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 92824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 92924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 93024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 93124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 93224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 93324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 93424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 93524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 93624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 93724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 93824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 93924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 94024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 94124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 94224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 94324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 94424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 94524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 94624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 94724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 94824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 949452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 950452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 951452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 95224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 95324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 95424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 95524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 95624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 95724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 95824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 95924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 96024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 96124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 96224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 96324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 96424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 96524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 96624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 967de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 968de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 969de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 97024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 97124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 97224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 97324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 97424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 97524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoLaunch (Module* module, 97624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *argv[], 97724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *envp[], 978452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton uint32_t launch_flags, 97924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdin_path, 98024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdout_path, 981de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton const char *stderr_path, 982de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton const char *working_directory) = 0; 98324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 98424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 98524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 98624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 98724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 98824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 98924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 99024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 99124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 99224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 99324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 99424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 99524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 99624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 99724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 99824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 99924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 100024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 100124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 100224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 100324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 100424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 100524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 100624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 100724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 100824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 100924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 101024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 101124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 101224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 101324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 101424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 101524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 101624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 101724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 101824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 101924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 102024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 102124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 102224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 102324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 102424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 102524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoResume () = 0; 102624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 102724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 102824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 102924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 103024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 103124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 103224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 103424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 103524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 103624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 103724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 103924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 104024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 104124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 104224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 104324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 104424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 104524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 104624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 104724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 104824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 104924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 105024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 105124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1052360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt must produce one and only one stop StateChanged event if it actually 1053360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// stops the process. If the stop happens through some natural event (for 1054360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// instance a SIGSTOP), then forwarding that event will do. Otherwise, you must 1055360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// generate the event manually. Note also, the private event thread is stopped when 1056360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt is run to prevent the events generated while halting to trigger 1057360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// other state changes before the halt is complete. 10583ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 10593ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// @param[out] caused_stop 106020d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// If true, then this Halt caused the stop, otherwise, the 106120d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// process was already stopped. 10623ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 106324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 106424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 106524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 106624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 106724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 10683ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham DoHalt (bool &caused_stop) = 0; 106924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 107024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 107124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 107224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 107324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 107424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 107524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 107624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 107724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 107824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 107924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 108024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 108124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 108224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 108324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 108424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 108524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 108624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 108724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 108824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 108924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 109024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 109124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 109224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 109324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 109524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 109624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 109724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 109824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 109924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 110024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 110124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 110224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDetach () = 0; 110324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 110424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 110524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 110624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 110724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 110824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 110924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 111024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 111124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 111224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 111324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 111424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 111524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 111624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 111724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 111824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 111924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 112024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 112124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 112224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 112324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 112424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 112524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 112624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 112724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 112824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 112924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 113024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 113124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 113224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 113324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 113424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoSignal (int signal) = 0; 113524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 113624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 113724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 113824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 113924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 114024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 114124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 114224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 114324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 114424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 114524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 114624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 114724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 114824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 114924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 115024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 115124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 115224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 115324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 115424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 115524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 115624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 115724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 115824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 115924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 116024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 116124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 116224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 116324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 116424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 116524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 116624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 116724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 116824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 116924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 117024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 117124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 117224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 117324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 117424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 117524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 117624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 117724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 117824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 117924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 118024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 1182395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () 1183395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1184395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 1185395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 118624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 118724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 118924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 119024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 119124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 119224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 119324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 119424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 1195395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () const 1196395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1197395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 1198395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 1199395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 120024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 120124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 120224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 120324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 120524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 120624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 120824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 120924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 121024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 1211360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 1212427f290ff96f3ab9f2cf3a1af7001d2c560424c7Greg Clayton lldb::ExecutionResults 1213360f53f3c216ee4fb433da0a367168785328a856Jim Ingham RunThreadPlan (ExecutionContext &exe_ctx, 1214360f53f3c216ee4fb433da0a367168785328a856Jim Ingham lldb::ThreadPlanSP &thread_plan_sp, 1215360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool stop_others, 1216360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool try_all_threads, 1217360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool discard_on_error, 1218360f53f3c216ee4fb433da0a367168785328a856Jim Ingham uint32_t single_thread_timeout_usec, 1219360f53f3c216ee4fb433da0a367168785328a856Jim Ingham Stream &errors); 1220360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 1221360f53f3c216ee4fb433da0a367168785328a856Jim Ingham static const char * 1222427f290ff96f3ab9f2cf3a1af7001d2c560424c7Greg Clayton ExecutionResultAsCString (lldb::ExecutionResults result); 122324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 122424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 122524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class CommandObjectProcessLaunch; 122624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class ProcessEventData; 122724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class CommandObjectBreakpointCommand; 122824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 122924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 123024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 123124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 123224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 123324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 123424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 123575c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 123675c703dd8b492bad25a987b96853626641ae7246Greg Clayton // Called internally 123775c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 123875c703dd8b492bad25a987b96853626641ae7246Greg Clayton void 123975c703dd8b492bad25a987b96853626641ae7246Greg Clayton CompleteAttach (); 124075c703dd8b492bad25a987b96853626641ae7246Greg Clayton 124124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 124224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 124324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 124424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 124524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 124624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 124724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 124824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 124924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 125024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 125124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 125224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 125324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 125424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 125524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 125624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 125724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 125824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 125924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 126024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 126124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 126424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 126524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 126624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 126724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 126924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the number of times this process has posted a stop event. 127024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 127124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 127224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of times this process has stopped while being 127324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debugged. 127424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 127524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 127624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStopID () const; 127724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 127924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 128024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 128124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 128224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 128324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 128424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 128524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 128624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 128724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 128824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 128924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 129024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 129124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 129224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 129324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 129472e1c782ba1e4226da37af4722af608de9f39408Greg Clayton virtual bool 129524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 129624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 129724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 129824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 129924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 130024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 130124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 130224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 130324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 130424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 130524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 130624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 130724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 130824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 130924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 131024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 131124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 131224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 131324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 131424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 131524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 131624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 131724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 131824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 131924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 132024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 132124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 132224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 132324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 132424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 132524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 132624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 132724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 132824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 132924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 133024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 133124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 133224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 133324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 133424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 133524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 133624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 133724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 133824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 133924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 134024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 134124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 134324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 134424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 134524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 134624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 134724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 134824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 134924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 135024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 135124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 135424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 135524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 135624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 135724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 135824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 135924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 136024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 136124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 136224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 136324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 136424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 136524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 136624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 136724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 136824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 136924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1370fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 1371fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ReadMemoryFromInferior (lldb::addr_t vm_addr, 1372fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *buf, 1373fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t size, 1374fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 1375fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 13766d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 13776d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// Reads an unsigned integer of the specified byte size from 13786d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// process memory. 13796d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 13806d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] load_addr 13816d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// A load address of the integer to read. 13826d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 13836d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] byte_size 13846d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The size in byte of the integer to read. 13856d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 13866d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[out] error 13876d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// An error that indicates the success or failure of this 13886d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// operation. If error indicates success (error.Success()), 13896d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// then the value returned can be trusted, otherwise zero 13906d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// will be returned. 13916d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 13926d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @return 13936d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The unsigned integer that was read from the process memory 13946d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// space. If the integer was smaller than a uint64_t, any 13956d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// unused upper bytes will be zero filled. If the process 13966d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// byte order differs from the host byte order, the integer 13976d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// value will be appropriately byte swapped into host byte 13986d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// order. 13996d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 1400f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton uint64_t 14016d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton ReadUnsignedInteger (lldb::addr_t load_addr, 14026d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton size_t byte_size, 1403f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton Error &error); 140424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 140524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 140624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 140724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 140824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 140924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 141024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 141124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 141224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 141324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 141424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 141524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 141624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 141724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 141824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 141924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 142024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 142124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 142224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) = 0; 142324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 142424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 142524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 142624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 142724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 142824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 142924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 143024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 143224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 143324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 143424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 143624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 143724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 143824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 144024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 144124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 144224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 144324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 144424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 144524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 144624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 144724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 144824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 144924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 145024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 145124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 145224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 145324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 145424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 145524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 145624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 145724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 145824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 145924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 146124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 146224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 146424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 146524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 146624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 146724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 146824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 146924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAllocateMemory (size_t size, uint32_t permissions, Error &error) = 0; 147024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 147124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 147224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 147324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 147524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 147624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 147724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 148024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 148124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 148224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 148324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 148524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 148624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 148724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 148824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 148924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 149024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 149124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 149324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 149424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 149624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 149724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 149824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 149924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 150024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 150224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 150324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 150424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 150624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 150724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 150924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 151024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDeallocateMemory (lldb::addr_t ptr) = 0; 151124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 151424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 151524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 151624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 151724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 151824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 151924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 152024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 152124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 152324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 152424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 152524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 152624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 152724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 152824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 152924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 153024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 153124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 153224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 153324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 153424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 153524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 153624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 153724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 153824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 153924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 154024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 154124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 154624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 154724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 154824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 154924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 155024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 155124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDOUT (char *buf, size_t buf_size, Error &error) 155224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 155324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdout unsupported"); 155424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 155524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 155624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 155724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 155824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 155924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 156024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 156124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 156224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 156324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 156424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 156524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 156624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 156724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 156824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 156924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 157024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 157224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 157324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 157524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 157724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 157824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 157924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 158024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDERR (char *buf, size_t buf_size, Error &error) 158124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 158224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stderr unsupported"); 158324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 158424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 158624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 158724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 158824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 158924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 159024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 159124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 159224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 159324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 159424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 159524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 159624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 159724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site) = 0; 159824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 159924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 160024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpoint (BreakpointSite *bp_site) = 0; 160124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 160224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 160324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpoint (BreakpointSite *bp_site) = 0; 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 160524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 160624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 160724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 160824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 160924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 161024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 161124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 161224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 161324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 161424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 161524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 161624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 161724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 161824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 161924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 162024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 162124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 162324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 162424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 162624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 162724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 162924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 163024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 16313fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 163224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CreateBreakpointSite (lldb::BreakpointLocationSP &owner, 163324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 163424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 163624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 163724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 163924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 164324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 164424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 164524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 164624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 164724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 164824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 164924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 165024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 165124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 165224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 165324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 165424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 165524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 165624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableWatchpoint (WatchpointLocation *bp_loc); 165724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 165824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 165924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableWatchpoint (WatchpointLocation *bp_loc); 166024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 166124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 166224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 166324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 166424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t 166524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UpdateThreadListIfNeeded () = 0; 166624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 166724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 1668395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () 1669395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1670395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 1671395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 167224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 167324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ThreadList & 1674395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () const 1675395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1676395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 1677395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 167824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 167924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 168024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 168124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 168224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 168424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 168624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 168724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 168824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 168924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessToStop (const TimeValue *timeout); 169024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 169124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 169224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 169324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 169424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 169524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 169663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 169724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1698f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham class 1699f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker 1700f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 1701f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham public: 1702f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker (Process &process, Listener *listener) : 1703f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process (process), 1704f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_listener (listener) 1705f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 1706f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.HijackProcessEvents (listener); 1707f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 1708f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ~ProcessEventHijacker () 1709f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 1710f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.RestoreProcessEvents(); 1711f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 1712f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 1713f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham private: 1714f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Process &m_process; 1715f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Listener *m_listener; 1716f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham }; 1717f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham friend class ProcessEventHijacker; 171824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 171963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// If you need to ensure that you and only you will hear about some public 172063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// event, then make a new listener, set to listen to process events, and 172163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// then call this with that listener. Then you will have to wait on that 172263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// listener explicitly for events (rather than using the GetNextEvent & WaitFor* 172363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// calls above. Be sure to call RestoreProcessEvents when you are done. 172463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 172563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @param[in] listener 172663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// This is the new listener to whom all process events will be delivered. 172763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 172863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @return 172963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Returns \b true if the new listener could be installed, 173063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// \b false otherwise. 173163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 173263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham bool 173363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham HijackProcessEvents (Listener *listener); 173463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 173563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 173663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Restores the process event broadcasting to its normal state. 173763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 173863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 173963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham void 174063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham RestoreProcessEvents (); 174163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 174263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghamprotected: 174363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 174424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 174524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 174624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 174724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 174824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 174924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 175124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 175224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 175424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 175524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 175624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 175724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 175824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 175924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 176063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghampublic: 176124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ABI * 176224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 176324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 176475c703dd8b492bad25a987b96853626641ae7246Greg Clayton DynamicLoader * 176575c703dd8b492bad25a987b96853626641ae7246Greg Clayton GetDynamicLoader () 176675c703dd8b492bad25a987b96853626641ae7246Greg Clayton { 176775c703dd8b492bad25a987b96853626641ae7246Greg Clayton return m_dyld_ap.get(); 176875c703dd8b492bad25a987b96853626641ae7246Greg Clayton } 176975c703dd8b492bad25a987b96853626641ae7246Greg Clayton 1770642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual LanguageRuntime * 1771642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetLanguageRuntime (lldb::LanguageType language); 1772642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 1773642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual CPPLanguageRuntime * 1774642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetCPPLanguageRuntime (); 1775642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 1776642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual ObjCLanguageRuntime * 1777642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetObjCLanguageRuntime (); 177824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 177924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 178024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 1781f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 1782f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 1783f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 1784d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham return m_dynamic_checkers_ap.get(); 1785f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 1786f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 1787f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 1788f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 1789d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham m_dynamic_checkers_ap.reset(dynamic_checkers); 1790f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 179124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 179255e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 179355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StartNoticingNewThreads() 179455e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 179555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 179655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 179755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 179855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 179955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StopNoticingNewThreads() 180055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 180155e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 180255e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 180355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 180424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 180624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Target * 1808395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateTarget () 1809395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1810395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return &m_target; 1811395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 181224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 181324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Process * 1814395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateProcess () 1815395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1816395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return this; 1817395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 181824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 181924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Thread * 1820395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateThread () 1821395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1822395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 1823395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 182424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 182524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual StackFrame * 1826395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateStackFrame () 1827395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1828395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 1829395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 183024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 183124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 1832a830adbcd63d1995a01e6e18da79893c1426ca43Greg Clayton CalculateExecutionContext (ExecutionContext &exe_ctx); 183324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 183424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP 183524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSP (); 183624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 183724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 1838c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 1839c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // lldb::ExecutionContextScope pure virtual functions 1840c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 1841c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class NextEventAction 1842c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 1843c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 1844c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham typedef enum EventActionResult 1845c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 1846c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionSuccess, 1847c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionRetry, 1848c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionExit 1849c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } EventActionResult; 1850c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 1851c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction (Process *process) : 1852c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham m_process(process) 1853c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham {} 1854c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual ~NextEventAction() {} 1855c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 1856c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp) = 0; 1857c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual void HandleBeingUnshipped () {}; 1858c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted () = 0; 1859c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString() = 0; 1860c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham protected: 1861c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham Process *m_process; 1862c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 1863c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 1864c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham void SetNextEventAction (Process::NextEventAction *next_event_action) 1865c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 186668bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham if (m_next_event_action_ap.get()) 186768bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap->HandleBeingUnshipped(); 186868bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham 186968bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap.reset(next_event_action); 1870c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } 1871c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 1872c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // This is the completer for Attaching: 1873c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class AttachCompletionHandler : public NextEventAction 1874c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 1875c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 1876c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham AttachCompletionHandler (Process *process) : 1877c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction(process) 1878c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham {} 1879c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual ~AttachCompletionHandler() {} 1880c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 1881c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp); 1882c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted (); 1883c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString(); 1884c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham private: 1885c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham std::string m_exit_string; 1886c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 1887c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 1888c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 1889fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton class MemoryCache 1890fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton { 1891fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton public: 1892fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton //------------------------------------------------------------------ 1893fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton // Constructors and Destructors 1894fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton //------------------------------------------------------------------ 1895fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache (); 1896fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 1897fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ~MemoryCache (); 1898fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 1899fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void 1900fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Clear(); 1901fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 1902fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void 1903fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Flush (lldb::addr_t addr, size_t size); 1904fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 1905fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 1906fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Read (Process *process, 1907fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton lldb::addr_t addr, 1908fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *dst, 1909fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t dst_len, 1910fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 1911fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 1912fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton protected: 1913fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton typedef std::map<lldb::addr_t, lldb::DataBufferSP> collection; 1914fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton //------------------------------------------------------------------ 1915fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton // Classes that inherit from MemoryCache can see and modify these 1916fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton //------------------------------------------------------------------ 1917fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton uint32_t m_cache_line_byte_size; 1918fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Mutex m_cache_mutex; 1919fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton collection m_cache; 1920fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 1921fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton private: 1922fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton DISALLOW_COPY_AND_ASSIGN (MemoryCache); 1923fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton }; 1924fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 1925f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham bool 1926f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham HijackPrivateProcessEvents (Listener *listener); 1927f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 1928f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham void 1929f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham RestorePrivateProcessEvents (); 1930fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 193124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 193224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 193324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 193424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 193524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 193624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 193724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 193824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 193924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 194024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 194124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 194224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_stop_id; ///< A count of many times the process has stopped. 194324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 194424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 194524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 194624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 194724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 19480baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton std::vector<lldb::addr_t> m_image_tokens; 194924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 195024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend 195124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ///< to insert in the target. 195275c703dd8b492bad25a987b96853626641ae7246Greg Clayton std::auto_ptr<DynamicLoader> m_dyld_ap; 1953d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers_ap; ///< The functions used by the expression parser to validate data that expressions use. 195424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 195524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 1956861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderSP m_process_input_reader; 1957861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb_private::Communication m_stdio_communication; 195820d338fad87eba91de65aa9bec76e01c04472848Greg Clayton lldb_private::Mutex m_stdio_communication_mutex; 1959861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice std::string m_stdout_data; 1960fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache m_memory_cache; 1961fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 1962642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham typedef std::map<lldb::LanguageType, lldb::LanguageRuntimeSP> LanguageRuntimeCollection; 1963642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham LanguageRuntimeCollection m_language_runtimes; 19647e2f91cb958c8670774cb2190db7b858618b5b9bGreg Clayton std::auto_ptr<NextEventAction> m_next_event_action_ap; 196524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 196624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 196724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 196824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 196924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 197024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 197124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 197324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 197424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 197624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 197724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 197924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StartPrivateStateThread (); 198024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 198224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 198324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 198524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 198624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 198824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 198924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 199124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 199224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 199424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 199524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 199724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 199824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 200024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 200124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 200324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 200424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 200624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 200724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 200924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 201024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 201124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 201224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 201324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 201424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 201524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 201624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 201724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 2018861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2019861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2020861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice AppendSTDOUT (const char *s, size_t len); 2021861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2022861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static void 2023861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len); 2024861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2025861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2026861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PushProcessInputReader (); 2027861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2028861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2029861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PopProcessInputReader (); 2030861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2031861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2032861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ResetProcessInputReader (); 2033861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2034861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2035861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice SetUpProcessInputReader (int file_descriptor); 2036861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2037861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static size_t 2038861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ProcessInputReaderCallback (void *baton, 2039861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice InputReader &reader, 2040861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderAction notification, 2041861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice const char *bytes, 2042861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice size_t bytes_len); 2043861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2044861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 204524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 204624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 204824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 20506e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 205124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 205224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 205424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 205624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 2058