Process.h revision 567e7f3ba16eb48cb9fd6a2f26f2f7269eb6983c
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 14b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton#include <spawn.h> 15b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 1624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// C++ Includes 1724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include <list> 18b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton#include <iosfwd> 19ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton#include <vector> 2024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Other libraries and framework includes 2224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Project includes 2324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/lldb-private.h" 24e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Core/ArchSpec.h" 2524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Broadcaster.h" 26861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice#include "lldb/Core/Communication.h" 2724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Error.h" 2824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Event.h" 297508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham#include "lldb/Core/StringList.h" 3024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/ThreadSafeValue.h" 3124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/PluginInterface.h" 326e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice#include "lldb/Core/UserSettingsController.h" 3324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Breakpoint/BreakpointSiteList.h" 34a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan#include "lldb/Expression/ClangPersistentVariables.h" 35f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan#include "lldb/Expression/IRDynamicChecks.h" 36ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton#include "lldb/Host/FileSpec.h" 37e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Args.h" 38e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Options.h" 3924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 40613b8739a4d489b7f1c571288d5786768c024205Greg Clayton#include "lldb/Target/Memory.h" 4124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ThreadList.h" 4224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/UnixSignals.h" 4324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 4524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 46b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 47b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceSettings 48b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 496e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeclass ProcessInstanceSettings : public InstanceSettings 506e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice{ 516e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticepublic: 526e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 53004afcb95736e97d071b1dd9b5254800e11e581cCaroline Tice ProcessInstanceSettings (UserSettingsController &owner, bool live_instance = true, const char *name = NULL); 546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 556e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings (const ProcessInstanceSettings &rhs); 566e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 576e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ~ProcessInstanceSettings (); 596e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings& 616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice operator= (const ProcessInstanceSettings &rhs); 626e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 636e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 646e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 656e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice UpdateInstanceSettingsVariable (const ConstString &var_name, 666e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *index_value, 676e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *value, 686e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &instance_name, 696e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const SettingEntry &entry, 70b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton VarSetOperationType op, 716e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Error &err, 726e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 736e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 74bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice bool 756e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice GetInstanceSettingsValue (const SettingEntry &entry, 766e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &var_name, 775bc8c97d62b2e399bd90fb7e00c903d7887412abCaroline Tice StringList &value, 78bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice Error *err); 796e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 806e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 81238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const Args & 82238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetRunArguments () const 83238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 84238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_run_args; 85238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 86238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 87238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 88238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetRunArguments (const Args &args) 89238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 90238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_run_args = args; 91238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 92238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 93638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton void 94638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton GetHostEnvironmentIfNeeded (); 95638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton 96238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton size_t 97638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton GetEnvironmentAsArgs (Args &env); 98238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 99238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 100238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardInputPath () const 101238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 102238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_input_path.empty()) 103238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 104238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_input_path.c_str(); 105238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 106238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 107238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 108238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardInputPath (const char *path) 109238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 110238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 111238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_input_path.assign (path); 112238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 113238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 114238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 115238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 116238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_input_path); 117238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 118238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 119238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 120238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 121238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardOutputPath () const 122238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 123238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_output_path.empty()) 124238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 125238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_output_path.c_str(); 126238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 127238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 128238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 129238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardOutputPath (const char *path) 130238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 131238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 132238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_output_path.assign (path); 133238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 134238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 135238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 136238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 137238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_output_path); 138238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 139238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 140238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 141238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton const char * 142238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetStandardErrorPath () const 143238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 144238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (m_error_path.empty()) 145238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return NULL; 146238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_error_path.c_str(); 147238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 148238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 149238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 150238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetStandardErrorPath (const char *path) 151238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 152238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton if (path && path[0]) 153238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_error_path.assign (path); 154238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton else 155238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 156238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton // Make sure we deallocate memory in string... 157238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton std::string tmp; 158238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton tmp.swap (m_error_path); 159238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 160238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 161238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 162238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton bool 163238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton GetDisableASLR () const 164238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 165238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton return m_disable_aslr; 166238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 167238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 168238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton void 169238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton SetDisableASLR (bool b) 170238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton { 171238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton m_disable_aslr = b; 172238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton } 173bd666017403e102e0ca435d6da585ff979f83598Caroline Tice 174bd666017403e102e0ca435d6da585ff979f83598Caroline Tice bool 175bd666017403e102e0ca435d6da585ff979f83598Caroline Tice GetDisableSTDIO () const 176bd666017403e102e0ca435d6da585ff979f83598Caroline Tice { 177bd666017403e102e0ca435d6da585ff979f83598Caroline Tice return m_disable_stdio; 178bd666017403e102e0ca435d6da585ff979f83598Caroline Tice } 179bd666017403e102e0ca435d6da585ff979f83598Caroline Tice 180bd666017403e102e0ca435d6da585ff979f83598Caroline Tice void 181bd666017403e102e0ca435d6da585ff979f83598Caroline Tice SetDisableSTDIO (bool b) 182bd666017403e102e0ca435d6da585ff979f83598Caroline Tice { 183bd666017403e102e0ca435d6da585ff979f83598Caroline Tice m_disable_stdio = b; 184bd666017403e102e0ca435d6da585ff979f83598Caroline Tice } 185238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 1866e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprotected: 1876e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1886e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 1896e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, 1906e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 1916e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1920021c97fbd17e38113d2e76b93c94ee05213ee45Johnny Chen const ConstString 1936e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CreateInstanceName (); 1946e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 195c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 1966e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice RunArgsVarName (); 1976e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 198c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 1996e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice EnvVarsVarName (); 2006e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 201c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 202638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton InheritHostEnvVarName (); 203638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton 204638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton static const ConstString & 2056e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice InputPathVarName (); 2066e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 207c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2086e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice OutputPathVarName (); 2096e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 210c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2116e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ErrorPathVarName (); 2126e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 213c3c24084efb0e1c4734c136532c1e43e9427c912Jim Ingham static const ConstString & 2146e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice DisableASLRVarName(); 2156e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 216bd666017403e102e0ca435d6da585ff979f83598Caroline Tice static const ConstString & 217bd666017403e102e0ca435d6da585ff979f83598Caroline Tice DisableSTDIOVarName (); 218bd666017403e102e0ca435d6da585ff979f83598Caroline Tice 2196e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprivate: 2206e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 221238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton typedef std::map<std::string, std::string> dictionary; 2226e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Args m_run_args; 223238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton dictionary m_env_vars; 2246e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_input_path; 2256e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_output_path; 2266e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice std::string m_error_path; 2276e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool m_disable_aslr; 228bd666017403e102e0ca435d6da585ff979f83598Caroline Tice bool m_disable_stdio; 229638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton bool m_inherit_host_env; 230638351aee118e89c658ca295cb4e9d1db7849befGreg Clayton bool m_got_host_env; 2316e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice}; 2326e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 233b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 234b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInfo 235b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 236b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A base class for information for a process. This can be used to fill 237b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// out information for a process prior to launching it, or it can be 238b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// used for an instance of a process and can be filled in with the 239b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// existing values for that process. 240b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 241e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonclass ProcessInfo 242e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 243e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 244e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo () : 245ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable (), 246b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 247b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment (), 248b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid (LLDB_INVALID_UID), 249b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid (LLDB_INVALID_UID), 250e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch(), 251b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (LLDB_INVALID_PROCESS_ID) 252e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 253e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 254b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 255e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo (const char *name, 256e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec &arch, 257e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t pid) : 258b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_executable (name, false), 259b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 260b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment(), 261b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid (LLDB_INVALID_UID), 262b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid (LLDB_INVALID_UID), 263e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch (arch), 264b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (pid) 265e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 266e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 267e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 268e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 269e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear () 270e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 271ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.Clear(); 272b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments.Clear(); 273b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment.Clear(); 274b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid = LLDB_INVALID_UID; 275b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid = LLDB_INVALID_UID; 276e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch.Clear(); 277e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = LLDB_INVALID_PROCESS_ID; 278e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 279e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 280e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 281e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetName() const 282e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 283ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetCString(); 284e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 285b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 286e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 287e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetNameLength() const 288e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 289ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetLength(); 290e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 291e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 292e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 293e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetName (const char *name) 294e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 295ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.GetFilename().SetCString (name); 296ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 297ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 298ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton FileSpec & 299ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () 300ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 301ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 302e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 303b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 304ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton const FileSpec & 305ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () const 30624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 307ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 30824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 30924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 310a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 311b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetUserID() const 312a733c04608cc94592a15d27583529588e19db552Greg Clayton { 313b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid; 314a733c04608cc94592a15d27583529588e19db552Greg Clayton } 315b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 316a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 317b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetGroupID() const 318a733c04608cc94592a15d27583529588e19db552Greg Clayton { 319b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid; 320a733c04608cc94592a15d27583529588e19db552Greg Clayton } 32124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 32224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 323b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton UserIDIsValid () const 32424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 325b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid != UINT32_MAX; 32624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 32724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 32824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 329b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GroupIDIsValid () const 33024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 331b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid != UINT32_MAX; 33224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 33324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 334a733c04608cc94592a15d27583529588e19db552Greg Clayton void 335b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetUserID (uint32_t uid) 336a733c04608cc94592a15d27583529588e19db552Greg Clayton { 337b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid = uid; 338a733c04608cc94592a15d27583529588e19db552Greg Clayton } 339a733c04608cc94592a15d27583529588e19db552Greg Clayton 340a733c04608cc94592a15d27583529588e19db552Greg Clayton void 341b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetGroupID (uint32_t gid) 342a733c04608cc94592a15d27583529588e19db552Greg Clayton { 343b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid = gid; 344a733c04608cc94592a15d27583529588e19db552Greg Clayton } 345b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 346e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ArchSpec & 347e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () 348e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 349e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 350e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 351b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 352e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec & 353e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () const 354e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 355e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 356e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 357b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 358e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 359e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessID () const 360e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 361e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_pid; 362e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 363e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 364e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 365e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetProcessID (lldb::pid_t pid) 366e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 367e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = pid; 368e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 369e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 370a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 371a733c04608cc94592a15d27583529588e19db552Greg Clayton ProcessIDIsValid() const 372a733c04608cc94592a15d27583529588e19db552Greg Clayton { 373a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_pid != LLDB_INVALID_PROCESS_ID; 374a733c04608cc94592a15d27583529588e19db552Greg Clayton } 375b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 376b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 377b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Dump (Stream &s, Platform *platform) const; 378b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 379b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 380b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () 381b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 382b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 383b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 384b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 385b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 386b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () const 387b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 388b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 389b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 390b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 391b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 392b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetArgumentsFromArgs (const Args& args, 393b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool first_arg_is_executable, 394b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool first_arg_is_executable_and_argument); 395b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 396b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 397b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () 398b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 399b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 400b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 401b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 402b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 403b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () const 404b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 405b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 406b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 407b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 408b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 409b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileSpec m_executable; 410b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_arguments; 411b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_environment; 412b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_uid; 413b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_gid; 414b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ArchSpec m_arch; 415b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_pid; 416b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 417b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 418b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 419b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfo 420b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 421b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes an existing process and any discoverable information that 422b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// pertains to that process. 423b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 424b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfo : public ProcessInfo 425b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 426b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 427b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo () : 428b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (), 429b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 430b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 431b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 432b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 433b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 434b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 435b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo (const char *name, 436b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ArchSpec &arch, 437b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t pid) : 438b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (name, arch, pid), 439b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 440b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 441b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 442b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 443b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 444b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 445b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 446b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 447b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 448b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 449b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = UINT32_MAX; 450b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = UINT32_MAX; 451b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid = LLDB_INVALID_PROCESS_ID; 452b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 453b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 454b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 455b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveUserID() const 456b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 457b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid; 458b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 459b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 460b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 461b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveGroupID() const 462b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 463b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid; 464b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 465b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 466b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 467b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveUserIDIsValid () const 468b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 469b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid != UINT32_MAX; 470b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 471b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 472b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 473b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveGroupIDIsValid () const 474b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 475b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid != UINT32_MAX; 476b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 477b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 478b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 479b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveUserID (uint32_t uid) 480b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 481b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = uid; 482b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 483b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 484b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 485b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveGroupID (uint32_t gid) 486b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 487b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = gid; 488b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 489a733c04608cc94592a15d27583529588e19db552Greg Clayton 490a733c04608cc94592a15d27583529588e19db552Greg Clayton lldb::pid_t 491a733c04608cc94592a15d27583529588e19db552Greg Clayton GetParentProcessID () const 492a733c04608cc94592a15d27583529588e19db552Greg Clayton { 493a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid; 494a733c04608cc94592a15d27583529588e19db552Greg Clayton } 495a733c04608cc94592a15d27583529588e19db552Greg Clayton 496a733c04608cc94592a15d27583529588e19db552Greg Clayton void 497a733c04608cc94592a15d27583529588e19db552Greg Clayton SetParentProcessID (lldb::pid_t pid) 498a733c04608cc94592a15d27583529588e19db552Greg Clayton { 499a733c04608cc94592a15d27583529588e19db552Greg Clayton m_parent_pid = pid; 500a733c04608cc94592a15d27583529588e19db552Greg Clayton } 501a733c04608cc94592a15d27583529588e19db552Greg Clayton 502a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 503a733c04608cc94592a15d27583529588e19db552Greg Clayton ParentProcessIDIsValid() const 504a733c04608cc94592a15d27583529588e19db552Greg Clayton { 505a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid != LLDB_INVALID_PROCESS_ID; 506a733c04608cc94592a15d27583529588e19db552Greg Clayton } 50724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 50824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 50924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Dump (Stream &s, Platform *platform) const; 51024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 51124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton static void 512b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose); 513b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 514b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 515b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const; 516b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 517b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 518b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_euid; 519b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_egid; 520b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_parent_pid; 521b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 522b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 523b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 524b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 525b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessLaunchInfo 526b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 527b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes any information that is required to launch a process. 528b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 529b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 530b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchInfo : public ProcessInfo 531b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 532b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 533b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 534b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton class FileAction 535b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 536b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton public: 537b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 538b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction () : 539b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action (eFileActionNone), 540b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd (-1), 541b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg (-1), 542b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path () 543b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 544b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 545b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 546b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 547b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear() 548b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 549b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action = eFileActionNone; 550b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd = -1; 551b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg = -1; 552b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path.clear(); 553b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 554b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 555b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 556b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Close (int fd); 557b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 558b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 559b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Duplicate (int fd, int dup_fd); 560b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 561b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 562b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Open (int fd, const char *path, bool read, bool write); 563b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 564b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static bool 565b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AddPosixSpawnFileAction (posix_spawn_file_actions_t *file_actions, 566b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction *info, 567b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Log *log, 568b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error& error); 569b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 570b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton protected: 571b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton enum Action 572b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 573b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton eFileActionNone, 574b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton eFileActionClose, 575b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton eFileActionDuplicate, 576b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton eFileActionOpen 577b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton }; 578b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 579b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Action m_action; // The action for this file 580b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_fd; // An existing file descriptor 581b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_arg; // oflag for eFileActionOpen*, dup_fd for eFileActionDuplicate 582b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_path; // A file path to use for opening after fork or posix_spawn 583b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton }; 584b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 585b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo () : 586b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo(), 587b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_flags (), 588b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_stdin_info (), 589b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_stdout_info (), 590b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_stderr_info () 591b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 592b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 593b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 594b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 595b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (const FileAction &info) 596b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 597b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.push_back(info); 598b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 599b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 600b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 601b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendCloseFileAction (int fd) 602b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 603b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 604b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton file_action.Close (fd); 605b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (file_action); 606b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 607b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 608b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 609b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendDuplciateFileAction (int fd, int dup_fd) 610b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 611b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 612b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton file_action.Duplicate (fd, dup_fd); 613b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (file_action); 614b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 615b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 616b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 617b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendOpenFileAction (int fd, const char *path, bool read, bool write) 618b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 619b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 620b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton file_action.Open (fd, path, read, write); 621b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (file_action); 622b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 623b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 624b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 625b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendSuppressFileAction (int fd, bool read, bool write) 626b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 627b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 628b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton file_action.Open (fd, "/dev/null", read, write); 629b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (file_action); 630b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 631b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 632b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 633b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetNumFileActions () const 634b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 635b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_file_actions.size(); 636b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 637b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 638b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction * 639b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFileActionAtIndex (size_t idx) const 640b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 641b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (idx < m_file_actions.size()) 642b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return &m_file_actions[idx]; 643b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 644b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 645b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 646b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags & 647b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () 648b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 649b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 650b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 651b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 652b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Flags & 653b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () const 654b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 655b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 656b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 657b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 658b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 659b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetWorkingDirectory () const 660b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 661b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_working_dir.empty()) 662b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 663b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_working_dir.c_str(); 664b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 66524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 66624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 667b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetWorkingDirectory (const char *working_dir) 668b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 669b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (working_dir && working_dir[0]) 670b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.assign (working_dir); 671b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 672b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 673b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 674ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 675b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 676b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SwapWorkingDirectory (std::string &working_dir) 677ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 678b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.swap (working_dir); 679b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 680b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 681b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 682b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 683b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetProcessPluginName () const 684b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 685b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_plugin_name.empty()) 686b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 687b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_plugin_name.c_str(); 688b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 689b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 690b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 691b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetProcessPluginName (const char *plugin) 692b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 693b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (plugin && plugin[0]) 694b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.assign (plugin); 695b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 696b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 697ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 698ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 699b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 700b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 701ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 702b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 703b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 704b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 705b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_flags.Clear(); 706b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_stdin_info.Clear(); 707b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_stdout_info.Clear(); 708b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_stderr_info.Clear(); 709b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.clear(); 710ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 711a733c04608cc94592a15d27583529588e19db552Greg Clayton 712e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 713b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_working_dir; 714b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_plugin_name; 715b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags m_flags; // Bitwise OR of bits from lldb::LaunchFlags 716b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction m_stdin_info; // File action for stdin 717b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction m_stdout_info; // File action for stdout 718b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction m_stderr_info; // File action for stderr 719b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::vector<FileAction> m_file_actions; // File actions for any other files 720e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 721e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 722b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchCommandOptions : public Options 72324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton{ 72424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonpublic: 725b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 726b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchCommandOptions (CommandInterpreter &interpreter) : 727b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Options(interpreter) 728b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 729143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton // Keep default values of all options in one place: OptionParsingStarting () 730143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting (); 731b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 732b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 733b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ~ProcessLaunchCommandOptions () 734b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 735b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 736b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 737b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error 738143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton SetOptionValue (uint32_t option_idx, const char *option_arg); 739b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 740b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 741143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting () 742b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 743b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton launch_info.Clear(); 744b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 745b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 746b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const OptionDefinition* 747b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetDefinitions () 748b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 749b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return g_option_table; 750b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 751b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 752b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Options table: Required for subclasses of Options. 753b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 754b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static OptionDefinition g_option_table[]; 755b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 756b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Instance variables to hold the values for command options. 757b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 758b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo launch_info; 759b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 760b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 761b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 762b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfoMatch 763b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 764b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A class to help matching one ProcessInstanceInfo to another. 765b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 766b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 767b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoMatch 768b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 769b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 770b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch () : 77124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 77224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (lldb_private::eNameMatchIgnore), 77324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 77424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 77524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 77624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 777b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch (const char *process_name, 77824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType process_name_match_type) : 77924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 78024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (process_name_match_type), 78124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 78224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 78324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info.SetName (process_name); 78424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 78524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 786b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo & 78724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () 78824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 78924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 79024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 79124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 792b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 79324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () const 79424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 79524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 79624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 79724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 79824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 79924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetMatchAllUsers () const 80024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 80124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_all_users; 80224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 80324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 80424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 80524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetMatchAllUsers (bool b) 80624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 80724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users = b; 80824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 80924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 81024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType 81124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetNameMatchType () const 81224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 81324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_name_match_type; 81424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 81524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 81624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 81724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetNameMatchType (lldb_private::NameMatchType name_match_type) 81824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 81924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type = name_match_type; 82024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 82124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 82224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 82324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton NameMatches (const char *process_name) const; 82424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 82524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 826b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Matches (const ProcessInstanceInfo &proc_info) const; 82724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 82824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 82924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton MatchAllProcesses () const; 83024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 83124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Clear (); 83224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 83324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonprotected: 834b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo m_match_info; 83524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType m_name_match_type; 83624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool m_match_all_users; 83724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton}; 83824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 839b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoList 840e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 841e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 842b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoList () : 843e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos() 844e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 845e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 846e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 847e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 848e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear() 849e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 850e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.clear(); 851e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 852e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 853e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton uint32_t 854e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetSize() 855e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 856e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos.size(); 857e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 858e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 859e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 860b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Append (const ProcessInstanceInfo &info) 861e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 862e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.push_back (info); 863e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 864e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 865e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 866e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameAtIndex (uint32_t idx) 867e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 868e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 869e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetName(); 870e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return NULL; 871e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 872e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 873e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 874e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameLengthAtIndex (uint32_t idx) 875e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 876e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 877e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetNameLength(); 878e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return 0; 879e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 880e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 881e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 882e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessIDAtIndex (uint32_t idx) 883e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 884e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 885e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetProcessID(); 8862bc9eb3ba78efc64a273729b480bafc3bbaa433aJohnny Chen return 0; 887e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 888e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 889e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton bool 890b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetInfoAtIndex (uint32_t idx, ProcessInstanceInfo &info) 891e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 892e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 893e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 894e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton info = m_infos[idx]; 895e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return true; 896e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 897e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return false; 898e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 899e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 90024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton // You must ensure "idx" is valid before calling this function 901b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 90224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfoAtIndex (uint32_t idx) const 90324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 90424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton assert (idx < m_infos.size()); 90524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_infos[idx]; 90624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 90724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 908e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 909b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton typedef std::vector<ProcessInstanceInfo> collection; 910e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton collection m_infos; 911e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 912e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 9136e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 91421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// This class tracks the Modification state of the process. Things that can currently modify 91521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// the program are running the program (which will up the StopID) and writing memory (which 91621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// will up the MemoryID.) 91721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// FIXME: Should we also include modification of register states? 91821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 91921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamclass ProcessModID 92021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 92121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend bool operator== (const ProcessModID &lhs, const ProcessModID &rhs); 92221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghampublic: 92321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID () : 92421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id (0), 92521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id (0) 92621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 92721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 92821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID (const ProcessModID &rhs) : 92921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id (rhs.m_stop_id), 93021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id (rhs.m_memory_id) 93121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 93221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 93321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham const ProcessModID & operator= (const ProcessModID &rhs) 93421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 93521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (this != &rhs) 93621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 93721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = rhs.m_stop_id; 93821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id = rhs.m_memory_id; 93921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 94021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return *this; 94121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 94221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 94321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ~ProcessModID () {} 94421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 94521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void BumpStopID () { m_stop_id++; } 94621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void BumpMemoryID () { m_memory_id++; } 94721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 94821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetStopID() const { return m_stop_id; } 94921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetMemoryID () const { return m_memory_id; } 95021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 95121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool MemoryIDEqual (const ProcessModID &compare) const 95221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 95321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_memory_id == compare.m_memory_id; 95421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 95521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 95621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool StopIDEqual (const ProcessModID &compare) const 95721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 95821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id == compare.m_stop_id; 95921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 96021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 96121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void SetInvalid () 96221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 96321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = UINT32_MAX; 96421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 96521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 96621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool IsValid () const 96721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 96821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id != UINT32_MAX; 96921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 97021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamprivate: 97121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_stop_id; 97221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_memory_id; 97321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham}; 97421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator== (const ProcessModID &lhs, const ProcessModID &rhs) 97521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 97621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (lhs.StopIDEqual (rhs) 97721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham && lhs.MemoryIDEqual (rhs)) 97821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 97921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 98021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 98121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 98221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 98321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator!= (const ProcessModID &lhs, const ProcessModID &rhs) 98421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 98521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (!lhs.StopIDEqual (rhs) 98621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham || !lhs.MemoryIDEqual (rhs)) 98721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 98821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 98921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 99021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 99121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 99224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 99324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 99424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 99524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 99624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 997567e7f3ba16eb48cb9fd6a2f26f2f7269eb6983cGreg Clayton public ReferenceCountedBaseVirtual<Process>, 99824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 99924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 100024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 10016e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public PluginInterface, 10026e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public ProcessInstanceSettings 100324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 100424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 1005d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Inghamfriend class ClangFunction; // For WaitForStateChangeEventsPrivate 100621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectProcessLaunch; 100721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class ProcessEventData; 100821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectBreakpointCommand; 100921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class StopInfo; 101024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 101124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 101224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 101324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 101424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 101524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 101624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 101724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 101824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 101924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 102024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 1021e28824e0b988221c7eedf8e3d212527d2bdac6a7Eli Friedman eBroadcastBitSTDERR = (1 << 3) 102224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 102324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 102424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 102524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 102624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 102724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 102824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 102924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 1030360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 103124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 103324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 103424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 103524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 103624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 103724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 103924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 104024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 104124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 104224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 104324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 104424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 104524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 104624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 104724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 104824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 10493ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham friend class Process; 10503ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 105124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 105224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 105324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 105424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 105524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 105624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 105724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 105824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 105924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 106024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 106124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 106224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 106324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 10643ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetProcessSP() const 10653ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 10663ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_process_sp; 10673ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 106824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 10693ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetState() const 10703ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 10713ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_state; 10723ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 107324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 10743ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetRestarted () const 10753ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 10763ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_restarted; 10773ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 10783ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool 10793ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterrupted () const 10803ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 10813ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_interrupted; 10823ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 108324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 108424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 108524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 108624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 108724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 108824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 108924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 109124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 109224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 109424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 109524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 109724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 109824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 110024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 110124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 110224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 110324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 110424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 110524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 11063ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterruptedFromEvent (const Event *event_ptr); 11073ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 11083ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static void 11093ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterruptedInEvent (Event *event_ptr, bool new_value); 11103ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 11113ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static bool 111224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 111324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 111424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 111524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 111624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 11173ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetUpdateStateOnRemoval() 11183ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 11196cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham m_update_state++; 11203ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 112124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 11223ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetRestarted (bool new_value) 11233ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 11243ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_restarted = new_value; 11253ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 11263ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham void 11273ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterrupted (bool new_value) 11283ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 11293ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_interrupted = new_value; 11303ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 113124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 113224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 113324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 113424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 11356cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham int m_update_state; 11363ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool m_interrupted; 113724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 113824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 113924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 11406e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1141d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton class SettingsController : public UserSettingsController 11426e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice { 11436e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public: 11446e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1145d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton SettingsController (); 11466e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11476e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 1148d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton ~SettingsController (); 11496e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11506e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry global_settings_table[]; 11516e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry instance_settings_table[]; 11526e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11536e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice protected: 11546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11556e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice lldb::InstanceSettingsSP 1156d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton CreateInstanceSettings (const char *instance_name); 11576e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice private: 11596e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice // Class-wide settings. 11616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1162d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton DISALLOW_COPY_AND_ASSIGN (SettingsController); 11636e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice }; 11646e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 116521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 116624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 116724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1168990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 11692a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsInitialize (); 1170990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1171990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 11722a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsTerminate (); 1173990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1174990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static lldb::UserSettingsControllerSP & 1175990de7bb41d3afec6b789155408ff322187d8682Greg Clayton GetSettingsController (); 11766e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11771ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice void 11781ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice UpdateInstanceName (); 11791ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice 1180395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 118124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 118324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 118524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 118624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 118824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 118924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 119024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 119124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 119224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 119324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 119424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 119524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 119624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 119724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 119824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 119924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 120024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 120124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 120224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 120424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 120524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 120724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 120824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 120924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 121024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 121124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 121224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 121324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static Process* 121424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner FindPlugin (Target &target, const char *plugin_name, Listener &listener); 121524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 121924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 122024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 122124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 122224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 122324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 122424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 122524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 122624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 122724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 122824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 122924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 123024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 123124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 123224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 123324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 123424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 123524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 123624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 123724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1238395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton lldb::ByteOrder 1239395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetByteOrder () const; 1240395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 1241395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton uint32_t 1242395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetAddressByteSize () const; 1243395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 124424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 124524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 124624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1247fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 124824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 124924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 125024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 125124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 125224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 125324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 125424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 125524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 12568d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton CanDebug (Target &target, 12578d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton bool plugin_specified_by_name) = 0; 125824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 125924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 126124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 126224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 126324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 126424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 126524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 126624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 126724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 126824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 127024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 127124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 127224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 127324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 127424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 127524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 127624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 127724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 127824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 127924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 128024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 128124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 128224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 128324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 128424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 128524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 128624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 128724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 128824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 128924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 129024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 129124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 129224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1293452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1294452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1295452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 129624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 129724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 129824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 129924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 130024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 130124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 130224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 130324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 130424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 130524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 130624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 130724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 130824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 130924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 131024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1311de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1312de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1313de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 131424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 131524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 131624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 131724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 131824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 131924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Launch (char const *argv[], 132024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *envp[], 1321452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton uint32_t launch_flags, 132224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdin_path, 132324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdout_path, 1324de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton const char *stderr_path, 1325de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton const char *working_directory); 132624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 132724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 132824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 132924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 133024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 133124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillAttach (lldb::pid_t) 133224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoAttach (lldb::pid_t) will 133324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 133424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 133524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 133624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 133724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 133824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 133924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 134024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 134124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 134324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 134424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (lldb::pid_t pid); 134524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 134624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 134724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process by process name. 134824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 134924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 135024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call 135124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::WillAttach (const char *) and if that returns \b 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, Process::DoAttach (const char *) will be called to 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// actually do the attach. If DoAttach returns \b true, then 135424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DidAttach() will be called. 135524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 135624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 135724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A process name to match against the current process list. 135824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 135924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 136024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 136124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 136224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 136324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 136424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (const char *process_name, bool wait_for_launch); 13657508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1366e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1367e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton ConnectRemote (const char *remote_url); 13687508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1369dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool 1370dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham AttachedToProcess() const 1371dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham { 1372dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham return m_attached_to_process; 1373dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham } 13747508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 13757508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 137624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 137724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 137824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 137924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 138024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 138124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 138224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 138324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 138424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 138524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 138624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 138724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 138824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 138924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 139024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 139124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 139224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 13940baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Load a shared library into this process. 13950baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 13960baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Try and load a shared library into the current process. This 13970baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// call might fail in the dynamic loader plug-in says it isn't safe 13980baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// to try and load shared libraries at the moment. 13990baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 14000baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[in] image_spec 14010baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// The image file spec that points to the shared library that 14020baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// you want to load. 14030baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 14040baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[out] error 14050baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// An error object that gets filled in with any errors that 14060baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// might occur when trying to load the shared library. 14070baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 14080baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @return 14090baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// A token that represents the shared library that can be 14100baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// later used to unload the shared library. A value of 14110baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// LLDB_INVALID_IMAGE_TOKEN will be returned if the shared 14120baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// library can't be opened. 14130baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 14140baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual uint32_t 14150baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton LoadImage (const FileSpec &image_spec, Error &error); 14160baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 14170baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual Error 14180baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton UnloadImage (uint32_t image_token); 14190baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 14200baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 142124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 142224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 142324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 142424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 142524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 142624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 142724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 142824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 142924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 143124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 143224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 143324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 143424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 143524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 143624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 143724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 143824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 144024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 144124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 144224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 144324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 144424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 144524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 144624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 144724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 144824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 144924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 145024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 145124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 145224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 145324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 145424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 145524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 145624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 145724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 145824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 145924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 146024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 146124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 146224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 146424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 146524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 146624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 146724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 146924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 147024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 147124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 147224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 147324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 147524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 147624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 148024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 14813ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 148224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Resume (); 148324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 148524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 148624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 148724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 148824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 14893ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// If the process is successfully halted, a eStateStopped 14903ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// process event with GetInterrupted will be broadcast. If false, we will 14913ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// halt the process with no events generated by the halt. 149224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 149324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 14943ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// Returns an error object. If the error is empty, the process is halted. 14953ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// otherwise the halt has failed. 149624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 14973ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 149824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 149924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 150024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 150224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 150424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 150524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 150724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 150824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15093ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 151024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 151124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 151424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 151524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 151624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 151724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 151824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 151924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 152024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 152124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15223ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 152324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 152424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 152524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 152624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 152724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 152924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 153024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 153124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 153224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 153324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15343ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 153524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 153624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 1538395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetUnixSignals () 1539395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1540395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_unix_signals; 1541395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 154224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 154524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 154624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 154724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 154824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 154924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 155024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 155124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 155224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 155324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 155424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 155524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 155624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 155754e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 155824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 155924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 156024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 156124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 156224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 156424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 156524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 156624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 156724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 156824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 156924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 157024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 157124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 157254e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 157324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 157424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 157524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1577e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1578e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton DoConnectRemote (const char *remote_url) 1579e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton { 1580e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton Error error; 1581e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton error.SetErrorString ("remote connections are not supported"); 1582e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton return error; 1583e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton } 1584e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 158624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 158724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 158824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 158924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 159024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 159124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 159224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 159324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 159424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 159524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 159654e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithID (lldb::pid_t pid) = 0; 159724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 159824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 159924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 160024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 160224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 160324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 160524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 160624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 160724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 160824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 161024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 161124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 161224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 161324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 161454e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithName (const char *process_name, bool wait_for_launch) 161524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 161624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 161724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 161824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 161924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 162024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 162224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 162324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 162424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 162524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 162624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 162724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 162824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 162924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 163224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 163324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 163424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 163524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 163624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 163724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 163824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 163924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 164224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 164324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 164424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 164524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 164724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 164824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 165024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 165124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 165224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 165324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 165424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 165524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 165624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 165724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 165824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 165924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 166024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 166124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 166224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 166324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 166424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1665452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1666452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1667452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 166824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 166924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 167024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 167124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 167224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 167324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 167424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 167524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 167624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 167724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 167824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 167924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 168024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 168124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 168224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1683de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1684de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1685de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 168624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 168724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 168824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 168924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 169024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 169124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoLaunch (Module* module, 169224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *argv[], 169324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner char const *envp[], 1694452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton uint32_t launch_flags, 169524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdin_path, 169624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char *stdout_path, 1697de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton const char *stderr_path, 1698de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton const char *working_directory) = 0; 169924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 170024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 170124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 170224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 170324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 170424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 170524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 170624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 170724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 170824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 170924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 171024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 171124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 171224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 171324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 171524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 171624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 171824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 171924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 172024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 172124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 172224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 172324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 172424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 172524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 172624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 172824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 172924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 173024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 173124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 173224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 173324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 173424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 173524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 173624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 173724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 173824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 173924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 174024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 174124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoResume () = 0; 174224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 174324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 174424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 174524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 174724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 174824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 174924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 175024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 175124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 175224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 175324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 175424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 175524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 175724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 175824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 176024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 176124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 176224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 176324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 176424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 176524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 176624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 176724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1768360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt must produce one and only one stop StateChanged event if it actually 1769360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// stops the process. If the stop happens through some natural event (for 1770360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// instance a SIGSTOP), then forwarding that event will do. Otherwise, you must 1771360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// generate the event manually. Note also, the private event thread is stopped when 1772360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt is run to prevent the events generated while halting to trigger 1773360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// other state changes before the halt is complete. 17743ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 17753ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// @param[out] caused_stop 177620d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// If true, then this Halt caused the stop, otherwise, the 177720d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// process was already stopped. 17783ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 177924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 178024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 178124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 178224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 178324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 17843ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham DoHalt (bool &caused_stop) = 0; 178524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 178624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 178724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 178824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 178924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 179024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 179124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 179224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 179324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 179424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 179524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 179624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 179724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 179824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 179924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 180024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 180124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 180224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 180324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 180524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 180624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 180724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 180824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 180924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 181024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 181124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 181224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 181424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 181524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 181624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 181724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 181824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDetach () = 0; 181924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 182024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 182124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 182224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 182324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 182424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 182524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 182624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 182724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 182824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 182924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 183024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 183124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 183224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 183324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 183424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 183524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 183624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 183724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 183824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 183924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 184024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 184124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 184224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 184424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 184524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 184624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 184724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 184824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 184924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 185024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoSignal (int signal) = 0; 185124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 185524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 185624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 185824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 185924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 186024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 186124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 186224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 186324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 186424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 186624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 186824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 186924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 187124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 187224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 187324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 187424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 187624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 187724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 187824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 188024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 188124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 188224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 188324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 188424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 188524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 188724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 188824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 188924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 189024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 189224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 189324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 189424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 189524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 189624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 1898395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () 1899395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1900395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 1901395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 190224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 190324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 190424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 190524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 190724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 190824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 190924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 191024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 1911395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () const 1912395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1913395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 1914395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 1915395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 191624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 191724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 191824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 191924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 192024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 192124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 192224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 192324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 192424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 192524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 192624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 1927360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 1928b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResults 1929360f53f3c216ee4fb433da0a367168785328a856Jim Ingham RunThreadPlan (ExecutionContext &exe_ctx, 1930360f53f3c216ee4fb433da0a367168785328a856Jim Ingham lldb::ThreadPlanSP &thread_plan_sp, 1931360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool stop_others, 1932360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool try_all_threads, 1933360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool discard_on_error, 1934360f53f3c216ee4fb433da0a367168785328a856Jim Ingham uint32_t single_thread_timeout_usec, 1935360f53f3c216ee4fb433da0a367168785328a856Jim Ingham Stream &errors); 1936360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 1937360f53f3c216ee4fb433da0a367168785328a856Jim Ingham static const char * 1938b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResultAsCString (ExecutionResults result); 193924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1940abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton void 1941abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetStatus (Stream &ostrm); 1942abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 1943abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton size_t 1944abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetThreadStatus (Stream &ostrm, 1945abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton bool only_threads_with_stop_reason, 1946abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t start_frame, 1947abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames, 1948abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames_with_source); 1949abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 195024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 195124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 195324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 195424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 195624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 195724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195875c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 195975c703dd8b492bad25a987b96853626641ae7246Greg Clayton // Called internally 196075c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 196175c703dd8b492bad25a987b96853626641ae7246Greg Clayton void 196275c703dd8b492bad25a987b96853626641ae7246Greg Clayton CompleteAttach (); 196375c703dd8b492bad25a987b96853626641ae7246Greg Clayton 196424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 196524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 196724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 196824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 196924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 197024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 197124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 197224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 197324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 197424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 197624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 197724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 197824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 197924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 198024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 198124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 198324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 198424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 198724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 198824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 198924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 199024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 199221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// Get the Modification ID of the process. 199324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 199424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 199521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// The modification ID of the process. 199624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 199721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID 199821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetModID () const 199921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 200021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id; 200121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 200221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 200324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 200421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetStopID () const 200521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 200621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id.GetStopID(); 200721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 200821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 200924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 201024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 201124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 201224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 201324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 201424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 201524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 201624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 201724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 201824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 201924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 202024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 202124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 202224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 202324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 202424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 202572e1c782ba1e4226da37af4722af608de9f39408Greg Clayton virtual bool 202624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 202724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 202824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 202924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 203024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 203124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 203224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 203324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 203424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 203624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 203724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 203824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 204024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 204224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 204324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 204424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 204524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 204724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 204824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 204924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 205124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 205224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 205424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 205524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 205624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 205824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 205924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 206024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 206124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 206224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 206324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 206424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 206524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 206624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 206724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 206824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 206924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 207024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 207124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 207224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 207324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 207424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 207524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 207624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 207724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 207824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 207924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 208024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 208224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 208324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 208424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 208624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 208724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 208924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 209024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 209124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 209224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 209324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 209424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 209524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 209624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 209724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 209824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 209924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 210024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2101b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2102b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// Read a NULL terminated C string from memory 2103b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// 2104b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// This function will read a cache page at a time until the NULL 2105b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// C stirng terminator is found. It will stop reading if the NULL 2106b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// termination byte isn't found before reading \a cstr_max_len 2107b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// bytes, and the results are always guaranteed to be NULL 2108b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// terminated (at most cstr_max_len - 1 bytes will be read). 2109b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2110b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 2111b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2112b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton char *cstr, 2113b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t cstr_max_len); 2114b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2115fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 2116fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ReadMemoryFromInferior (lldb::addr_t vm_addr, 2117fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *buf, 2118fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t size, 2119fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 2120fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 21216d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 21226d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// Reads an unsigned integer of the specified byte size from 21236d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// process memory. 21246d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 21256d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] load_addr 21266d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// A load address of the integer to read. 21276d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 21286d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] byte_size 21296d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The size in byte of the integer to read. 21306d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 2131c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] fail_value 2132c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value to return if we fail to read an integer. 2133c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 21346d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[out] error 21356d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// An error that indicates the success or failure of this 21366d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// operation. If error indicates success (error.Success()), 21376d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// then the value returned can be trusted, otherwise zero 21386d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// will be returned. 21396d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 21406d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @return 21416d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The unsigned integer that was read from the process memory 21426d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// space. If the integer was smaller than a uint64_t, any 21436d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// unused upper bytes will be zero filled. If the process 21446d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// byte order differs from the host byte order, the integer 21456d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// value will be appropriately byte swapped into host byte 21466d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// order. 21476d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 2148f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton uint64_t 2149c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadUnsignedIntegerFromMemory (lldb::addr_t load_addr, 2150c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t byte_size, 2151c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint64_t fail_value, 2152c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2153c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2154c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t 2155c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadPointerFromMemory (lldb::addr_t vm_addr, 2156c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2157c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2158c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool 2159c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WritePointerToMemory (lldb::addr_t vm_addr, 2160c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t ptr_value, 2161c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2162c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 216324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 216424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 216524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 216724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 216824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 216924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 217024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 217124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 217224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 217324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 217424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 217524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 217624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2177c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2178c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2179c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 218024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 218124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 218224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 218324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 218424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) = 0; 218524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 218624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2187c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// Write all or part of a scalar value to memory. 2188c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2189c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value contained in \a scalar will be swapped to match the 2190c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// byte order of the process that is being debugged. If \a size is 2191c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// less than the size of scalar, the least significate \a size bytes 2192c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// from scalar will be written. If \a size is larger than the byte 2193c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// size of scalar, then the extra space will be padded with zeros 2194c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// and the scalar value will be placed in the least significant 2195c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// bytes in memory. 2196c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2197c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] vm_addr 2198c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// A virtual load address that indicates where to start writing 2199c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// memory to. 2200c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2201c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] scalar 2202c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The scalar to write to the debugged process. 2203c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2204c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] size 2205c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// This value can be smaller or larger than the scalar value 2206c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// itself. If \a size is smaller than the size of \a scalar, 2207c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the least significant bytes in \a scalar will be used. If 2208c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// \a size is larger than the byte size of \a scalar, then 2209c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the extra space will be padded with zeros. If \a size is 2210c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// set to UINT32_MAX, then the size of \a scalar will be used. 2211c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2212c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2213c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2214c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2215c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @return 2216c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The number of bytes that were actually written. 2217c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 2218c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2219c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WriteScalarToMemory (lldb::addr_t vm_addr, 2220c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton const Scalar &scalar, 2221c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t size, 2222c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2223c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2224c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2225c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadScalarIntegerFromMemory (lldb::addr_t addr, 2226c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t byte_size, 2227c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool is_signed, 2228c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Scalar &scalar, 2229c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2230c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2231c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 223224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 223324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 223424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 223524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 223624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 223724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 223824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 223924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 224024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 224124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 224324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 224424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 224524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 224724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 224824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 224924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 225024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 225124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 225224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 225324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 225424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 225524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 225624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 225724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 225824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 225924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 226024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 226124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 226224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 226324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 226424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 226524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 226624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 226724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 226824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 226924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 227024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 227124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 227224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 227324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 227424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 227524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 227624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAllocateMemory (size_t size, uint32_t permissions, Error &error) = 0; 227724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 227824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 227924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 228024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 228224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 228324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 228424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 228624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 228724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 228924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 229024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 229124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 229224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 229324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2294b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// @param[in/out] error 2295b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// An error object to fill in if things go wrong. 229624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 229724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 229824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 229924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 230024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 230124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 230224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 230324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 230424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 23056cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Determines whether executing JIT-compiled code in this process 23066cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 23076cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 23086cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @return 23096cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 23106cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 23116cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan bool CanJIT (); 23126cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 23136cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 23146cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Sets whether executing JIT-compiled code in this process 23156cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 23166cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 23176cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @param[in] can_jit 23186cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 23196cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 23206cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan void SetCanJIT (bool can_jit); 23216cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 23226cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 232324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 232424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 232524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 232624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 232724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 232824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 232924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 233024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 233124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 233324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 233424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 233524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 233624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 233724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDeallocateMemory (lldb::addr_t ptr) = 0; 233824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 233924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 234024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 234124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 234324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 234424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 234624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 234724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 234824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 235024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 235124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 235324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 235424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 235524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 235624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 235824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 235924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 236024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 236124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 236224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 236324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 236424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 236524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 236624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 236724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 236824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 236924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 237024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 237124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 237224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 237324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 237424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 237524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 237624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 237724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 237824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDOUT (char *buf, size_t buf_size, Error &error) 237924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 238024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdout unsupported"); 238124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 238224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 238324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 238424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 238524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 238624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 238724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 238824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 238924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 239024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 239124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 239224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 239324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 239424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 239524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 239624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 239724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 239824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 239924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 240024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 240224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 240324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 240424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 240524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 240624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 240724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDERR (char *buf, size_t buf_size, Error &error) 240824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 240924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stderr unsupported"); 241024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 241124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 241224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 241324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 241424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 241524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 241624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 241724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 241824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 241924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 242024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 242124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 242224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 2423b1888f24fa181489840b9acf193e224d125d0776Greg Clayton size_t 2424b1888f24fa181489840b9acf193e224d125d0776Greg Clayton GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site); 242524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 242624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 242724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpoint (BreakpointSite *bp_site) = 0; 242824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 242924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 243024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpoint (BreakpointSite *bp_site) = 0; 243124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 243224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 243324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 243424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 243524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 243624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 243724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 243824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 243924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 244024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 244124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 244224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 244324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 244424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 244524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 244624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 244724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 244824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 244924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 245024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 245124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 245224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 245324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 245424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 245524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 245624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 245724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 24583fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 245924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CreateBreakpointSite (lldb::BreakpointLocationSP &owner, 246024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 246124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 246324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 246424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 246624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 246724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 247024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 247124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 247224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 247324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 247424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 247524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 247624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 247724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 247824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 247924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 248024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 248124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 248224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 248324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableWatchpoint (WatchpointLocation *bp_loc); 248424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 248524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 248624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableWatchpoint (WatchpointLocation *bp_loc); 248724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 248824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 248924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 249024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 249124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t 249237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list) = 0; 249337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 249437f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton void 249537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadListIfNeeded (); 249624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 249724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 2498395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () 2499395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2500395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 2501395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 250224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 250524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 250624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 250824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 250924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 251024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 251124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 251224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 251324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 251424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessToStop (const TimeValue *timeout); 251524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 251624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 251724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 251824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 251924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 252024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 252163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 252224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2523f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham class 2524f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker 2525f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2526f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham public: 2527f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker (Process &process, Listener *listener) : 2528f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process (process), 2529f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_listener (listener) 2530f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2531f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.HijackProcessEvents (listener); 2532f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 2533f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ~ProcessEventHijacker () 2534f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2535f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.RestoreProcessEvents(); 2536f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 2537f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 2538f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham private: 2539f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Process &m_process; 2540f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Listener *m_listener; 2541f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham }; 2542f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham friend class ProcessEventHijacker; 254324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 254463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// If you need to ensure that you and only you will hear about some public 254563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// event, then make a new listener, set to listen to process events, and 254663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// then call this with that listener. Then you will have to wait on that 254763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// listener explicitly for events (rather than using the GetNextEvent & WaitFor* 254863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// calls above. Be sure to call RestoreProcessEvents when you are done. 254963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 255063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @param[in] listener 255163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// This is the new listener to whom all process events will be delivered. 255263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 255363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @return 255463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Returns \b true if the new listener could be installed, 255563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// \b false otherwise. 255663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 255763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham bool 255863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham HijackProcessEvents (Listener *listener); 255963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 256063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 256163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Restores the process event broadcasting to its normal state. 256263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 256363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 256463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham void 256563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham RestoreProcessEvents (); 256663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 256763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghamprotected: 256863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 256924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 257024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 257124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 257224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 257324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 257424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 257524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 257624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 257724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 257824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 257924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 258024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 258124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 258224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 258324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 258424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 258563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghampublic: 258675906e4ec98af3717e415727a8d663a4e246bb4fGreg Clayton const lldb::ABISP & 258724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 258824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 258975c703dd8b492bad25a987b96853626641ae7246Greg Clayton DynamicLoader * 259075c703dd8b492bad25a987b96853626641ae7246Greg Clayton GetDynamicLoader () 259175c703dd8b492bad25a987b96853626641ae7246Greg Clayton { 259275c703dd8b492bad25a987b96853626641ae7246Greg Clayton return m_dyld_ap.get(); 259375c703dd8b492bad25a987b96853626641ae7246Greg Clayton } 259475c703dd8b492bad25a987b96853626641ae7246Greg Clayton 259537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton OperatingSystem * 259637f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton GetOperatingSystem () 259737f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton { 259837f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton return m_os_ap.get(); 259937f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton } 260037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 260137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 2602642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual LanguageRuntime * 2603642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetLanguageRuntime (lldb::LanguageType language); 2604642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 2605642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual CPPLanguageRuntime * 2606642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetCPPLanguageRuntime (); 2607642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 2608642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual ObjCLanguageRuntime * 2609642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetObjCLanguageRuntime (); 261024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 261124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 261224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 2613f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 2614f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 2615f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 2616d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham return m_dynamic_checkers_ap.get(); 2617f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 2618f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 2619f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 2620f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 2621d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham m_dynamic_checkers_ap.reset(dynamic_checkers); 2622f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 262324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2624c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 2625c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to set the lldb in the mode where it breaks on new thread 2626c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// creations, and then auto-restarts. This is useful when you are trying 2627c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// to run only one thread, but either that thread or the kernel is creating 2628c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// new threads in the process. If you stop when the thread is created, you 2629c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// can immediately suspend it, and keep executing only the one thread you intend. 2630c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 2631c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 2632c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 2633c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 2634c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 263555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 263655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StartNoticingNewThreads() 263755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 263855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 263955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 264055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 2641c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 2642c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to turn off the stop & notice new threads mode. 2643c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 2644c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 2645c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 2646c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 2647c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 264855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 264955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StopNoticingNewThreads() 265055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 265155e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 265255e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 265355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 265424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 265524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 265624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 265724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Target * 2658395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateTarget () 2659395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2660395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return &m_target; 2661395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 266224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Process * 2664395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateProcess () 2665395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2666395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return this; 2667395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 266824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Thread * 2670395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateThread () 2671395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2672395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 2673395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 267424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 267524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual StackFrame * 2676395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateStackFrame () 2677395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2678395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 2679395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 268024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 268124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 2682a830adbcd63d1995a01e6e18da79893c1426ca43Greg Clayton CalculateExecutionContext (ExecutionContext &exe_ctx); 268324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 268424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP 268524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSP (); 268624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 268724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 2688c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 268921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // NextEventAction provides a way to register an action on the next 269021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // event that is delivered to this process. There is currently only 269121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // one next event action allowed in the process at one time. If a 269221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // new "NextEventAction" is added while one is already present, the 269321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // old action will be discarded (with HandleBeingUnshipped called 269421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // after it is discarded.) 2695c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 2696c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class NextEventAction 2697c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2698c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 2699c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham typedef enum EventActionResult 2700c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2701c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionSuccess, 2702c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionRetry, 2703c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionExit 2704c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } EventActionResult; 2705c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2706c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction (Process *process) : 2707c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham m_process(process) 2708c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham {} 2709c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual ~NextEventAction() {} 2710c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2711c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp) = 0; 2712c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual void HandleBeingUnshipped () {}; 2713c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted () = 0; 2714c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString() = 0; 2715c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham protected: 2716c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham Process *m_process; 2717c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 2718c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2719c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham void SetNextEventAction (Process::NextEventAction *next_event_action) 2720c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 272168bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham if (m_next_event_action_ap.get()) 272268bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap->HandleBeingUnshipped(); 272368bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham 272468bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap.reset(next_event_action); 2725c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } 2726c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2727c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // This is the completer for Attaching: 2728c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class AttachCompletionHandler : public NextEventAction 2729c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2730c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 2731c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham AttachCompletionHandler (Process *process) : 2732c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction(process) 2733c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham {} 2734c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual ~AttachCompletionHandler() {} 2735c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2736c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp); 2737c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted (); 2738c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString(); 2739c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham private: 2740c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham std::string m_exit_string; 2741c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 2742c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2743f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham bool 2744f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham HijackPrivateProcessEvents (Listener *listener); 2745f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 2746f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham void 2747f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham RestorePrivateProcessEvents (); 2748a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton 2749a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton bool 2750a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton PrivateStateThreadIsValid () const 2751a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton { 2752a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton return m_private_state_thread != LLDB_INVALID_HOST_THREAD; 2753a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton } 2754fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 275524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 275624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 275724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 275824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 275924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 276024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 276124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 276224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 276324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 276424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 276524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 276621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID m_mod_id; ///< Tracks the state of the process over stops and other alterations. 276724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 276824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 276924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 277024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 277124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 27720baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton std::vector<lldb::addr_t> m_image_tokens; 277324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 277424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend 277524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ///< to insert in the target. 277675c703dd8b492bad25a987b96853626641ae7246Greg Clayton std::auto_ptr<DynamicLoader> m_dyld_ap; 2777d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers_ap; ///< The functions used by the expression parser to validate data that expressions use. 277837f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton std::auto_ptr<OperatingSystem> m_os_ap; 277924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 278024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 2781861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderSP m_process_input_reader; 2782861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb_private::Communication m_stdio_communication; 278320d338fad87eba91de65aa9bec76e01c04472848Greg Clayton lldb_private::Mutex m_stdio_communication_mutex; 2784861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice std::string m_stdout_data; 2785fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache m_memory_cache; 2786613b8739a4d489b7f1c571288d5786768c024205Greg Clayton AllocatedMemoryCache m_allocated_memory_cache; 2787dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool m_attached_to_process; /// Did we launch the process or attach to it? 2788fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 2789642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham typedef std::map<lldb::LanguageType, lldb::LanguageRuntimeSP> LanguageRuntimeCollection; 2790642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham LanguageRuntimeCollection m_language_runtimes; 27917e2f91cb958c8670774cb2190db7b858618b5b9bGreg Clayton std::auto_ptr<NextEventAction> m_next_event_action_ap; 279224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 27936cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan enum { 27946cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITDontKnow= 0, 27956cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITYes, 27966cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITNo 27976cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan } m_can_jit; 27986cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 279924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 280024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 280124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 280224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 280324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 280424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 280524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 280624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 280724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 280824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 280924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 281024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 281124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 281224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StartPrivateStateThread (); 281324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 281424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 281524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 281624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 281724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 281824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 281924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 282124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 282224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 282424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 282524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 282724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 282824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 283024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 283124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 283324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 283424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 283624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 283724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 283924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 284024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 284224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 284324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 284524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 284624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 284724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 284824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 285024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 2851861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2852861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2853861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice AppendSTDOUT (const char *s, size_t len); 2854861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2855861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static void 2856861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len); 2857861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2858861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2859861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PushProcessInputReader (); 2860861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2861861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2862861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PopProcessInputReader (); 2863861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2864861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2865861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ResetProcessInputReader (); 2866861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2867861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2868861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice SetUpProcessInputReader (int file_descriptor); 2869861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2870861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static size_t 2871861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ProcessInputReaderCallback (void *baton, 2872861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice InputReader &reader, 2873861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderAction notification, 2874861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice const char *bytes, 2875861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice size_t bytes_len); 2876861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2877861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 287824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 287924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 288024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 288124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 288224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 28836e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 288424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 288524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 288624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 288724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 288824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 288924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 289024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 2891