Process.h revision b5a8f1498e1ddaeed5187a878d57ea0b74af9c26
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 1407c51d09d4b61891cdc37f44bb332dc286b4de2fBenjamin Kramer#include <limits.h> 15b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton#include <spawn.h> 16b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 1724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// C++ Includes 1824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include <list> 19b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton#include <iosfwd> 20ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton#include <vector> 2124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Other libraries and framework includes 2324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Project includes 2424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/lldb-private.h" 25e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Core/ArchSpec.h" 2624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Broadcaster.h" 27861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice#include "lldb/Core/Communication.h" 2824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Error.h" 2924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Event.h" 30a9385537809ef342c843c5ab972e513742652047Greg Clayton#include "lldb/Core/RangeMap.h" 317508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham#include "lldb/Core/StringList.h" 3224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/ThreadSafeValue.h" 3324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/PluginInterface.h" 346e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice#include "lldb/Core/UserSettingsController.h" 3524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Breakpoint/BreakpointSiteList.h" 36a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan#include "lldb/Expression/ClangPersistentVariables.h" 37f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan#include "lldb/Expression/IRDynamicChecks.h" 38ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton#include "lldb/Host/FileSpec.h" 391c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton#include "lldb/Host/Host.h" 40e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Args.h" 41e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Options.h" 4224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 43613b8739a4d489b7f1c571288d5786768c024205Greg Clayton#include "lldb/Target/Memory.h" 4424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ThreadList.h" 4524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/UnixSignals.h" 46464c6161464694412b7472129e789248f1cf21b9Greg Clayton#include "lldb/Utility/PseudoTerminal.h" 4724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 4924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 50b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 51b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceSettings 52b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 536e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeclass ProcessInstanceSettings : public InstanceSettings 546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice{ 556e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticepublic: 566e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 57334d33a19fd28cf41cba74cc61cf149e7101a603Greg Clayton ProcessInstanceSettings (const lldb::UserSettingsControllerSP &owner_sp, bool live_instance = true, const char *name = NULL); 586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 596e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings (const ProcessInstanceSettings &rhs); 606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 626e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ~ProcessInstanceSettings (); 636e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 646e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings& 656e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice operator= (const ProcessInstanceSettings &rhs); 666e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 676e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 686e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 696e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice UpdateInstanceSettingsVariable (const ConstString &var_name, 706e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *index_value, 716e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *value, 726e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &instance_name, 736e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const SettingEntry &entry, 74b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton VarSetOperationType op, 756e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Error &err, 766e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 776e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 78bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice bool 796e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice GetInstanceSettingsValue (const SettingEntry &entry, 806e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &var_name, 815bc8c97d62b2e399bd90fb7e00c903d7887412abCaroline Tice StringList &value, 82bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice Error *err); 836e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 846e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 856e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprotected: 866e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 876e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 886e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, 896e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 906e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 910021c97fbd17e38113d2e76b93c94ee05213ee45Johnny Chen const ConstString 926e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CreateInstanceName (); 936e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice}; 946e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 95b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 96b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInfo 97b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 98b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A base class for information for a process. This can be used to fill 99b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// out information for a process prior to launching it, or it can be 100b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// used for an instance of a process and can be filled in with the 101b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// existing values for that process. 102b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 103e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonclass ProcessInfo 104e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 105e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 106e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo () : 107ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable (), 108b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 109b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment (), 110444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 111444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 112e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch(), 113b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (LLDB_INVALID_PROCESS_ID) 114e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 115e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 116b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 117e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo (const char *name, 118e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec &arch, 119e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t pid) : 120b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_executable (name, false), 121b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 122b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment(), 123444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 124444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 125e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch (arch), 126b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (pid) 127e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 128e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 129e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 130e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 131e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear () 132e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 133ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.Clear(); 134b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments.Clear(); 135b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment.Clear(); 136444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid = UINT32_MAX; 137444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid = UINT32_MAX; 138e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch.Clear(); 139e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = LLDB_INVALID_PROCESS_ID; 140e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 141e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 142e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 143e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetName() const 144e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 145ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetCString(); 146e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 147b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 148e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 149e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetNameLength() const 150e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 151ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetLength(); 152e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 153e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 154ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton FileSpec & 155ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () 156ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 157ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 158e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 15936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 16036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 16136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetExecutableFile (const FileSpec &exe_file, bool add_exe_file_as_first_arg) 16236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file) 16436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable = exe_file; 16636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 16736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.Clear(); 16936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton char filename[PATH_MAX]; 17036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file.GetPath(filename, sizeof(filename))) 17136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.AppendArgument (filename); 17236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton else 17536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 17636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable.Clear(); 17736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 17836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.Clear(); 17936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 18036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 18136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 182ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton const FileSpec & 183ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () const 18424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 185ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 18624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 18724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 188a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 189b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetUserID() const 190a733c04608cc94592a15d27583529588e19db552Greg Clayton { 191b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid; 192a733c04608cc94592a15d27583529588e19db552Greg Clayton } 193b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 194a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 195b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetGroupID() const 196a733c04608cc94592a15d27583529588e19db552Greg Clayton { 197b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid; 198a733c04608cc94592a15d27583529588e19db552Greg Clayton } 19924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 20024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 201b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton UserIDIsValid () const 20224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 203b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid != UINT32_MAX; 20424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 20524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 20624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 207b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GroupIDIsValid () const 20824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 209b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid != UINT32_MAX; 21024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 21124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 212a733c04608cc94592a15d27583529588e19db552Greg Clayton void 213b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetUserID (uint32_t uid) 214a733c04608cc94592a15d27583529588e19db552Greg Clayton { 215b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid = uid; 216a733c04608cc94592a15d27583529588e19db552Greg Clayton } 217a733c04608cc94592a15d27583529588e19db552Greg Clayton 218a733c04608cc94592a15d27583529588e19db552Greg Clayton void 219b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetGroupID (uint32_t gid) 220a733c04608cc94592a15d27583529588e19db552Greg Clayton { 221b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid = gid; 222a733c04608cc94592a15d27583529588e19db552Greg Clayton } 223b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 224e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ArchSpec & 225e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () 226e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 227e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 228e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 229b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 230e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec & 231e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () const 232e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 233e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 234e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 235b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 236e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 237e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessID () const 238e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 239e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_pid; 240e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 241e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 242e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 243e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetProcessID (lldb::pid_t pid) 244e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 245e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = pid; 246e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 247e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 248a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 249a733c04608cc94592a15d27583529588e19db552Greg Clayton ProcessIDIsValid() const 250a733c04608cc94592a15d27583529588e19db552Greg Clayton { 251a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_pid != LLDB_INVALID_PROCESS_ID; 252a733c04608cc94592a15d27583529588e19db552Greg Clayton } 253b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 254b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 255b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Dump (Stream &s, Platform *platform) const; 256b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 257b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 258b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () 259b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 260b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 261b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 262b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 263b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 264b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () const 265b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 266b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 267b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 268b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 269b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 27036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetArguments (const Args& args, 27136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable, 27236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable_and_argument); 273b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 27436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 27536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetArguments (char const **argv, 27636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable, 27736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable_and_argument); 27836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 279b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 280b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () 281b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 282b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 283b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 284b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 285b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 286b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () const 287b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 288b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 289b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 290b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 291b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 292b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileSpec m_executable; 293b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_arguments; 294b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_environment; 295b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_uid; 296b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_gid; 297b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ArchSpec m_arch; 298b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_pid; 299b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 300b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 301b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 302b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfo 303b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 304b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes an existing process and any discoverable information that 305b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// pertains to that process. 306b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 307b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfo : public ProcessInfo 308b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 309b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 310b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo () : 311b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (), 312b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 313b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 314b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 315b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 316b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 317b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 318b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo (const char *name, 319b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ArchSpec &arch, 320b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t pid) : 321b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (name, arch, pid), 322b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 323b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 324b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 325b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 326b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 327b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 328b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 329b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 330b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 331b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 332b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = UINT32_MAX; 333b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = UINT32_MAX; 334b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid = LLDB_INVALID_PROCESS_ID; 335b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 336b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 337b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 338b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveUserID() const 339b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 340b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid; 341b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 342b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 343b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 344b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveGroupID() const 345b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 346b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid; 347b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 348b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 349b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 350b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveUserIDIsValid () const 351b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 352b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid != UINT32_MAX; 353b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 354b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 355b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 356b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveGroupIDIsValid () const 357b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 358b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid != UINT32_MAX; 359b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 360b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 361b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 362b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveUserID (uint32_t uid) 363b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 364b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = uid; 365b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 366b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 367b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 368b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveGroupID (uint32_t gid) 369b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 370b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = gid; 371b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 372a733c04608cc94592a15d27583529588e19db552Greg Clayton 373a733c04608cc94592a15d27583529588e19db552Greg Clayton lldb::pid_t 374a733c04608cc94592a15d27583529588e19db552Greg Clayton GetParentProcessID () const 375a733c04608cc94592a15d27583529588e19db552Greg Clayton { 376a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid; 377a733c04608cc94592a15d27583529588e19db552Greg Clayton } 378a733c04608cc94592a15d27583529588e19db552Greg Clayton 379a733c04608cc94592a15d27583529588e19db552Greg Clayton void 380a733c04608cc94592a15d27583529588e19db552Greg Clayton SetParentProcessID (lldb::pid_t pid) 381a733c04608cc94592a15d27583529588e19db552Greg Clayton { 382a733c04608cc94592a15d27583529588e19db552Greg Clayton m_parent_pid = pid; 383a733c04608cc94592a15d27583529588e19db552Greg Clayton } 384a733c04608cc94592a15d27583529588e19db552Greg Clayton 385a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 386a733c04608cc94592a15d27583529588e19db552Greg Clayton ParentProcessIDIsValid() const 387a733c04608cc94592a15d27583529588e19db552Greg Clayton { 388a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid != LLDB_INVALID_PROCESS_ID; 389a733c04608cc94592a15d27583529588e19db552Greg Clayton } 39024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 39124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 39224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Dump (Stream &s, Platform *platform) const; 39324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 39424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton static void 395b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose); 396b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 397b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 398b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const; 399b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 400b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 401b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_euid; 402b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_egid; 403b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_parent_pid; 404b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 4051c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 406b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 407b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 408b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessLaunchInfo 409b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 410b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes any information that is required to launch a process. 411b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 412b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 413b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchInfo : public ProcessInfo 414b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 415b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 416b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 417b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton class FileAction 418b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 419b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton public: 42036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton enum Action 42136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 42236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionNone, 42336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionClose, 42436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionDuplicate, 42536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionOpen 42636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton }; 42736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 428b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 429b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction () : 430b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action (eFileActionNone), 431b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd (-1), 432b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg (-1), 433b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path () 434b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 435b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 436b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 437b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 438b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear() 439b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 440b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action = eFileActionNone; 441b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd = -1; 442b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg = -1; 443b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path.clear(); 444b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 445b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 446b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 447b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Close (int fd); 448b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 449b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 450b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Duplicate (int fd, int dup_fd); 451b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 452b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 453b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Open (int fd, const char *path, bool read, bool write); 454b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 455b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static bool 456b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AddPosixSpawnFileAction (posix_spawn_file_actions_t *file_actions, 457b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction *info, 458b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Log *log, 459b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error& error); 460b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 46136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 46236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFD () const 463b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 46436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_fd; 46536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 46636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 46736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Action 46836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetAction () const 46936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 47036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_action; 47136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 47436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetActionArgument () const 47536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 47636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_arg; 47736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char * 48036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetPath () const 48136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 48236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_path.empty()) 48336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 48436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_path.c_str(); 48536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 486b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 48736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton protected: 488b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Action m_action; // The action for this file 489b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_fd; // An existing file descriptor 490b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_arg; // oflag for eFileActionOpen*, dup_fd for eFileActionDuplicate 491b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_path; // A file path to use for opening after fork or posix_spawn 492b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton }; 493b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 494b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo () : 495b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo(), 496ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_working_dir (), 497ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_plugin_name (), 498ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_shell (), 499ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_flags (0), 500ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_file_actions (), 501464c6161464694412b7472129e789248f1cf21b9Greg Clayton m_pty (), 502ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_resume_count (0), 503ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback (NULL), 504ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback_baton (NULL), 505ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_signals (false) 506b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 507b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 508b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 50936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo (const char *stdin_path, 51036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stdout_path, 51136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stderr_path, 51236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *working_directory, 51336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton uint32_t launch_flags) : 51436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessInfo(), 5151c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_working_dir (), 5161c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_plugin_name (), 5171c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_shell (), 5181c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_flags (launch_flags), 5191c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_file_actions (), 520464c6161464694412b7472129e789248f1cf21b9Greg Clayton m_pty (), 5211c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_resume_count (0), 5221c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback (NULL), 5231c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton (NULL), 5241c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals (false) 52536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stderr_path) 52736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 52936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 53036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 53136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDERR_FILENO, stderr_path, read, write)) 53236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 53336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 53436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdout_path) 53536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 53636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 53736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = false; 53836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 53936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDOUT_FILENO, stdout_path, read, write)) 54036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 54136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 54236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdin_path) 54336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 54436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 54536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 54636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = false; 54736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDIN_FILENO, stdin_path, read, write)) 54836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 54936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 55036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (working_directory) 55136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetWorkingDirectory(working_directory); 55236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 553abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 554b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 555b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (const FileAction &info) 556b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 557b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.push_back(info); 558b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 559b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 560abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 561b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendCloseFileAction (int fd) 562b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 563b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 564abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Close (fd)) 565abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 566abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 567abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 568abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 569abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 570b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 571b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 572abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 573b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendDuplciateFileAction (int fd, int dup_fd) 574b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 575b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 576abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Duplicate (fd, dup_fd)) 577abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 578abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 579abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 580abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 581abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 582b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 583b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 584abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 585b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendOpenFileAction (int fd, const char *path, bool read, bool write) 586b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 587b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 588abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, path, read, write)) 589abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 590abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 591abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 592abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 593abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 594b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 595b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 596abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 597b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendSuppressFileAction (int fd, bool read, bool write) 598b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 599b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 600abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, "/dev/null", read, write)) 601abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 602abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 603abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 604abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 605abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 606b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 607abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 608abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton void 609464c6161464694412b7472129e789248f1cf21b9Greg Clayton FinalizeFileActions (Target *target, 610464c6161464694412b7472129e789248f1cf21b9Greg Clayton bool default_to_use_pty); 611b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 612b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 613b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetNumFileActions () const 614b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 615b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_file_actions.size(); 616b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 617b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 618b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction * 619b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFileActionAtIndex (size_t idx) const 620b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 621b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (idx < m_file_actions.size()) 622b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return &m_file_actions[idx]; 623b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 624b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 625b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 62636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const FileAction * 62736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFileActionForFD (int fd) const 62836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 62936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton for (uint32_t idx=0, count=m_file_actions.size(); idx < count; ++idx) 63036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 63136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_file_actions[idx].GetFD () == fd) 63236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return &m_file_actions[idx]; 63336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 63436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 63536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 63636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 637b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags & 638b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () 639b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 640b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 641b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 642b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 643b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Flags & 644b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () const 645b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 646b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 647b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 648b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 649b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 650b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetWorkingDirectory () const 651b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 652b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_working_dir.empty()) 653b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 654b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_working_dir.c_str(); 655b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 65624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 65724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 658b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetWorkingDirectory (const char *working_dir) 659b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 660b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (working_dir && working_dir[0]) 661b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.assign (working_dir); 662b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 663b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 664b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 665ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 666b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 667b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SwapWorkingDirectory (std::string &working_dir) 668ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 669b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.swap (working_dir); 670b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 671b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 672b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 673b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 674b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetProcessPluginName () const 675b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 676b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_plugin_name.empty()) 677b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 678b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_plugin_name.c_str(); 679b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 680b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 681b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 682b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetProcessPluginName (const char *plugin) 683b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 684b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (plugin && plugin[0]) 685b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.assign (plugin); 686b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 687b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 688ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 689ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 690527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 691527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetShell () const 692527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 693527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_shell.empty()) 694527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 695527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_shell.c_str(); 696527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 697527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 698527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 699527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetShell (const char * path) 700527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 701527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (path && path[0]) 702527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 703527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.assign (path); 704527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Set (lldb::eLaunchFlagLaunchInShell); 705527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 706527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 707527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 708527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 709527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Clear (lldb::eLaunchFlagLaunchInShell); 710527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 711527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 712527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 713527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 714527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 715527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 716527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 717527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 718527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 719527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 720527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 721527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 722527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 723527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 724527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 725b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 726b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 727ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 728b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 729b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 730b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 731527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 732b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_flags.Clear(); 733b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.clear(); 734527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 735ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 736a733c04608cc94592a15d27583529588e19db552Greg Clayton 737527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 738527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ConvertArgumentsForLaunchingInShell (Error &error, bool localhost); 739527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 7401c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void 7411c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton SetMonitorProcessCallback (Host::MonitorChildProcessCallback callback, 7421c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *baton, 7431c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool monitor_signals) 7441c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7451c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback = callback; 7461c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton = baton; 7471c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals = monitor_signals; 7481c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7491c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 7501c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool 7511c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton MonitorProcess () const 7521c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7531c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton if (m_monitor_callback && ProcessIDIsValid()) 7541c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7551c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::StartMonitoringChildProcess (m_monitor_callback, 7561c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton, 7571c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton GetProcessID(), 7581c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals); 7591c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return true; 7601c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7611c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return false; 7621c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7631c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 764464c6161464694412b7472129e789248f1cf21b9Greg Clayton lldb_utility::PseudoTerminal & 765464c6161464694412b7472129e789248f1cf21b9Greg Clayton GetPTY () 766464c6161464694412b7472129e789248f1cf21b9Greg Clayton { 767464c6161464694412b7472129e789248f1cf21b9Greg Clayton return m_pty; 768464c6161464694412b7472129e789248f1cf21b9Greg Clayton } 7691c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 770e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 771b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_working_dir; 772b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_plugin_name; 773527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_shell; 774b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags m_flags; // Bitwise OR of bits from lldb::LaunchFlags 775b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::vector<FileAction> m_file_actions; // File actions for any other files 776464c6161464694412b7472129e789248f1cf21b9Greg Clayton lldb_utility::PseudoTerminal m_pty; 777527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 7781c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::MonitorChildProcessCallback m_monitor_callback; 7791c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *m_monitor_callback_baton; 7801c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool m_monitor_signals; 781527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton}; 782527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 783527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 784527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// ProcessLaunchInfo 785527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// 786527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// Describes any information that is required to launch a process. 787527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 788527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 789527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonclass ProcessAttachInfo : public ProcessInstanceInfo 790527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton{ 791527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonpublic: 792527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo() : 793527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 794527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 795527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 796527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch (false) 797527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 798527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 799527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 800527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo (const ProcessLaunchInfo &launch_info) : 801527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 802527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 803527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 804527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch (false) 805527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 806527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfo::operator= (launch_info); 807527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (launch_info.GetProcessPluginName()); 808527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (launch_info.GetResumeCount()); 809527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 810527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 811527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 812527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetWaitForLaunch () const 813527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 814527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_wait_for_launch; 815527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 816527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 817527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 818527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetWaitForLaunch (bool b) 819527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 820527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = b; 821527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 822527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 823527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 824527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 825527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 826527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 827527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 828527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 829527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 830527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 831527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 832527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 833527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 834527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 835527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 836527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetProcessPluginName () const 837527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 838527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_plugin_name.empty()) 839527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 840527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_plugin_name.c_str(); 841527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 842527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 843527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 844527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (const char *plugin) 845527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 846527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (plugin && plugin[0]) 847527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.assign (plugin); 848527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 849527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 850527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 851527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 852527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 853527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Clear () 854527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 855527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo::Clear(); 856527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 857527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 858527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = false; 859527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 860527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 861527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 862527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfoSpecified () const 863527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 864527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetExecutableFile()) 865527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 866527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetProcessID() != LLDB_INVALID_PROCESS_ID) 867527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 868527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetParentProcessID() != LLDB_INVALID_PROCESS_ID) 869527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 870527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return false; 871527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 872527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonprotected: 873527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_plugin_name; 874527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 875527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool m_wait_for_launch; 876e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 877e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 878b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchCommandOptions : public Options 87924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton{ 88024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonpublic: 881b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 882b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchCommandOptions (CommandInterpreter &interpreter) : 883b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Options(interpreter) 884b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 885143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton // Keep default values of all options in one place: OptionParsingStarting () 886143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting (); 887b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 888b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 889b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ~ProcessLaunchCommandOptions () 890b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 891b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 892b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 893b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error 894143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton SetOptionValue (uint32_t option_idx, const char *option_arg); 895b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 896b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 897143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting () 898b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 899b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton launch_info.Clear(); 900b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 901b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 902b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const OptionDefinition* 903b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetDefinitions () 904b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 905b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return g_option_table; 906b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 907b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 908b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Options table: Required for subclasses of Options. 909b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 910b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static OptionDefinition g_option_table[]; 911b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 912b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Instance variables to hold the values for command options. 913b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 914b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo launch_info; 915b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 916b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 917b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 918b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfoMatch 919b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 920b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A class to help matching one ProcessInstanceInfo to another. 921b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 922b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 923b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoMatch 924b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 925b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 926b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch () : 92724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 92824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (lldb_private::eNameMatchIgnore), 92924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 93024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 93124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 93224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 933b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch (const char *process_name, 934527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton lldb_private::NameMatchType process_name_match_type) : 93524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 93624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (process_name_match_type), 93724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 93824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 939527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_match_info.GetExecutableFile().SetFile(process_name, false); 94024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 94124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 942b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo & 94324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () 94424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 94524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 94624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 94724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 948b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 94924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () const 95024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 95124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 95224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 95324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 95424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 95524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetMatchAllUsers () const 95624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 95724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_all_users; 95824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 95924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 96024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 96124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetMatchAllUsers (bool b) 96224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 96324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users = b; 96424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 96524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 96624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType 96724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetNameMatchType () const 96824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 96924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_name_match_type; 97024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 97124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 97224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 97324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetNameMatchType (lldb_private::NameMatchType name_match_type) 97424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 97524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type = name_match_type; 97624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 97724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 97824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 97924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton NameMatches (const char *process_name) const; 98024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 98124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 982b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Matches (const ProcessInstanceInfo &proc_info) const; 98324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 98424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 98524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton MatchAllProcesses () const; 98624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 98724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Clear (); 98824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 98924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonprotected: 990b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo m_match_info; 99124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType m_name_match_type; 99224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool m_match_all_users; 99324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton}; 99424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 995b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoList 996e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 997e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 998b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoList () : 999e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos() 1000e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1001e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1002e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1003e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1004e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear() 1005e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1006e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.clear(); 1007e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1008e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1009e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton uint32_t 1010e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetSize() 1011e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1012e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos.size(); 1013e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1014e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1015e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1016b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Append (const ProcessInstanceInfo &info) 1017e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1018e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.push_back (info); 1019e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1020e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1021e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 1022e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameAtIndex (uint32_t idx) 1023e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1024e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1025e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetName(); 1026e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return NULL; 1027e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1028e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1029e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 1030e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameLengthAtIndex (uint32_t idx) 1031e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1032e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1033e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetNameLength(); 1034e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return 0; 1035e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1036e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1037e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 1038e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessIDAtIndex (uint32_t idx) 1039e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1040e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1041e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetProcessID(); 10422bc9eb3ba78efc64a273729b480bafc3bbaa433aJohnny Chen return 0; 1043e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1044e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1045e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton bool 1046b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetInfoAtIndex (uint32_t idx, ProcessInstanceInfo &info) 1047e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1048e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1049e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1050e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton info = m_infos[idx]; 1051e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return true; 1052e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1053e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return false; 1054e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1055e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 105624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton // You must ensure "idx" is valid before calling this function 1057b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 105824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfoAtIndex (uint32_t idx) const 105924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 106024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton assert (idx < m_infos.size()); 106124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_infos[idx]; 106224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 106324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1064e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 1065b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton typedef std::vector<ProcessInstanceInfo> collection; 1066e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton collection m_infos; 1067e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 1068e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 10696e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 107021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// This class tracks the Modification state of the process. Things that can currently modify 107121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// the program are running the program (which will up the StopID) and writing memory (which 107221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// will up the MemoryID.) 107321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// FIXME: Should we also include modification of register states? 107421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 107521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamclass ProcessModID 107621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 107721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend bool operator== (const ProcessModID &lhs, const ProcessModID &rhs); 107821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghampublic: 107921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID () : 10800296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id (0), 10810296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id (0), 10820296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_memory_id (0), 10830296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume (0), 10840296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression (false) 108521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 108621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 108721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID (const ProcessModID &rhs) : 108821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id (rhs.m_stop_id), 108921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id (rhs.m_memory_id) 109021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 109121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 109221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham const ProcessModID & operator= (const ProcessModID &rhs) 109321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 109421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (this != &rhs) 109521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 109621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = rhs.m_stop_id; 109721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id = rhs.m_memory_id; 109821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 109921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return *this; 110021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 110121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 110221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ~ProcessModID () {} 110321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 11040296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpStopID () { 11050296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id++; 11060296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11070296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 110821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void BumpMemoryID () { m_memory_id++; } 110921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 11100296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpResumeID () { 11110296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id++; 11120296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (m_running_user_expression > 0) 11130296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume = m_resume_id; 11140296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11150296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 111621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetStopID() const { return m_stop_id; } 111721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetMemoryID () const { return m_memory_id; } 11180296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetResumeID () const { return m_resume_id; } 11190296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetLastUserExpressionResumeID () const { return m_last_user_expression_resume; } 112021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 112121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool MemoryIDEqual (const ProcessModID &compare) const 112221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 112321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_memory_id == compare.m_memory_id; 112421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 112521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 112621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool StopIDEqual (const ProcessModID &compare) const 112721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 112821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id == compare.m_stop_id; 112921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 113021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 113121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void SetInvalid () 113221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 113321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = UINT32_MAX; 113421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 113521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 113621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool IsValid () const 113721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 113821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id != UINT32_MAX; 113921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 11400296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 11410296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 11420296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on) 11430296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 11440296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham // REMOVEME printf ("Setting running user expression %s at resume id %d - value: %d.\n", on ? "on" : "off", m_resume_id, m_running_user_expression); 11450296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (on) 11460296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression++; 11470296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham else 11480296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression--; 11490296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11500296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 115121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamprivate: 115221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_stop_id; 11530296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_resume_id; 115421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_memory_id; 11550296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_last_user_expression_resume; 11560296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_running_user_expression; 115721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham}; 115821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator== (const ProcessModID &lhs, const ProcessModID &rhs) 115921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 116021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (lhs.StopIDEqual (rhs) 116121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham && lhs.MemoryIDEqual (rhs)) 116221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 116321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 116421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 116521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 116621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 116721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator!= (const ProcessModID &lhs, const ProcessModID &rhs) 116821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 116921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (!lhs.StopIDEqual (rhs) 117021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham || !lhs.MemoryIDEqual (rhs)) 117121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 117221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 117321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 117421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 1175a9385537809ef342c843c5ab972e513742652047Greg Clayton 1176a9385537809ef342c843c5ab972e513742652047Greg Claytonclass MemoryRegionInfo 1177a9385537809ef342c843c5ab972e513742652047Greg Clayton{ 1178a9385537809ef342c843c5ab972e513742652047Greg Claytonpublic: 1179a9385537809ef342c843c5ab972e513742652047Greg Clayton typedef Range<lldb::addr_t, lldb::addr_t> RangeType; 11801f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 11811f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda enum OptionalBool { 11821f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eDontKnow = -1, 11831f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eNo = 0, 11841f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eYes = 1 11851f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda }; 11861f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 1187a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo () : 1188a9385537809ef342c843c5ab972e513742652047Greg Clayton m_range (), 11891f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read (eDontKnow), 11901f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_write (eDontKnow), 11911f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_execute (eDontKnow) 1192a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1193a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1194a9385537809ef342c843c5ab972e513742652047Greg Clayton 1195a9385537809ef342c843c5ab972e513742652047Greg Clayton ~MemoryRegionInfo () 1196a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1197a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1198a9385537809ef342c843c5ab972e513742652047Greg Clayton 1199a9385537809ef342c843c5ab972e513742652047Greg Clayton RangeType & 1200a9385537809ef342c843c5ab972e513742652047Greg Clayton GetRange() 1201a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1202a9385537809ef342c843c5ab972e513742652047Greg Clayton return m_range; 1203a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1204a9385537809ef342c843c5ab972e513742652047Greg Clayton 1205a9385537809ef342c843c5ab972e513742652047Greg Clayton void 1206a9385537809ef342c843c5ab972e513742652047Greg Clayton Clear() 1207a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1208a9385537809ef342c843c5ab972e513742652047Greg Clayton m_range.Clear(); 12091f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read = m_write = m_execute = eDontKnow; 1210a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1211a9385537809ef342c843c5ab972e513742652047Greg Clayton 1212a9385537809ef342c843c5ab972e513742652047Greg Clayton const RangeType & 1213a9385537809ef342c843c5ab972e513742652047Greg Clayton GetRange() const 1214a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1215a9385537809ef342c843c5ab972e513742652047Greg Clayton return m_range; 1216a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12171f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12181f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12191f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetReadable () const 1220a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12211f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_read; 1222a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12231f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12241f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12251f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetWritable () const 1226a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12271f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_write; 12281f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda } 12291f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12301f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12311f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetExecutable () const 12321f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda { 12331f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_execute; 1234a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1235a9385537809ef342c843c5ab972e513742652047Greg Clayton 1236a9385537809ef342c843c5ab972e513742652047Greg Clayton void 12371f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetReadable (OptionalBool val) 1238a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12391f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read = val; 1240a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12411f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 1242a9385537809ef342c843c5ab972e513742652047Greg Clayton void 12431f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetWritable (OptionalBool val) 1244a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12451f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_write = val; 1246a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1247a9385537809ef342c843c5ab972e513742652047Greg Clayton 1248a9385537809ef342c843c5ab972e513742652047Greg Clayton void 12491f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetExecutable (OptionalBool val) 1250a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12511f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_execute = val; 1252a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1253a9385537809ef342c843c5ab972e513742652047Greg Clayton 1254a9385537809ef342c843c5ab972e513742652047Greg Claytonprotected: 1255a9385537809ef342c843c5ab972e513742652047Greg Clayton RangeType m_range; 12561f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_read; 12571f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_write; 12581f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_execute; 1259a9385537809ef342c843c5ab972e513742652047Greg Clayton}; 126021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 126124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 126224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 126324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 126424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 126524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 126613d24fb1817faa7ccc4cfd799113ba1a2b8968ebGreg Clayton public std::tr1::enable_shared_from_this<Process>, 126724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 126824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 126924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 12706e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public PluginInterface, 12716e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public ProcessInstanceSettings 127224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 127324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 1274d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Inghamfriend class ClangFunction; // For WaitForStateChangeEventsPrivate 127521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectProcessLaunch; 127621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class ProcessEventData; 127721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectBreakpointCommand; 127821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class StopInfo; 127924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 128024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 128124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 128224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 128324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 128424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 128524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 128624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 128724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 128824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 128924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 1290e28824e0b988221c7eedf8e3d212527d2bdac6a7Eli Friedman eBroadcastBitSTDERR = (1 << 3) 129124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 129224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 129324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 129424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 129524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 129624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 129724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 129824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 1299360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 130024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 130124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 130224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 130324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 130424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 130524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 130624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 130724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 130824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 130924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 131024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 131124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 131224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 131324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 131424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 131624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 131724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 13183ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham friend class Process; 13193ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 132024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 132124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 132224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 132324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 132424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 132524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 132624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 132724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 132824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 132924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 133024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 133124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 133224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 13333ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetProcessSP() const 13343ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13353ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_process_sp; 13363ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 133724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 13383ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetState() const 13393ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13403ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_state; 13413ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 13433ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetRestarted () const 13443ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13453ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_restarted; 13463ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 13473ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool 13483ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterrupted () const 13493ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13503ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_interrupted; 13513ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 135424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 135524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 135724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 135824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 136024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 136124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 136324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 136424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 136624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 136724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 136924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 137024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 137124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 137224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 137324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 137424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 13753ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterruptedFromEvent (const Event *event_ptr); 13763ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 13773ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static void 13783ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterruptedInEvent (Event *event_ptr, bool new_value); 13793ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 13803ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static bool 138124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 138224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 138424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 13863ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetUpdateStateOnRemoval() 13873ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13886cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham m_update_state++; 13893ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 139024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 13913ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetRestarted (bool new_value) 13923ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13933ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_restarted = new_value; 13943ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 13953ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham void 13963ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterrupted (bool new_value) 13973ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13983ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_interrupted = new_value; 13993ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 140024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 140224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 140324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 14046cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham int m_update_state; 14053ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool m_interrupted; 140624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 140724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 14096e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1410d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton class SettingsController : public UserSettingsController 14116e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice { 14126e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public: 14136e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1414d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton SettingsController (); 14156e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14166e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 1417d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton ~SettingsController (); 14186e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14196e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry global_settings_table[]; 14206e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry instance_settings_table[]; 14216e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14226e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice protected: 14236e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14246e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice lldb::InstanceSettingsSP 1425d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton CreateInstanceSettings (const char *instance_name); 14266e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14276e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice private: 14286e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14296e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice // Class-wide settings. 14306e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1431d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton DISALLOW_COPY_AND_ASSIGN (SettingsController); 14326e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice }; 14336e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 143421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 143524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 143624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1437990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 14382a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsInitialize (); 1439990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1440990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 14412a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsTerminate (); 1442990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1443990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static lldb::UserSettingsControllerSP & 1444990de7bb41d3afec6b789155408ff322187d8682Greg Clayton GetSettingsController (); 14456e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14461ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice void 14471ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice UpdateInstanceName (); 14481ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice 1449395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 145024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 145124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 145224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 145324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 145424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 145524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 145624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 145724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 145824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 145924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 146024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 146124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 146224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 146324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 146424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 146524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 146624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 146724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 146924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 147024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 147124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 147324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 147424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 147624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 147724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 148024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 148124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 148224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static Process* 148324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner FindPlugin (Target &target, const char *plugin_name, Listener &listener); 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 148824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 148924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 149024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 149124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 149224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 149324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 149424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 149524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 149624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 149724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 149824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 149924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 150024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 150224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 150324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 15041c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool exited, 150524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 150624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 150724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1508395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton lldb::ByteOrder 1509395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetByteOrder () const; 1510395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 1511395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton uint32_t 1512395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetAddressByteSize () const; 1513395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 151424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 151624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1517fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 151824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 151924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 152024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 152224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 152324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 152424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 152524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 15268d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton CanDebug (Target &target, 15278d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton bool plugin_specified_by_name) = 0; 152824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 152924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 153124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 153224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 153324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 153424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 153524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 153624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 153724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 153824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 154024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 154124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 154524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 154624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 154724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 154824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 155024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 155124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 155224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 155324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 155424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 155524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 155624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 155724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 155824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 155924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 156024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 156124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 156224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1563452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1564452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1565452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 156624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 156724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 156824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 156924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 157024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 157224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 157324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 157424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 157524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 157724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 157824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 157924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 158024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1581de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1582de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1583de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 158424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 158624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 158724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 158824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 158936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Launch (const ProcessLaunchInfo &launch_info); 159024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 159124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 1592527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// Attach to an existing process using the process attach info. 159324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 159424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 1595527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// subclasses. It will first call WillAttach (lldb::pid_t) 1596527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// or WillAttach (const char *), and if that returns \b 1597527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// true, DoAttach (lldb::pid_t) or DoAttach (const char *) will 159824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 159924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 160024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 160224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 160324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 160524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 160624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 160724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 160824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 1609527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Attach (ProcessAttachInfo &attach_info); 161024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1611e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1612e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton ConnectRemote (const char *remote_url); 16137508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1614dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool 1615ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton GetShouldDetach () const 1616dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham { 1617ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton return m_should_detach; 1618dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham } 1619ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 1620ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton void 1621ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton SetShouldDetach (bool b) 1622ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton { 1623ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_should_detach = b; 1624ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton } 1625ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 16267508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 162724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 162824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 162924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 163024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 163124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 163224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 163324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 163424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 163524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 163624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 163724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 163824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 163924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 164224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 164324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 16450baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Load a shared library into this process. 16460baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 16470baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Try and load a shared library into the current process. This 16480baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// call might fail in the dynamic loader plug-in says it isn't safe 16490baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// to try and load shared libraries at the moment. 16500baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 16510baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[in] image_spec 16520baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// The image file spec that points to the shared library that 16530baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// you want to load. 16540baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 16550baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[out] error 16560baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// An error object that gets filled in with any errors that 16570baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// might occur when trying to load the shared library. 16580baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 16590baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @return 16600baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// A token that represents the shared library that can be 16610baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// later used to unload the shared library. A value of 16620baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// LLDB_INVALID_IMAGE_TOKEN will be returned if the shared 16630baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// library can't be opened. 16640baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 16650baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual uint32_t 16660baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton LoadImage (const FileSpec &image_spec, Error &error); 16670baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 16680baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual Error 16690baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton UnloadImage (uint32_t image_token); 16700baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 16710baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 167224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 167324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 167424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 167524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 167624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 167724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 167824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 167924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 168024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 168124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 168224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 168424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 168524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 168624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 168724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 168924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 169024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 169124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 169224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 169324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 169424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 169524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 169624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 169724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 169824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 169924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 170024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 170124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 170224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 170324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 170424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 170524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 170624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 170724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 170824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 170924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 171024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 171124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 171224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 171324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 171524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 171624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 171724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 171824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 172024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 172124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 172224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 172324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 172424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 172624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 172724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 172924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 173024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 173124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 17323ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 173324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Resume (); 173424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 173524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 173624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 173724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 173824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 173924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 17403ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// If the process is successfully halted, a eStateStopped 17413ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// process event with GetInterrupted will be broadcast. If false, we will 17423ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// halt the process with no events generated by the halt. 174324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 17453ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// Returns an error object. If the error is empty, the process is halted. 17463ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// otherwise the halt has failed. 174724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 17483ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 174924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 175024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 175124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 175224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 175324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 175524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 175624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 175824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 175924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 17603ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 176124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 176224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 176324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 176424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 176524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 176624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 176724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 176824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 176924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 177024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 177124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 177224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 17733ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 177424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 177524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 177624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 177724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 177824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 177924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 178024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 178124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 178224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 178324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 178424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 17853ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 178624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 178724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 178824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 1789395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetUnixSignals () 1790395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1791395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_unix_signals; 1792395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 179324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 179424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 179524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 179624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 179724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 179824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 179924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 180024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 180124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 180224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 180324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 180424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 180524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 180624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 180854e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 180924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 181024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 181124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 181224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 181324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 181424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 181524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 181724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 181824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 182024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 182124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 182224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 182354e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 182424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 182524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 182624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 182724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1828e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1829e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton DoConnectRemote (const char *remote_url) 1830e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton { 1831e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton Error error; 1832e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton error.SetErrorString ("remote connections are not supported"); 1833e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton return error; 1834e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton } 1835e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton 183624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 183724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 183824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 183924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 184024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 184124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 184224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 184324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 184424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 184524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 184624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 184754e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithID (lldb::pid_t pid) = 0; 184824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 185024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 185124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 185224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 185324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 185424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 185524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 185624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 185724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 185824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 185924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 186124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 186224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 186324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 186554e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithName (const char *process_name, bool wait_for_launch) 186624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 186724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 186824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 186924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 187024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 187124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 187224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 187424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 187624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 187724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 187924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 188024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 188124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 188224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 188324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 188424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 188624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 188724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 188924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 189024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 189224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 189324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 189424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 189524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 189624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 189724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 189924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 190124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 190224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 190324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 190424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 190524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 190724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 190824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 190924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 191024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 191124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 191224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 191324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 191424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 191524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1916452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1917452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1918452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 191924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 192024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 192124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 192224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 192324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 192424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 192524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 192624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 192724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 192824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 192924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 193024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 193124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 193224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 193324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1934de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1935de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1936de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 193724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 193824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 193924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 194024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 194124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 194236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton DoLaunch (Module *exe_module, 194336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const ProcessLaunchInfo &launch_info) = 0; 194424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 194524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 194624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 194724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 194824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 194924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 195024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 195124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 195224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 195324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 195724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 195824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 195924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 196024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 196124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 196224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 196324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 196424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 196624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 196724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 196824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 197024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 197124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 197224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 197324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 197424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 197524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 197624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 197724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 197824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 197924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 198024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 198124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 198224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 198324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 198424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 198624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoResume () = 0; 198724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 199024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 199124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 199224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 199324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 199424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 199524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 199624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 199924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 200024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 200124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 200224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 200324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 200424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 200524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 200624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 200724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 200824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 200924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 201024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 201124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 201224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2013360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt must produce one and only one stop StateChanged event if it actually 2014360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// stops the process. If the stop happens through some natural event (for 2015360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// instance a SIGSTOP), then forwarding that event will do. Otherwise, you must 2016360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// generate the event manually. Note also, the private event thread is stopped when 2017360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt is run to prevent the events generated while halting to trigger 2018360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// other state changes before the halt is complete. 20193ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 20203ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// @param[out] caused_stop 202120d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// If true, then this Halt caused the stop, otherwise, the 202220d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// process was already stopped. 20233ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 202424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 202524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 202624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 202724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 202824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 20293ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham DoHalt (bool &caused_stop) = 0; 203024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 203124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 203324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 203424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 203524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 203624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 203824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 203924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 204024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 204224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 204424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 204524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 204724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 204824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 205024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 205124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 205224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 205324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 205424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 205624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 205724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 205924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 206024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 206124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 206224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 206324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDetach () = 0; 206424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 206524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 206624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 206724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 206824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 206924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 207024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 207124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 207224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 207324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 207424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 207524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 207624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 207724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 207824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 207924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 208124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 208224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 208324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 208424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 208524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 208624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 208724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 208824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 208924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 209024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 209124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 209224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 209324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 209424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 209524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoSignal (int signal) = 0; 209624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 209724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 209824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 209924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 210024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 210124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 210324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 210424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 210624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 210724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 211024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 211124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 211224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 211324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 211424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 211524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 211624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 211724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 211824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 211924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 212024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 212124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 212224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 212324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 212424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 212524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 212624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 212724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 212824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 212924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 213024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 213124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 213224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 213324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 213424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 213524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 213624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 213724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 213824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 213924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 214024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 214124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 214224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 2143395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () 2144395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2145395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2146395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 214724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 214824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 214924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 215024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 215124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 215224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 215324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 215424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 215524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 2156395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () const 2157395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2158395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2159395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 2160395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 216124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 216224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 216324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 216424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 216624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 216724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 216924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 217024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 217124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 2172360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2173b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResults 2174360f53f3c216ee4fb433da0a367168785328a856Jim Ingham RunThreadPlan (ExecutionContext &exe_ctx, 2175360f53f3c216ee4fb433da0a367168785328a856Jim Ingham lldb::ThreadPlanSP &thread_plan_sp, 2176360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool stop_others, 2177360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool try_all_threads, 2178360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool discard_on_error, 2179360f53f3c216ee4fb433da0a367168785328a856Jim Ingham uint32_t single_thread_timeout_usec, 2180360f53f3c216ee4fb433da0a367168785328a856Jim Ingham Stream &errors); 2181360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2182360f53f3c216ee4fb433da0a367168785328a856Jim Ingham static const char * 2183b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResultAsCString (ExecutionResults result); 218424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2185abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton void 2186abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetStatus (Stream &ostrm); 2187abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 2188abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton size_t 2189abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetThreadStatus (Stream &ostrm, 2190abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton bool only_threads_with_stop_reason, 2191abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t start_frame, 2192abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames, 2193abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames_with_source); 2194abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 219524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 219624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 219724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 219824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 219924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 220024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 220124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 220224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 220375c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 220475c703dd8b492bad25a987b96853626641ae7246Greg Clayton // Called internally 220575c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 220675c703dd8b492bad25a987b96853626641ae7246Greg Clayton void 220775c703dd8b492bad25a987b96853626641ae7246Greg Clayton CompleteAttach (); 220875c703dd8b492bad25a987b96853626641ae7246Greg Clayton 220924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 221024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 221124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 221224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 221324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 221424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 221524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 221624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 221724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 221824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 221924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 222024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 222124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 222224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 222324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 222424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 222524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 222624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 222724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 222824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 222924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 223024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 223124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 223224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 223324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 223424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 223524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 223624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 223721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// Get the Modification ID of the process. 223824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 223924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 224021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// The modification ID of the process. 224124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 224221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID 224321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetModID () const 224421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 224521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id; 224621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 224721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 22480296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham const ProcessModID & 22490296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetModIDRef () const 22500296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 22510296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id; 22520296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 22530296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 225424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 225521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetStopID () const 225621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 225721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id.GetStopID(); 225821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 225921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 22600296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 22610296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetResumeID () const 22620296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 22630296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetResumeID(); 22640296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 22650296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 22660296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 22670296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetLastUserExpressionResumeID () const 22680296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 22690296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetLastUserExpressionResumeID(); 22700296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 22710296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 227224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 227324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 227424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 227524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 227624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 227724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 227824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 227924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 228124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 228224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 228424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 228524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 228724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 228872e1c782ba1e4226da37af4722af608de9f39408Greg Clayton virtual bool 228924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 229024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 229124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 229224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 229324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 229424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 229524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 229624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 229724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 229824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 229924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 230024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 230124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 230224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 230324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 230424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 230524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 230624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 230724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 230824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 230924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 231024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 231124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 231224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 231324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 231424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 231524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 231624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 231724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 231824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 231924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 232024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 232124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 232224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 232324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 232424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 232524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 232624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 232724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 232824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 232924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 233024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 233124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 233324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 233424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 233524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 233724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 233824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 233924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 234124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 234224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 234324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 234524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 234624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 234724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 234924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 235024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 235124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 235224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 235324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 235424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 235524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 235624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 235724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 235924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 236024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 236124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 236224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 236324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2364b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2365b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// Read a NULL terminated C string from memory 2366b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// 2367b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// This function will read a cache page at a time until the NULL 2368b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// C stirng terminator is found. It will stop reading if the NULL 2369b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// termination byte isn't found before reading \a cstr_max_len 2370b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// bytes, and the results are always guaranteed to be NULL 2371b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// terminated (at most cstr_max_len - 1 bytes will be read). 2372b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2373b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 2374b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2375b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton char *cstr, 23764a2e33769873d68d5703da5742c0e248f46e3a72Greg Clayton size_t cstr_max_len, 23774a2e33769873d68d5703da5742c0e248f46e3a72Greg Clayton Error &error); 2378b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2379fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 2380fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ReadMemoryFromInferior (lldb::addr_t vm_addr, 2381fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *buf, 2382fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t size, 2383fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 2384fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 23856d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 23866d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// Reads an unsigned integer of the specified byte size from 23876d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// process memory. 23886d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 23896d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] load_addr 23906d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// A load address of the integer to read. 23916d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 23926d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] byte_size 23936d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The size in byte of the integer to read. 23946d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 2395c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] fail_value 2396c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value to return if we fail to read an integer. 2397c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 23986d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[out] error 23996d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// An error that indicates the success or failure of this 24006d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// operation. If error indicates success (error.Success()), 24016d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// then the value returned can be trusted, otherwise zero 24026d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// will be returned. 24036d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 24046d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @return 24056d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The unsigned integer that was read from the process memory 24066d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// space. If the integer was smaller than a uint64_t, any 24076d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// unused upper bytes will be zero filled. If the process 24086d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// byte order differs from the host byte order, the integer 24096d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// value will be appropriately byte swapped into host byte 24106d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// order. 24116d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 2412f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton uint64_t 2413c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadUnsignedIntegerFromMemory (lldb::addr_t load_addr, 2414c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t byte_size, 2415c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint64_t fail_value, 2416c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2417c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2418c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t 2419c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadPointerFromMemory (lldb::addr_t vm_addr, 2420c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2421c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2422c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool 2423c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WritePointerToMemory (lldb::addr_t vm_addr, 2424c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t ptr_value, 2425c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2426c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 242724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 242824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 242924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 243024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 243124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 243224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 243324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 243424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 243524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 243624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 243724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 243824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 243924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 244024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2441c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2442c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2443c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 244424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 244524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 244624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 244724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 244824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) = 0; 244924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 245024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2451c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// Write all or part of a scalar value to memory. 2452c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2453c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value contained in \a scalar will be swapped to match the 2454c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// byte order of the process that is being debugged. If \a size is 2455c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// less than the size of scalar, the least significate \a size bytes 2456c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// from scalar will be written. If \a size is larger than the byte 2457c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// size of scalar, then the extra space will be padded with zeros 2458c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// and the scalar value will be placed in the least significant 2459c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// bytes in memory. 2460c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2461c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] vm_addr 2462c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// A virtual load address that indicates where to start writing 2463c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// memory to. 2464c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2465c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] scalar 2466c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The scalar to write to the debugged process. 2467c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2468c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] size 2469c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// This value can be smaller or larger than the scalar value 2470c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// itself. If \a size is smaller than the size of \a scalar, 2471c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the least significant bytes in \a scalar will be used. If 2472c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// \a size is larger than the byte size of \a scalar, then 2473c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the extra space will be padded with zeros. If \a size is 2474c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// set to UINT32_MAX, then the size of \a scalar will be used. 2475c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2476c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2477c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2478c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2479c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @return 2480c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The number of bytes that were actually written. 2481c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 2482c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2483c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WriteScalarToMemory (lldb::addr_t vm_addr, 2484c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton const Scalar &scalar, 2485c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t size, 2486c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2487c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2488c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2489c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadScalarIntegerFromMemory (lldb::addr_t addr, 2490c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t byte_size, 2491c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool is_signed, 2492c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Scalar &scalar, 2493c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2494c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2495c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 249624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 249724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 249824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 249924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 250024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 250124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 250224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 250324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 250424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 250524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 250624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 250724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 250824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 250924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 251024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 251124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 251224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 251324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 251424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 251524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 251624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 251724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 251824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 251924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 252024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 252124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 252224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 252324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 252424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 252524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 252624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 252724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 252824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 252924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 253024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 253124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 253224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 253324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 253424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 253524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 253624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 253724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 253824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 253924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 254024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAllocateMemory (size_t size, uint32_t permissions, Error &error) = 0; 254124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 254224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 254324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 254424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 254524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 254624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 254724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 254824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 254924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 255024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 255124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 255224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 255324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 255424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 255524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 255624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 255724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2558b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// @param[in/out] error 2559b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// An error object to fill in if things go wrong. 256024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 256124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 256224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 256324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 256424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 256524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 256624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 256724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2568a9385537809ef342c843c5ab972e513742652047Greg Clayton virtual Error 2569a9385537809ef342c843c5ab972e513742652047Greg Clayton GetMemoryRegionInfo (lldb::addr_t load_addr, 2570a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo &range_info) 2571a9385537809ef342c843c5ab972e513742652047Greg Clayton { 2572a9385537809ef342c843c5ab972e513742652047Greg Clayton Error error; 2573a9385537809ef342c843c5ab972e513742652047Greg Clayton error.SetErrorString ("Process::GetMemoryRegionInfo() not supported"); 2574a9385537809ef342c843c5ab972e513742652047Greg Clayton return error; 2575a9385537809ef342c843c5ab972e513742652047Greg Clayton } 25761f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 2577b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton lldb::ModuleSP 2578b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton ReadModuleFromMemory (const FileSpec& file_spec, 2579b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton lldb::addr_t header_addr); 2580b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton 25811f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda //------------------------------------------------------------------ 25821f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// Attempt to get the attributes for a region of memory in the process. 25831f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 25841f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// It may be possible for the remote debug server to inspect attributes 25851f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// for a region of memory in the process, such as whether there is a 25861f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// valid page of memory at a given address or whether that page is 25871f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// readable/writable/executable by the process. 25881f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 25891f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @param[in] load_addr 25901f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// The address of interest in the process. 25911f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 25921f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @param[out] permissions 25931f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// If this call returns successfully, this bitmask will have 25941f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// its Permissions bits set to indicate whether the region is 25951f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// readable/writable/executable. If this call fails, the 25961f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// bitmask values are undefined. 25971f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 25981f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @return 25991f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// Returns true if it was able to determine the attributes of the 26001f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// memory region. False if not. 26011f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda //------------------------------------------------------------------ 26021f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 26031f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda virtual bool 26041f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetLoadAddressPermissions (lldb::addr_t load_addr, uint32_t &permissions) 2605a9385537809ef342c843c5ab972e513742652047Greg Clayton { 2606a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo range_info; 26071f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions = 0; 2608a9385537809ef342c843c5ab972e513742652047Greg Clayton Error error (GetMemoryRegionInfo (load_addr, range_info)); 26091f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (!error.Success()) 26101f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return false; 26111f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetReadable() == MemoryRegionInfo::eDontKnow 26121f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda || range_info.GetWritable() == MemoryRegionInfo::eDontKnow 26131f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda || range_info.GetExecutable() == MemoryRegionInfo::eDontKnow) 26141f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda { 26151f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return false; 26161f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda } 26171f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 26181f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetReadable() == MemoryRegionInfo::eYes) 26191f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsReadable; 26201f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 26211f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetWritable() == MemoryRegionInfo::eYes) 26221f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsWritable; 26231f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 26241f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetExecutable() == MemoryRegionInfo::eYes) 26251f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsExecutable; 26261f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 26271f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return true; 2628a9385537809ef342c843c5ab972e513742652047Greg Clayton } 26291f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 263024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 26316cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Determines whether executing JIT-compiled code in this process 26326cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 26336cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 26346cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @return 26356cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 26366cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 26376cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan bool CanJIT (); 26386cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 26396cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 26406cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Sets whether executing JIT-compiled code in this process 26416cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 26426cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 26436cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @param[in] can_jit 26446cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 26456cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 26466cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan void SetCanJIT (bool can_jit); 26476cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 26486cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 264924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 265024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 265124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 265224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 265324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 265424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 265524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 265624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 265724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 265824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 265924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 266024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 266124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 266324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDeallocateMemory (lldb::addr_t ptr) = 0; 266424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 266624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 266724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 266824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 266924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 267024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 267124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 267224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 267324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 267424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 267524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 267624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 267724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 267824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 267924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 268024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 268124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 268224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 268324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 268424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 268524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 268624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 268724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 268824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 268924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 269024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 269124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 269224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 269324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 269424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 269524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 269624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 269724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 269824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 269924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 270024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 270124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 270224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 270324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 2704bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDOUT (char *buf, size_t buf_size, Error &error); 270524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 270624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 270724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 270824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 270924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 271024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 271124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 271224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 271324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 271424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 271524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 271624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 271724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 271824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 271924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 272024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 272124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 272224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 272324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 272424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 272524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 272624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 272724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 2728bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDERR (char *buf, size_t buf_size, Error &error); 272924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 273024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 273124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 273224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 273324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 273424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 273524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 273624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 273724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 273824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 273924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 2740b1888f24fa181489840b9acf193e224d125d0776Greg Clayton size_t 2741b1888f24fa181489840b9acf193e224d125d0776Greg Clayton GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site); 274224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 274324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 274424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpoint (BreakpointSite *bp_site) = 0; 274524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 274624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 274724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpoint (BreakpointSite *bp_site) = 0; 274824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 274924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 275024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 275124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 275224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 275324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 275424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 275524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 275624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 275724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 275824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 275924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 276024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 276124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 276224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 276324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 276424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 276524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 276624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 276724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 276824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 276924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 277024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 277124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 277224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 277324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 277424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 27753fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 277613d24fb1817faa7ccc4cfd799113ba1a2b8968ebGreg Clayton CreateBreakpointSite (const lldb::BreakpointLocationSP &owner, 277724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 277824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 277924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 278024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 278124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 278224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 278324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 278424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 278524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 278624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 278724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 278824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 278924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 279024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 279124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 279224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 279324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 279424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 279524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 279624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 279724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 279824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 279924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2800ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen EnableWatchpoint (Watchpoint *wp); 280124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 280224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2803ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen DisableWatchpoint (Watchpoint *wp); 280424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 280524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 280624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 280724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 280824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t 280937f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list) = 0; 281037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 281137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton void 281237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadListIfNeeded (); 281324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 281424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 2815395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () 2816395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2817395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 2818395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 281924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 282224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 282324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 282524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 282624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 282724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 282824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 282924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 283124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessToStop (const TimeValue *timeout); 283224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 283424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 283524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 283724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 283863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 283924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2840f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham class 2841f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker 2842f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2843f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham public: 2844f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker (Process &process, Listener *listener) : 2845f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process (process), 2846f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_listener (listener) 2847f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2848f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.HijackProcessEvents (listener); 2849f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 2850f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ~ProcessEventHijacker () 2851f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2852f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.RestoreProcessEvents(); 2853f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 2854f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 2855f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham private: 2856f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Process &m_process; 2857f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Listener *m_listener; 2858f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham }; 2859f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham friend class ProcessEventHijacker; 286024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 286163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// If you need to ensure that you and only you will hear about some public 286263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// event, then make a new listener, set to listen to process events, and 286363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// then call this with that listener. Then you will have to wait on that 286463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// listener explicitly for events (rather than using the GetNextEvent & WaitFor* 286563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// calls above. Be sure to call RestoreProcessEvents when you are done. 286663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 286763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @param[in] listener 286863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// This is the new listener to whom all process events will be delivered. 286963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 287063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @return 287163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Returns \b true if the new listener could be installed, 287263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// \b false otherwise. 287363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 287463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham bool 287563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham HijackProcessEvents (Listener *listener); 287663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 287763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 287863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Restores the process event broadcasting to its normal state. 287963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 288063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 288163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham void 288263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham RestoreProcessEvents (); 288363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 288463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghamprotected: 288563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 288624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 288724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 288824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 288924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 289024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 289124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 289224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 289324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 289424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 289524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 289624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 289724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 289824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 289924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 290024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 290124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 290263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghampublic: 290375906e4ec98af3717e415727a8d663a4e246bb4fGreg Clayton const lldb::ABISP & 290424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 290524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 290675c703dd8b492bad25a987b96853626641ae7246Greg Clayton DynamicLoader * 290775c703dd8b492bad25a987b96853626641ae7246Greg Clayton GetDynamicLoader () 290875c703dd8b492bad25a987b96853626641ae7246Greg Clayton { 290975c703dd8b492bad25a987b96853626641ae7246Greg Clayton return m_dyld_ap.get(); 291075c703dd8b492bad25a987b96853626641ae7246Greg Clayton } 291175c703dd8b492bad25a987b96853626641ae7246Greg Clayton 291237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton OperatingSystem * 291337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton GetOperatingSystem () 291437f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton { 291537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton return m_os_ap.get(); 291637f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton } 291737f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 291837f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 2919642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual LanguageRuntime * 2920642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetLanguageRuntime (lldb::LanguageType language); 2921642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 2922642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual CPPLanguageRuntime * 2923642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetCPPLanguageRuntime (); 2924642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 2925642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual ObjCLanguageRuntime * 2926642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetObjCLanguageRuntime (); 292724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 292824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 292924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 2930f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 2931f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 2932f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 2933d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham return m_dynamic_checkers_ap.get(); 2934f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 2935f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 2936f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 2937f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 2938d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham m_dynamic_checkers_ap.reset(dynamic_checkers); 2939f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 294024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2941c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 2942c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to set the lldb in the mode where it breaks on new thread 2943c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// creations, and then auto-restarts. This is useful when you are trying 2944c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// to run only one thread, but either that thread or the kernel is creating 2945c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// new threads in the process. If you stop when the thread is created, you 2946c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// can immediately suspend it, and keep executing only the one thread you intend. 2947c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 2948c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 2949c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 2950c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 2951c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 295255e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 295355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StartNoticingNewThreads() 295455e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 295555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 295655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 295755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 2958c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 2959c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to turn off the stop & notice new threads mode. 2960c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 2961c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 2962c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 2963c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 2964c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 296555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 296655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StopNoticingNewThreads() 296755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 296855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 296955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 297055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 29710296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 29720296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on); 29730296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 297424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 297524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 297624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 297724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Target * 2978395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateTarget () 2979395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2980395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return &m_target; 2981395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 298224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 298324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Process * 2984395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateProcess () 2985395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2986395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return this; 2987395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 298824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 298924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Thread * 2990395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateThread () 2991395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2992395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 2993395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 299424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 299524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual StackFrame * 2996395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateStackFrame () 2997395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2998395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 2999395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 300024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 300124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 3002a830adbcd63d1995a01e6e18da79893c1426ca43Greg Clayton CalculateExecutionContext (ExecutionContext &exe_ctx); 300324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3004464c6161464694412b7472129e789248f1cf21b9Greg Clayton void 3005464c6161464694412b7472129e789248f1cf21b9Greg Clayton SetSTDIOFileDescriptor (int file_descriptor); 3006464c6161464694412b7472129e789248f1cf21b9Greg Clayton 300724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 3008c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 300921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // NextEventAction provides a way to register an action on the next 301021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // event that is delivered to this process. There is currently only 301121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // one next event action allowed in the process at one time. If a 301221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // new "NextEventAction" is added while one is already present, the 301321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // old action will be discarded (with HandleBeingUnshipped called 301421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // after it is discarded.) 3015c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 3016c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class NextEventAction 3017c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3018c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 3019c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham typedef enum EventActionResult 3020c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3021c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionSuccess, 3022c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionRetry, 3023c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionExit 3024c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } EventActionResult; 3025c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3026c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction (Process *process) : 3027c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham m_process(process) 30282d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 30292d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 30302d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 30312d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 30322d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~NextEventAction() 30332d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 30342d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 3035c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3036c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp) = 0; 3037c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual void HandleBeingUnshipped () {}; 3038c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted () = 0; 3039c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString() = 0; 3040c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham protected: 3041c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham Process *m_process; 3042c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 3043c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3044c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham void SetNextEventAction (Process::NextEventAction *next_event_action) 3045c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 304668bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham if (m_next_event_action_ap.get()) 304768bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap->HandleBeingUnshipped(); 304868bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham 304968bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap.reset(next_event_action); 3050c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } 3051c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3052c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // This is the completer for Attaching: 3053c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class AttachCompletionHandler : public NextEventAction 3054c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3055c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 30562d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton AttachCompletionHandler (Process *process, uint32_t exec_count) : 30572d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton NextEventAction (process), 30582d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton m_exec_count (exec_count) 30592d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 30602d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 30612d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 30622d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 30632d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~AttachCompletionHandler() 30642d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 30652d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 3066c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3067c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp); 3068c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted (); 3069c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString(); 3070c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham private: 30712d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton uint32_t m_exec_count; 3072c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham std::string m_exit_string; 3073c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 3074c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3075f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham bool 3076f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham HijackPrivateProcessEvents (Listener *listener); 3077f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 3078f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham void 3079f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham RestorePrivateProcessEvents (); 3080a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton 3081a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton bool 3082a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton PrivateStateThreadIsValid () const 3083a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton { 3084a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton return m_private_state_thread != LLDB_INVALID_HOST_THREAD; 3085a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton } 3086fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 308724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 308824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 308924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 309024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 309124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 309224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 309324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 309424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 309524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 309624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 309724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 309821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID m_mod_id; ///< Tracks the state of the process over stops and other alterations. 309924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 310024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 310124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 310224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 310324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 31040baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton std::vector<lldb::addr_t> m_image_tokens; 310524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 310624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend 310724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ///< to insert in the target. 310875c703dd8b492bad25a987b96853626641ae7246Greg Clayton std::auto_ptr<DynamicLoader> m_dyld_ap; 3109d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers_ap; ///< The functions used by the expression parser to validate data that expressions use. 311037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton std::auto_ptr<OperatingSystem> m_os_ap; 311124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 311224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 3113861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderSP m_process_input_reader; 3114861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb_private::Communication m_stdio_communication; 311520d338fad87eba91de65aa9bec76e01c04472848Greg Clayton lldb_private::Mutex m_stdio_communication_mutex; 3116861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice std::string m_stdout_data; 3117bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton std::string m_stderr_data; 3118fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache m_memory_cache; 3119613b8739a4d489b7f1c571288d5786768c024205Greg Clayton AllocatedMemoryCache m_allocated_memory_cache; 3120ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton bool m_should_detach; /// Should we detach if the process object goes away with an explicit call to Kill or Detach? 3121fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 3122642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham typedef std::map<lldb::LanguageType, lldb::LanguageRuntimeSP> LanguageRuntimeCollection; 3123642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham LanguageRuntimeCollection m_language_runtimes; 31247e2f91cb958c8670774cb2190db7b858618b5b9bGreg Clayton std::auto_ptr<NextEventAction> m_next_event_action_ap; 312524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 31266cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan enum { 31276cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITDontKnow= 0, 31286cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITYes, 31296cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITNo 31306cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan } m_can_jit; 31316cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 313224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 313324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 313424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 313524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 313624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 313724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 313824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 313924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 314024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 314124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 314224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 314324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 314424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 314524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StartPrivateStateThread (); 314624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 314724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 314824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 314924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 315024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 315124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 315224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 315324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 315424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 315524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 315624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 315724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 315824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 315924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 316024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 316124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 316224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 316324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 316424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 316524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 316624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 316724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 316824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 316924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 317024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 317124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 317224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 317324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 317424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 317524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 317624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 317724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 317824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 317924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 318024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 318124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 318224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 318324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 3184861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3185861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3186861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice AppendSTDOUT (const char *s, size_t len); 3187861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3188bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton void 3189bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton AppendSTDERR (const char *s, size_t len); 3190bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton 3191861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static void 3192861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len); 3193861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3194861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3195861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PushProcessInputReader (); 3196861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3197861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3198861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PopProcessInputReader (); 3199861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3200861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3201861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ResetProcessInputReader (); 3202861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3203861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static size_t 3204861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ProcessInputReaderCallback (void *baton, 3205861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice InputReader &reader, 3206861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderAction notification, 3207861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice const char *bytes, 3208861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice size_t bytes_len); 3209861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3210861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 321124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 321224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 321324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 321424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 321524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 32166e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 321724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 321824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 321924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 322024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 322124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 322224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 322324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 3224