Process.h revision 0bce9a22354df3f00e68ffd912119a0741753b7f
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" 40a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton#include "lldb/Host/ReadWriteLock.h" 41e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Args.h" 42e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Options.h" 4324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 44613b8739a4d489b7f1c571288d5786768c024205Greg Clayton#include "lldb/Target/Memory.h" 4524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ThreadList.h" 4624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/UnixSignals.h" 47464c6161464694412b7472129e789248f1cf21b9Greg Clayton#include "lldb/Utility/PseudoTerminal.h" 4824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 5024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 51c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton//---------------------------------------------------------------------- 52c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton// ProcessProperties 53c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton//---------------------------------------------------------------------- 54c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Claytonclass ProcessProperties : public Properties 55c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton{ 56c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Claytonpublic: 57c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton ProcessProperties(bool is_global); 5886827fbccc9a4d1f9993d74940f724d63d826e45Jim Ingham 59c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton virtual 60c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton ~ProcessProperties(); 61c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton 62c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton bool 63c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton GetDisableMemoryCache() const; 6473844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton 65c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton Args 66c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton GetExtraStartupCommands () const; 676e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 68c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton void 69c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton SetExtraStartupCommands (const Args &args); 702e7f313dc473b036788319690116b324cb44b765Greg Clayton 712e7f313dc473b036788319690116b324cb44b765Greg Clayton FileSpec 722e7f313dc473b036788319690116b324cb44b765Greg Clayton GetPythonOSPluginPath () const; 732e7f313dc473b036788319690116b324cb44b765Greg Clayton 742e7f313dc473b036788319690116b324cb44b765Greg Clayton void 752e7f313dc473b036788319690116b324cb44b765Greg Clayton SetPythonOSPluginPath (const FileSpec &file); 76c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton}; 77c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton 78c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Claytontypedef STD_SHARED_PTR(ProcessProperties) ProcessPropertiesSP; 796e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 80b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 81b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInfo 82b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 83b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A base class for information for a process. This can be used to fill 84b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// out information for a process prior to launching it, or it can be 85b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// used for an instance of a process and can be filled in with the 86b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// existing values for that process. 87b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 88e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonclass ProcessInfo 89e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 90e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 91e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo () : 92ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable (), 93b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 94b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment (), 95444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 96444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 97e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch(), 98b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (LLDB_INVALID_PROCESS_ID) 99e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 100e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 101b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 102e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo (const char *name, 103e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec &arch, 104e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t pid) : 105b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_executable (name, false), 106b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 107b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment(), 108444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 109444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 110e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch (arch), 111b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (pid) 112e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 113e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 114e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 115e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 116e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear () 117e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 118ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.Clear(); 119b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments.Clear(); 120b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment.Clear(); 121444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid = UINT32_MAX; 122444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid = UINT32_MAX; 123e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch.Clear(); 124e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = LLDB_INVALID_PROCESS_ID; 125e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 126e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 127e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 128e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetName() const 129e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 130ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetCString(); 131e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 132b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 133e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 134e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetNameLength() const 135e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 136ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetLength(); 137e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 138e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 139ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton FileSpec & 140ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () 141ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 142ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 143e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 14436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 14536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 14636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetExecutableFile (const FileSpec &exe_file, bool add_exe_file_as_first_arg) 14736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 14836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file) 14936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 15036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable = exe_file; 15136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 15236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 15336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton char filename[PATH_MAX]; 15436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file.GetPath(filename, sizeof(filename))) 155c86723f0a71f5d929f4543c544d9255da52ea49dHan Ming Ong m_arguments.InsertArgumentAtIndex (0, filename); 15636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 15736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 15836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton else 15936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable.Clear(); 16136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 16236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 16336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 164ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton const FileSpec & 165ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () const 16624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 167ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 16824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 16924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 170a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 171b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetUserID() const 172a733c04608cc94592a15d27583529588e19db552Greg Clayton { 173b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid; 174a733c04608cc94592a15d27583529588e19db552Greg Clayton } 175b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 176a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 177b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetGroupID() const 178a733c04608cc94592a15d27583529588e19db552Greg Clayton { 179b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid; 180a733c04608cc94592a15d27583529588e19db552Greg Clayton } 18124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 18224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 183b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton UserIDIsValid () const 18424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 185b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid != UINT32_MAX; 18624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 18724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 18824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 189b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GroupIDIsValid () const 19024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 191b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid != UINT32_MAX; 19224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 19324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 194a733c04608cc94592a15d27583529588e19db552Greg Clayton void 195b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetUserID (uint32_t uid) 196a733c04608cc94592a15d27583529588e19db552Greg Clayton { 197b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid = uid; 198a733c04608cc94592a15d27583529588e19db552Greg Clayton } 199a733c04608cc94592a15d27583529588e19db552Greg Clayton 200a733c04608cc94592a15d27583529588e19db552Greg Clayton void 201b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetGroupID (uint32_t gid) 202a733c04608cc94592a15d27583529588e19db552Greg Clayton { 203b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid = gid; 204a733c04608cc94592a15d27583529588e19db552Greg Clayton } 205b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 206e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ArchSpec & 207e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () 208e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 209e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 210e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 211b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 212e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec & 213e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () const 214e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 215e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 216e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 217b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 218e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 219e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessID () const 220e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 221e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_pid; 222e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 223e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 224e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 225e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetProcessID (lldb::pid_t pid) 226e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 227e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = pid; 228e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 229e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 230a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 231a733c04608cc94592a15d27583529588e19db552Greg Clayton ProcessIDIsValid() const 232a733c04608cc94592a15d27583529588e19db552Greg Clayton { 233a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_pid != LLDB_INVALID_PROCESS_ID; 234a733c04608cc94592a15d27583529588e19db552Greg Clayton } 235b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 236b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 237b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Dump (Stream &s, Platform *platform) const; 238b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 239b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 240b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () 241b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 242b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 243b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 244b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 245b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 246b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () const 247b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 248b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 249b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 250b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2510c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton const char * 2520c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton GetArg0 () const 2530c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton { 2540c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton if (m_arg0.empty()) 2550c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton return NULL; 2560c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton return m_arg0.c_str(); 2570c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton } 2580c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton 2590c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton void 2600c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton SetArg0 (const char *arg) 2610c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton { 2620c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton if (arg && arg[0]) 2630c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton m_arg0.clear(); 2640c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton else 2650c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton m_arg0 = arg; 2660c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton } 2670c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton 268b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 2690c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton SetArguments (const Args& args, bool first_arg_is_executable); 270b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 27136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 2720c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton SetArguments (char const **argv, bool first_arg_is_executable); 27336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 274b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 275b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () 276b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 277b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 278b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 279b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 280b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 281b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () const 282b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 283b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 284b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 285b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 286b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 287b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileSpec m_executable; 2880c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton std::string m_arg0; // argv[0] if supported. If empty, then use m_executable. 2890c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton // Not all process plug-ins support specifying an argv[0] 2900c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton // that differs from the resolved platform executable 2910c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton // (which is in m_executable) 2920c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton Args m_arguments; // All program arguments except argv[0] 293b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_environment; 294b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_uid; 295b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_gid; 296b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ArchSpec m_arch; 297b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_pid; 298b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 299b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 300b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 301b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfo 302b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 303b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes an existing process and any discoverable information that 304b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// pertains to that process. 305b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 306b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfo : public ProcessInfo 307b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 308b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 309b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo () : 310b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (), 311b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 312b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 313b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 314b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 315b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 316b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 317b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo (const char *name, 318b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ArchSpec &arch, 319b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t pid) : 320b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (name, arch, pid), 321b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 322b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 323b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 324b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 325b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 326b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 327b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 328b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 329b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 330b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 331b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = UINT32_MAX; 332b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = UINT32_MAX; 333b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid = LLDB_INVALID_PROCESS_ID; 334b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 335b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 336b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 337b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveUserID() const 338b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 339b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid; 340b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 341b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 342b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 343b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveGroupID() const 344b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 345b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid; 346b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 347b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 348b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 349b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveUserIDIsValid () const 350b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 351b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid != UINT32_MAX; 352b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 353b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 354b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 355b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveGroupIDIsValid () const 356b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 357b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid != UINT32_MAX; 358b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 359b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 360b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 361b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveUserID (uint32_t uid) 362b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 363b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = uid; 364b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 365b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 366b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 367b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveGroupID (uint32_t gid) 368b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 369b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = gid; 370b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 371a733c04608cc94592a15d27583529588e19db552Greg Clayton 372a733c04608cc94592a15d27583529588e19db552Greg Clayton lldb::pid_t 373a733c04608cc94592a15d27583529588e19db552Greg Clayton GetParentProcessID () const 374a733c04608cc94592a15d27583529588e19db552Greg Clayton { 375a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid; 376a733c04608cc94592a15d27583529588e19db552Greg Clayton } 377a733c04608cc94592a15d27583529588e19db552Greg Clayton 378a733c04608cc94592a15d27583529588e19db552Greg Clayton void 379a733c04608cc94592a15d27583529588e19db552Greg Clayton SetParentProcessID (lldb::pid_t pid) 380a733c04608cc94592a15d27583529588e19db552Greg Clayton { 381a733c04608cc94592a15d27583529588e19db552Greg Clayton m_parent_pid = pid; 382a733c04608cc94592a15d27583529588e19db552Greg Clayton } 383a733c04608cc94592a15d27583529588e19db552Greg Clayton 384a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 385a733c04608cc94592a15d27583529588e19db552Greg Clayton ParentProcessIDIsValid() const 386a733c04608cc94592a15d27583529588e19db552Greg Clayton { 387a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid != LLDB_INVALID_PROCESS_ID; 388a733c04608cc94592a15d27583529588e19db552Greg Clayton } 38924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 39024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 39124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Dump (Stream &s, Platform *platform) const; 39224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 39324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton static void 394b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose); 395b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 396b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 397b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const; 398b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 399b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 400b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_euid; 401b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_egid; 402b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_parent_pid; 403b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 4041c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 405b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 406b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 407b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessLaunchInfo 408b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 409b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes any information that is required to launch a process. 410b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 411b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 412b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchInfo : public ProcessInfo 413b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 414b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 415b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 416b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton class FileAction 417b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 418b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton public: 41936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton enum Action 42036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 42136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionNone, 42236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionClose, 42336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionDuplicate, 42436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionOpen 42536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton }; 42636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 427b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 428b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction () : 429b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action (eFileActionNone), 430b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd (-1), 431b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg (-1), 432b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path () 433b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 434b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 435b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 436b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 437b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear() 438b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 439b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action = eFileActionNone; 440b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd = -1; 441b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg = -1; 442b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path.clear(); 443b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 444b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 445b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 446b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Close (int fd); 447b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 448b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 449b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Duplicate (int fd, int dup_fd); 450b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 451b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 452b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Open (int fd, const char *path, bool read, bool write); 453b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 454b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static bool 455b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AddPosixSpawnFileAction (posix_spawn_file_actions_t *file_actions, 456b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction *info, 457b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Log *log, 458b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error& error); 459b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 46036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 46136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFD () const 462b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 46336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_fd; 46436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 46536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 46636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Action 46736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetAction () const 46836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 46936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_action; 47036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 47336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetActionArgument () const 47436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 47536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_arg; 47636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char * 47936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetPath () const 48036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 48136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_path.empty()) 48236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 48336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_path.c_str(); 48436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 485b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 48636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton protected: 487b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Action m_action; // The action for this file 488b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_fd; // An existing file descriptor 489b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_arg; // oflag for eFileActionOpen*, dup_fd for eFileActionDuplicate 490b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_path; // A file path to use for opening after fork or posix_spawn 491b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton }; 492b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 493b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo () : 494b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo(), 495ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_working_dir (), 496ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_plugin_name (), 497ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_shell (), 498ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_flags (0), 499ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_file_actions (), 500464c6161464694412b7472129e789248f1cf21b9Greg Clayton m_pty (), 501ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_resume_count (0), 502ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback (NULL), 503ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback_baton (NULL), 504ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_signals (false) 505b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 506b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 507b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 50836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo (const char *stdin_path, 50936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stdout_path, 51036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stderr_path, 51136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *working_directory, 51236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton uint32_t launch_flags) : 51336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessInfo(), 5141c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_working_dir (), 5151c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_plugin_name (), 5161c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_shell (), 5171c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_flags (launch_flags), 5181c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_file_actions (), 519464c6161464694412b7472129e789248f1cf21b9Greg Clayton m_pty (), 5201c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_resume_count (0), 5211c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback (NULL), 5221c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton (NULL), 5231c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals (false) 52436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52595ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (stdin_path) 52636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 52836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 52995ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool write = false; 53095ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (file_action.Open(STDIN_FILENO, stdin_path, read, write)) 53136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 53236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 53336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdout_path) 53436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 53536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 53636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = false; 53736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 53836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDOUT_FILENO, stdout_path, read, write)) 53936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 54036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 54195ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (stderr_path) 54236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 54336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 54495ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool read = false; 54595ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool write = true; 54695ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (file_action.Open(STDERR_FILENO, stderr_path, read, write)) 54736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 54836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 54936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (working_directory) 55036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetWorkingDirectory(working_directory); 55136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 552abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 553b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 554b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (const FileAction &info) 555b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 556b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.push_back(info); 557b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 558b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 559abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 560b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendCloseFileAction (int fd) 561b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 562b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 563abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Close (fd)) 564abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 565abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 566abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 567abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 568abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 569b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 570b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 571abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 5720a8dcacde404c520f1131c641041dceb9f68b6faGreg Clayton AppendDuplicateFileAction (int fd, int dup_fd) 573b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 574b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 575abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Duplicate (fd, dup_fd)) 576abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 577abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 578abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 579abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 580abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 581b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 582b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 583abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 584b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendOpenFileAction (int fd, const char *path, bool read, bool write) 585b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 586b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 587abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, path, read, write)) 588abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 589abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 590abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 591abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 592abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 593b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 594b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 595abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 596b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendSuppressFileAction (int fd, bool read, bool write) 597b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 598b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 599abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, "/dev/null", read, write)) 600abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 601abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 602abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 603abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 604abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 605b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 606abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 607abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton void 608464c6161464694412b7472129e789248f1cf21b9Greg Clayton FinalizeFileActions (Target *target, 609464c6161464694412b7472129e789248f1cf21b9Greg Clayton bool default_to_use_pty); 610b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 611b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 612b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetNumFileActions () const 613b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 614b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_file_actions.size(); 615b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 616b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 617b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction * 618b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFileActionAtIndex (size_t idx) const 619b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 620b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (idx < m_file_actions.size()) 621b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return &m_file_actions[idx]; 622b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 623b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 624b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 62536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const FileAction * 62636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFileActionForFD (int fd) const 62736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 62836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton for (uint32_t idx=0, count=m_file_actions.size(); idx < count; ++idx) 62936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 63036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_file_actions[idx].GetFD () == fd) 63136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return &m_file_actions[idx]; 63236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 63336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 63436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 63536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 636b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags & 637b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () 638b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 639b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 640b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 641b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 642b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Flags & 643b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () const 644b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 645b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 646b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 647b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 648b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 649b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetWorkingDirectory () const 650b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 651b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_working_dir.empty()) 652b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 653b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_working_dir.c_str(); 654b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 65524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 65624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 657b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetWorkingDirectory (const char *working_dir) 658b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 659b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (working_dir && working_dir[0]) 660b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.assign (working_dir); 661b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 662b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 663b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 664ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 665b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 666b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SwapWorkingDirectory (std::string &working_dir) 667ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 668b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.swap (working_dir); 669b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 670b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 671b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 672b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 673b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetProcessPluginName () const 674b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 675b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_plugin_name.empty()) 676b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 677b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_plugin_name.c_str(); 678b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 679b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 680b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 681b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetProcessPluginName (const char *plugin) 682b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 683b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (plugin && plugin[0]) 684b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.assign (plugin); 685b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 686b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 687ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 688ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 689527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 690527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetShell () const 691527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 692527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_shell.empty()) 693527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 694527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_shell.c_str(); 695527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 696527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 697527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 698527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetShell (const char * path) 699527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 700527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (path && path[0]) 701527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 702527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.assign (path); 703527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Set (lldb::eLaunchFlagLaunchInShell); 704527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 705527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 706527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 707527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 708527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Clear (lldb::eLaunchFlagLaunchInShell); 709527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 710527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 711527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 712527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 713527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 714527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 715527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 716527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 717527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 718527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 719527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 720527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 721527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 722527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 723b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham 724b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham bool 725b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham GetLaunchInSeparateProcessGroup () 726b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham { 727b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham return m_flags.Test(lldb::eLaunchFlagLaunchInSeparateProcessGroup); 728b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham } 729b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham 730b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham void 731b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham SetLaunchInSeparateProcessGroup (bool separate) 732b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham { 733b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham if (separate) 734b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham m_flags.Set(lldb::eLaunchFlagLaunchInSeparateProcessGroup); 735b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham else 736b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham m_flags.Clear (lldb::eLaunchFlagLaunchInSeparateProcessGroup); 737b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham 738b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham } 739527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 740b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 741b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 742ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 743b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 744b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 745b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 746527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 747b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_flags.Clear(); 748b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.clear(); 749527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 750ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 751a733c04608cc94592a15d27583529588e19db552Greg Clayton 752527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 75397471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton ConvertArgumentsForLaunchingInShell (Error &error, 75497471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool localhost, 75597471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool will_debug, 75697471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool first_arg_is_full_shell_command); 757527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 7581c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void 7591c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton SetMonitorProcessCallback (Host::MonitorChildProcessCallback callback, 7601c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *baton, 7611c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool monitor_signals) 7621c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7631c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback = callback; 7641c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton = baton; 7651c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals = monitor_signals; 7661c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7671c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 7681c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool 7691c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton MonitorProcess () const 7701c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7711c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton if (m_monitor_callback && ProcessIDIsValid()) 7721c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7731c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::StartMonitoringChildProcess (m_monitor_callback, 7741c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton, 7751c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton GetProcessID(), 7761c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals); 7771c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return true; 7781c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7791c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return false; 7801c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7811c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 782464c6161464694412b7472129e789248f1cf21b9Greg Clayton lldb_utility::PseudoTerminal & 783464c6161464694412b7472129e789248f1cf21b9Greg Clayton GetPTY () 784464c6161464694412b7472129e789248f1cf21b9Greg Clayton { 785464c6161464694412b7472129e789248f1cf21b9Greg Clayton return m_pty; 786464c6161464694412b7472129e789248f1cf21b9Greg Clayton } 7871c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 788e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 789b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_working_dir; 790b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_plugin_name; 791527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_shell; 792b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags m_flags; // Bitwise OR of bits from lldb::LaunchFlags 793b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::vector<FileAction> m_file_actions; // File actions for any other files 794464c6161464694412b7472129e789248f1cf21b9Greg Clayton lldb_utility::PseudoTerminal m_pty; 795527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 7961c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::MonitorChildProcessCallback m_monitor_callback; 7971c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *m_monitor_callback_baton; 7981c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool m_monitor_signals; 799b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham 800527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton}; 801527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 802527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 803527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// ProcessLaunchInfo 804527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// 805527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// Describes any information that is required to launch a process. 806527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 807527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 808527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonclass ProcessAttachInfo : public ProcessInstanceInfo 809527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton{ 810527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonpublic: 811527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo() : 812527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 813527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 814527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 8157c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_wait_for_launch (false), 8163a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_ignore_existing (true), 8177c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_continue_once_attached (false) 818527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 819527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 820527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 821527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo (const ProcessLaunchInfo &launch_info) : 822527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 823527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 824527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 8257c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_wait_for_launch (false), 8263a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_ignore_existing (true), 8277c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_continue_once_attached (false) 828527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 829527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfo::operator= (launch_info); 830527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (launch_info.GetProcessPluginName()); 831527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (launch_info.GetResumeCount()); 832527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 833527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 834527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 835527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetWaitForLaunch () const 836527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 837527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_wait_for_launch; 838527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 839527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 840527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 841527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetWaitForLaunch (bool b) 842527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 843527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = b; 844527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 845527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 8467c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen bool 8473a458eb1e413d39546b664813bba9f9ac292357eJim Ingham GetIgnoreExisting () const 8483a458eb1e413d39546b664813bba9f9ac292357eJim Ingham { 8493a458eb1e413d39546b664813bba9f9ac292357eJim Ingham return m_ignore_existing; 8503a458eb1e413d39546b664813bba9f9ac292357eJim Ingham } 8513a458eb1e413d39546b664813bba9f9ac292357eJim Ingham 8523a458eb1e413d39546b664813bba9f9ac292357eJim Ingham void 8533a458eb1e413d39546b664813bba9f9ac292357eJim Ingham SetIgnoreExisting (bool b) 8543a458eb1e413d39546b664813bba9f9ac292357eJim Ingham { 8553a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_ignore_existing = b; 8563a458eb1e413d39546b664813bba9f9ac292357eJim Ingham } 8573a458eb1e413d39546b664813bba9f9ac292357eJim Ingham 8583a458eb1e413d39546b664813bba9f9ac292357eJim Ingham bool 8597c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen GetContinueOnceAttached () const 8607c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen { 8617c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen return m_continue_once_attached; 8627c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen } 8637c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen 8647c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen void 8657c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen SetContinueOnceAttached (bool b) 8667c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen { 8677c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_continue_once_attached = b; 8687c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen } 8697c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen 870527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 871527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 872527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 873527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 874527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 875527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 876527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 877527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 878527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 879527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 880527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 881527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 882527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 883527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetProcessPluginName () const 884527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 885527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_plugin_name.empty()) 886527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 887527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_plugin_name.c_str(); 888527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 889527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 890527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 891527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (const char *plugin) 892527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 893527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (plugin && plugin[0]) 894527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.assign (plugin); 895527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 896527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 897527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 898527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 899527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 900527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Clear () 901527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 902527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo::Clear(); 903527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 904527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 905527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = false; 9063a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_ignore_existing = true; 9073a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_continue_once_attached = false; 908527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 909527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 910527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 911527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfoSpecified () const 912527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 913527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetExecutableFile()) 914527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 915527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetProcessID() != LLDB_INVALID_PROCESS_ID) 916527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 917527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetParentProcessID() != LLDB_INVALID_PROCESS_ID) 918527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 919527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return false; 920527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 921527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonprotected: 922527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_plugin_name; 923527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 924527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool m_wait_for_launch; 9253a458eb1e413d39546b664813bba9f9ac292357eJim Ingham bool m_ignore_existing; 9267c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen bool m_continue_once_attached; // Supports the use-case scenario of immediately continuing the process once attached. 927e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 928e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 929b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchCommandOptions : public Options 93024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton{ 93124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonpublic: 932b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 933b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchCommandOptions (CommandInterpreter &interpreter) : 934b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Options(interpreter) 935b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 936143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton // Keep default values of all options in one place: OptionParsingStarting () 937143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting (); 938b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 939b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 940b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ~ProcessLaunchCommandOptions () 941b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 942b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 943b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 944b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error 945143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton SetOptionValue (uint32_t option_idx, const char *option_arg); 946b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 947b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 948143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting () 949b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 950b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton launch_info.Clear(); 951b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 952b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 953b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const OptionDefinition* 954b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetDefinitions () 955b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 956b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return g_option_table; 957b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 958b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 959b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Options table: Required for subclasses of Options. 960b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 961b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static OptionDefinition g_option_table[]; 962b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 963b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Instance variables to hold the values for command options. 964b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 965b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo launch_info; 966b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 967b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 968b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 969b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfoMatch 970b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 971b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A class to help matching one ProcessInstanceInfo to another. 972b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 973b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 974b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoMatch 975b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 976b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 977b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch () : 97824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 979a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton m_name_match_type (eNameMatchIgnore), 98024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 98124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 98224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 98324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 984b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch (const char *process_name, 985a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType process_name_match_type) : 98624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 98724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (process_name_match_type), 98824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 98924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 990527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_match_info.GetExecutableFile().SetFile(process_name, false); 99124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 99224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 993b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo & 99424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () 99524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 99624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 99724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 99824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 999b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 100024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () const 100124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 100224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 100324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 100424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 100524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 100624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetMatchAllUsers () const 100724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 100824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_all_users; 100924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 101024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 101124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 101224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetMatchAllUsers (bool b) 101324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 101424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users = b; 101524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 101624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1017a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType 101824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetNameMatchType () const 101924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 102024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_name_match_type; 102124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 102224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 102324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 1024a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton SetNameMatchType (NameMatchType name_match_type) 102524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 102624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type = name_match_type; 102724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 102824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 102924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 103024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton NameMatches (const char *process_name) const; 103124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 103224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 1033b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Matches (const ProcessInstanceInfo &proc_info) const; 103424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 103524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 103624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton MatchAllProcesses () const; 103724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 103824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Clear (); 103924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 104024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonprotected: 1041b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo m_match_info; 1042a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType m_name_match_type; 104324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool m_match_all_users; 104424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton}; 104524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1046b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoList 1047e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 1048e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 1049b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoList () : 1050e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos() 1051e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1052e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1053e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1054e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1055e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear() 1056e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1057e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.clear(); 1058e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1059e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1060e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton uint32_t 1061e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetSize() 1062e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1063e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos.size(); 1064e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1065e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1066e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1067b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Append (const ProcessInstanceInfo &info) 1068e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1069e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.push_back (info); 1070e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1071e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1072e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 1073e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameAtIndex (uint32_t idx) 1074e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1075e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1076e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetName(); 1077e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return NULL; 1078e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1079e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1080e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 1081e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameLengthAtIndex (uint32_t idx) 1082e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1083e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1084e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetNameLength(); 1085e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return 0; 1086e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1087e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1088e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 1089e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessIDAtIndex (uint32_t idx) 1090e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1091e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1092e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetProcessID(); 10932bc9eb3ba78efc64a273729b480bafc3bbaa433aJohnny Chen return 0; 1094e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1095e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1096e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton bool 1097b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetInfoAtIndex (uint32_t idx, ProcessInstanceInfo &info) 1098e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1099e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1100e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1101e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton info = m_infos[idx]; 1102e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return true; 1103e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1104e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return false; 1105e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1106e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 110724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton // You must ensure "idx" is valid before calling this function 1108b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 110924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfoAtIndex (uint32_t idx) const 111024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 111124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton assert (idx < m_infos.size()); 111224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_infos[idx]; 111324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 111424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1115e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 1116b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton typedef std::vector<ProcessInstanceInfo> collection; 1117e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton collection m_infos; 1118e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 1119e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 11206e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 112121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// This class tracks the Modification state of the process. Things that can currently modify 112221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// the program are running the program (which will up the StopID) and writing memory (which 112321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// will up the MemoryID.) 112421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// FIXME: Should we also include modification of register states? 112521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 112621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamclass ProcessModID 112721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 112821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend bool operator== (const ProcessModID &lhs, const ProcessModID &rhs); 112921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghampublic: 113021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID () : 11310296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id (0), 11320296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id (0), 11330296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_memory_id (0), 11340296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume (0), 11350296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression (false) 113621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 113721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 113821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID (const ProcessModID &rhs) : 113921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id (rhs.m_stop_id), 114021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id (rhs.m_memory_id) 114121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 114221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 114321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham const ProcessModID & operator= (const ProcessModID &rhs) 114421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 114521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (this != &rhs) 114621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 114721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = rhs.m_stop_id; 114821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id = rhs.m_memory_id; 114921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 115021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return *this; 115121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 115221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 115321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ~ProcessModID () {} 115421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 11550296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpStopID () { 11560296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id++; 11570296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11580296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 115921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void BumpMemoryID () { m_memory_id++; } 116021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 11610296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpResumeID () { 11620296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id++; 11630296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (m_running_user_expression > 0) 11640296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume = m_resume_id; 11650296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11660296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 116721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetStopID() const { return m_stop_id; } 116821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetMemoryID () const { return m_memory_id; } 11690296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetResumeID () const { return m_resume_id; } 11700296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetLastUserExpressionResumeID () const { return m_last_user_expression_resume; } 117121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 117221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool MemoryIDEqual (const ProcessModID &compare) const 117321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 117421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_memory_id == compare.m_memory_id; 117521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 117621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 117721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool StopIDEqual (const ProcessModID &compare) const 117821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 117921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id == compare.m_stop_id; 118021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 118121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 118221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void SetInvalid () 118321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 118421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = UINT32_MAX; 118521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 118621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 118721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool IsValid () const 118821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 118921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id != UINT32_MAX; 119021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 11910296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 11925a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata bool 11935a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata IsLastResumeForUserExpression () const 11945a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata { 11955a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata return m_resume_id == m_last_user_expression_resume; 11965a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata } 11975a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata 11980296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 11990296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on) 12000296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 12010296fe73a7cb1482226b1303a795ede00e12d677Jim 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); 12020296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (on) 12030296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression++; 12040296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham else 12050296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression--; 12060296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 12070296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 120821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamprivate: 120921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_stop_id; 12100296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_resume_id; 121121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_memory_id; 12120296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_last_user_expression_resume; 12130296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_running_user_expression; 121421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham}; 121521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator== (const ProcessModID &lhs, const ProcessModID &rhs) 121621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 121721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (lhs.StopIDEqual (rhs) 121821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham && lhs.MemoryIDEqual (rhs)) 121921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 122021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 122121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 122221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 122321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 122421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator!= (const ProcessModID &lhs, const ProcessModID &rhs) 122521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 122621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (!lhs.StopIDEqual (rhs) 122721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham || !lhs.MemoryIDEqual (rhs)) 122821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 122921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 123021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 123121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 1232a9385537809ef342c843c5ab972e513742652047Greg Clayton 1233a9385537809ef342c843c5ab972e513742652047Greg Claytonclass MemoryRegionInfo 1234a9385537809ef342c843c5ab972e513742652047Greg Clayton{ 1235a9385537809ef342c843c5ab972e513742652047Greg Claytonpublic: 1236a9385537809ef342c843c5ab972e513742652047Greg Clayton typedef Range<lldb::addr_t, lldb::addr_t> RangeType; 12371f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12381f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda enum OptionalBool { 12391f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eDontKnow = -1, 12401f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eNo = 0, 12411f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eYes = 1 12421f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda }; 12431f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 1244a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo () : 1245a9385537809ef342c843c5ab972e513742652047Greg Clayton m_range (), 12461f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read (eDontKnow), 12471f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_write (eDontKnow), 12481f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_execute (eDontKnow) 1249a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1250a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1251a9385537809ef342c843c5ab972e513742652047Greg Clayton 1252a9385537809ef342c843c5ab972e513742652047Greg Clayton ~MemoryRegionInfo () 1253a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1254a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1255a9385537809ef342c843c5ab972e513742652047Greg Clayton 1256a9385537809ef342c843c5ab972e513742652047Greg Clayton RangeType & 1257a9385537809ef342c843c5ab972e513742652047Greg Clayton GetRange() 1258a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1259a9385537809ef342c843c5ab972e513742652047Greg Clayton return m_range; 1260a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1261a9385537809ef342c843c5ab972e513742652047Greg Clayton 1262a9385537809ef342c843c5ab972e513742652047Greg Clayton void 1263a9385537809ef342c843c5ab972e513742652047Greg Clayton Clear() 1264a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1265a9385537809ef342c843c5ab972e513742652047Greg Clayton m_range.Clear(); 12661f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read = m_write = m_execute = eDontKnow; 1267a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1268a9385537809ef342c843c5ab972e513742652047Greg Clayton 1269a9385537809ef342c843c5ab972e513742652047Greg Clayton const RangeType & 1270a9385537809ef342c843c5ab972e513742652047Greg Clayton GetRange() const 1271a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1272a9385537809ef342c843c5ab972e513742652047Greg Clayton return m_range; 1273a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12741f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12751f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12761f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetReadable () const 1277a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12781f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_read; 1279a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12801f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12811f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12821f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetWritable () const 1283a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12841f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_write; 12851f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda } 12861f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12871f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12881f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetExecutable () const 12891f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda { 12901f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_execute; 1291a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1292a9385537809ef342c843c5ab972e513742652047Greg Clayton 1293a9385537809ef342c843c5ab972e513742652047Greg Clayton void 12941f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetReadable (OptionalBool val) 1295a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12961f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read = val; 1297a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12981f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 1299a9385537809ef342c843c5ab972e513742652047Greg Clayton void 13001f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetWritable (OptionalBool val) 1301a9385537809ef342c843c5ab972e513742652047Greg Clayton { 13021f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_write = val; 1303a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1304a9385537809ef342c843c5ab972e513742652047Greg Clayton 1305a9385537809ef342c843c5ab972e513742652047Greg Clayton void 13061f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetExecutable (OptionalBool val) 1307a9385537809ef342c843c5ab972e513742652047Greg Clayton { 13081f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_execute = val; 1309a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1310a9385537809ef342c843c5ab972e513742652047Greg Clayton 1311a9385537809ef342c843c5ab972e513742652047Greg Claytonprotected: 1312a9385537809ef342c843c5ab972e513742652047Greg Clayton RangeType m_range; 13131f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_read; 13141f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_write; 13151f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_execute; 1316a9385537809ef342c843c5ab972e513742652047Greg Clayton}; 131721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 131824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 131924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 132024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 132124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 132224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 1323598df88bd6fc33c6fb330bc859bdc277795501f3Greg Clayton public STD_ENABLE_SHARED_FROM_THIS(Process), 132473844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton public ProcessProperties, 132524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 132624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 132724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 132873844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton public PluginInterface 132924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 133024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 1331d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Inghamfriend class ClangFunction; // For WaitForStateChangeEventsPrivate 133221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectProcessLaunch; 133321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class ProcessEventData; 133421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectBreakpointCommand; 133521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class StopInfo; 133624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 133724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 133824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 133924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 134024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 134124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 134324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 134424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 134524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 134624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 1347fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong eBroadcastBitSTDERR = (1 << 3), 1348fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong eBroadcastBitProfileData = (1 << 4) 134924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 135024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 135424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 135524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 135624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 13575a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 1358761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton typedef Range<lldb::addr_t, lldb::addr_t> LoadRange; 1359a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // We use a read/write lock to allow on or more clients to 1360a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // access the process state while the process is stopped (reader). 1361a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // We lock the write lock to control access to the process 1362a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // while it is running (readers, or clients that want the process 1363a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // stopped can block waiting for the process to stop, or just 1364a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // try to lock it to see if they can immediately access the stopped 1365a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // process. If the try read lock fails, then the process is running. 1366a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef ReadWriteLock::ReadLocker StopLocker; 1367a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef ReadWriteLock::WriteLocker RunLocker; 1368761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton 13695a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham // These two functions fill out the Broadcaster interface: 13705a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 13715a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham static ConstString &GetStaticBroadcasterClass (); 13725a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 13735a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham virtual ConstString &GetBroadcasterClass() const 13745a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham { 13755a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham return GetStaticBroadcasterClass(); 13765a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham } 13775a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 137824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 137924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 138024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 138124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 138224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 138324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 138424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 138524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 138624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 138724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 138824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 138924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 139024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 139124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 139224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 139424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 139524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 13963ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham friend class Process; 13973ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 139824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 139924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 140024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 140124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 140324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 140524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 140624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 140824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 140924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 141024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 14113ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetProcessSP() const 14123ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14133ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_process_sp; 14143ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 141524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 14163ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetState() const 14173ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14183ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_state; 14193ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 142024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 14213ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetRestarted () const 14223ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14233ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_restarted; 14243ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 14253ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool 14263ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterrupted () const 14273ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14283ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_interrupted; 14293ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 143024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 143124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 143224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 143324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 143424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 143524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 143624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 143724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 143824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 143924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 144024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 144124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 144224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 144324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 144424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 144524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 144624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 144724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 144824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 144924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 145024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 145124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 145224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 14533ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterruptedFromEvent (const Event *event_ptr); 14543ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 14553ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static void 14563ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterruptedInEvent (Event *event_ptr, bool new_value); 14573ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 14583ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static bool 145924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 146024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 146124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 146224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 146324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 14643ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetUpdateStateOnRemoval() 14653ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14666cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham m_update_state++; 14673ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 146824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 14693ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetRestarted (bool new_value) 14703ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14713ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_restarted = new_value; 14723ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 14733ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham void 14743ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterrupted (bool new_value) 14753ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14763ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_interrupted = new_value; 14773ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 148024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 148124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 14826cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham int m_update_state; 14833ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool m_interrupted; 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 148524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 14876e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 148824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 148924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1490990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 14912a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsInitialize (); 1492990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1493990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 14942a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsTerminate (); 149573844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton 149673844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton static const ProcessPropertiesSP & 149773844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton GetGlobalProperties(); 1498990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 149924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 150124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 150324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 150424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 150624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 150824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 150924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 151124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 151224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 151524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 151624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 151724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 151824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 151924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 152024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 152224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 152324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 152524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 152624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 152724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 152824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 153024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 153146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton static lldb::ProcessSP 153246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton FindPlugin (Target &target, 153346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const char *plugin_name, 153446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Listener &listener, 153546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const FileSpec *crash_file_path); 153624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 154024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 154124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 154224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 154524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 154624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 154724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 154824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 154924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 155024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 155124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 155224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 155324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 155424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 155524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 15561c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool exited, 155724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 155824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 155924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1560395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton lldb::ByteOrder 1561395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetByteOrder () const; 1562395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 1563395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton uint32_t 1564395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetAddressByteSize () const; 1565395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 156624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 156824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1569fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 157024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 157124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 157224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 157424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 157524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 157724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 15788d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton CanDebug (Target &target, 15798d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton bool plugin_specified_by_name) = 0; 158024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 158124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 158224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 158324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 158424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 158624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 158724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 158824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 158924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 1590d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham 1591d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham 1592d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham //------------------------------------------------------------------ 1593d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// Return whether this object is valid (i.e. has not been finalized.) 1594d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// 1595d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// @return 1596d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// Returns \b true if this Process has not been finalized 1597d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// and \b false otherwise. 1598d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham //------------------------------------------------------------------ 1599d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham bool 1600d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham IsValid() const 1601d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham { 1602d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham return !m_finalize_called; 1603d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham } 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 160524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 160613193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// Return a multi-word command object that can be used to expose 160713193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// plug-in specific commands. 160813193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// 160913193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// This object will be used to resolve plug-in commands and can be 161013193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// triggered by a call to: 161113193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// 161213193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// (lldb) process commmand <args> 161313193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// 161413193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// @return 161513193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// A CommandObject which can be one of the concrete subclasses 161613193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// of CommandObject like CommandObjectRaw, CommandObjectParsed, 161713193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// or CommandObjectMultiword. 161813193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton //------------------------------------------------------------------ 161913193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton virtual CommandObject * 162013193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton GetPluginCommandObject() 162113193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton { 162213193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton return NULL; 162313193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton } 162413193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton 162513193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton //------------------------------------------------------------------ 162624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 162724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 162824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 162924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 163024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 163124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 163224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 163324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 163424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 163524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 163624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 163724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 163824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 163924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 164224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 164424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 164524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 164724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 164824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1649452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1650452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1651452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 165224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 165324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 165424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 165524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 165624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 165724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 165824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 165924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 166024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 166124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 166224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 166324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 166424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 166524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 166624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1667de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1668de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1669de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 167024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 167124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 167224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 167324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 167424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 167536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Launch (const ProcessLaunchInfo &launch_info); 167624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 167746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton virtual Error 167846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton LoadCore (); 167946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 168046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton virtual Error 168146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoLoadCore () 168246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 168346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 168446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support loading core files.", GetShortPluginName()); 168546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 168646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 16879ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton 16889ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton //------------------------------------------------------------------ 16899ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// Get the dynamic loader plug-in for this process. 16909ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// 16919ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// The default action is to let the DynamicLoader plug-ins check 16929ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// the main executable and the DynamicLoader will select itself 16939ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// automatically. Subclasses can override this if inspecting the 16949ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// executable is not desired, or if Process subclasses can only 16959ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// use a specific DynamicLoader plug-in. 16969ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton //------------------------------------------------------------------ 16979ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton virtual DynamicLoader * 16989ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton GetDynamicLoader (); 169946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 170024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 1701527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// Attach to an existing process using the process attach info. 170224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 170324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 1704527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// subclasses. It will first call WillAttach (lldb::pid_t) 1705527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// or WillAttach (const char *), and if that returns \b 1706527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// true, DoAttach (lldb::pid_t) or DoAttach (const char *) will 170724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 170824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 170924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 171124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 171224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 171424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 171524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 171624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 171724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 1718527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Attach (ProcessAttachInfo &attach_info); 171924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1720fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda //------------------------------------------------------------------ 1721fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// Attach to a remote system via a URL 1722fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1723fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @param[in] strm 1724fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// A stream where output intended for the user 1725fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// (if the driver has a way to display that) generated during 1726fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// the connection. This may be NULL if no output is needed.A 1727fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1728fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @param[in] remote_url 1729fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// The URL format that we are connecting to. 1730fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1731fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @return 1732fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// Returns an error object. 1733fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda //------------------------------------------------------------------ 1734e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1735fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda ConnectRemote (Stream *strm, const char *remote_url); 17367508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1737dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool 1738ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton GetShouldDetach () const 1739dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham { 1740ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton return m_should_detach; 1741dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham } 1742ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 1743ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton void 1744ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton SetShouldDetach (bool b) 1745ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton { 1746ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_should_detach = b; 1747ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton } 1748ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 17497508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 175024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 175124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 175324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 175424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 175524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 175624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 175724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 175824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 176024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 176124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 176224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 176324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 176424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 176524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 176624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 176724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 17680baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Load a shared library into this process. 17690baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 17700baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Try and load a shared library into the current process. This 17710baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// call might fail in the dynamic loader plug-in says it isn't safe 17720baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// to try and load shared libraries at the moment. 17730baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 17740baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[in] image_spec 17750baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// The image file spec that points to the shared library that 17760baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// you want to load. 17770baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 17780baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[out] error 17790baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// An error object that gets filled in with any errors that 17800baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// might occur when trying to load the shared library. 17810baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 17820baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @return 17830baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// A token that represents the shared library that can be 17840baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// later used to unload the shared library. A value of 17850baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// LLDB_INVALID_IMAGE_TOKEN will be returned if the shared 17860baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// library can't be opened. 17870baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 17880baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual uint32_t 17890baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton LoadImage (const FileSpec &image_spec, Error &error); 17900baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 17910baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual Error 17920baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton UnloadImage (uint32_t image_token); 17930baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 17940baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 179524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 179624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 179724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 179824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 179924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 180024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 180124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 180224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 180324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 180424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 180524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 180724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 180824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 180924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 181024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 181124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 181224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 181424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 181524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 181724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 181824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 181924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 182024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 182124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 182224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 182324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 182424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 182524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 182624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 182724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 182824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 182924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 183024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 183124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 183224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 183324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 183424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 183524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 183624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 183724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 183824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 183924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 184024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 184124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 184224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 184324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 184424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 184524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 184624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 184724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1848027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// N.B. This function also sets the Write side of the Run Lock, 1849027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// which is unset when the corresponding stop event is pulled off 1850027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// the Public Event Queue. If you need to resume the process without 1851027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// setting the Run Lock, use PrivateResume (though you should only do 1852027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// that from inside the Process class. 1853027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// 185424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 185524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 185624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 185724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 185824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 185924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 186024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18613ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 1862027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham Resume(); 1863027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham 186424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 186624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 186824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 18693ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// If the process is successfully halted, a eStateStopped 18703ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// process event with GetInterrupted will be broadcast. If false, we will 18713ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// halt the process with no events generated by the halt. 187224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 18743ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// Returns an error object. If the error is empty, the process is halted. 18753ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// otherwise the halt has failed. 187624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18773ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 187824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 187924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 188024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 188124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 188224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 188424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 188524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 188724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 188824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18893ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 189024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 189124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 189224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 189424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 189524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 189624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 189724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 189824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 189924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 190024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 190124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 19023ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 190324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 190424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 190524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 190624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 190724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 190924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 191024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 191124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 191224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 191324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 19143ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 191524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 191624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 191724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 1918395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetUnixSignals () 1919395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1920395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_unix_signals; 1921395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 192224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 192324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 192424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 192524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 192624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 192724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 192824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 192924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 193024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 193124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 193224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 193324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 193424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 193524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 193624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 193754e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 193824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 193924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 194024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 194124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 194224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 194324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 194424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 194524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 194624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 194724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 194824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 194924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 195024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 195124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 195254e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 195324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 195424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 195524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 195624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1957fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda //------------------------------------------------------------------ 1958fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// Attach to a remote system via a URL 1959fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1960fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @param[in] strm 1961fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// A stream where output intended for the user 1962fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// (if the driver has a way to display that) generated during 1963fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// the connection. This may be NULL if no output is needed.A 1964fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1965fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @param[in] remote_url 1966fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// The URL format that we are connecting to. 1967fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1968fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @return 1969fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// Returns an error object. 1970fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda //------------------------------------------------------------------ 1971e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1972fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda DoConnectRemote (Stream *strm, const char *remote_url) 1973e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton { 1974e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton Error error; 1975e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton error.SetErrorString ("remote connections are not supported"); 1976e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton return error; 1977e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton } 1978e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton 197924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 198124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 198224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 198324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 198424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 198524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 198624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 198724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 198824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 199046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoAttachToProcessWithID (lldb::pid_t pid) 199146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 199246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 199346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support attaching to a process by pid", GetShortPluginName()); 199446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 199546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 199624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 1998d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Attach to an existing process using a process ID. 1999d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 2000d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] pid 2001d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// The process ID that we should attempt to attach to. 2002d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 2003d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] attach_info 2004d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Information on how to do the attach. For example, GetUserID() 2005d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// will return the uid to attach as. 2006d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 2007d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @return 2008d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Returns \a pid if attaching was successful, or 2009d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// LLDB_INVALID_PROCESS_ID if attaching fails. 2010d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// hanming : need flag 2011d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong //------------------------------------------------------------------ 2012d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong virtual Error 2013d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong DoAttachToProcessWithID (lldb::pid_t pid, const ProcessAttachInfo &attach_info) 2014d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong { 2015d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong Error error; 2016d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong error.SetErrorStringWithFormat("error: %s does not support attaching to a process by pid", GetShortPluginName()); 2017d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong return error; 2018d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong } 2019d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong 2020d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong //------------------------------------------------------------------ 202124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 202224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 202324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 202424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 202524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 202624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 202724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 202824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 202924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 203024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2031d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] attach_info 2032d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Information on how to do the attach. For example, GetUserID() 2033d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// will return the uid to attach as. 2034d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 203524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 203624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 203724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 203824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2040d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong DoAttachToProcessWithName (const char *process_name, bool wait_for_launch, const ProcessAttachInfo &attach_info) 204124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 204224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 204324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 204424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 204524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 204624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 204724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 204924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 205124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 205224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 205324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 205424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 205524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 20580bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// Called after a process re-execs itself. 20590bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// 20600bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// Allow Process plug-ins to execute some code after a process has 20610bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// exec'ed itself. Subclasses typically should override DoDidExec() 20620bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// as the lldb_private::Process class needs to remove its dynamic 20630bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// loader, runtime, ABI and other plug-ins, as well as unload all 20640bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// shared libraries. 20650bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton //------------------------------------------------------------------ 20660bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton virtual void 20670bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton DidExec (); 20680bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton 20690bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton //------------------------------------------------------------------ 20700bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// Subclasses of Process should implement this function if they 20710bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// need to do anything after a process exec's itself. 20720bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton //------------------------------------------------------------------ 20730bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton virtual void 20740bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton DoDidExec () 20750bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton { 20760bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton } 20770bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton 20780bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton //------------------------------------------------------------------ 207924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 208024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 208224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 208324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 208524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 208624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 208724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 208824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 208924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 209024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 209124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 209224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 209324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 209424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 209524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 209624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 209724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 209824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 209924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 210024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 210124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 210224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 210324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 210424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 210524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 210624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 210724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 210824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 210924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 211024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 211124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2112452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 2113452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 2114452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 211524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 211624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 211724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 211824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 211924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 212024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 212124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 212224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 212324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 212424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 212524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 212624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 212724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 212824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 212924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2130de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 2131de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 2132de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 213324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 213424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 213524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 213624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 213724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 213836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton DoLaunch (Module *exe_module, 213946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const ProcessLaunchInfo &launch_info) 214046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 214146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 214246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support launching processes", GetShortPluginName()); 214346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 214446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 214546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 214624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 214724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 214824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 214924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 215024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 215124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 215224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 215324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 215424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 215524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 215624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 215724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 215824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 215924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 216024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 216224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 216324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 216524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 216624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 216724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 216824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 216924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 217024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 217124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 217224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 217324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 217424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 217524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 217624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 217724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 217824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 217924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 218024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 218124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 218224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 218324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 218424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 218524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 218624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 218724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 218846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoResume () 218946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 219046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 219146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support resuming processes", GetShortPluginName()); 219246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 219346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 219446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 219524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 219624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 219724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 219824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 219924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 220024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 220124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 220224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 220324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 220424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 220524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 220624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 220724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 220824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 220924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 221024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 221124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 221224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 221324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 221424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 221524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 221624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 221724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 221824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 221924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 222024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2221360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt must produce one and only one stop StateChanged event if it actually 2222360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// stops the process. If the stop happens through some natural event (for 2223360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// instance a SIGSTOP), then forwarding that event will do. Otherwise, you must 2224360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// generate the event manually. Note also, the private event thread is stopped when 2225360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt is run to prevent the events generated while halting to trigger 2226360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// other state changes before the halt is complete. 22273ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 22283ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// @param[out] caused_stop 222920d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// If true, then this Halt caused the stop, otherwise, the 223020d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// process was already stopped. 22313ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 223224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 223324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 223424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 223524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 223624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 223746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoHalt (bool &caused_stop) 223846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 223946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 224046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support halting processes", GetShortPluginName()); 224146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 224246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 224346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 224424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 224524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 224624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 224724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 224924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 225024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 225124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 225224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 225324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 225424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 225524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 225624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 225724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 225824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 225924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 226024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 226124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 226224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 226324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 226424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 226524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 226624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 226724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 226824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 226924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 227024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 227124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 227224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 227324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 227424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 227524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 227624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 227746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoDetach () 227846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 227946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 228046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support detaching from processes", GetShortPluginName()); 228146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 228246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 228346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 228424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 228524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 228624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 228724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 228924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 229024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 229124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 229224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 229324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 229424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 229524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 229624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 229724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 229824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 229924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 230024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 230124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 230224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 230324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 230424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 230524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 230624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 230724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 230824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 230924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 231024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 231124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 231224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 231324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 231424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 231546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoSignal (int signal) 231646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 231746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 231846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support senging signals to processes", GetShortPluginName()); 231946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 232046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 232124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 232224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 232324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 232424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 232524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 232624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 232724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 232824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 232924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 233024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 233124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 233224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 233324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 233424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 233624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 233724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 233824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 233924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 234024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 234124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 234224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 234324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 234424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 234524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 234724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 234824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 234924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 235024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 235124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 235224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 235324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 235524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 235624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 235724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 235924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 236024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 236124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 236224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 236324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 236424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 2365395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () 2366395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2367395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2368395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 236924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 237024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 237124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 237224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 237324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 237424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 237524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 237624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 237724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 2378395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () const 2379395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2380395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2381395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 2382395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 2383cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton //------------------------------------------------------------------ 2384cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// Flush all data in the process. 2385cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// 2386cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// Flush the memory caches, all threads, and any other cached data 2387cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// in the process. 2388cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// 2389cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// This function can be called after a world changing event like 2390cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// adding a new symbol file, or after the process makes a large 2391cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// context switch (from boot ROM to booted into an OS). 2392cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton //------------------------------------------------------------------ 2393cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton void 2394cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton Flush (); 239524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 239624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 239724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 239824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 239924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 240024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 240124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 240324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 240424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 240524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 2406360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2407b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResults 2408360f53f3c216ee4fb433da0a367168785328a856Jim Ingham RunThreadPlan (ExecutionContext &exe_ctx, 2409360f53f3c216ee4fb433da0a367168785328a856Jim Ingham lldb::ThreadPlanSP &thread_plan_sp, 2410360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool stop_others, 241147beabb1386be44e3f90dbc30a0b22c23b93a4dcJim Ingham bool run_others, 2412360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool discard_on_error, 241347beabb1386be44e3f90dbc30a0b22c23b93a4dcJim Ingham uint32_t timeout_usec, 2414360f53f3c216ee4fb433da0a367168785328a856Jim Ingham Stream &errors); 2415360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2416360f53f3c216ee4fb433da0a367168785328a856Jim Ingham static const char * 2417b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResultAsCString (ExecutionResults result); 241824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2419abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton void 2420abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetStatus (Stream &ostrm); 2421abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 2422abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton size_t 2423abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetThreadStatus (Stream &ostrm, 2424abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton bool only_threads_with_stop_reason, 2425abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t start_frame, 2426abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames, 2427abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames_with_source); 2428abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 24295d90ade8e8e0d776fe8e1b9e88fc1c86d02e8e4eJim Ingham void 24305d90ade8e8e0d776fe8e1b9e88fc1c86d02e8e4eJim Ingham SendAsyncInterrupt (); 24315d90ade8e8e0d776fe8e1b9e88fc1c86d02e8e4eJim Ingham 243224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 243324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 243424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 243524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 243624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 243724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 243824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 243924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 244075c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 2441027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// The "private" side of resuming a process. This doesn't alter the 2442027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// state of m_run_lock, but just causes the process to resume. 2443027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// 2444027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// @return 2445027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// An Error object describing the success or failure of the resume. 2446027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham //------------------------------------------------------------------ 2447027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham Error 2448027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham PrivateResume (); 2449027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham 2450027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham //------------------------------------------------------------------ 245175c703dd8b492bad25a987b96853626641ae7246Greg Clayton // Called internally 245275c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 245375c703dd8b492bad25a987b96853626641ae7246Greg Clayton void 245475c703dd8b492bad25a987b96853626641ae7246Greg Clayton CompleteAttach (); 245575c703dd8b492bad25a987b96853626641ae7246Greg Clayton 245624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 245724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 245824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 245924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 246024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 246124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 246224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 246324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 246424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 246524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 246624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 246824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 246924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 247024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 247124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 247224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 247324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 247424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 247524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 247624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 247724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 247824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 247924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 248024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 248124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 248224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 248324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 248421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// Get the Modification ID of the process. 248524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 248624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 248721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// The modification ID of the process. 248824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 248921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID 249021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetModID () const 249121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 249221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id; 249321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 249421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 24950296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham const ProcessModID & 24960296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetModIDRef () const 24970296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 24980296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id; 24990296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 25000296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 250124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 250221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetStopID () const 250321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 250421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id.GetStopID(); 250521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 250621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 25070296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 25080296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetResumeID () const 25090296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 25100296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetResumeID(); 25110296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 25120296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 25130296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 25140296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetLastUserExpressionResumeID () const 25150296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 25160296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetLastUserExpressionResumeID(); 25170296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 25180296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 251924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 252024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 252124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 252224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 252324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 252424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 252524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 252624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 252724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 252824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 252924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 253024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 253124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 253224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 253324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 253424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 253572e1c782ba1e4226da37af4722af608de9f39408Greg Clayton virtual bool 253624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 253724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 253824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 253924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 254024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 254124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 254224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 254324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 254424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 254524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 254624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 254724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 254824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 254924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 255024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 255124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 255224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 255324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 255424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 255524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 255624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 255724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 255824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 255924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 256024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 256124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 256224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 256324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 256424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 256524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 256624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 256724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 256824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 256924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 257024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 257124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 257224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 257324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 257424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 257524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 257624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 257724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 257824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 257924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 258024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 258124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 258224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 258324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 258424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 258524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 258624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 258724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 258824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 258924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 259024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 259124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 259224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 259324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 259424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 259524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 259624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 259724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 259824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 259924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 260024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 260124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 260224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 260324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 260424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 26059ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton virtual size_t 260624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 260724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 260824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 260924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 261024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2611b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2612b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// Read a NULL terminated C string from memory 2613b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// 2614b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// This function will read a cache page at a time until the NULL 2615b0e3c7c4d063da2cc6a2550ad4979d5c342c8306Jason Molenda /// C string terminator is found. It will stop reading if the NULL 2616b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// termination byte isn't found before reading \a cstr_max_len 2617b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// bytes, and the results are always guaranteed to be NULL 2618b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// terminated (at most cstr_max_len - 1 bytes will be read). 2619b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2620b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 2621b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2622b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton char *cstr, 26234a2e33769873d68d5703da5742c0e248f46e3a72Greg Clayton size_t cstr_max_len, 26244a2e33769873d68d5703da5742c0e248f46e3a72Greg Clayton Error &error); 2625b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2626fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 2627dd29b97f71187509df339596c3397dea0e429754Greg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2628dd29b97f71187509df339596c3397dea0e429754Greg Clayton std::string &out_str, 2629dd29b97f71187509df339596c3397dea0e429754Greg Clayton Error &error); 2630dd29b97f71187509df339596c3397dea0e429754Greg Clayton 2631dd29b97f71187509df339596c3397dea0e429754Greg Clayton size_t 2632fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ReadMemoryFromInferior (lldb::addr_t vm_addr, 2633fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *buf, 2634fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t size, 2635fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 2636fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 26376d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 26386d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// Reads an unsigned integer of the specified byte size from 26396d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// process memory. 26406d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 26416d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] load_addr 26426d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// A load address of the integer to read. 26436d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 26446d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] byte_size 26456d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The size in byte of the integer to read. 26466d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 2647c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] fail_value 2648c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value to return if we fail to read an integer. 2649c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 26506d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[out] error 26516d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// An error that indicates the success or failure of this 26526d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// operation. If error indicates success (error.Success()), 26536d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// then the value returned can be trusted, otherwise zero 26546d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// will be returned. 26556d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 26566d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @return 26576d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The unsigned integer that was read from the process memory 26586d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// space. If the integer was smaller than a uint64_t, any 26596d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// unused upper bytes will be zero filled. If the process 26606d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// byte order differs from the host byte order, the integer 26616d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// value will be appropriately byte swapped into host byte 26626d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// order. 26636d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 2664f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton uint64_t 2665c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadUnsignedIntegerFromMemory (lldb::addr_t load_addr, 2666c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t byte_size, 2667c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint64_t fail_value, 2668c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2669c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2670c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t 2671c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadPointerFromMemory (lldb::addr_t vm_addr, 2672c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2673c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2674c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool 2675c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WritePointerToMemory (lldb::addr_t vm_addr, 2676c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t ptr_value, 2677c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2678c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 267924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 268024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 268124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 268224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 268324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 268424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 268524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 268624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 268724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 268824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 268924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 269024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 269124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 269224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2693c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2694c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2695c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 269624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 269724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 269824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 269924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 270046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) 270146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 270246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support writing to processes", GetShortPluginName()); 270346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return 0; 270446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 270546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 270624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 270724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2708c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// Write all or part of a scalar value to memory. 2709c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2710c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value contained in \a scalar will be swapped to match the 2711c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// byte order of the process that is being debugged. If \a size is 2712c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// less than the size of scalar, the least significate \a size bytes 2713c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// from scalar will be written. If \a size is larger than the byte 2714c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// size of scalar, then the extra space will be padded with zeros 2715c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// and the scalar value will be placed in the least significant 2716c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// bytes in memory. 2717c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2718c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] vm_addr 2719c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// A virtual load address that indicates where to start writing 2720c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// memory to. 2721c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2722c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] scalar 2723c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The scalar to write to the debugged process. 2724c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2725c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] size 2726c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// This value can be smaller or larger than the scalar value 2727c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// itself. If \a size is smaller than the size of \a scalar, 2728c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the least significant bytes in \a scalar will be used. If 2729c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// \a size is larger than the byte size of \a scalar, then 2730c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the extra space will be padded with zeros. If \a size is 2731c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// set to UINT32_MAX, then the size of \a scalar will be used. 2732c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2733c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2734c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2735c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2736c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @return 2737c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The number of bytes that were actually written. 2738c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 2739c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2740c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WriteScalarToMemory (lldb::addr_t vm_addr, 2741c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton const Scalar &scalar, 2742c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t size, 2743c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2744c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2745c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2746c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadScalarIntegerFromMemory (lldb::addr_t addr, 2747c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t byte_size, 2748c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool is_signed, 2749c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Scalar &scalar, 2750c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2751c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2752c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 275324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 275424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 275524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 275624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 275724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 275824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 275924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 276024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 276124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 276224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 276324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 276424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 276524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 276624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 276724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 276824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 276924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 277024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 277124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 277224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 277324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 277424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 277524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 277624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 277724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 277824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 277924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 278024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 278124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 278224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 278324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 278424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 278524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 278624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 278724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 278824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 278924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 279024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 279124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 279224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 279324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 279424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 279524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 279624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 279746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoAllocateMemory (size_t size, uint32_t permissions, Error &error) 279846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 279946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support allocating in the debug process", GetShortPluginName()); 280046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return LLDB_INVALID_ADDRESS; 280146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 280246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 280324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 280424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 280524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 280624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 280724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 280824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 280924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 281024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 281124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 281224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 281324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 281424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 281524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 281624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 281724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 281824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 281924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2820b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// @param[in/out] error 2821b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// An error object to fill in if things go wrong. 282224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 282324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 282424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 282524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 282624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 282824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 282924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2830a9385537809ef342c843c5ab972e513742652047Greg Clayton virtual Error 2831a9385537809ef342c843c5ab972e513742652047Greg Clayton GetMemoryRegionInfo (lldb::addr_t load_addr, 2832a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo &range_info) 2833a9385537809ef342c843c5ab972e513742652047Greg Clayton { 2834a9385537809ef342c843c5ab972e513742652047Greg Clayton Error error; 2835a9385537809ef342c843c5ab972e513742652047Greg Clayton error.SetErrorString ("Process::GetMemoryRegionInfo() not supported"); 2836a9385537809ef342c843c5ab972e513742652047Greg Clayton return error; 2837a9385537809ef342c843c5ab972e513742652047Greg Clayton } 28381f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 28397cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen virtual Error 28407cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen GetWatchpointSupportInfo (uint32_t &num) 28417cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen { 28427cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen Error error; 28437cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen error.SetErrorString ("Process::GetWatchpointSupportInfo() not supported"); 28447cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen return error; 28457cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen } 28467cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen 28477de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata virtual Error 28487de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata GetWatchpointSupportInfo (uint32_t &num, bool& after) 28497de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata { 28507de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata Error error; 28517de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata error.SetErrorString ("Process::GetWatchpointSupportInfo() not supported"); 28527de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata return error; 28537de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata } 28547de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata 2855b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton lldb::ModuleSP 2856b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton ReadModuleFromMemory (const FileSpec& file_spec, 28579ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton lldb::addr_t header_addr, 28589ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton bool add_image_to_target, 28599ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton bool load_sections_in_target); 2860b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton 28611f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda //------------------------------------------------------------------ 28621f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// Attempt to get the attributes for a region of memory in the process. 28631f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 28641f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// It may be possible for the remote debug server to inspect attributes 28651f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// for a region of memory in the process, such as whether there is a 28661f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// valid page of memory at a given address or whether that page is 28671f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// readable/writable/executable by the process. 28681f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 28691f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @param[in] load_addr 28701f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// The address of interest in the process. 28711f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 28721f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @param[out] permissions 28731f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// If this call returns successfully, this bitmask will have 28741f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// its Permissions bits set to indicate whether the region is 28751f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// readable/writable/executable. If this call fails, the 28761f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// bitmask values are undefined. 28771f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 28781f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @return 28791f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// Returns true if it was able to determine the attributes of the 28801f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// memory region. False if not. 28811f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda //------------------------------------------------------------------ 28821f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 28831f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda virtual bool 28841f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetLoadAddressPermissions (lldb::addr_t load_addr, uint32_t &permissions) 2885a9385537809ef342c843c5ab972e513742652047Greg Clayton { 2886a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo range_info; 28871f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions = 0; 2888a9385537809ef342c843c5ab972e513742652047Greg Clayton Error error (GetMemoryRegionInfo (load_addr, range_info)); 28891f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (!error.Success()) 28901f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return false; 28911f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetReadable() == MemoryRegionInfo::eDontKnow 28921f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda || range_info.GetWritable() == MemoryRegionInfo::eDontKnow 28931f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda || range_info.GetExecutable() == MemoryRegionInfo::eDontKnow) 28941f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda { 28951f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return false; 28961f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda } 28971f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 28981f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetReadable() == MemoryRegionInfo::eYes) 28991f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsReadable; 29001f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29011f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetWritable() == MemoryRegionInfo::eYes) 29021f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsWritable; 29031f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29041f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetExecutable() == MemoryRegionInfo::eYes) 29051f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsExecutable; 29061f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29071f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return true; 2908a9385537809ef342c843c5ab972e513742652047Greg Clayton } 29091f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 291024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 29116cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Determines whether executing JIT-compiled code in this process 29126cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 29136cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 29146cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @return 29156cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 29166cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 29176cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan bool CanJIT (); 29186cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 29196cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 29206cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Sets whether executing JIT-compiled code in this process 29216cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 29226cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 29236cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @param[in] can_jit 29246cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 29256cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 29266cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan void SetCanJIT (bool can_jit); 29276cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 29286cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 292924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 293024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 293124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 293224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 293324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 293424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 293524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 293624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 293724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 293824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 293924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 294024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 294124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 294224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 294346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoDeallocateMemory (lldb::addr_t ptr) 294446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 294546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 294646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support deallocating in the debug process", GetShortPluginName()); 294746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 294846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 294946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 295024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 295124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 295224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 295324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 295424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 295524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 295624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 295724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 295824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 295924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 296024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 296124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 296224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 296324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 296424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 296524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 296624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 2967fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong 296824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 296924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 297024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 297124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 297224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 297324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 297424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 297524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 297624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 297724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 297824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 297924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 298024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 298124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 298224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 298324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 298424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 298524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 298624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 298724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 298824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 298924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 2990bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDOUT (char *buf, size_t buf_size, Error &error); 299124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 299224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 299324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 299424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 299524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 299624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 299724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 299824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 299924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 300024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 300124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 300224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 300324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 300424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 300524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 300624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 300724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 300824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 300924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 301024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 301124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 301224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 301324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 3014bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDERR (char *buf, size_t buf_size, Error &error); 301524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 301624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 301724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 301824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 301924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 302024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 302124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 302224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3023fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong //------------------------------------------------------------------ 3024fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// Get any available profile data. 3025fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// 3026fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// @param[out] buf 3027fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// A buffer that will receive any profile data bytes that are 3028fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// currently available. 3029fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// 3030fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// @param[out] buf_size 3031fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// The size in bytes for the buffer \a buf. 3032fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// 3033fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// @return 3034fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// The number of bytes written into \a buf. If this value is 3035fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// equal to \a buf_size, another call to this function should 3036fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// be made to retrieve more profile data. 3037fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong //------------------------------------------------------------------ 3038fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong virtual size_t 3039fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong GetAsyncProfileData (char *buf, size_t buf_size, Error &error); 3040fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong 304124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 304224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 304324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 3044b1888f24fa181489840b9acf193e224d125d0776Greg Clayton size_t 3045b1888f24fa181489840b9acf193e224d125d0776Greg Clayton GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site); 304624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 304724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 304846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton EnableBreakpoint (BreakpointSite *bp_site) 304946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 305046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 305146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support enabling breakpoints", GetShortPluginName()); 305246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 305346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 305446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 305524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 305624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 305746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DisableBreakpoint (BreakpointSite *bp_site) 305846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 305946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 306046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support disabling breakpoints", GetShortPluginName()); 306146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 306246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 306346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 306424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 306524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 306624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 306724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 306824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 306924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 307024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 307124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 307224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 307324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 307424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 307524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 307624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 307724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 307824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 307924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 308024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 308124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 308224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 308324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 308424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 308524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 308624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 308724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 308824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 308924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 309024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 30913fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 309213d24fb1817faa7ccc4cfd799113ba1a2b8968ebGreg Clayton CreateBreakpointSite (const lldb::BreakpointLocationSP &owner, 309324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 309424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 309524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 309624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 309724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 309824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 309924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 310024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 310124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 310224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 310324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 310424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 310524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 310624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 310724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 310824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 310924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 311024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 311124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 311224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 311324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 311424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 311524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 3116ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen EnableWatchpoint (Watchpoint *wp); 311724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 311824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 3119ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen DisableWatchpoint (Watchpoint *wp); 312024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 312124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 312224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 312324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 3124ae932359b80098532f3c3766fa9e6527352fbb67Greg Clayton virtual bool 312537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list) = 0; 312637f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 312737f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton void 312837f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadListIfNeeded (); 312924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 313024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 3131395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () 3132395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3133395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 3134395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 313524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 313624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 313724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 313824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 313924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 314024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 314124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 314224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 314324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 314424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 314524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 314624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 3147bb1af9ce3e25eae9916f85cb9a0c82e291c20bb4Greg Clayton WaitForProcessToStop (const TimeValue *timeout, lldb::EventSP *event_sp_ptr = NULL); 314824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 314924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 315024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 315124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 315224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 315324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 315463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 315524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3156f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham class 3157f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker 3158f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3159f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham public: 3160f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker (Process &process, Listener *listener) : 31612827e26d7d85636dd0d934a7e15d9ef5b95fac67Filipe Cabecinhas m_process (process) 3162f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3163f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.HijackProcessEvents (listener); 3164f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 3165f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ~ProcessEventHijacker () 3166f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3167f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.RestoreProcessEvents(); 3168f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 3169f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 3170f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham private: 3171f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Process &m_process; 3172f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham }; 3173f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham friend class ProcessEventHijacker; 317424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 317563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// If you need to ensure that you and only you will hear about some public 317663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// event, then make a new listener, set to listen to process events, and 317763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// then call this with that listener. Then you will have to wait on that 317863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// listener explicitly for events (rather than using the GetNextEvent & WaitFor* 317963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// calls above. Be sure to call RestoreProcessEvents when you are done. 318063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 318163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @param[in] listener 318263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// This is the new listener to whom all process events will be delivered. 318363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 318463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @return 318563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Returns \b true if the new listener could be installed, 318663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// \b false otherwise. 318763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 318863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham bool 318963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham HijackProcessEvents (Listener *listener); 319063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 319163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 319263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Restores the process event broadcasting to its normal state. 319363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 319463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 319563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham void 319663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham RestoreProcessEvents (); 319763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 319863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghamprotected: 319963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 320024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 320124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 320224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 320324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 320424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 320524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 320624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 320724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 320824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 320924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 321024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 321124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 321224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 321324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 321424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 321524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 321663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghampublic: 321775906e4ec98af3717e415727a8d663a4e246bb4fGreg Clayton const lldb::ABISP & 321824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 321924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 322037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton OperatingSystem * 322137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton GetOperatingSystem () 322237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton { 322337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton return m_os_ap.get(); 322437f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton } 322537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 322637f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 3227642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual LanguageRuntime * 3228e31176627725f4236c9ca049edc027756709780bJim Ingham GetLanguageRuntime (lldb::LanguageType language, bool retry_if_null = true); 3229642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 3230642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual CPPLanguageRuntime * 3231e31176627725f4236c9ca049edc027756709780bJim Ingham GetCPPLanguageRuntime (bool retry_if_null = true); 3232642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 3233642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual ObjCLanguageRuntime * 3234e31176627725f4236c9ca049edc027756709780bJim Ingham GetObjCLanguageRuntime (bool retry_if_null = true); 3235e31176627725f4236c9ca049edc027756709780bJim Ingham 323624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 32376b1763b5ab8f182029807293d74a66e1e1c6bafdEnrico Granata IsPossibleDynamicValue (ValueObject& in_value); 32386b1763b5ab8f182029807293d74a66e1e1c6bafdEnrico Granata 32396b1763b5ab8f182029807293d74a66e1e1c6bafdEnrico Granata bool 324024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 3241f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 3242f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 3243f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 3244d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham return m_dynamic_checkers_ap.get(); 3245f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 3246f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 3247f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 3248f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 3249d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham m_dynamic_checkers_ap.reset(dynamic_checkers); 3250f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 325124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3252c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 3253c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to set the lldb in the mode where it breaks on new thread 3254c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// creations, and then auto-restarts. This is useful when you are trying 3255c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// to run only one thread, but either that thread or the kernel is creating 3256c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// new threads in the process. If you stop when the thread is created, you 3257c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// can immediately suspend it, and keep executing only the one thread you intend. 3258c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 3259c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 3260c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 3261c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 3262c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 326355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 326455e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StartNoticingNewThreads() 326555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 326655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 326755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 326855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 3269c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 3270c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to turn off the stop & notice new threads mode. 3271c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 3272c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 3273c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 3274c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 3275c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 327655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 327755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StopNoticingNewThreads() 327855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 327955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 328055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 328155e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 32820296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 32830296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on); 32840296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 328524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 328624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 328724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 3288289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::TargetSP 3289289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton CalculateTarget (); 3290289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3291289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::ProcessSP 3292395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateProcess () 3293395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3294289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return shared_from_this(); 3295395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 3296289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3297289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::ThreadSP 3298395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateThread () 3299395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3300289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return lldb::ThreadSP(); 3301395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 3302289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3303289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::StackFrameSP 3304395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateStackFrame () 3305395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3306289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return lldb::StackFrameSP(); 3307395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 330824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 330924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 3310a830adbcd63d1995a01e6e18da79893c1426ca43Greg Clayton CalculateExecutionContext (ExecutionContext &exe_ctx); 331124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3312464c6161464694412b7472129e789248f1cf21b9Greg Clayton void 3313464c6161464694412b7472129e789248f1cf21b9Greg Clayton SetSTDIOFileDescriptor (int file_descriptor); 3314464c6161464694412b7472129e789248f1cf21b9Greg Clayton 3315761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3316761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // Add a permanent region of memory that should never be read or 3317761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // written to. This can be used to ensure that memory reads or writes 3318761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // to certain areas of memory never end up being sent to the 3319761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // DoReadMemory or DoWriteMemory functions which can improve 3320761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // performance. 3321761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3322761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton void 3323761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton AddInvalidMemoryRegion (const LoadRange ®ion); 3324761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton 3325761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3326761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // Remove a permanent region of memory that should never be read or 3327761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // written to that was previously added with AddInvalidMemoryRegion. 3328761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3329761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton bool 3330761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton RemoveInvalidMemoryRange (const LoadRange ®ion); 33311831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 33321831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham //------------------------------------------------------------------ 33331831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // If the setup code of a thread plan needs to do work that might involve 33341831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // calling a function in the target, it should not do that work directly 33351831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // in one of the thread plan functions (DidPush/WillResume) because 33361831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // such work needs to be handled carefully. Instead, put that work in 33371831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // a PreResumeAction callback, and register it with the process. It will 33381831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // get done before the actual "DoResume" gets called. 33391831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham //------------------------------------------------------------------ 33401831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 33411831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham typedef bool (PreResumeActionCallback)(void *); 33421831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 33431831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham void 33441831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham AddPreResumeAction (PreResumeActionCallback callback, void *baton); 33451831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 33461831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham bool 33471831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham RunPreResumeActions (); 33481831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 33491831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham void 33501831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham ClearPreResumeActions (); 33511831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 3352a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ReadWriteLock & 3353a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton GetRunLock () 3354a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton { 3355a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton return m_run_lock; 3356a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton } 3357a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton 335824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 3359c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 336021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // NextEventAction provides a way to register an action on the next 336121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // event that is delivered to this process. There is currently only 336221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // one next event action allowed in the process at one time. If a 336321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // new "NextEventAction" is added while one is already present, the 336421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // old action will be discarded (with HandleBeingUnshipped called 336521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // after it is discarded.) 3366c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 3367c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class NextEventAction 3368c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3369c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 3370c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham typedef enum EventActionResult 3371c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3372c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionSuccess, 3373c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionRetry, 3374c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionExit 3375c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } EventActionResult; 3376c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3377c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction (Process *process) : 3378c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham m_process(process) 33792d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 33802d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 33812d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 33822d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 33832d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~NextEventAction() 33842d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 33852d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 3386c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3387c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp) = 0; 3388293b98f5e24ef736766db37feedfefd3b215a0ceFilipe Cabecinhas virtual void HandleBeingUnshipped () {} 3389c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted () = 0; 3390c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString() = 0; 3391c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham protected: 3392c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham Process *m_process; 3393c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 3394c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3395c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham void SetNextEventAction (Process::NextEventAction *next_event_action) 3396c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 339768bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham if (m_next_event_action_ap.get()) 339868bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap->HandleBeingUnshipped(); 339968bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham 340068bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap.reset(next_event_action); 3401c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } 3402c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3403c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // This is the completer for Attaching: 3404c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class AttachCompletionHandler : public NextEventAction 3405c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3406c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 34072d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton AttachCompletionHandler (Process *process, uint32_t exec_count) : 34082d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton NextEventAction (process), 34092d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton m_exec_count (exec_count) 34102d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 34112d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 34122d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 34132d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 34142d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~AttachCompletionHandler() 34152d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 34162d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 3417c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3418c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp); 3419c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted (); 3420c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString(); 3421c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham private: 34222d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton uint32_t m_exec_count; 3423c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham std::string m_exit_string; 3424c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 3425c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3426f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham bool 3427f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham HijackPrivateProcessEvents (Listener *listener); 3428f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 3429f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham void 3430f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham RestorePrivateProcessEvents (); 3431a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton 3432a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton bool 3433a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton PrivateStateThreadIsValid () const 3434a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton { 34351831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham return IS_VALID_LLDB_HOST_THREAD(m_private_state_thread); 3436a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton } 3437fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 343824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 3439a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // Type definitions 3440a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton //------------------------------------------------------------------ 3441a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef std::map<lldb::LanguageType, lldb::LanguageRuntimeSP> LanguageRuntimeCollection; 3442a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton 34435ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham struct PreResumeCallbackAndBaton 34445ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham { 34455ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham bool (*callback) (void *); 34465ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham void *baton; 34475ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham PreResumeCallbackAndBaton (PreResumeActionCallback in_callback, void *in_baton) : 34485ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham callback (in_callback), 34495ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham baton (in_baton) 34505ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham { 34515ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham } 34525ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham }; 34535ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham 3454a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton //------------------------------------------------------------------ 345524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 345624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 345724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 345824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 345924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 346024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 346124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 346224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 346324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 346424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 3465a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ProcessModID m_mod_id; ///< Tracks the state of the process over stops and other alterations. 346624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 346724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 346824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 346924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 347024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 34710baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton std::vector<lldb::addr_t> m_image_tokens; 347224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 3473a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend to insert in the target. 347475c703dd8b492bad25a987b96853626641ae7246Greg Clayton std::auto_ptr<DynamicLoader> m_dyld_ap; 3475a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers_ap; ///< The functions used by the expression parser to validate data that expressions use. 3476a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton std::auto_ptr<OperatingSystem> m_os_ap; 347724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 347824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 3479861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderSP m_process_input_reader; 3480559cf6e8b52b940f5f4362b32d628838d6301e2eJason Molenda Communication m_stdio_communication; 3481559cf6e8b52b940f5f4362b32d628838d6301e2eJason Molenda Mutex m_stdio_communication_mutex; 3482861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice std::string m_stdout_data; 3483bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton std::string m_stderr_data; 3484fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong Mutex m_profile_data_comm_mutex; 3485f14269add7f6fb84da7ccfd866f8e9f7e81068beHan Ming Ong std::vector<std::string> m_profile_data; 3486fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache m_memory_cache; 3487613b8739a4d489b7f1c571288d5786768c024205Greg Clayton AllocatedMemoryCache m_allocated_memory_cache; 3488ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton bool m_should_detach; /// Should we detach if the process object goes away with an explicit call to Kill or Detach? 3489559cf6e8b52b940f5f4362b32d628838d6301e2eJason Molenda LanguageRuntimeCollection m_language_runtimes; 34907e2f91cb958c8670774cb2190db7b858618b5b9bGreg Clayton std::auto_ptr<NextEventAction> m_next_event_action_ap; 34911831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham std::vector<PreResumeCallbackAndBaton> m_pre_resume_actions; 3492a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ReadWriteLock m_run_lock; 34934389256aecd2693109969c21fa2f00c4612320b3Jim Ingham Predicate<bool> m_currently_handling_event; 3494d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham bool m_finalize_called; 349524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 34966cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan enum { 34976cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITDontKnow= 0, 34986cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITYes, 34996cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITNo 35006cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan } m_can_jit; 35016cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 350224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 350324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 350424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 350524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 350624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 350724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 350824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 350924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 351024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 351124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 351224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 351324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 351424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 35151831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham StartPrivateStateThread (bool force = false); 351624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 351724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 351824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 351924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 352024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 352124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 352224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 352324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 352424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 352524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 352624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 352724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 352824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 352924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 353024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 353124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 353224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 353324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 353424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 353524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 353624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 353724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 353824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 353924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 354024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 354124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 354224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 354324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 354424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 354524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 354624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 354724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 354824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 354924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 355024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 355124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 355224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 355324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 3554861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3555861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3556861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice AppendSTDOUT (const char *s, size_t len); 3557861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3558bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton void 3559bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton AppendSTDERR (const char *s, size_t len); 3560bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton 3561fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong void 3562fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong BroadcastAsyncProfileData(const char *s, size_t len); 3563fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong 3564861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static void 3565861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len); 3566861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3567861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3568861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PushProcessInputReader (); 3569861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3570861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3571861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PopProcessInputReader (); 3572861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3573861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3574861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ResetProcessInputReader (); 3575861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3576861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static size_t 3577861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ProcessInputReaderCallback (void *baton, 3578861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice InputReader &reader, 3579861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderAction notification, 3580861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice const char *bytes, 3581861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice size_t bytes_len); 3582861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3583861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 358424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 358524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 358624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 358724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 358824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 35896e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 359024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 359124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 359224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 359324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 359424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 359524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 359624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 3597