Process.h revision efb4aeba2bd8411ac0aee9934f08959094d50711
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); 76b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham 77b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham bool 78b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham GetIgnoreBreakpointsInExpressions () const; 79b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham 80b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham void 81b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham SetIgnoreBreakpointsInExpressions (bool ignore); 82b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham 83b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham bool 84b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham GetUnwindOnErrorInExpressions () const; 85b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham 86b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham void 87b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham SetUnwindOnErrorInExpressions (bool ignore); 88090f83176695d86197b0e86b67dee4160ec5003dJim Ingham 89090f83176695d86197b0e86b67dee4160ec5003dJim Ingham bool 90090f83176695d86197b0e86b67dee4160ec5003dJim Ingham GetStopOnSharedLibraryEvents () const; 91090f83176695d86197b0e86b67dee4160ec5003dJim Ingham 92090f83176695d86197b0e86b67dee4160ec5003dJim Ingham void 93090f83176695d86197b0e86b67dee4160ec5003dJim Ingham SetStopOnSharedLibraryEvents (bool stop); 94c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton}; 95c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Clayton 96c6e82e4a323d7a7168b05365c53c9bc2e0d418e3Greg Claytontypedef STD_SHARED_PTR(ProcessProperties) ProcessPropertiesSP; 976e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 98b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 99b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInfo 100b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 101b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A base class for information for a process. This can be used to fill 102b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// out information for a process prior to launching it, or it can be 103b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// used for an instance of a process and can be filled in with the 104b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// existing values for that process. 105b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 106e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonclass ProcessInfo 107e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 108e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 109e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo () : 110ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable (), 111b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 112b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment (), 113444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 114444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 115e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch(), 116b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (LLDB_INVALID_PROCESS_ID) 117e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 118e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 119b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 120e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo (const char *name, 121e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec &arch, 122e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t pid) : 123b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_executable (name, false), 124b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 125b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment(), 126444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 127444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 128e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch (arch), 129b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (pid) 130e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 131e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 132e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 133e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 134e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear () 135e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 136ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.Clear(); 137b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments.Clear(); 138b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment.Clear(); 139444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid = UINT32_MAX; 140444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid = UINT32_MAX; 141e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch.Clear(); 142e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = LLDB_INVALID_PROCESS_ID; 143e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 144e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 145e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 146e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetName() const 147e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 148ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetCString(); 149e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 150b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 151e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 152e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetNameLength() const 153e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 154ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetLength(); 155e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 156e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 157ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton FileSpec & 158ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () 159ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 160ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 161e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 16236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 16336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 16436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetExecutableFile (const FileSpec &exe_file, bool add_exe_file_as_first_arg) 16536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file) 16736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable = exe_file; 16936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 17036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 17136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton char filename[PATH_MAX]; 17236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file.GetPath(filename, sizeof(filename))) 173c86723f0a71f5d929f4543c544d9255da52ea49dHan Ming Ong m_arguments.InsertArgumentAtIndex (0, filename); 17436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton else 17736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 17836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable.Clear(); 17936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 18036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 18136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 182ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton const FileSpec & 183ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () const 18424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 185ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 18624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 18724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 188a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 189b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetUserID() const 190a733c04608cc94592a15d27583529588e19db552Greg Clayton { 191b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid; 192a733c04608cc94592a15d27583529588e19db552Greg Clayton } 193b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 194a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 195b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetGroupID() const 196a733c04608cc94592a15d27583529588e19db552Greg Clayton { 197b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid; 198a733c04608cc94592a15d27583529588e19db552Greg Clayton } 19924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 20024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 201b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton UserIDIsValid () const 20224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 203b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid != UINT32_MAX; 20424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 20524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 20624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 207b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GroupIDIsValid () const 20824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 209b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid != UINT32_MAX; 21024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 21124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 212a733c04608cc94592a15d27583529588e19db552Greg Clayton void 213b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetUserID (uint32_t uid) 214a733c04608cc94592a15d27583529588e19db552Greg Clayton { 215b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid = uid; 216a733c04608cc94592a15d27583529588e19db552Greg Clayton } 217a733c04608cc94592a15d27583529588e19db552Greg Clayton 218a733c04608cc94592a15d27583529588e19db552Greg Clayton void 219b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetGroupID (uint32_t gid) 220a733c04608cc94592a15d27583529588e19db552Greg Clayton { 221b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid = gid; 222a733c04608cc94592a15d27583529588e19db552Greg Clayton } 223b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 224e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ArchSpec & 225e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () 226e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 227e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 228e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 229b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 230e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec & 231e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () const 232e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 233e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 234e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 235b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 236e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 237e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessID () const 238e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 239e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_pid; 240e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 241e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 242e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 243e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetProcessID (lldb::pid_t pid) 244e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 245e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = pid; 246e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 247e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 248a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 249a733c04608cc94592a15d27583529588e19db552Greg Clayton ProcessIDIsValid() const 250a733c04608cc94592a15d27583529588e19db552Greg Clayton { 251a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_pid != LLDB_INVALID_PROCESS_ID; 252a733c04608cc94592a15d27583529588e19db552Greg Clayton } 253b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 254b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 255b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Dump (Stream &s, Platform *platform) const; 256b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 257b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 258b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () 259b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 260b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 261b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 262b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 263b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 264b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () const 265b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 266b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 267b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 268b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2690c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton const char * 2700c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton GetArg0 () const 2710c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton { 2720c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton if (m_arg0.empty()) 2730c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton return NULL; 2740c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton return m_arg0.c_str(); 2750c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton } 2760c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton 2770c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton void 2780c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton SetArg0 (const char *arg) 2790c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton { 2800c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton if (arg && arg[0]) 2810c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton m_arg0.clear(); 2820c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton else 2830c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton m_arg0 = arg; 2840c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton } 2850c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton 286b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 2870c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton SetArguments (const Args& args, bool first_arg_is_executable); 288b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 28936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 2900c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton SetArguments (char const **argv, bool first_arg_is_executable); 29136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 292b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 293b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () 294b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 295b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 296b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 297b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 298b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 299b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () const 300b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 301b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 302b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 303b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 304b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 305b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileSpec m_executable; 3060c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton std::string m_arg0; // argv[0] if supported. If empty, then use m_executable. 3070c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton // Not all process plug-ins support specifying an argv[0] 3080c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton // that differs from the resolved platform executable 3090c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton // (which is in m_executable) 3100c8446cc220c429fb51f8f9864275c8b1c768533Greg Clayton Args m_arguments; // All program arguments except argv[0] 311b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_environment; 312b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_uid; 313b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_gid; 314b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ArchSpec m_arch; 315b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_pid; 316b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 317b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 318b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 319b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfo 320b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 321b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes an existing process and any discoverable information that 322b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// pertains to that process. 323b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 324b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfo : public ProcessInfo 325b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 326b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 327b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo () : 328b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (), 329b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 330b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 331b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 332b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 333b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 334b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 335b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo (const char *name, 336b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ArchSpec &arch, 337b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t pid) : 338b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (name, arch, pid), 339b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 340b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 341b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 342b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 343b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 344b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 345b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 346b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 347b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 348b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 349b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = UINT32_MAX; 350b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = UINT32_MAX; 351b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid = LLDB_INVALID_PROCESS_ID; 352b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 353b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 354b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 355b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveUserID() const 356b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 357b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid; 358b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 359b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 360b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 361b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveGroupID() const 362b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 363b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid; 364b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 365b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 366b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 367b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveUserIDIsValid () const 368b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 369b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid != UINT32_MAX; 370b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 371b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 372b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 373b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveGroupIDIsValid () const 374b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 375b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid != UINT32_MAX; 376b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 377b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 378b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 379b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveUserID (uint32_t uid) 380b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 381b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = uid; 382b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 383b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 384b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 385b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveGroupID (uint32_t gid) 386b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 387b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = gid; 388b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 389a733c04608cc94592a15d27583529588e19db552Greg Clayton 390a733c04608cc94592a15d27583529588e19db552Greg Clayton lldb::pid_t 391a733c04608cc94592a15d27583529588e19db552Greg Clayton GetParentProcessID () const 392a733c04608cc94592a15d27583529588e19db552Greg Clayton { 393a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid; 394a733c04608cc94592a15d27583529588e19db552Greg Clayton } 395a733c04608cc94592a15d27583529588e19db552Greg Clayton 396a733c04608cc94592a15d27583529588e19db552Greg Clayton void 397a733c04608cc94592a15d27583529588e19db552Greg Clayton SetParentProcessID (lldb::pid_t pid) 398a733c04608cc94592a15d27583529588e19db552Greg Clayton { 399a733c04608cc94592a15d27583529588e19db552Greg Clayton m_parent_pid = pid; 400a733c04608cc94592a15d27583529588e19db552Greg Clayton } 401a733c04608cc94592a15d27583529588e19db552Greg Clayton 402a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 403a733c04608cc94592a15d27583529588e19db552Greg Clayton ParentProcessIDIsValid() const 404a733c04608cc94592a15d27583529588e19db552Greg Clayton { 405a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid != LLDB_INVALID_PROCESS_ID; 406a733c04608cc94592a15d27583529588e19db552Greg Clayton } 40724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 40824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 40924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Dump (Stream &s, Platform *platform) const; 41024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 41124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton static void 412b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose); 413b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 414b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 415b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const; 416b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 417b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 418b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_euid; 419b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_egid; 420b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_parent_pid; 421b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 4221c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 423b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 424b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 425b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessLaunchInfo 426b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 427b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes any information that is required to launch a process. 428b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 429b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 430b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchInfo : public ProcessInfo 431b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 432b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 433b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 434b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton class FileAction 435b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 436b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton public: 43736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton enum Action 43836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 43936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionNone, 44036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionClose, 44136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionDuplicate, 44236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionOpen 44336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton }; 44436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 445b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 446b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction () : 447b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action (eFileActionNone), 448b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd (-1), 449b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg (-1), 450b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path () 451b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 452b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 453b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 454b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 455b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear() 456b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 457b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action = eFileActionNone; 458b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd = -1; 459b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg = -1; 460b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path.clear(); 461b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 462b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 463b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 464b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Close (int fd); 465b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 466b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 467b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Duplicate (int fd, int dup_fd); 468b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 469b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 470b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Open (int fd, const char *path, bool read, bool write); 471b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 472b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static bool 473b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AddPosixSpawnFileAction (posix_spawn_file_actions_t *file_actions, 474b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction *info, 475b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Log *log, 476b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error& error); 477b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 47836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 47936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFD () const 480b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 48136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_fd; 48236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 48336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 48436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Action 48536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetAction () const 48636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 48736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_action; 48836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 48936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 49036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 49136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetActionArgument () const 49236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 49336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_arg; 49436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 49536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 49636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char * 49736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetPath () const 49836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 49936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_path.empty()) 50036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 50136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_path.c_str(); 50236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 503b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 50436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton protected: 505b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Action m_action; // The action for this file 506b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_fd; // An existing file descriptor 507b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_arg; // oflag for eFileActionOpen*, dup_fd for eFileActionDuplicate 508b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_path; // A file path to use for opening after fork or posix_spawn 509b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton }; 510b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 511b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo () : 512b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo(), 513ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_working_dir (), 514ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_plugin_name (), 515ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_shell (), 516ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_flags (0), 517ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_file_actions (), 518464c6161464694412b7472129e789248f1cf21b9Greg Clayton m_pty (), 519ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_resume_count (0), 520ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback (NULL), 521ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback_baton (NULL), 522ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_signals (false) 523b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 524b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 525b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 52636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo (const char *stdin_path, 52736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stdout_path, 52836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stderr_path, 52936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *working_directory, 53036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton uint32_t launch_flags) : 53136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessInfo(), 5321c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_working_dir (), 5331c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_plugin_name (), 5341c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_shell (), 5351c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_flags (launch_flags), 5361c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_file_actions (), 537464c6161464694412b7472129e789248f1cf21b9Greg Clayton m_pty (), 5381c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_resume_count (0), 5391c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback (NULL), 5401c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton (NULL), 5411c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals (false) 54236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 54395ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (stdin_path) 54436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 54536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 54636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 54795ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool write = false; 54895ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (file_action.Open(STDIN_FILENO, stdin_path, read, write)) 54936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 55036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 55136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdout_path) 55236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 55336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 55436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = false; 55536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 55636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDOUT_FILENO, stdout_path, read, write)) 55736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 55836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 55995ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (stderr_path) 56036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 56136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 56295ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool read = false; 56395ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool write = true; 56495ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (file_action.Open(STDERR_FILENO, stderr_path, read, write)) 56536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 56636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 56736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (working_directory) 56836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetWorkingDirectory(working_directory); 56936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 570abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 571b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 572b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (const FileAction &info) 573b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 574b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.push_back(info); 575b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 576b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 577abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 578b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendCloseFileAction (int fd) 579b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 580b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 581abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Close (fd)) 582abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 583abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 584abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 585abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 586abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 587b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 588b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 589abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 5900a8dcacde404c520f1131c641041dceb9f68b6faGreg Clayton AppendDuplicateFileAction (int fd, int dup_fd) 591b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 592b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 593abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Duplicate (fd, dup_fd)) 594abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 595abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 596abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 597abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 598abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 599b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 600b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 601abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 602b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendOpenFileAction (int fd, const char *path, bool read, bool write) 603b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 604b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 605abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, path, read, write)) 606abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 607abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 608abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 609abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 610abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 611b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 612b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 613abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 614b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendSuppressFileAction (int fd, bool read, bool write) 615b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 616b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 617abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, "/dev/null", read, write)) 618abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 619abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 620abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 621abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 622abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 623b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 624abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 625abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton void 626464c6161464694412b7472129e789248f1cf21b9Greg Clayton FinalizeFileActions (Target *target, 627464c6161464694412b7472129e789248f1cf21b9Greg Clayton bool default_to_use_pty); 628b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 629b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 630b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetNumFileActions () const 631b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 632b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_file_actions.size(); 633b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 634b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 635b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction * 636b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFileActionAtIndex (size_t idx) const 637b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 638b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (idx < m_file_actions.size()) 639b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return &m_file_actions[idx]; 640b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 641b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 642b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 64336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const FileAction * 64436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFileActionForFD (int fd) const 64536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 64636da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton for (size_t idx=0, count=m_file_actions.size(); idx < count; ++idx) 64736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 64836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_file_actions[idx].GetFD () == fd) 64936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return &m_file_actions[idx]; 65036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 65136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 65236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 65336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 654b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags & 655b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () 656b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 657b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 658b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 659b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 660b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Flags & 661b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () const 662b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 663b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 664b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 665b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 666b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 667b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetWorkingDirectory () const 668b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 669b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_working_dir.empty()) 670b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 671b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_working_dir.c_str(); 672b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 67324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 67424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 675b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetWorkingDirectory (const char *working_dir) 676b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 677b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (working_dir && working_dir[0]) 678b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.assign (working_dir); 679b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 680b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 681b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 682ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 683b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 684b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SwapWorkingDirectory (std::string &working_dir) 685ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 686b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.swap (working_dir); 687b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 688b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 689b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 690b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 691b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetProcessPluginName () const 692b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 693b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_plugin_name.empty()) 694b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 695b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_plugin_name.c_str(); 696b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 697b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 698b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 699b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetProcessPluginName (const char *plugin) 700b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 701b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (plugin && plugin[0]) 702b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.assign (plugin); 703b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 704b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 705ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 706ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 707527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 708527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetShell () const 709527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 710527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_shell.empty()) 711527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 712527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_shell.c_str(); 713527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 714527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 715527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 716527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetShell (const char * path) 717527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 718527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (path && path[0]) 719527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 720527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.assign (path); 721527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Set (lldb::eLaunchFlagLaunchInShell); 722527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 723527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 724527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 725527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 726527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Clear (lldb::eLaunchFlagLaunchInShell); 727527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 728527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 729527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 730527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 731527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 732527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 733527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 734527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 735527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 736527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 737527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 738527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 739527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 740527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 741b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham 742b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham bool 743b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham GetLaunchInSeparateProcessGroup () 744b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham { 745b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham return m_flags.Test(lldb::eLaunchFlagLaunchInSeparateProcessGroup); 746b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham } 747b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham 748b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham void 749b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham SetLaunchInSeparateProcessGroup (bool separate) 750b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham { 751b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham if (separate) 752b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham m_flags.Set(lldb::eLaunchFlagLaunchInSeparateProcessGroup); 753b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham else 754b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham m_flags.Clear (lldb::eLaunchFlagLaunchInSeparateProcessGroup); 755b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham 756b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham } 757527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 758b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 759b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 760ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 761b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 762b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 763b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 764527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 765b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_flags.Clear(); 766b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.clear(); 767527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 768ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 769a733c04608cc94592a15d27583529588e19db552Greg Clayton 770527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 77197471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton ConvertArgumentsForLaunchingInShell (Error &error, 77297471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool localhost, 77397471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool will_debug, 77497471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool first_arg_is_full_shell_command); 775527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 7761c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void 7771c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton SetMonitorProcessCallback (Host::MonitorChildProcessCallback callback, 7781c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *baton, 7791c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool monitor_signals) 7801c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7811c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback = callback; 7821c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton = baton; 7831c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals = monitor_signals; 7841c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7851c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 7861c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool 7871c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton MonitorProcess () const 7881c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7891c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton if (m_monitor_callback && ProcessIDIsValid()) 7901c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7911c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::StartMonitoringChildProcess (m_monitor_callback, 7921c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton, 7931c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton GetProcessID(), 7941c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals); 7951c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return true; 7961c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7971c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return false; 7981c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7991c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 800464c6161464694412b7472129e789248f1cf21b9Greg Clayton lldb_utility::PseudoTerminal & 801464c6161464694412b7472129e789248f1cf21b9Greg Clayton GetPTY () 802464c6161464694412b7472129e789248f1cf21b9Greg Clayton { 803464c6161464694412b7472129e789248f1cf21b9Greg Clayton return m_pty; 804464c6161464694412b7472129e789248f1cf21b9Greg Clayton } 8051c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 806e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 807b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_working_dir; 808b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_plugin_name; 809527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_shell; 810b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags m_flags; // Bitwise OR of bits from lldb::LaunchFlags 811b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::vector<FileAction> m_file_actions; // File actions for any other files 812464c6161464694412b7472129e789248f1cf21b9Greg Clayton lldb_utility::PseudoTerminal m_pty; 813527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 8141c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::MonitorChildProcessCallback m_monitor_callback; 8151c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *m_monitor_callback_baton; 8161c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool m_monitor_signals; 817b7b2532bf23c852ea3e43d10f2377338be5b464fJim Ingham 818527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton}; 819527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 820527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 821527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// ProcessLaunchInfo 822527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// 823527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// Describes any information that is required to launch a process. 824527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 825527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 826527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonclass ProcessAttachInfo : public ProcessInstanceInfo 827527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton{ 828527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonpublic: 829527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo() : 830527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 831527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 832527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 8337c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_wait_for_launch (false), 8343a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_ignore_existing (true), 8357c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_continue_once_attached (false) 836527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 837527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 838527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 839527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo (const ProcessLaunchInfo &launch_info) : 840527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 841527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 842527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 8437c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_wait_for_launch (false), 8443a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_ignore_existing (true), 8457c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_continue_once_attached (false) 846527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 847527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfo::operator= (launch_info); 848527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (launch_info.GetProcessPluginName()); 849527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (launch_info.GetResumeCount()); 850527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 851527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 852527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 853527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetWaitForLaunch () const 854527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 855527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_wait_for_launch; 856527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 857527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 858527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 859527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetWaitForLaunch (bool b) 860527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 861527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = b; 862527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 863527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 8647c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen bool 8653a458eb1e413d39546b664813bba9f9ac292357eJim Ingham GetIgnoreExisting () const 8663a458eb1e413d39546b664813bba9f9ac292357eJim Ingham { 8673a458eb1e413d39546b664813bba9f9ac292357eJim Ingham return m_ignore_existing; 8683a458eb1e413d39546b664813bba9f9ac292357eJim Ingham } 8693a458eb1e413d39546b664813bba9f9ac292357eJim Ingham 8703a458eb1e413d39546b664813bba9f9ac292357eJim Ingham void 8713a458eb1e413d39546b664813bba9f9ac292357eJim Ingham SetIgnoreExisting (bool b) 8723a458eb1e413d39546b664813bba9f9ac292357eJim Ingham { 8733a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_ignore_existing = b; 8743a458eb1e413d39546b664813bba9f9ac292357eJim Ingham } 8753a458eb1e413d39546b664813bba9f9ac292357eJim Ingham 8763a458eb1e413d39546b664813bba9f9ac292357eJim Ingham bool 8777c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen GetContinueOnceAttached () const 8787c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen { 8797c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen return m_continue_once_attached; 8807c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen } 8817c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen 8827c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen void 8837c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen SetContinueOnceAttached (bool b) 8847c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen { 8857c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen m_continue_once_attached = b; 8867c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen } 8877c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen 888527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 889527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 890527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 891527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 892527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 893527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 894527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 895527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 896527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 897527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 898527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 899527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 900527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 901527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetProcessPluginName () const 902527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 903527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_plugin_name.empty()) 904527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 905527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_plugin_name.c_str(); 906527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 907527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 908527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 909527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (const char *plugin) 910527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 911527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (plugin && plugin[0]) 912527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.assign (plugin); 913527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 914527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 915527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 916527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 917527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 918527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Clear () 919527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 920527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo::Clear(); 921527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 922527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 923527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = false; 9243a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_ignore_existing = true; 9253a458eb1e413d39546b664813bba9f9ac292357eJim Ingham m_continue_once_attached = false; 926527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 927527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 928527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 929527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfoSpecified () const 930527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 931527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetExecutableFile()) 932527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 933527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetProcessID() != LLDB_INVALID_PROCESS_ID) 934527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 935527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetParentProcessID() != LLDB_INVALID_PROCESS_ID) 936527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 937527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return false; 938527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 939527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonprotected: 940527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_plugin_name; 941527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 942527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool m_wait_for_launch; 9433a458eb1e413d39546b664813bba9f9ac292357eJim Ingham bool m_ignore_existing; 9447c09997f9a65bdfd9a0cbd7783d5a5f0a9f83646Johnny Chen bool m_continue_once_attached; // Supports the use-case scenario of immediately continuing the process once attached. 945e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 946e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 947b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchCommandOptions : public Options 94824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton{ 94924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonpublic: 950b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 951b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchCommandOptions (CommandInterpreter &interpreter) : 952b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Options(interpreter) 953b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 954143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton // Keep default values of all options in one place: OptionParsingStarting () 955143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting (); 956b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 957b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 958b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ~ProcessLaunchCommandOptions () 959b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 960b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 961b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 962b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error 963143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton SetOptionValue (uint32_t option_idx, const char *option_arg); 964b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 965b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 966143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting () 967b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 968b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton launch_info.Clear(); 969b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 970b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 971b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const OptionDefinition* 972b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetDefinitions () 973b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 974b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return g_option_table; 975b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 976b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 977b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Options table: Required for subclasses of Options. 978b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 979b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static OptionDefinition g_option_table[]; 980b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 981b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Instance variables to hold the values for command options. 982b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 983b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo launch_info; 984b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 985b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 986b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 987b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfoMatch 988b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 989b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A class to help matching one ProcessInstanceInfo to another. 990b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 991b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 992b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoMatch 993b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 994b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 995b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch () : 99624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 997a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton m_name_match_type (eNameMatchIgnore), 99824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 99924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 100024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 100124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1002b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch (const char *process_name, 1003a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType process_name_match_type) : 100424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 100524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (process_name_match_type), 100624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 100724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 1008527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_match_info.GetExecutableFile().SetFile(process_name, false); 100924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 101024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1011b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo & 101224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () 101324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 101424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 101524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 101624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1017b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 101824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () const 101924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 102024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 102124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 102224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 102324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 102424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetMatchAllUsers () const 102524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 102624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_all_users; 102724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 102824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 102924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 103024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetMatchAllUsers (bool b) 103124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 103224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users = b; 103324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 103424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1035a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType 103624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetNameMatchType () const 103724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 103824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_name_match_type; 103924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 104024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 104124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 1042a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton SetNameMatchType (NameMatchType name_match_type) 104324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 104424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type = name_match_type; 104524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 104624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 104724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 104824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton NameMatches (const char *process_name) const; 104924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 105024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 1051b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Matches (const ProcessInstanceInfo &proc_info) const; 105224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 105324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 105424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton MatchAllProcesses () const; 105524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 105624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Clear (); 105724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 105824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonprotected: 1059b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo m_match_info; 1060a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType m_name_match_type; 106124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool m_match_all_users; 106224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton}; 106324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1064b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoList 1065e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 1066e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 1067b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoList () : 1068e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos() 1069e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1070e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1071e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1072e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1073e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear() 1074e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1075e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.clear(); 1076e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1077e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 107836da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton size_t 1079e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetSize() 1080e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1081e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos.size(); 1082e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1083e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1084e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1085b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Append (const ProcessInstanceInfo &info) 1086e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1087e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.push_back (info); 1088e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1089e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1090e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 109136da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton GetProcessNameAtIndex (size_t idx) 1092e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1093e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1094e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetName(); 1095e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return NULL; 1096e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1097e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1098e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 109936da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton GetProcessNameLengthAtIndex (size_t idx) 1100e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1101e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1102e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetNameLength(); 1103e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return 0; 1104e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1105e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1106e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 110736da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton GetProcessIDAtIndex (size_t idx) 1108e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1109e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1110e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetProcessID(); 11112bc9eb3ba78efc64a273729b480bafc3bbaa433aJohnny Chen return 0; 1112e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1113e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1114e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton bool 111536da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton GetInfoAtIndex (size_t idx, ProcessInstanceInfo &info) 1116e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1117e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1118e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1119e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton info = m_infos[idx]; 1120e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return true; 1121e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1122e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return false; 1123e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1124e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 112524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton // You must ensure "idx" is valid before calling this function 1126b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 112736da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton GetProcessInfoAtIndex (size_t idx) const 112824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 112924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton assert (idx < m_infos.size()); 113024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_infos[idx]; 113124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 113224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1133e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 1134b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton typedef std::vector<ProcessInstanceInfo> collection; 1135e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton collection m_infos; 1136e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 1137e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 11386e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 113921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// This class tracks the Modification state of the process. Things that can currently modify 114021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// the program are running the program (which will up the StopID) and writing memory (which 114121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// will up the MemoryID.) 114221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// FIXME: Should we also include modification of register states? 114321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 114421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamclass ProcessModID 114521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 114621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend bool operator== (const ProcessModID &lhs, const ProcessModID &rhs); 114721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghampublic: 114821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID () : 11490296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id (0), 11500e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham m_last_natural_stop_id(0), 11510296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id (0), 11520296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_memory_id (0), 11530296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume (0), 11540296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression (false) 115521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 115621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 115721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID (const ProcessModID &rhs) : 115821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id (rhs.m_stop_id), 115921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id (rhs.m_memory_id) 116021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 116121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 116221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham const ProcessModID & operator= (const ProcessModID &rhs) 116321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 116421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (this != &rhs) 116521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 116621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = rhs.m_stop_id; 116721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id = rhs.m_memory_id; 116821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 116921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return *this; 117021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 117121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 117221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ~ProcessModID () {} 117321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 11740296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpStopID () { 11750e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham m_stop_id++; 11760e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham if (!IsLastResumeForUserExpression()) 11770e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham m_last_natural_stop_id++; 11780296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11790296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 118021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void BumpMemoryID () { m_memory_id++; } 118121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 11820296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpResumeID () { 11830296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id++; 11840296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (m_running_user_expression > 0) 11850296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume = m_resume_id; 11860296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11870296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 118821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetStopID() const { return m_stop_id; } 11890e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham uint32_t GetLastNaturalStopID() const { return m_last_natural_stop_id; } 119021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetMemoryID () const { return m_memory_id; } 11910296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetResumeID () const { return m_resume_id; } 11920296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetLastUserExpressionResumeID () const { return m_last_user_expression_resume; } 119321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 119421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool MemoryIDEqual (const ProcessModID &compare) const 119521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 119621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_memory_id == compare.m_memory_id; 119721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 119821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 119921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool StopIDEqual (const ProcessModID &compare) const 120021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 120121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id == compare.m_stop_id; 120221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 120321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 120421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void SetInvalid () 120521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 120621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = UINT32_MAX; 120721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 120821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 120921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool IsValid () const 121021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 121121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id != UINT32_MAX; 121221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 12130296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 12145a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata bool 12155a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata IsLastResumeForUserExpression () const 12165a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata { 12175a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata return m_resume_id == m_last_user_expression_resume; 12185a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata } 12195a60f5e8c81e8263e0d8af85a4f1e6cd1594970aEnrico Granata 12200296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 12210296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on) 12220296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 12230296fe73a7cb1482226b1303a795ede00e12d677Jim 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); 12240296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (on) 12250296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression++; 12260296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham else 12270296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression--; 12280296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 12290296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 123021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamprivate: 123121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_stop_id; 12320e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham uint32_t m_last_natural_stop_id; 12330296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_resume_id; 123421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_memory_id; 12350296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_last_user_expression_resume; 12360296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_running_user_expression; 123721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham}; 123821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator== (const ProcessModID &lhs, const ProcessModID &rhs) 123921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 124021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (lhs.StopIDEqual (rhs) 124121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham && lhs.MemoryIDEqual (rhs)) 124221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 124321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 124421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 124521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 124621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 124721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator!= (const ProcessModID &lhs, const ProcessModID &rhs) 124821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 124921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (!lhs.StopIDEqual (rhs) 125021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham || !lhs.MemoryIDEqual (rhs)) 125121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 125221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 125321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 125421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 1255a9385537809ef342c843c5ab972e513742652047Greg Clayton 1256a9385537809ef342c843c5ab972e513742652047Greg Claytonclass MemoryRegionInfo 1257a9385537809ef342c843c5ab972e513742652047Greg Clayton{ 1258a9385537809ef342c843c5ab972e513742652047Greg Claytonpublic: 1259a9385537809ef342c843c5ab972e513742652047Greg Clayton typedef Range<lldb::addr_t, lldb::addr_t> RangeType; 12601f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12611f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda enum OptionalBool { 12621f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eDontKnow = -1, 12631f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eNo = 0, 12641f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eYes = 1 12651f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda }; 12661f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 1267a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo () : 1268a9385537809ef342c843c5ab972e513742652047Greg Clayton m_range (), 12691f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read (eDontKnow), 12701f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_write (eDontKnow), 12711f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_execute (eDontKnow) 1272a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1273a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1274a9385537809ef342c843c5ab972e513742652047Greg Clayton 1275a9385537809ef342c843c5ab972e513742652047Greg Clayton ~MemoryRegionInfo () 1276a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1277a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1278a9385537809ef342c843c5ab972e513742652047Greg Clayton 1279a9385537809ef342c843c5ab972e513742652047Greg Clayton RangeType & 1280a9385537809ef342c843c5ab972e513742652047Greg Clayton GetRange() 1281a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1282a9385537809ef342c843c5ab972e513742652047Greg Clayton return m_range; 1283a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1284a9385537809ef342c843c5ab972e513742652047Greg Clayton 1285a9385537809ef342c843c5ab972e513742652047Greg Clayton void 1286a9385537809ef342c843c5ab972e513742652047Greg Clayton Clear() 1287a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1288a9385537809ef342c843c5ab972e513742652047Greg Clayton m_range.Clear(); 12891f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read = m_write = m_execute = eDontKnow; 1290a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1291a9385537809ef342c843c5ab972e513742652047Greg Clayton 1292a9385537809ef342c843c5ab972e513742652047Greg Clayton const RangeType & 1293a9385537809ef342c843c5ab972e513742652047Greg Clayton GetRange() const 1294a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1295a9385537809ef342c843c5ab972e513742652047Greg Clayton return m_range; 1296a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12971f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12981f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12991f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetReadable () const 1300a9385537809ef342c843c5ab972e513742652047Greg Clayton { 13011f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_read; 1302a9385537809ef342c843c5ab972e513742652047Greg Clayton } 13031f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 13041f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 13051f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetWritable () const 1306a9385537809ef342c843c5ab972e513742652047Greg Clayton { 13071f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_write; 13081f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda } 13091f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 13101f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 13111f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetExecutable () const 13121f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda { 13131f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_execute; 1314a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1315a9385537809ef342c843c5ab972e513742652047Greg Clayton 1316a9385537809ef342c843c5ab972e513742652047Greg Clayton void 13171f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetReadable (OptionalBool val) 1318a9385537809ef342c843c5ab972e513742652047Greg Clayton { 13191f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read = val; 1320a9385537809ef342c843c5ab972e513742652047Greg Clayton } 13211f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 1322a9385537809ef342c843c5ab972e513742652047Greg Clayton void 13231f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetWritable (OptionalBool val) 1324a9385537809ef342c843c5ab972e513742652047Greg Clayton { 13251f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_write = val; 1326a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1327a9385537809ef342c843c5ab972e513742652047Greg Clayton 1328a9385537809ef342c843c5ab972e513742652047Greg Clayton void 13291f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetExecutable (OptionalBool val) 1330a9385537809ef342c843c5ab972e513742652047Greg Clayton { 13311f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_execute = val; 1332a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1333a9385537809ef342c843c5ab972e513742652047Greg Clayton 1334a9385537809ef342c843c5ab972e513742652047Greg Claytonprotected: 1335a9385537809ef342c843c5ab972e513742652047Greg Clayton RangeType m_range; 13361f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_read; 13371f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_write; 13381f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_execute; 1339a9385537809ef342c843c5ab972e513742652047Greg Clayton}; 134021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 134124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 134324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 134424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 134524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 1346598df88bd6fc33c6fb330bc859bdc277795501f3Greg Clayton public STD_ENABLE_SHARED_FROM_THIS(Process), 134773844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton public ProcessProperties, 134824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 134924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 135024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 135173844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton public PluginInterface 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 1354d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Inghamfriend class ClangFunction; // For WaitForStateChangeEventsPrivate 135521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectProcessLaunch; 135621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class ProcessEventData; 135721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectBreakpointCommand; 135821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class StopInfo; 135924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 136124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 136324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 136424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 136524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 136624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 136724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 136824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 136924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 1370fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong eBroadcastBitSTDERR = (1 << 3), 1371fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong eBroadcastBitProfileData = (1 << 4) 137224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 137324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 137424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 137524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 137624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 137724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 137824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 137924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 13805a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 1381761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton typedef Range<lldb::addr_t, lldb::addr_t> LoadRange; 1382a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // We use a read/write lock to allow on or more clients to 1383a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // access the process state while the process is stopped (reader). 1384a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // We lock the write lock to control access to the process 1385a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // while it is running (readers, or clients that want the process 1386a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // stopped can block waiting for the process to stop, or just 1387a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // try to lock it to see if they can immediately access the stopped 1388a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // process. If the try read lock fails, then the process is running. 1389a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef ReadWriteLock::ReadLocker StopLocker; 1390a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef ReadWriteLock::WriteLocker RunLocker; 1391761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton 13925a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham // These two functions fill out the Broadcaster interface: 13935a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 13945a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham static ConstString &GetStaticBroadcasterClass (); 13955a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 13965a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham virtual ConstString &GetBroadcasterClass() const 13975a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham { 13985a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham return GetStaticBroadcasterClass(); 13995a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham } 14005a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 140164742744396c966e8de770e765130629b0c78335Greg Clayton 140224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 140324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 140424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 140524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 140624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 140724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 140824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 140924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 141024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 141124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 141224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 141324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 141424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 141524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 141624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 141724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 141824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 141924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 14203ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham friend class Process; 14213ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 142224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 142324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 142424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 142524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 142624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 142724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 142824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 142924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 143024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 143124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 143224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 143324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 143424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 14353ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetProcessSP() const 14363ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14373ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_process_sp; 14383ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 143924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 14403ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetState() const 14413ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14423ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_state; 14433ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 144424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 14453ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetRestarted () const 14463ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14473ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_restarted; 14483ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 144989e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham 145089e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham size_t 145189e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham GetNumRestartedReasons () 145289e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham { 145389e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham return m_restarted_reasons.size(); 145489e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham } 145589e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham 145689e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham const char * 145789e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham GetRestartedReasonAtIndex(size_t idx) 145889e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham { 145989e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham if (idx > m_restarted_reasons.size()) 146089e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham return NULL; 146189e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham else 146289e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham return m_restarted_reasons[idx].c_str(); 146389e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham } 146489e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham 14653ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool 14663ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterrupted () const 14673ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14683ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_interrupted; 14693ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 147024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 147124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 147224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 147324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 147424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 147524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 147624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 147724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 148124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 148224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 148524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 148724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 148889e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham 148989e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham static size_t 149089e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham GetNumRestartedReasons(const Event *event_ptr); 149189e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham 149289e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham static const char * 149389e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham GetRestartedReasonAtIndex(const Event *event_ptr, size_t idx); 149489e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham 149589e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham static void 149689e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham AddRestartedReason (Event *event_ptr, const char *reason); 149724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 149924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 150024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 150124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 15023ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterruptedFromEvent (const Event *event_ptr); 15033ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 15043ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static void 15053ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterruptedInEvent (Event *event_ptr, bool new_value); 15063ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 15073ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static bool 150824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 150924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 151124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 15133ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetUpdateStateOnRemoval() 15143ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 15156cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham m_update_state++; 15163ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 151724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 15183ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetRestarted (bool new_value) 15193ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 15203ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_restarted = new_value; 15213ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 15223ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham void 15233ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterrupted (bool new_value) 15243ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 15253ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_interrupted = new_value; 15263ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 152789e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham void 152889e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham AddRestartedReason (const char *reason) 152989e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham { 153089e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham m_restarted_reasons.push_back(reason); 153189e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham } 153224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 153424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 153589e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham std::vector<std::string> m_restarted_reasons; 153624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 15376cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham int m_update_state; 15383ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool m_interrupted; 153924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 154024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 154124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 15426e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1545990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 15462a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsInitialize (); 1547990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1548990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 15492a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsTerminate (); 155073844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton 155173844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton static const ProcessPropertiesSP & 155273844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton GetGlobalProperties(); 1553990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 155424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 155524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 155624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 155724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 155824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 155924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 156124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 156224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 156324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 156424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 156624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 156724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 156824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 157024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 157124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 157324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 157424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 157524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 157724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 157824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 158024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 158124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 158224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 158324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 158424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 158646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton static lldb::ProcessSP 158746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton FindPlugin (Target &target, 158846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const char *plugin_name, 158946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Listener &listener, 159046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const FileSpec *crash_file_path); 159124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 159224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 159324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 159424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 159524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 159624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 159724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 159824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 159924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 160024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 160124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 160224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 160324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 160524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 160624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 160724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 160824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 160924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 161024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 16111c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool exited, 161224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 161324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 161424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1615395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton lldb::ByteOrder 1616395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetByteOrder () const; 1617395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 1618395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton uint32_t 1619395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetAddressByteSize () const; 1620395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 162164742744396c966e8de770e765130629b0c78335Greg Clayton uint32_t 162264742744396c966e8de770e765130629b0c78335Greg Clayton GetUniqueID() const 162364742744396c966e8de770e765130629b0c78335Greg Clayton { 162464742744396c966e8de770e765130629b0c78335Greg Clayton return m_process_unique_id; 162564742744396c966e8de770e765130629b0c78335Greg Clayton } 162624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 162724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 162824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1629fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 163024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 163124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 163224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 163324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 163424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 163524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 163624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 163724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 16388d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton CanDebug (Target &target, 16398d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton bool plugin_specified_by_name) = 0; 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 164224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 164324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 164424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 164624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 164724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 164824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 164924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 1650d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham 1651d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham 1652d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham //------------------------------------------------------------------ 1653d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// Return whether this object is valid (i.e. has not been finalized.) 1654d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// 1655d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// @return 1656d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// Returns \b true if this Process has not been finalized 1657d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham /// and \b false otherwise. 1658d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham //------------------------------------------------------------------ 1659d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham bool 1660d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham IsValid() const 1661d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham { 1662d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham return !m_finalize_called; 1663d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham } 166424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 166524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 166613193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// Return a multi-word command object that can be used to expose 166713193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// plug-in specific commands. 166813193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// 166913193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// This object will be used to resolve plug-in commands and can be 167013193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// triggered by a call to: 167113193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// 167213193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// (lldb) process commmand <args> 167313193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// 167413193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// @return 167513193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// A CommandObject which can be one of the concrete subclasses 167613193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// of CommandObject like CommandObjectRaw, CommandObjectParsed, 167713193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton /// or CommandObjectMultiword. 167813193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton //------------------------------------------------------------------ 167913193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton virtual CommandObject * 168013193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton GetPluginCommandObject() 168113193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton { 168213193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton return NULL; 168313193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton } 168413193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton 168513193d5ae15f194102c14a5ccdc46e8db5c3d95fGreg Clayton //------------------------------------------------------------------ 168624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 168724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 168824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 168924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 169024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 169124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 169224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 169324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 169424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 169524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 169624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 169724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 169824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 169924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 170024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 170124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 170224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 170324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 170424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 170524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 170624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 170724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 170824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1709452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1710452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1711452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 171224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 171324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 171424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 171524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 171624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 171824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 171924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 172024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 172124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 172324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 172424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 172524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 172624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1727de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1728de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1729de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 173024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 173124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 173224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 173324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 173424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 173536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Launch (const ProcessLaunchInfo &launch_info); 173624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 173746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton virtual Error 173846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton LoadCore (); 173946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 174046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton virtual Error 174146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoLoadCore () 174246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 174346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 174446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support loading core files.", GetShortPluginName()); 174546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 174646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 17479ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton 17489ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton //------------------------------------------------------------------ 17499ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// Get the dynamic loader plug-in for this process. 17509ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// 17519ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// The default action is to let the DynamicLoader plug-ins check 17529ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// the main executable and the DynamicLoader will select itself 17539ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// automatically. Subclasses can override this if inspecting the 17549ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// executable is not desired, or if Process subclasses can only 17559ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// use a specific DynamicLoader plug-in. 17569ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton //------------------------------------------------------------------ 17579ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton virtual DynamicLoader * 17589ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton GetDynamicLoader (); 175946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 176024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 1761527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// Attach to an existing process using the process attach info. 176224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 176324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 1764527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// subclasses. It will first call WillAttach (lldb::pid_t) 1765527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// or WillAttach (const char *), and if that returns \b 1766527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// true, DoAttach (lldb::pid_t) or DoAttach (const char *) will 176724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 176824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 176924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 177024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 177124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 177224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 177324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 177424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 177524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 177624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 177724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 1778527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Attach (ProcessAttachInfo &attach_info); 177924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1780fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda //------------------------------------------------------------------ 1781fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// Attach to a remote system via a URL 1782fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1783fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @param[in] strm 1784fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// A stream where output intended for the user 1785fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// (if the driver has a way to display that) generated during 1786fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// the connection. This may be NULL if no output is needed.A 1787fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1788fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @param[in] remote_url 1789fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// The URL format that we are connecting to. 1790fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 1791fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @return 1792fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// Returns an error object. 1793fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda //------------------------------------------------------------------ 1794e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1795fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda ConnectRemote (Stream *strm, const char *remote_url); 17967508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1797dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool 1798ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton GetShouldDetach () const 1799dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham { 1800ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton return m_should_detach; 1801dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham } 1802ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 1803ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton void 1804ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton SetShouldDetach (bool b) 1805ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton { 1806ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_should_detach = b; 1807ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton } 1808ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 18097508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 181024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 181124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 181324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 181424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 181524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 181624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 181724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 181824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 182024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 182124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 182224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 182324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 182424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 182524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 182624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 182724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18280baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Load a shared library into this process. 18290baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 18300baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Try and load a shared library into the current process. This 18310baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// call might fail in the dynamic loader plug-in says it isn't safe 18320baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// to try and load shared libraries at the moment. 18330baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 18340baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[in] image_spec 18350baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// The image file spec that points to the shared library that 18360baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// you want to load. 18370baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 18380baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[out] error 18390baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// An error object that gets filled in with any errors that 18400baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// might occur when trying to load the shared library. 18410baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 18420baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @return 18430baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// A token that represents the shared library that can be 18440baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// later used to unload the shared library. A value of 18450baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// LLDB_INVALID_IMAGE_TOKEN will be returned if the shared 18460baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// library can't be opened. 18470baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 18480baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual uint32_t 18490baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton LoadImage (const FileSpec &image_spec, Error &error); 18500baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 18510baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual Error 18520baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton UnloadImage (uint32_t image_token); 18530baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 18540baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 185524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 185624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 185724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 185824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 185924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 186124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 186224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 186324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 186524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 186724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 186824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 186924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 187024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 187224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 187424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 187524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 187724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 187824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 187924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 188124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 188224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 188324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 188524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 188624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 188724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 188824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 188924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 189024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 189124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 189224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 189324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 189524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 189624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 189724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 189824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 189924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 190024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 190124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 190324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 190424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 190524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 190624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 190724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1908027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// N.B. This function also sets the Write side of the Run Lock, 1909027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// which is unset when the corresponding stop event is pulled off 1910027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// the Public Event Queue. If you need to resume the process without 1911027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// setting the Run Lock, use PrivateResume (though you should only do 1912027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// that from inside the Process class. 1913027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// 191424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 191524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 191624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 191724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 191824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 191924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 192024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 19213ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 1922027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham Resume(); 1923027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham 192424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 192524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 192624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 192724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 192824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 19293ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// If the process is successfully halted, a eStateStopped 19303ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// process event with GetInterrupted will be broadcast. If false, we will 19313ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// halt the process with no events generated by the halt. 193224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 193324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 19343ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// Returns an error object. If the error is empty, the process is halted. 19353ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// otherwise the halt has failed. 193624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 19373ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 193824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 193924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 194024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 194124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 194224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 194324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 194424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 194524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 194624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 194724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 194824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 19493ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 195024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 195124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 195324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 195424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 195524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 195624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 195724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 195824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 195924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 196024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 196124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 19623ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 196324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 196424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 196524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 196724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 196824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 196924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 197024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 197124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 197224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 197324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 19743ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 197524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 197624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 1978395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetUnixSignals () 1979395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1980395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_unix_signals; 1981395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 198224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 198424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 198524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 198624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 198924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 199024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 199124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 199224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 199324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 199424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 199524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 199624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 199754e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 199824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 199924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 200024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 200124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 200324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 200424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 200524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 200624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 200724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 200824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 200924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 201024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 201124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 201254e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 201324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 201424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 201524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 201624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2017fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda //------------------------------------------------------------------ 2018fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// Attach to a remote system via a URL 2019fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 2020fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @param[in] strm 2021fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// A stream where output intended for the user 2022fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// (if the driver has a way to display that) generated during 2023fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// the connection. This may be NULL if no output is needed.A 2024fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 2025fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @param[in] remote_url 2026fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// The URL format that we are connecting to. 2027fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// 2028fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// @return 2029fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda /// Returns an error object. 2030fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda //------------------------------------------------------------------ 2031e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 2032fac2e62f08719ba800a440b7ad0d5a55a26dc620Jason Molenda DoConnectRemote (Stream *strm, const char *remote_url) 2033e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton { 2034e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton Error error; 2035e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton error.SetErrorString ("remote connections are not supported"); 2036e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton return error; 2037e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton } 2038e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton 203924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 204124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 204324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 204424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 204624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 204724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 204824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 205046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoAttachToProcessWithID (lldb::pid_t pid) 205146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 205246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 205346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support attaching to a process by pid", GetShortPluginName()); 205446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 205546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 205624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2058d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Attach to an existing process using a process ID. 2059d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 2060d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] pid 2061d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// The process ID that we should attempt to attach to. 2062d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 2063d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] attach_info 2064d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Information on how to do the attach. For example, GetUserID() 2065d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// will return the uid to attach as. 2066d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 2067d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @return 2068d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Returns \a pid if attaching was successful, or 2069d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// LLDB_INVALID_PROCESS_ID if attaching fails. 2070d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// hanming : need flag 2071d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong //------------------------------------------------------------------ 2072d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong virtual Error 2073d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong DoAttachToProcessWithID (lldb::pid_t pid, const ProcessAttachInfo &attach_info) 2074d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong { 2075d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong Error error; 2076d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong error.SetErrorStringWithFormat("error: %s does not support attaching to a process by pid", GetShortPluginName()); 2077d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong return error; 2078d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong } 2079d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong 2080d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong //------------------------------------------------------------------ 208124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 208224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 208424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 208524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 208724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 208824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 208924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 209024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2091d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] attach_info 2092d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Information on how to do the attach. For example, GetUserID() 2093d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// will return the uid to attach as. 2094d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 209524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 209624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 209724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 209824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 209924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2100d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong DoAttachToProcessWithName (const char *process_name, bool wait_for_launch, const ProcessAttachInfo &attach_info) 210124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 210224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 210324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 210424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 210524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 210624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 210824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 210924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 211024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 211124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 211224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 211324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 211424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 211524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 211624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 211724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 21180bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// Called after a process re-execs itself. 21190bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// 21200bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// Allow Process plug-ins to execute some code after a process has 21210bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// exec'ed itself. Subclasses typically should override DoDidExec() 21220bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// as the lldb_private::Process class needs to remove its dynamic 21230bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// loader, runtime, ABI and other plug-ins, as well as unload all 21240bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// shared libraries. 21250bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton //------------------------------------------------------------------ 21260bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton virtual void 21270bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton DidExec (); 21280bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton 21290bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton //------------------------------------------------------------------ 21300bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// Subclasses of Process should implement this function if they 21310bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton /// need to do anything after a process exec's itself. 21320bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton //------------------------------------------------------------------ 21330bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton virtual void 21340bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton DoDidExec () 21350bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton { 21360bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton } 21370bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton 21380bce9a22354df3f00e68ffd912119a0741753b7fGreg Clayton //------------------------------------------------------------------ 213924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 214024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 214124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 214224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 214324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 214424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 214524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 214624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 214724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 214824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 214924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 215024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 215124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 215224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 215324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 215424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 215524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 215624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 215724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 215824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 215924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 216024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 216124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 216324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 216424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 216524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 216724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 216824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 217024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 217124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2172452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 2173452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 2174452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 217524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 217624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 217724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 217824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 217924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 218024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 218124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 218224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 218324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 218424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 218524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 218624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 218724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 218824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 218924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2190de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 2191de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 2192de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 219324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 219424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 219524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 219624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 219724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 219836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton DoLaunch (Module *exe_module, 219946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const ProcessLaunchInfo &launch_info) 220046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 220146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 220246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support launching processes", GetShortPluginName()); 220346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 220446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 220546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 220624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 220724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 220824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 220924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 221024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 221124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 221224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 221324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 221424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 221524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 221624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 221724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 221824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 221924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 222024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 222124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 222224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 222324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 222424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 222524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 222624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 222724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 222824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 222924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 223024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 223124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 223224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 223324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 223424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 223524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 223624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 223724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 223824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 223924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 224024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 224124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 224224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 224424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 224524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 224624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 224724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 224846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoResume () 224946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 225046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 225146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support resuming processes", GetShortPluginName()); 225246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 225346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 225446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 225524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 225624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 225724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 225824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 225924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 226024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 226124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 226224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 226324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 226424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 226524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 226624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 226724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 226824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 226924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 227024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 227124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 227224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 227324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 227424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 227524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 227624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 227724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 227824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 227924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 228024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2281360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt must produce one and only one stop StateChanged event if it actually 2282360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// stops the process. If the stop happens through some natural event (for 2283360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// instance a SIGSTOP), then forwarding that event will do. Otherwise, you must 2284360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// generate the event manually. Note also, the private event thread is stopped when 2285360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt is run to prevent the events generated while halting to trigger 2286360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// other state changes before the halt is complete. 22873ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 22883ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// @param[out] caused_stop 228920d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// If true, then this Halt caused the stop, otherwise, the 229020d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// process was already stopped. 22913ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 229224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 229324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 229424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 229524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 229624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 229746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoHalt (bool &caused_stop) 229846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 229946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 230046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support halting processes", GetShortPluginName()); 230146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 230246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 230346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 230424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 230524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 230624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 230724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 230824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 230924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 231024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 231124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 231224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 231324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 231424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 231524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 231624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 231724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 231824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 231924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 232024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 232124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 232224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 232324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 232424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 232524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 232624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 232724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 232824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 232924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 233024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 233124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 233324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 233424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 233524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 233624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 233746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoDetach () 233846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 233946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 234046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support detaching from processes", GetShortPluginName()); 234146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 234246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 234346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 234424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 234524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 234624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 234724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 234924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 235024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 235224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 235324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 235424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 235624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 235724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 235824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 235924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 236024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 236124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 236224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 236324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 236424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 236524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 236624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 236724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 236824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 236924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 237024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 237124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 237224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 237324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 237424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 237546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoSignal (int signal) 237646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 237746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 237846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support senging signals to processes", GetShortPluginName()); 237946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 238046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 238124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 238224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 238324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 238424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 238524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 238624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 238724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 238824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 238924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 239024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 239124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 239224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 239324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 239424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 239524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 239624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 239724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 239824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 239924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 240024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 240124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 240224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 240324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 240424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 240524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 240724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 240824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 240924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 241024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 241124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 241224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 241324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 241424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 241524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 241624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 241724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 241824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 241924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 242024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 242124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 242224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 242324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 242424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 2425395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () 2426395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2427395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2428395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 242924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 243024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 243124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 243224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 243324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 243424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 243524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 243624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 243724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 2438395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () const 2439395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2440395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2441395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 2442395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 2443cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton //------------------------------------------------------------------ 2444cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// Flush all data in the process. 2445cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// 2446cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// Flush the memory caches, all threads, and any other cached data 2447cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// in the process. 2448cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// 2449cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// This function can be called after a world changing event like 2450cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// adding a new symbol file, or after the process makes a large 2451cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// context switch (from boot ROM to booted into an OS). 2452cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton //------------------------------------------------------------------ 2453cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton void 2454cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton Flush (); 245524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 245624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 245724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 245824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 245924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 246024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 246124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 246224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 246324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 246424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 246524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 2466360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2467b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResults 2468360f53f3c216ee4fb433da0a367168785328a856Jim Ingham RunThreadPlan (ExecutionContext &exe_ctx, 2469360f53f3c216ee4fb433da0a367168785328a856Jim Ingham lldb::ThreadPlanSP &thread_plan_sp, 2470360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool stop_others, 247147beabb1386be44e3f90dbc30a0b22c23b93a4dcJim Ingham bool run_others, 2472b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham bool unwind_on_error, 2473b794020ffbd6473c59a6e98be044df50abf7fc30Jim Ingham bool ignore_breakpoints, 247447beabb1386be44e3f90dbc30a0b22c23b93a4dcJim Ingham uint32_t timeout_usec, 2475360f53f3c216ee4fb433da0a367168785328a856Jim Ingham Stream &errors); 2476360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2477360f53f3c216ee4fb433da0a367168785328a856Jim Ingham static const char * 2478b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResultAsCString (ExecutionResults result); 247924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2480abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton void 2481abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetStatus (Stream &ostrm); 2482abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 2483abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton size_t 2484abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetThreadStatus (Stream &ostrm, 2485abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton bool only_threads_with_stop_reason, 2486abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t start_frame, 2487abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames, 2488abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames_with_source); 2489abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 24905d90ade8e8e0d776fe8e1b9e88fc1c86d02e8e4eJim Ingham void 24915d90ade8e8e0d776fe8e1b9e88fc1c86d02e8e4eJim Ingham SendAsyncInterrupt (); 24925d90ade8e8e0d776fe8e1b9e88fc1c86d02e8e4eJim Ingham 249324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 249424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 249524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 249624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 249724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 249824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 249924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 250024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250175c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 2502027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// The "private" side of resuming a process. This doesn't alter the 2503027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// state of m_run_lock, but just causes the process to resume. 2504027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// 2505027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// @return 2506027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// An Error object describing the success or failure of the resume. 2507027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham //------------------------------------------------------------------ 2508027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham Error 2509027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham PrivateResume (); 2510027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham 2511027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham //------------------------------------------------------------------ 251275c703dd8b492bad25a987b96853626641ae7246Greg Clayton // Called internally 251375c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 251475c703dd8b492bad25a987b96853626641ae7246Greg Clayton void 251575c703dd8b492bad25a987b96853626641ae7246Greg Clayton CompleteAttach (); 251675c703dd8b492bad25a987b96853626641ae7246Greg Clayton 251724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 251824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 251924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 252024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 252124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 252224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 252324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 252424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 252524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 252624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 252724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 252824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 252924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 253024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 253124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 253224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 253324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 253424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 253524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 253624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 253724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 253824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 253924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 254024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 254124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 254224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 254324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 254424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 254521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// Get the Modification ID of the process. 254624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 254724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 254821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// The modification ID of the process. 254924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 255021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID 255121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetModID () const 255221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 255321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id; 255421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 255521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 25560296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham const ProcessModID & 25570296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetModIDRef () const 25580296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 25590296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id; 25600296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 25610296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 256224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 256321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetStopID () const 256421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 256521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id.GetStopID(); 256621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 256721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 25680296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 25690296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetResumeID () const 25700296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 25710296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetResumeID(); 25720296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 25730296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 25740296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 25750296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetLastUserExpressionResumeID () const 25760296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 25770296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetLastUserExpressionResumeID(); 25780296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 25790296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 25800e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham uint32_t 25810e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham GetLastNaturalStopID() 25820e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham { 25830e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham return m_mod_id.GetLastNaturalStopID(); 25840e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham } 25850e3b98e7de6d69613a9729bac9d4b965c0635698Jim Ingham 258624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 258724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 258824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 258924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 259024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 259124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 259224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 259324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 259424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 259524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 259624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 259724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 259824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 259924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 260024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 260124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 260272e1c782ba1e4226da37af4722af608de9f39408Greg Clayton virtual bool 260324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 260424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 260524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 260624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 260724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 260824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 260924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 261024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 261124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 261224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 261324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 261424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 261524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 261624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 261724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 261824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 261924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 262024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 262124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 262224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 262324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 262424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 262524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 262624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 262724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 262824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 262924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 263024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 263124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 263224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 263324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 263424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 263524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 263624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 263724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 263824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 263924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 264024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 264124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 264224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 264324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 264424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 264524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 264624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 264724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 264824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 264924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 265024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 265124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 265224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 265324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 265424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 265524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 265624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 265724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 265824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 265924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 266024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 266124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 266224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 266324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 266424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 266524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 266624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 266724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 266824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 266924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 267024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 267124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 26729ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton virtual size_t 267324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 267424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 267524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 267624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 267724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2678b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2679b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// Read a NULL terminated C string from memory 2680b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// 2681b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// This function will read a cache page at a time until the NULL 2682b0e3c7c4d063da2cc6a2550ad4979d5c342c8306Jason Molenda /// C string terminator is found. It will stop reading if the NULL 2683b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// termination byte isn't found before reading \a cstr_max_len 2684b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// bytes, and the results are always guaranteed to be NULL 2685b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// terminated (at most cstr_max_len - 1 bytes will be read). 2686b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2687b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 2688b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2689b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton char *cstr, 26904a2e33769873d68d5703da5742c0e248f46e3a72Greg Clayton size_t cstr_max_len, 26914a2e33769873d68d5703da5742c0e248f46e3a72Greg Clayton Error &error); 2692b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2693fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 2694dd29b97f71187509df339596c3397dea0e429754Greg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2695dd29b97f71187509df339596c3397dea0e429754Greg Clayton std::string &out_str, 2696dd29b97f71187509df339596c3397dea0e429754Greg Clayton Error &error); 2697dd29b97f71187509df339596c3397dea0e429754Greg Clayton 2698dd29b97f71187509df339596c3397dea0e429754Greg Clayton size_t 2699fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ReadMemoryFromInferior (lldb::addr_t vm_addr, 2700fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *buf, 2701fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t size, 2702fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 2703fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 27046d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 27056d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// Reads an unsigned integer of the specified byte size from 27066d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// process memory. 27076d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 27086d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] load_addr 27096d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// A load address of the integer to read. 27106d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 27116d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] byte_size 27126d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The size in byte of the integer to read. 27136d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 2714c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] fail_value 2715c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value to return if we fail to read an integer. 2716c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 27176d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[out] error 27186d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// An error that indicates the success or failure of this 27196d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// operation. If error indicates success (error.Success()), 27206d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// then the value returned can be trusted, otherwise zero 27216d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// will be returned. 27226d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 27236d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @return 27246d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The unsigned integer that was read from the process memory 27256d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// space. If the integer was smaller than a uint64_t, any 27266d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// unused upper bytes will be zero filled. If the process 27276d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// byte order differs from the host byte order, the integer 27286d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// value will be appropriately byte swapped into host byte 27296d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// order. 27306d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 2731f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton uint64_t 2732c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadUnsignedIntegerFromMemory (lldb::addr_t load_addr, 2733c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t byte_size, 2734c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint64_t fail_value, 2735c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2736c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2737c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t 2738c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadPointerFromMemory (lldb::addr_t vm_addr, 2739c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2740c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2741c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool 2742c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WritePointerToMemory (lldb::addr_t vm_addr, 2743c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t ptr_value, 2744c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2745c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 274624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 274724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 274824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 274924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 275024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 275124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 275224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 275324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 275424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 275524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 275624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 275724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 275824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 275924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2760c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2761c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2762c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 276324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 276424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 276524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 276624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 276746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) 276846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 276946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support writing to processes", GetShortPluginName()); 277046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return 0; 277146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 277246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 277324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 277424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2775c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// Write all or part of a scalar value to memory. 2776c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2777c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value contained in \a scalar will be swapped to match the 2778c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// byte order of the process that is being debugged. If \a size is 2779c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// less than the size of scalar, the least significate \a size bytes 2780c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// from scalar will be written. If \a size is larger than the byte 2781c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// size of scalar, then the extra space will be padded with zeros 2782c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// and the scalar value will be placed in the least significant 2783c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// bytes in memory. 2784c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2785c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] vm_addr 2786c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// A virtual load address that indicates where to start writing 2787c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// memory to. 2788c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2789c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] scalar 2790c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The scalar to write to the debugged process. 2791c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2792c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] size 2793c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// This value can be smaller or larger than the scalar value 2794c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// itself. If \a size is smaller than the size of \a scalar, 2795c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the least significant bytes in \a scalar will be used. If 2796c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// \a size is larger than the byte size of \a scalar, then 2797c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the extra space will be padded with zeros. If \a size is 2798c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// set to UINT32_MAX, then the size of \a scalar will be used. 2799c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2800c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2801c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2802c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2803c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @return 2804c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The number of bytes that were actually written. 2805c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 2806c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2807c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WriteScalarToMemory (lldb::addr_t vm_addr, 2808c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton const Scalar &scalar, 280936da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton size_t size, 2810c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2811c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2812c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2813c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadScalarIntegerFromMemory (lldb::addr_t addr, 2814c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t byte_size, 2815c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool is_signed, 2816c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Scalar &scalar, 2817c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2818c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2819c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 282024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 282124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 282224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 282324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 282424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 282524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 282624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 282724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 282824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 282924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 283024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 283124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 283224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 283324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 283424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 283524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 283624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 283724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 283824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 283924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 284024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 284124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 284224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 284324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 284424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 284524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 284624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 284924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 285024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 285124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 285224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 285324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 285424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 285524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 285624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 285724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 285824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 285924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 286024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 286124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 286224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 286324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 286446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoAllocateMemory (size_t size, uint32_t permissions, Error &error) 286546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 286646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support allocating in the debug process", GetShortPluginName()); 286746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return LLDB_INVALID_ADDRESS; 286846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 286946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 287024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 287124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 287224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 287324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 287424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 287524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 287624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 287724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 287824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 287924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 288024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 288124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 288224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 288324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 288424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 288524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 288624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2887b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// @param[in/out] error 2888b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// An error object to fill in if things go wrong. 288924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 289024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 289124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 289224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 289324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 289424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 289524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 289624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2897a9385537809ef342c843c5ab972e513742652047Greg Clayton virtual Error 2898a9385537809ef342c843c5ab972e513742652047Greg Clayton GetMemoryRegionInfo (lldb::addr_t load_addr, 2899a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo &range_info) 2900a9385537809ef342c843c5ab972e513742652047Greg Clayton { 2901a9385537809ef342c843c5ab972e513742652047Greg Clayton Error error; 2902a9385537809ef342c843c5ab972e513742652047Greg Clayton error.SetErrorString ("Process::GetMemoryRegionInfo() not supported"); 2903a9385537809ef342c843c5ab972e513742652047Greg Clayton return error; 2904a9385537809ef342c843c5ab972e513742652047Greg Clayton } 29051f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29067cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen virtual Error 29077cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen GetWatchpointSupportInfo (uint32_t &num) 29087cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen { 29097cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen Error error; 29107cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen error.SetErrorString ("Process::GetWatchpointSupportInfo() not supported"); 29117cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen return error; 29127cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen } 29137cbdcfb0cefcfd877b507ff2d83e51a1bde3fcc7Johnny Chen 29147de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata virtual Error 29157de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata GetWatchpointSupportInfo (uint32_t &num, bool& after) 29167de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata { 29177de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata Error error; 29187de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata error.SetErrorString ("Process::GetWatchpointSupportInfo() not supported"); 29197de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata return error; 29207de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata } 29217de2a3b03f37987c67f142ce328cc2484c831468Enrico Granata 2922b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton lldb::ModuleSP 2923b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton ReadModuleFromMemory (const FileSpec& file_spec, 29242ddb2b8aed6d43665c6955255f6a077574a08412Greg Clayton lldb::addr_t header_addr); 2925b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton 29261f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda //------------------------------------------------------------------ 29271f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// Attempt to get the attributes for a region of memory in the process. 29281f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 29291f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// It may be possible for the remote debug server to inspect attributes 29301f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// for a region of memory in the process, such as whether there is a 29311f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// valid page of memory at a given address or whether that page is 29321f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// readable/writable/executable by the process. 29331f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 29341f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @param[in] load_addr 29351f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// The address of interest in the process. 29361f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 29371f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @param[out] permissions 29381f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// If this call returns successfully, this bitmask will have 29391f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// its Permissions bits set to indicate whether the region is 29401f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// readable/writable/executable. If this call fails, the 29411f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// bitmask values are undefined. 29421f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 29431f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @return 29441f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// Returns true if it was able to determine the attributes of the 29451f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// memory region. False if not. 29461f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda //------------------------------------------------------------------ 29471f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29481f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda virtual bool 29491f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetLoadAddressPermissions (lldb::addr_t load_addr, uint32_t &permissions) 2950a9385537809ef342c843c5ab972e513742652047Greg Clayton { 2951a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo range_info; 29521f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions = 0; 2953a9385537809ef342c843c5ab972e513742652047Greg Clayton Error error (GetMemoryRegionInfo (load_addr, range_info)); 29541f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (!error.Success()) 29551f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return false; 29561f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetReadable() == MemoryRegionInfo::eDontKnow 29571f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda || range_info.GetWritable() == MemoryRegionInfo::eDontKnow 29581f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda || range_info.GetExecutable() == MemoryRegionInfo::eDontKnow) 29591f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda { 29601f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return false; 29611f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda } 29621f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29631f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetReadable() == MemoryRegionInfo::eYes) 29641f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsReadable; 29651f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29661f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetWritable() == MemoryRegionInfo::eYes) 29671f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsWritable; 29681f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29691f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetExecutable() == MemoryRegionInfo::eYes) 29701f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsExecutable; 29711f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 29721f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return true; 2973a9385537809ef342c843c5ab972e513742652047Greg Clayton } 29741f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 297524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 29766cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Determines whether executing JIT-compiled code in this process 29776cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 29786cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 29796cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @return 29806cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 29816cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 29826cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan bool CanJIT (); 29836cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 29846cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 29856cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Sets whether executing JIT-compiled code in this process 29866cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 29876cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 29886cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @param[in] can_jit 29896cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 29906cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 29916cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan void SetCanJIT (bool can_jit); 29926cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 29936cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 299424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 299524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 299624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 299724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 299824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 299924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 300024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 300124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 300224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 300324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 300424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 300524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 300624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 300724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 300846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoDeallocateMemory (lldb::addr_t ptr) 300946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 301046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 301146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support deallocating in the debug process", GetShortPluginName()); 301246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 301346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 301446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 301524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 301624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 301724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 301824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 301924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 302024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 302124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 302224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 302324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 302424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 302524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 302624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 302724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 302824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 302924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 303024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 303124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 3032fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong 303324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 303424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 303524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 303624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 303724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 303824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 303924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 304024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 304124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 304224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 304324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 304424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 304524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 304624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 304724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 304824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 304924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 305024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 305124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 305224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 305324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 305424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 3055bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDOUT (char *buf, size_t buf_size, Error &error); 305624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 305724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 305824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 305924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 306024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 306124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 306224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 306324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 306424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 306524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 306624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 306724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 306824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 306924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 307024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 307124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 307224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 307324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 307424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 307524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 307624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 307724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 307824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 3079bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDERR (char *buf, size_t buf_size, Error &error); 308024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 308124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 308224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 308324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 308424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 308524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 308624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 308724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3088fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong //------------------------------------------------------------------ 3089fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// Get any available profile data. 3090fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// 3091fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// @param[out] buf 3092fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// A buffer that will receive any profile data bytes that are 3093fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// currently available. 3094fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// 3095fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// @param[out] buf_size 3096fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// The size in bytes for the buffer \a buf. 3097fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// 3098fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// @return 3099fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// The number of bytes written into \a buf. If this value is 3100fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// equal to \a buf_size, another call to this function should 3101fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong /// be made to retrieve more profile data. 3102fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong //------------------------------------------------------------------ 3103fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong virtual size_t 3104fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong GetAsyncProfileData (char *buf, size_t buf_size, Error &error); 3105fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong 310624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 310724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 310824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 3109b1888f24fa181489840b9acf193e224d125d0776Greg Clayton size_t 3110b1888f24fa181489840b9acf193e224d125d0776Greg Clayton GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site); 311124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 311224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 3113efb4aeba2bd8411ac0aee9934f08959094d50711Jim Ingham EnableBreakpointSite (BreakpointSite *bp_site) 311446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 311546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 311646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support enabling breakpoints", GetShortPluginName()); 311746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 311846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 311946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 312024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 312124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 3122efb4aeba2bd8411ac0aee9934f08959094d50711Jim Ingham DisableBreakpointSite (BreakpointSite *bp_site) 312346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 312446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 312546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support disabling breakpoints", GetShortPluginName()); 312646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 312746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 312846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 312924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 313024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 313124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 313224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 313324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 313424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 313524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 313624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 313724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 313824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 313924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 314024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 314124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 314224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 314324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 314424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 314524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 314624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 314724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 314824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 314924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 315024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 315124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 315224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 315324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 315424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 315524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 31563fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 315713d24fb1817faa7ccc4cfd799113ba1a2b8968ebGreg Clayton CreateBreakpointSite (const lldb::BreakpointLocationSP &owner, 315824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 315924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 316024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 316124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 316224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 316324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 316424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 316524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 316624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 316724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 316824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 316924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 317024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 317124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 317224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 317324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 317424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 317524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 317624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 317724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 317824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 317924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 318024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 31819c970a371511a0e31ba9360aa841d445792c1ab0Jim Ingham EnableWatchpoint (Watchpoint *wp, bool notify = true); 318224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 318324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 31849c970a371511a0e31ba9360aa841d445792c1ab0Jim Ingham DisableWatchpoint (Watchpoint *wp, bool notify = true); 318524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 318624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 318724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 318824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 3189ae932359b80098532f3c3766fa9e6527352fbb67Greg Clayton virtual bool 319037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list) = 0; 319137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 319237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton void 319337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadListIfNeeded (); 319424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 319524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 3196395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () 3197395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3198395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 3199395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 3200ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong 3201ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong // This is obsoleted and will be removed very soon. 320224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 320324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 3204ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong 3205ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong uint32_t 3206ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong GetNextThreadIndexID (uint64_t thread_id); 3207ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong 320852ebc0aab1fdecb634801deceeddd71a14c2148cGreg Clayton lldb::ThreadSP 320952ebc0aab1fdecb634801deceeddd71a14c2148cGreg Clayton CreateOSPluginThread (lldb::tid_t tid, lldb::addr_t context); 321052ebc0aab1fdecb634801deceeddd71a14c2148cGreg Clayton 3211ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong // Returns true if an index id has been assigned to a thread. 3212ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong bool 3213ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong HasAssignedIndexIDToThread(uint64_t sb_thread_id); 3214ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong 3215ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong // Given a thread_id, it will assign a more reasonable index id for display to the user. 3216ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong // If the thread_id has previously been assigned, the same index id will be used. 3217ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong uint32_t 3218ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong AssignIndexIDToThread(uint64_t thread_id); 321924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 322024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 322124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 322224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 322324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 322424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 322524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 322624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 3227bb1af9ce3e25eae9916f85cb9a0c82e291c20bb4Greg Clayton WaitForProcessToStop (const TimeValue *timeout, lldb::EventSP *event_sp_ptr = NULL); 322824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 322924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 323024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 323124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 323224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 323324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 323463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 323524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3236f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham class 3237f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker 3238f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3239f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham public: 3240f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker (Process &process, Listener *listener) : 32412827e26d7d85636dd0d934a7e15d9ef5b95fac67Filipe Cabecinhas m_process (process) 3242f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3243f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.HijackProcessEvents (listener); 3244f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 3245f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ~ProcessEventHijacker () 3246f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3247f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.RestoreProcessEvents(); 3248f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 3249f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 3250f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham private: 3251f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Process &m_process; 3252f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham }; 3253f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham friend class ProcessEventHijacker; 325424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 325563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// If you need to ensure that you and only you will hear about some public 325663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// event, then make a new listener, set to listen to process events, and 325763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// then call this with that listener. Then you will have to wait on that 325863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// listener explicitly for events (rather than using the GetNextEvent & WaitFor* 325963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// calls above. Be sure to call RestoreProcessEvents when you are done. 326063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 326163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @param[in] listener 326263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// This is the new listener to whom all process events will be delivered. 326363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 326463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @return 326563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Returns \b true if the new listener could be installed, 326663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// \b false otherwise. 326763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 326863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham bool 326963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham HijackProcessEvents (Listener *listener); 327063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 327163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 327263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Restores the process event broadcasting to its normal state. 327363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 327463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 327563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham void 327663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham RestoreProcessEvents (); 327763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 327863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghamprotected: 327963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 328024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 328124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 328224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 328324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 328424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 328524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 328624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 328724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 328824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 328924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 329024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 329124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 329224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 329324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 329424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 329524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 329663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghampublic: 329775906e4ec98af3717e415727a8d663a4e246bb4fGreg Clayton const lldb::ABISP & 329824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 329924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 330037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton OperatingSystem * 330137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton GetOperatingSystem () 330237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton { 330337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton return m_os_ap.get(); 330437f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton } 330537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 330637f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 3307642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual LanguageRuntime * 3308e31176627725f4236c9ca049edc027756709780bJim Ingham GetLanguageRuntime (lldb::LanguageType language, bool retry_if_null = true); 3309642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 3310642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual CPPLanguageRuntime * 3311e31176627725f4236c9ca049edc027756709780bJim Ingham GetCPPLanguageRuntime (bool retry_if_null = true); 3312642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 3313642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual ObjCLanguageRuntime * 3314e31176627725f4236c9ca049edc027756709780bJim Ingham GetObjCLanguageRuntime (bool retry_if_null = true); 3315e31176627725f4236c9ca049edc027756709780bJim Ingham 331624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 33176b1763b5ab8f182029807293d74a66e1e1c6bafdEnrico Granata IsPossibleDynamicValue (ValueObject& in_value); 33186b1763b5ab8f182029807293d74a66e1e1c6bafdEnrico Granata 33196b1763b5ab8f182029807293d74a66e1e1c6bafdEnrico Granata bool 332024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 3321f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 3322f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 3323f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 3324d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham return m_dynamic_checkers_ap.get(); 3325f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 3326f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 3327f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 3328f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 3329d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham m_dynamic_checkers_ap.reset(dynamic_checkers); 3330f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 333124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3332c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 3333c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to set the lldb in the mode where it breaks on new thread 3334c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// creations, and then auto-restarts. This is useful when you are trying 3335c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// to run only one thread, but either that thread or the kernel is creating 3336c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// new threads in the process. If you stop when the thread is created, you 3337c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// can immediately suspend it, and keep executing only the one thread you intend. 3338c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 3339c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 3340c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 3341c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 3342c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 334355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 334455e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StartNoticingNewThreads() 334555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 334655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 334755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 334855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 3349c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 3350c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to turn off the stop & notice new threads mode. 3351c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 3352c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 3353c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 3354c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 3355c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 335655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 335755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StopNoticingNewThreads() 335855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 335955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 336055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 336155e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 33620296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 33630296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on); 33640296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 336524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 336624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 336724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 3368289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::TargetSP 3369289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton CalculateTarget (); 3370289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3371289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::ProcessSP 3372395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateProcess () 3373395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3374289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return shared_from_this(); 3375395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 3376289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3377289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::ThreadSP 3378395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateThread () 3379395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3380289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return lldb::ThreadSP(); 3381395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 3382289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3383289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::StackFrameSP 3384395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateStackFrame () 3385395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3386289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return lldb::StackFrameSP(); 3387395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 338824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 338924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 3390a830adbcd63d1995a01e6e18da79893c1426ca43Greg Clayton CalculateExecutionContext (ExecutionContext &exe_ctx); 339124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3392464c6161464694412b7472129e789248f1cf21b9Greg Clayton void 3393464c6161464694412b7472129e789248f1cf21b9Greg Clayton SetSTDIOFileDescriptor (int file_descriptor); 3394464c6161464694412b7472129e789248f1cf21b9Greg Clayton 3395761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3396761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // Add a permanent region of memory that should never be read or 3397761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // written to. This can be used to ensure that memory reads or writes 3398761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // to certain areas of memory never end up being sent to the 3399761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // DoReadMemory or DoWriteMemory functions which can improve 3400761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // performance. 3401761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3402761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton void 3403761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton AddInvalidMemoryRegion (const LoadRange ®ion); 3404761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton 3405761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3406761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // Remove a permanent region of memory that should never be read or 3407761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // written to that was previously added with AddInvalidMemoryRegion. 3408761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3409761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton bool 3410761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton RemoveInvalidMemoryRange (const LoadRange ®ion); 34111831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 34121831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham //------------------------------------------------------------------ 34131831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // If the setup code of a thread plan needs to do work that might involve 34141831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // calling a function in the target, it should not do that work directly 34151831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // in one of the thread plan functions (DidPush/WillResume) because 34161831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // such work needs to be handled carefully. Instead, put that work in 34171831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // a PreResumeAction callback, and register it with the process. It will 34181831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // get done before the actual "DoResume" gets called. 34191831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham //------------------------------------------------------------------ 34201831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 34211831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham typedef bool (PreResumeActionCallback)(void *); 34221831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 34231831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham void 34241831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham AddPreResumeAction (PreResumeActionCallback callback, void *baton); 34251831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 34261831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham bool 34271831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham RunPreResumeActions (); 34281831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 34291831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham void 34301831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham ClearPreResumeActions (); 34311831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 3432a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ReadWriteLock & 3433a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton GetRunLock () 3434a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton { 3435a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton return m_run_lock; 3436a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton } 3437a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton 343824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 3439c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 344021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // NextEventAction provides a way to register an action on the next 344121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // event that is delivered to this process. There is currently only 344221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // one next event action allowed in the process at one time. If a 344321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // new "NextEventAction" is added while one is already present, the 344421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // old action will be discarded (with HandleBeingUnshipped called 344521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // after it is discarded.) 3446c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 3447c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class NextEventAction 3448c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3449c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 3450c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham typedef enum EventActionResult 3451c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3452c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionSuccess, 3453c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionRetry, 3454c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionExit 3455c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } EventActionResult; 3456c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3457c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction (Process *process) : 3458c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham m_process(process) 34592d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 34602d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 34612d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 34622d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 34632d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~NextEventAction() 34642d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 34652d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 3466c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3467c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp) = 0; 3468293b98f5e24ef736766db37feedfefd3b215a0ceFilipe Cabecinhas virtual void HandleBeingUnshipped () {} 3469c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted () = 0; 3470c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString() = 0; 3471c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham protected: 3472c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham Process *m_process; 3473c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 3474c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3475c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham void SetNextEventAction (Process::NextEventAction *next_event_action) 3476c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 347768bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham if (m_next_event_action_ap.get()) 347868bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap->HandleBeingUnshipped(); 347968bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham 348068bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap.reset(next_event_action); 3481c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } 3482c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3483c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // This is the completer for Attaching: 3484c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class AttachCompletionHandler : public NextEventAction 3485c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3486c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 34872d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton AttachCompletionHandler (Process *process, uint32_t exec_count) : 34882d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton NextEventAction (process), 34892d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton m_exec_count (exec_count) 34902d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 34912d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 34922d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 34932d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 34942d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~AttachCompletionHandler() 34952d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 34962d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 3497c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3498c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp); 3499c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted (); 3500c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString(); 3501c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham private: 35022d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton uint32_t m_exec_count; 3503c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham std::string m_exit_string; 3504c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 3505c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3506f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham bool 3507f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham HijackPrivateProcessEvents (Listener *listener); 3508f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 3509f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham void 3510f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham RestorePrivateProcessEvents (); 3511a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton 3512a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton bool 3513a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton PrivateStateThreadIsValid () const 3514a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton { 35151831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham return IS_VALID_LLDB_HOST_THREAD(m_private_state_thread); 3516a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton } 3517fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 351824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 3519a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // Type definitions 3520a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton //------------------------------------------------------------------ 3521a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef std::map<lldb::LanguageType, lldb::LanguageRuntimeSP> LanguageRuntimeCollection; 3522a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton 35235ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham struct PreResumeCallbackAndBaton 35245ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham { 35255ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham bool (*callback) (void *); 35265ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham void *baton; 35275ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham PreResumeCallbackAndBaton (PreResumeActionCallback in_callback, void *in_baton) : 35285ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham callback (in_callback), 35295ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham baton (in_baton) 35305ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham { 35315ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham } 35325ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham }; 35335ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham 3534a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton //------------------------------------------------------------------ 353524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 353624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 353724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 353824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 353924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 354024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 354124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 354224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 354324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 354424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 3545a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ProcessModID m_mod_id; ///< Tracks the state of the process over stops and other alterations. 354664742744396c966e8de770e765130629b0c78335Greg Clayton uint32_t m_process_unique_id; ///< Each lldb_private::Process class that is created gets a unique integer ID that increments with each new instance 354724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 3548ccd5c4ee85d1592f9ae3da02c85f5647ca02fab2Han Ming Ong std::map<uint64_t, uint32_t> m_thread_id_to_index_id_map; 354924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 355024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 355124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 355224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 35530baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton std::vector<lldb::addr_t> m_image_tokens; 355424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 3555a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend to insert in the target. 355675c703dd8b492bad25a987b96853626641ae7246Greg Clayton std::auto_ptr<DynamicLoader> m_dyld_ap; 3557a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers_ap; ///< The functions used by the expression parser to validate data that expressions use. 3558a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton std::auto_ptr<OperatingSystem> m_os_ap; 355924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 356024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 3561861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderSP m_process_input_reader; 3562559cf6e8b52b940f5f4362b32d628838d6301e2eJason Molenda Communication m_stdio_communication; 3563559cf6e8b52b940f5f4362b32d628838d6301e2eJason Molenda Mutex m_stdio_communication_mutex; 3564861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice std::string m_stdout_data; 3565bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton std::string m_stderr_data; 3566fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong Mutex m_profile_data_comm_mutex; 3567f14269add7f6fb84da7ccfd866f8e9f7e81068beHan Ming Ong std::vector<std::string> m_profile_data; 3568fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache m_memory_cache; 3569613b8739a4d489b7f1c571288d5786768c024205Greg Clayton AllocatedMemoryCache m_allocated_memory_cache; 3570ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton bool m_should_detach; /// Should we detach if the process object goes away with an explicit call to Kill or Detach? 3571559cf6e8b52b940f5f4362b32d628838d6301e2eJason Molenda LanguageRuntimeCollection m_language_runtimes; 35727e2f91cb958c8670774cb2190db7b858618b5b9bGreg Clayton std::auto_ptr<NextEventAction> m_next_event_action_ap; 35731831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham std::vector<PreResumeCallbackAndBaton> m_pre_resume_actions; 3574a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ReadWriteLock m_run_lock; 35754389256aecd2693109969c21fa2f00c4612320b3Jim Ingham Predicate<bool> m_currently_handling_event; 3576d0bdddff8bc6dd5f71492452ce2bbd72fdaa147bJim Ingham bool m_finalize_called; 357789e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham lldb::StateType m_last_broadcast_state; /// This helps with the Public event coalescing in ShouldBroadcastEvent. 357889e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham 35796cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan enum { 35806cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITDontKnow= 0, 35816cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITYes, 35826cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITNo 35836cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan } m_can_jit; 35846cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 358524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 358624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 358724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 358824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 358924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 359024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 359124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 359224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 359324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 359424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 359524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 359624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 359724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 35981831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham StartPrivateStateThread (bool force = false); 359924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 360024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 360124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 360224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 360324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 360424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 360524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 360624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 360724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 360824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 360924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 361024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 361124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 361224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 361324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 361424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 361524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 361624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 361724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 361824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 361924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 362024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 362124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 362224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 362324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 362424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 362524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 362624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 362724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 362824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 362924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 363024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 363124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 363224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 363324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 363424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 363524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 363624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 3637861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3638861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3639861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice AppendSTDOUT (const char *s, size_t len); 3640861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3641bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton void 3642bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton AppendSTDERR (const char *s, size_t len); 3643bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton 3644fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong void 3645fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong BroadcastAsyncProfileData(const char *s, size_t len); 3646fb9cee64303d36d6fe5d87e63dd8701d1ddb70a9Han Ming Ong 3647861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static void 3648861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len); 3649861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3650861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3651861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PushProcessInputReader (); 3652861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3653861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3654861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PopProcessInputReader (); 3655861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3656861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3657861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ResetProcessInputReader (); 3658861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3659861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static size_t 3660861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ProcessInputReaderCallback (void *baton, 3661861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice InputReader &reader, 3662861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderAction notification, 3663861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice const char *bytes, 3664861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice size_t bytes_len); 3665861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3666861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 366724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 366824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 366924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 367024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 367124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 367289e248f04ecb87d0df4a4b96158c3fac0a3e43c7Jim Ingham 367324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 367424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 367524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 367624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 367724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 367824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 367924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 3680