Process.h revision bcb5b454767121980d937d2610ba762fdb575c45
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" 2324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Error.h" 2424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Event.h" 257508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham#include "lldb/Core/StringList.h" 2624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/ThreadSafeValue.h" 2724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/PluginInterface.h" 286e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice#include "lldb/Core/UserSettingsController.h" 2924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Breakpoint/BreakpointSiteList.h" 30a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan#include "lldb/Expression/ClangPersistentVariables.h" 31f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan#include "lldb/Expression/IRDynamicChecks.h" 3224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 3324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ObjCObjectPrinter.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 91238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton size_t 92238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetEnvironmentAsArgs (Args &env) const 93238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 94238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton dictionary::const_iterator pos, end = m_env_vars.end(); 95238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton for (pos = m_env_vars.begin(); pos != end; ++pos) 96238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 97238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string env_var_equal_value (pos->first); 98238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton env_var_equal_value.append(1, '='); 99238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton env_var_equal_value.append (pos->second); 100238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton env.AppendArgument (env_var_equal_value.c_str()); 101238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 102238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return env.GetArgumentCount(); 103238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 104238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 105238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 106238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardInputPath () const 107238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 108238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_input_path.empty()) 109238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 110238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_input_path.c_str(); 111238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 112238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 113238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 114238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardInputPath (const char *path) 115238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 116238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 117238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_input_path.assign (path); 118238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 119238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 120238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 121238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 122238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_input_path); 123238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 124238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 125238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 126238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 127238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardOutputPath () const 128238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 129238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_output_path.empty()) 130238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 131238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_output_path.c_str(); 132238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 133238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 134238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 135238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardOutputPath (const char *path) 136238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 137238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 138238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_output_path.assign (path); 139238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 140238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 141238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 142238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 143238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_output_path); 144238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 145238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 146238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 147238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 148238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardErrorPath () const 149238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 150238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_error_path.empty()) 151238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 152238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_error_path.c_str(); 153238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 154238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 155238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 156238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardErrorPath (const char *path) 157238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 158238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 159238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_error_path.assign (path); 160238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 161238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 162238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 163238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 164238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_error_path); 165238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 166238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 167238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 168238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton bool 169238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetDisableASLR () const 170238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 171238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_disable_aslr; 172238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 173238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 174238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 175238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetDisableASLR (bool b) 176238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 177238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_disable_aslr = b; 178238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 179238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 1806e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprotected: 1816e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1826e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 1836e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, 1846e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 1856e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1860021c97fbd17e38113d2e76b93c94ee05213ee45Johnny Chen const ConstString 1876e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CreateInstanceName (); 1886e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 189c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 1906e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice RunArgsVarName (); 1916e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 192c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 1936e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice EnvVarsVarName (); 1946e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 195c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 1966e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice InputPathVarName (); 1976e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 198c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 1996e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice OutputPathVarName (); 2006e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 201c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2026e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ErrorPathVarName (); 2036e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 204c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2056e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice PluginVarName (); 2066e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 207c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2086e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice DisableASLRVarName(); 2096e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 2106e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 2116e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprivate: 2126e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 213238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton typedef std::map<std::string, std::string> dictionary; 2146e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Args m_run_args; 215238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton dictionary m_env_vars; 2166e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_input_path; 2176e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_output_path; 2186e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_error_path; 219f2c330df115cfdaedbf9d359b00f3ebb3cab9887Caroline Tice ProcessPlugins m_plugin; 2206e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool m_disable_aslr; 2216e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice}; 2226e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 2236e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 22424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 22524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 22624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 22724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 22824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 22924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 23024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 23124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 2326e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public PluginInterface, 2336e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public ProcessInstanceSettings 23424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 23524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 23624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 23724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 23824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 23924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 24024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 24124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 24224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 24324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 24424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 24524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 24624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 247e28824e0b988221c7eedf8e3d212527d2bdac6a7Eli Friedman eBroadcastBitSTDERR = (1 << 3) 24824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 24924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 25024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 25124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 25224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 25324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 25424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 25524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 25624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 25724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 25824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 25924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 26024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 26124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 26224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 26324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 26424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 26524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 26624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 26724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 26824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 26924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 27024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 27124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 27224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 27324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 27424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 27524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 27624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 27724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 27824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 27924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 28024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 28124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 28224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 28324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 28424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 28524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 28624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 28724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 28824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessSP() const; 28924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 29124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState() const; 29224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 29424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestarted () const; 29524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 29724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 29824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 30024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 30124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 30224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 30324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 30424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 30524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 30624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 30724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 30824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 30924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 31024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 31124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 31224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 31324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 31424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 31524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 31624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 31724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 31824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 31924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 32224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 32424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval(); 32524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 32724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestarted (bool new_value); 32824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 32924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 33024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 33124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 33224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_update_state; 33324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 33424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 33524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 3366e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 337d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton class SettingsController : public UserSettingsController 3386e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice { 3396e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public: 3406e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 341d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton SettingsController (); 3426e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3436e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 344d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton ~SettingsController (); 3456e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3466e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry global_settings_table[]; 3476e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry instance_settings_table[]; 3486e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3496e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice protected: 3506e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3516e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice lldb::InstanceSettingsSP 352d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton CreateInstanceSettings (const char *instance_name); 3536e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static lldb::OptionEnumValueElement g_plugins[]; 3556e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3566e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice private: 3576e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 3586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice // Class-wide settings. 3596e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 360d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton DISALLOW_COPY_AND_ASSIGN (SettingsController); 3616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice }; 3626e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 36324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 36424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3656e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static lldb::UserSettingsControllerSP 3666e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice GetSettingsController (bool finish = false); 3676e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 36824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 36924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 37024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 37124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 37224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 37324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 37424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 37524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 37624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 37724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 37824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 37924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 38024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 38124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 38224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 38324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 38424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 38524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 38624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 38724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 38824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 38924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 39024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 39124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 39224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 39324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 39424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 39524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 39624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 39724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 39824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 39924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 40024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static Process* 40124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner FindPlugin (Target &target, const char *plugin_name, Listener &listener); 40224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 40324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 40424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 40524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 40624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 40724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 40824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 40924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 41024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 41124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 41224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 41324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 41424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 41524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 41624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 41724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 41824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 41924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 42024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 42124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 42224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 42324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 42424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 42524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 42624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 42724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 428fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 42924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 43024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 43124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 43224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 43324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 43424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 43524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 43624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 43724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CanDebug (Target &target) = 0; 43824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 43924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 44024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 44124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 44224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 44324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 44424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 44524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 44624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 44724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 44824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 44924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 45024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 45124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 45224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 45324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 45424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 45524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 45624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 45724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 45824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 45924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 46024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 46124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 46224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 46324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 46424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 46524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 46624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 46724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 46824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 46924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 47024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 47124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 47224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 473452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 474452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 475452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 47624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 47724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 47824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 47924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 48024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 48124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 48224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 48324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 48424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 48524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 48624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 48724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 48824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 48924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 49024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 49124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 49224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 49324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 49424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 49524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 49624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Launch (char const *argv[], 49724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *envp[], 498452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton uint32_t launch_flags, 49924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdin_path, 50024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdout_path, 50124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stderr_path); 50224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 50324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 50424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 50524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 50624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 50724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillAttach (lldb::pid_t) 50824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoAttach (lldb::pid_t) will 50924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 51024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 51124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 51224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 51324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 51424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 51524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 51624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 51724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 51824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 51924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 52024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (lldb::pid_t pid); 52124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 52224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 52324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process by process name. 52424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 52524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 52624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call 52724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::WillAttach (const char *) and if that returns \b 52824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, Process::DoAttach (const char *) will be called to 52924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// actually do the attach. If DoAttach returns \b true, then 53024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DidAttach() will be called. 53124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 53224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 53324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A process name to match against the current process list. 53424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 53524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 53624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 53724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 53824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 53924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 54024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (const char *process_name, bool wait_for_launch); 5417508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 5427508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 5437508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// List the processes matching the given partial name. 5447508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5457508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// FIXME: Is it too heavyweight to create an entire process object to do this? 5467508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// The problem is for remote processes we're going to have to set up the same transport 5477508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// to get this data as to actually attach. So we need to factor out transport 5487508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// and process before we can do this separately from the process. 5497508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5507508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[in] name 5517508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// A partial name to match against the current process list. 5527508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5537508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[out] matches 5547508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// The list of process names matching \a name. 5557508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5567508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[in] pids 5577508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// A vector filled with the pids that correspond to the names in \a matches. 5587508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5597508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @return 5607508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Returns the number of matching processes. 5617508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 5627508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 5637508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham virtual uint32_t 5647508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham ListProcessesMatchingName (const char *name, StringList &matches, std::vector<lldb::pid_t> &pids); 5657508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 5667508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 5677508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Find the architecture of a process by pid. 5687508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5697508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// FIXME: See comment for ListProcessesMatchingName. 5707508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5717508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[in] pid 5727508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// A pid to inspect. 5737508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5747508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @return 5757508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Returns the architecture of the process or an invalid architecture if the process can't be found. 5767508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 5777508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham virtual ArchSpec 5787508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham GetArchSpecForExistingProcess (lldb::pid_t pid); 5797508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 5807508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 5817508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Find the architecture of a process by name. 5827508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5837508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// FIXME: See comment for ListProcessesMatchingName. 5847508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5857508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @param[in] process_name 5867508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// The process name to inspect. 5877508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// 5887508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// @return 5897508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham /// Returns the architecture of the process or an invalid architecture if the process can't be found. 5907508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 5917508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham virtual ArchSpec 5927508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham GetArchSpecForExistingProcess (const char *process_name); 59324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 59424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 59524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetAddressByteSize(); 59624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 59724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 59824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 59924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 60024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 60124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 60224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 60324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 60424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 60524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 60624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 60724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 60824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 60924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 61024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 61124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 61224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 61324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 61424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 61524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 61624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 61724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 61824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 61924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 62024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 62124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 62224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 62324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 62424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 62524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 62624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 62724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 62824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 62924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 63024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 63124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 63224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 63324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 63424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 63524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 63624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 63724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 63824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 63924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 64024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 64124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 64224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 64324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 64424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 64524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 64624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 64724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 64824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 64924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 65024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 65124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 65224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 65324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 65424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 65524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 65624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 65724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 65824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 65924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 66024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 66124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 66224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 66324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 66424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 66524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 66624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 66724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 66824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 66924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 67024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 67124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 67224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 67324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 67424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 67524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 67624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 67724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Resume (); 67824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 67924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 68024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 68124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 68224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 68324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 68424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 68524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 68624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 68724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 68824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 68924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 69024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 69124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 69224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 69324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 69424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 69524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 69624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 69724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 69824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 69924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 70024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 70124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 70224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 70324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 70424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 70524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 70624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 70724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 70824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 70924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 71024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 71124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 71224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 71324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 71424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 71524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 71624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 71724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 71824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 71924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 72024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 72124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 72224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 72324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 72424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 72524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 72624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 72724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 72824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 72924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetUnixSignals (); 73024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 73124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 73224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 73324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 73424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 73524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 73624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 73724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 73824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 73924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 74024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 74124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 74224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 74324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 74424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 74524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 74654e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 74724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 74824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 74924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 75024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 75124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 75224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 75324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 75424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 75524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 75624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 75724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 75824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 75924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 76024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 76154e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 76224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 76324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 76424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 76524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 76624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 76724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 76824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 76924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 77024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 77124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 77224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 77324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 77424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 77524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 77624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 77754e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithID (lldb::pid_t pid) = 0; 77824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 77924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 78024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 78124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 78224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 78324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 78424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 78524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 78624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 78724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 78824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 78924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 79024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 79124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 79224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 79324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 79424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 79554e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithName (const char *process_name, bool wait_for_launch) 79624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 79724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 79824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 79924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 80024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 80124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 80224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 80324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 80424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 80524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 80624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 80724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 80824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 80924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 81024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 81124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 81224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 81324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 81424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 81524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 81624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 81724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 81824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 81924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 82024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 82124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 82224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 82324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 82424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 82524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 82624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 82724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 82824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 82924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 83024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 83124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 83224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 83324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 83424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 83524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 83624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 83724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 83824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 83924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 84024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 84124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 84224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 84324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 84424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 84524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 846452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 847452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 848452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 84924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 85024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 85124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 85224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 85324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 85424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 85524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 85624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 85724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 85824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 85924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 86024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 86124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 86224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 86324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 86424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 86524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 86624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 86724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 86824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 86924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoLaunch (Module* module, 87024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *argv[], 87124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *envp[], 872452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton uint32_t launch_flags, 87324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdin_path, 87424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdout_path, 87524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stderr_path) = 0; 87624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 87724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 87824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 87924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 88024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 88124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 88224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 88324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 88424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 88524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 88624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 88724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 88824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 88924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 89024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 89124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 89224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 89324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 89424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 89524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 89624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 89724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 89824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 89924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 90024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 90124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 90224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 90324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 90424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 90524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 90624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 90724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 90824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 90924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 91024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 91124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 91224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 91324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 91424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 91524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 91624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 91724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 91824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoResume () = 0; 91924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 92024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 92124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 92224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 92324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 92424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 92524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 92624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 92724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 92824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 92924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 93024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 93124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 93224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 93324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 93424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 93524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 93624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 93724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 93824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 93924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 94024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 94124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 94224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 94324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 94424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 94524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 94624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 94724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 94824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 94924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 95024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoHalt () = 0; 95124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 95224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 95324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 95424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 95524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 95624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 95724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 95824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 95924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 96024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 96124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 96224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 96324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 96424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 96524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 96624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 96724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 96824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 96924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 97024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 97124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 97224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 97324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 97424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 97524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 97624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 97724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 97824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 97924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 98024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 98124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 98224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 98324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 98424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDetach () = 0; 98524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 98624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 98724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 98824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 98924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 99024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 99124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 99224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 99324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 99424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 99524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 99624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 99724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 99824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 99924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 100024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 100124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 100224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 100324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 100424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 100524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 100624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 100724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 100824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 100924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 101024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 101124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 101224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 101324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 101424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 101524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 101624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoSignal (int signal) = 0; 101724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 101824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 101924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 102024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 102124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 102224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 102324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 102424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 102524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 102624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 102724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 102824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 102924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 103024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 103224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 103324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 103424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 103524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 103724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 103824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 103924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 104024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 104124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 104224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 104324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 104424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 104524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 104624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 104724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 104824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 104924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 105024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 105124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 105224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 105324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 105424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 105524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 105624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 105724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 105824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 105924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 106024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 106124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 106224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 106324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 106424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetTarget (); 106524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 106624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 106724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 106824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 106924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 107024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 107124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 107224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 107324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 107424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetTarget () const; 107524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 107624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 107724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 107824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 107924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 108024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 108124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 108224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 108324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 108424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 108524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 108624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 108724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 108824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class CommandObjectProcessLaunch; 108924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class ProcessEventData; 109024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner friend class CommandObjectBreakpointCommand; 109124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 109324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 109424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 109624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 109724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 109924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 110024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 110124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 110224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 110324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 110424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 110524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 110624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 110724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 110824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 110924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 111024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 111124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 111224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 111324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 111424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 111524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 111624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 111724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 111824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 111924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 112024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 112124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 112224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 112324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 112424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 112524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 112624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the number of times this process has posted a stop event. 112724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 112824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 112924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of times this process has stopped while being 113024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debugged. 113124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 113224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 113324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStopID () const; 113424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 113524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 113624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 113724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 113824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 113924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 114024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 114124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 114224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 114324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 114424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 114524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 114624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 114724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 114824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 114924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 115024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 115124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 115224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 115324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 115424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 115524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 115624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 115724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 115824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 115924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 116024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 116124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 116224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 116324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 116424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 116524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 116624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 116724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 116824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 116924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 117024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 117124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 117224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 117324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 117424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 117524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 117624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 117724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 117824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 117924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 118024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 118124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 118224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 118324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 118424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 118524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 118724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 118824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 118924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 119024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 119124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 119224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 119324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 119424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 119524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 119624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 119724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 119824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 119924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 120024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 120124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 120224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 120424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 120524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 120624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 120824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 120924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 121024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 121124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 121224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 121324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 121424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 121524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 121624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 121724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 121824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 121924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 122024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 122124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 122224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 122324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 122424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 122524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 122624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 122724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 122824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 122924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 123024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 123124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 123224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 123324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 123424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 123524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 123624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 123724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 123824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 123924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 124024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 124124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 124224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 124324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 124424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 124524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) = 0; 124624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 124724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 124824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 124924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 125024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 125124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 125224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 125324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 125424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 125524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 125624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 125724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 125824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 125924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 126024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 126124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 126224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 126324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 126424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 126524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 126624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 126724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 126824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 126924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 127024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 127124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 127224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 127324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 127424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 127724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 127824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 127924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 128024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 128124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 128224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 128324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 128424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 128524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 128624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 128724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 128824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 128924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 129024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 129124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 129224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAllocateMemory (size_t size, uint32_t permissions, Error &error) = 0; 129324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 129424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 129524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 129624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 129724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 129824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 129924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 130024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 130124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 130224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 130324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 130424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 130524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 130624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 130724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 130824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 130924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 131024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 131124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 131224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 131324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 131424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 131624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 131724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 131924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 132024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 132124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 132224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 132324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 132424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 132524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 132624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 132724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 132824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 132924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 133024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 133124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 133224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 133324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDeallocateMemory (lldb::addr_t ptr) = 0; 133424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 133524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 133624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 133724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 133824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 133924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 134024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 134124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 134324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 134424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 134524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 134624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 134724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 134824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 134924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 135024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 135124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 135424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 135524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 135624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 135724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 135824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 135924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 136024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 136124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 136224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 136324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 136424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 136524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 136624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 136724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 136824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 136924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 137024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 137124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 137224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 137324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 137424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDOUT (char *buf, size_t buf_size, Error &error) 137524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 137624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdout unsupported"); 137724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 137824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 137924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 138224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 138324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 138424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 138524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 138624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 138724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 138824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 138924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 139024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 139124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 139224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 139324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 139424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 139524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 139624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 139724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 139824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 139924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 140024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 140124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 140224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 140324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDERR (char *buf, size_t buf_size, Error &error) 140424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 140524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stderr unsupported"); 140624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 140724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 140824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 141024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 141124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 141224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 141324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 141424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 141524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 141624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 141724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 141824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 141924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 142024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site) = 0; 142124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 142224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 142324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpoint (BreakpointSite *bp_site) = 0; 142424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 142524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 142624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpoint (BreakpointSite *bp_site) = 0; 142724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 142824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 142924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 143024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 143124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 143224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 143324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 143424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 143524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 143624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 143724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 143824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 143924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 144024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 144124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 144224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 144324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 144424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 144524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 144624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 144724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 144824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 144924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 145024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 145124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 145224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 145324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 14543fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 145524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CreateBreakpointSite (lldb::BreakpointLocationSP &owner, 145624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 145724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 145824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 145924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 146024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 146124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 146224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 146324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 146424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 146524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 146624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 146724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 146824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 146924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 147024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 147124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 147224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 147324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 147424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 147524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 147624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 147724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableWatchpoint (WatchpointLocation *bp_loc); 148024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 148224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableWatchpoint (WatchpointLocation *bp_loc); 148324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 148524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 148624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 148724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t 148824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UpdateThreadListIfNeeded () = 0; 148924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 149124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetThreadList (); 149224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ThreadList & 149424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetThreadList () const; 149524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 149724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 149824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 150124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 150324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 150424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 150524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 150624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessToStop (const TimeValue *timeout); 150724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 150824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 150924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 151024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 151224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 151324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 151624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 151724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 151824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 151924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 152024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 152224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 152324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 152524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 152624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 152724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 152824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 152924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 153024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 153224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Gets the byte order for this process. 153324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 153424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 153524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A valid ByteOrder enumeration, or eByteOrderInvalid. 153624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 153724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::ByteOrder 153824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetByteOrder () const = 0; 153924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 154024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ConstString & 154124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetTargetTriple () 154224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return m_target_triple; 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 154524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 154624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ABI * 154724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 154824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 154924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual DynamicLoader * 155024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetDynamicLoader (); 155124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 155224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 155324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 1554f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 1555f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 1556f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 1557f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan return m_dynamic_checkers.get(); 1558f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 1559f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 1560f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 1561f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 1562f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan m_dynamic_checkers.reset(dynamic_checkers); 1563f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 156424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 156524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 156724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Target * 156924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CalculateTarget (); 157024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 157124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Process * 157224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CalculateProcess (); 157324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 157424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Thread * 157524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CalculateThread (); 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 157724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual StackFrame * 157824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CalculateStackFrame (); 157924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 158024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 158124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Calculate (ExecutionContext &exe_ctx); 158224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 158324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP 158424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSP (); 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1586a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan ClangPersistentVariables & 1587a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan GetPersistentVariables(); 1588a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan 158924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ObjCObjectPrinter & 159024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetObjCObjectPrinter(); 159124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 159224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 159324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 159424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 159524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 159624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 159724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 159824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 159924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 160024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 160124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 160224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 160324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_stop_id; ///< A count of many times the process has stopped. 160524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 160624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 160724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 160824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 160924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 161024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 161124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend 161224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ///< to insert in the target. 1613a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan ClangPersistentVariables m_persistent_vars; ///< These are the persistent variables associated with this process for the expression parser. 1614f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers; ///< The functions used by the expression parser to validate data that expressions use. 161524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 161624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ConstString m_target_triple; 161724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 161824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ObjCObjectPrinter m_objc_object_printer; 161924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 162124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 162224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 162424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 162524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 162724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 162824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 163024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 163124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 163324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StartPrivateStateThread (); 163424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 163624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 163724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 163924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 164224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 164324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 164524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 164624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 164824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 164924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 165024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 165124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 165224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 165324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 165424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 165524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 165624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 165724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CompleteAttach (); 165824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 165924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 166024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 166124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 166224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 166324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 166424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 166524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 166624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 166724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 166824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 166924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 167024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 167124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 167224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 167324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 167424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 167524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 16766e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 167724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 167824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 167924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 168024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 16826e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 168324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 168424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 168524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 168624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 168724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 168824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 168924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 1690