Process.h revision ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9
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" 307508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham#include "lldb/Core/StringList.h" 3124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/ThreadSafeValue.h" 3224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/PluginInterface.h" 336e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice#include "lldb/Core/UserSettingsController.h" 3424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Breakpoint/BreakpointSiteList.h" 35a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan#include "lldb/Expression/ClangPersistentVariables.h" 36f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan#include "lldb/Expression/IRDynamicChecks.h" 37ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton#include "lldb/Host/FileSpec.h" 381c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton#include "lldb/Host/Host.h" 39e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Args.h" 40e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Options.h" 4124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 42613b8739a4d489b7f1c571288d5786768c024205Greg Clayton#include "lldb/Target/Memory.h" 4324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ThreadList.h" 4424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/UnixSignals.h" 4524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 4724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 48b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 49b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceSettings 50b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 516e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeclass ProcessInstanceSettings : public InstanceSettings 526e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice{ 536e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticepublic: 546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 55004afcb95736e97d071b1dd9b5254800e11e581cCaroline Tice ProcessInstanceSettings (UserSettingsController &owner, bool live_instance = true, const char *name = NULL); 566e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 576e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings (const ProcessInstanceSettings &rhs); 586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 596e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ~ProcessInstanceSettings (); 616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 626e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings& 636e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice operator= (const ProcessInstanceSettings &rhs); 646e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 656e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 666e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 676e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice UpdateInstanceSettingsVariable (const ConstString &var_name, 686e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *index_value, 696e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *value, 706e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &instance_name, 716e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const SettingEntry &entry, 72b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton VarSetOperationType op, 736e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Error &err, 746e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 756e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 76bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice bool 776e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice GetInstanceSettingsValue (const SettingEntry &entry, 786e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &var_name, 795bc8c97d62b2e399bd90fb7e00c903d7887412abCaroline Tice StringList &value, 80bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice Error *err); 816e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 826e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 836e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprotected: 846e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 856e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 866e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, 876e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 886e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 890021c97fbd17e38113d2e76b93c94ee05213ee45Johnny Chen const ConstString 906e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CreateInstanceName (); 916e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice}; 926e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 93b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 94b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInfo 95b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 96b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A base class for information for a process. This can be used to fill 97b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// out information for a process prior to launching it, or it can be 98b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// used for an instance of a process and can be filled in with the 99b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// existing values for that process. 100b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 101e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonclass ProcessInfo 102e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 103e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 104e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo () : 105ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable (), 106b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 107b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment (), 108444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 109444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 110e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch(), 111b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (LLDB_INVALID_PROCESS_ID) 112e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 113e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 114b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 115e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo (const char *name, 116e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec &arch, 117e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t pid) : 118b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_executable (name, false), 119b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 120b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment(), 121444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 122444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 123e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch (arch), 124b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (pid) 125e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 126e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 127e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 128e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 129e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear () 130e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 131ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.Clear(); 132b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments.Clear(); 133b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment.Clear(); 134444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid = UINT32_MAX; 135444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid = UINT32_MAX; 136e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch.Clear(); 137e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = LLDB_INVALID_PROCESS_ID; 138e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 139e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 140e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 141e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetName() const 142e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 143ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetCString(); 144e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 145b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 146e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 147e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetNameLength() const 148e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 149ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetLength(); 150e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 151e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 152ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton FileSpec & 153ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () 154ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 155ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 156e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 15736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 15836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 15936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetExecutableFile (const FileSpec &exe_file, bool add_exe_file_as_first_arg) 16036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file) 16236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable = exe_file; 16436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 16536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.Clear(); 16736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton char filename[PATH_MAX]; 16836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file.GetPath(filename, sizeof(filename))) 16936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.AppendArgument (filename); 17036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton else 17336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 17436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable.Clear(); 17536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 17636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.Clear(); 17736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 180ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton const FileSpec & 181ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () const 18224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 183ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 18424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 18524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 186a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 187b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetUserID() const 188a733c04608cc94592a15d27583529588e19db552Greg Clayton { 189b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid; 190a733c04608cc94592a15d27583529588e19db552Greg Clayton } 191b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 192a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 193b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetGroupID() const 194a733c04608cc94592a15d27583529588e19db552Greg Clayton { 195b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid; 196a733c04608cc94592a15d27583529588e19db552Greg Clayton } 19724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 19824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 199b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton UserIDIsValid () const 20024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 201b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid != UINT32_MAX; 20224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 20324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 20424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 205b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GroupIDIsValid () const 20624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 207b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid != UINT32_MAX; 20824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 20924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 210a733c04608cc94592a15d27583529588e19db552Greg Clayton void 211b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetUserID (uint32_t uid) 212a733c04608cc94592a15d27583529588e19db552Greg Clayton { 213b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid = uid; 214a733c04608cc94592a15d27583529588e19db552Greg Clayton } 215a733c04608cc94592a15d27583529588e19db552Greg Clayton 216a733c04608cc94592a15d27583529588e19db552Greg Clayton void 217b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetGroupID (uint32_t gid) 218a733c04608cc94592a15d27583529588e19db552Greg Clayton { 219b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid = gid; 220a733c04608cc94592a15d27583529588e19db552Greg Clayton } 221b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 222e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ArchSpec & 223e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () 224e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 225e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 226e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 227b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 228e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec & 229e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () const 230e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 231e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 232e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 233b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 234e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 235e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessID () const 236e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 237e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_pid; 238e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 239e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 240e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 241e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetProcessID (lldb::pid_t pid) 242e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 243e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = pid; 244e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 245e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 246a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 247a733c04608cc94592a15d27583529588e19db552Greg Clayton ProcessIDIsValid() const 248a733c04608cc94592a15d27583529588e19db552Greg Clayton { 249a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_pid != LLDB_INVALID_PROCESS_ID; 250a733c04608cc94592a15d27583529588e19db552Greg Clayton } 251b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 252b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 253b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Dump (Stream &s, Platform *platform) const; 254b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 255b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 256b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () 257b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 258b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 259b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 260b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 261b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 262b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () const 263b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 264b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 265b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 266b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 267b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 26836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetArguments (const Args& args, 26936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable, 27036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable_and_argument); 271b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 27236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 27336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetArguments (char const **argv, 27436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable, 27536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable_and_argument); 27636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 277b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 278b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () 279b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 280b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 281b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 282b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 283b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 284b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () const 285b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 286b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 287b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 288b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 289b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 290b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileSpec m_executable; 291b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_arguments; 292b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_environment; 293b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_uid; 294b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_gid; 295b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ArchSpec m_arch; 296b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_pid; 297b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 298b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 299b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 300b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfo 301b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 302b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes an existing process and any discoverable information that 303b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// pertains to that process. 304b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 305b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfo : public ProcessInfo 306b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 307b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 308b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo () : 309b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (), 310b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 311b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 312b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 313b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 314b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 315b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 316b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo (const char *name, 317b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ArchSpec &arch, 318b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t pid) : 319b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (name, arch, pid), 320b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 321b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 322b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 323b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 324b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 325b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 326b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 327b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 328b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 329b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 330b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = UINT32_MAX; 331b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = UINT32_MAX; 332b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid = LLDB_INVALID_PROCESS_ID; 333b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 334b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 335b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 336b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveUserID() const 337b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 338b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid; 339b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 340b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 341b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 342b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveGroupID() const 343b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 344b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid; 345b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 346b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 347b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 348b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveUserIDIsValid () const 349b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 350b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid != UINT32_MAX; 351b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 352b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 353b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 354b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveGroupIDIsValid () const 355b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 356b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid != UINT32_MAX; 357b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 358b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 359b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 360b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveUserID (uint32_t uid) 361b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 362b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = uid; 363b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 364b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 365b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 366b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveGroupID (uint32_t gid) 367b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 368b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = gid; 369b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 370a733c04608cc94592a15d27583529588e19db552Greg Clayton 371a733c04608cc94592a15d27583529588e19db552Greg Clayton lldb::pid_t 372a733c04608cc94592a15d27583529588e19db552Greg Clayton GetParentProcessID () const 373a733c04608cc94592a15d27583529588e19db552Greg Clayton { 374a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid; 375a733c04608cc94592a15d27583529588e19db552Greg Clayton } 376a733c04608cc94592a15d27583529588e19db552Greg Clayton 377a733c04608cc94592a15d27583529588e19db552Greg Clayton void 378a733c04608cc94592a15d27583529588e19db552Greg Clayton SetParentProcessID (lldb::pid_t pid) 379a733c04608cc94592a15d27583529588e19db552Greg Clayton { 380a733c04608cc94592a15d27583529588e19db552Greg Clayton m_parent_pid = pid; 381a733c04608cc94592a15d27583529588e19db552Greg Clayton } 382a733c04608cc94592a15d27583529588e19db552Greg Clayton 383a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 384a733c04608cc94592a15d27583529588e19db552Greg Clayton ParentProcessIDIsValid() const 385a733c04608cc94592a15d27583529588e19db552Greg Clayton { 386a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid != LLDB_INVALID_PROCESS_ID; 387a733c04608cc94592a15d27583529588e19db552Greg Clayton } 38824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 38924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 39024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Dump (Stream &s, Platform *platform) const; 39124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 39224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton static void 393b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose); 394b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 395b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 396b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const; 397b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 398b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 399b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_euid; 400b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_egid; 401b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_parent_pid; 402b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 4031c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 404b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 405b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 406b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessLaunchInfo 407b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 408b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes any information that is required to launch a process. 409b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 410b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 411b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchInfo : public ProcessInfo 412b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 413b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 414b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 415b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton class FileAction 416b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 417b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton public: 41836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton enum Action 41936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 42036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionNone, 42136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionClose, 42236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionDuplicate, 42336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionOpen 42436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton }; 42536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 426b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 427b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction () : 428b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action (eFileActionNone), 429b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd (-1), 430b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg (-1), 431b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path () 432b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 433b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 434b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 435b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 436b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear() 437b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 438b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action = eFileActionNone; 439b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd = -1; 440b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg = -1; 441b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path.clear(); 442b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 443b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 444b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 445b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Close (int fd); 446b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 447b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 448b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Duplicate (int fd, int dup_fd); 449b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 450b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 451b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Open (int fd, const char *path, bool read, bool write); 452b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 453b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static bool 454b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AddPosixSpawnFileAction (posix_spawn_file_actions_t *file_actions, 455b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction *info, 456b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Log *log, 457b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error& error); 458b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 45936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 46036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFD () const 461b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 46236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_fd; 46336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 46436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 46536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Action 46636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetAction () const 46736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 46836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_action; 46936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 47236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetActionArgument () const 47336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 47436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_arg; 47536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char * 47836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetPath () const 47936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 48036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_path.empty()) 48136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 48236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_path.c_str(); 48336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 484b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 48536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton protected: 486b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Action m_action; // The action for this file 487b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_fd; // An existing file descriptor 488b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_arg; // oflag for eFileActionOpen*, dup_fd for eFileActionDuplicate 489b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_path; // A file path to use for opening after fork or posix_spawn 490b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton }; 491b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 492b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo () : 493b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo(), 494ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_working_dir (), 495ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_plugin_name (), 496ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_shell (), 497ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_flags (0), 498ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_file_actions (), 499ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_resume_count (0), 500ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback (NULL), 501ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback_baton (NULL), 502ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_signals (false) 503b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 504b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 505b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 50636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo (const char *stdin_path, 50736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stdout_path, 50836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stderr_path, 50936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *working_directory, 51036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton uint32_t launch_flags) : 51136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessInfo(), 5121c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_working_dir (), 5131c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_plugin_name (), 5141c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_shell (), 5151c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_flags (launch_flags), 5161c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_file_actions (), 5171c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_resume_count (0), 5181c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback (NULL), 5191c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton (NULL), 5201c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals (false) 52136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stderr_path) 52336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 52536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 52636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 52736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDERR_FILENO, stderr_path, read, write)) 52836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 52936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 53036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdout_path) 53136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 53236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 53336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = false; 53436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 53536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDOUT_FILENO, stdout_path, read, write)) 53636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 53736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 53836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdin_path) 53936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 54036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 54136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 54236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = false; 54336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDIN_FILENO, stdin_path, read, write)) 54436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 54536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 54636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (working_directory) 54736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetWorkingDirectory(working_directory); 54836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 549abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 550b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 551b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (const FileAction &info) 552b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 553b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.push_back(info); 554b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 555b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 556abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 557b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendCloseFileAction (int fd) 558b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 559b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 560abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Close (fd)) 561abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 562abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 563abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 564abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 565abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 566b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 567b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 568abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 569b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendDuplciateFileAction (int fd, int dup_fd) 570b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 571b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 572abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Duplicate (fd, dup_fd)) 573abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 574abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 575abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 576abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 577abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 578b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 579b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 580abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 581b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendOpenFileAction (int fd, const char *path, bool read, bool write) 582b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 583b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 584abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, path, read, write)) 585abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 586abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 587abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 588abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 589abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 590b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 591b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 592abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 593b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendSuppressFileAction (int fd, bool read, bool write) 594b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 595b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 596abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, "/dev/null", read, write)) 597abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 598abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 599abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 600abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 601abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 602b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 603abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 604abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton void 605527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton FinalizeFileActions (Target *target); 606b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 607b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 608b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetNumFileActions () const 609b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 610b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_file_actions.size(); 611b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 612b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 613b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction * 614b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFileActionAtIndex (size_t idx) const 615b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 616b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (idx < m_file_actions.size()) 617b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return &m_file_actions[idx]; 618b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 619b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 620b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 62136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const FileAction * 62236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFileActionForFD (int fd) const 62336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 62436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton for (uint32_t idx=0, count=m_file_actions.size(); idx < count; ++idx) 62536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 62636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_file_actions[idx].GetFD () == fd) 62736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return &m_file_actions[idx]; 62836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 62936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 63036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 63136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 632b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags & 633b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () 634b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 635b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 636b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 637b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 638b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Flags & 639b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () const 640b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 641b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 642b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 643b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 644b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 645b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetWorkingDirectory () const 646b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 647b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_working_dir.empty()) 648b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 649b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_working_dir.c_str(); 650b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 65124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 65224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 653b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetWorkingDirectory (const char *working_dir) 654b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 655b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (working_dir && working_dir[0]) 656b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.assign (working_dir); 657b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 658b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 659b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 660ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 661b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 662b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SwapWorkingDirectory (std::string &working_dir) 663ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 664b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.swap (working_dir); 665b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 666b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 667b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 668b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 669b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetProcessPluginName () const 670b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 671b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_plugin_name.empty()) 672b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 673b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_plugin_name.c_str(); 674b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 675b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 676b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 677b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetProcessPluginName (const char *plugin) 678b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 679b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (plugin && plugin[0]) 680b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.assign (plugin); 681b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 682b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 683ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 684ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 685527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 686527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetShell () const 687527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 688527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_shell.empty()) 689527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 690527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_shell.c_str(); 691527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 692527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 693527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 694527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetShell (const char * path) 695527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 696527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (path && path[0]) 697527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 698527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.assign (path); 699527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Set (lldb::eLaunchFlagLaunchInShell); 700527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 701527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 702527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 703527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 704527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Clear (lldb::eLaunchFlagLaunchInShell); 705527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 706527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 707527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 708527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 709527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 710527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 711527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 712527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 713527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 714527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 715527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 716527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 717527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 718527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 719527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 720b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 721b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 722ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 723b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 724b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 725b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 726527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 727b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_flags.Clear(); 728b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.clear(); 729527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 730ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 731a733c04608cc94592a15d27583529588e19db552Greg Clayton 732527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 733527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ConvertArgumentsForLaunchingInShell (Error &error, bool localhost); 734527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 7351c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void 7361c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton SetMonitorProcessCallback (Host::MonitorChildProcessCallback callback, 7371c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *baton, 7381c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool monitor_signals) 7391c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7401c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback = callback; 7411c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton = baton; 7421c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals = monitor_signals; 7431c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7441c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 7451c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool 7461c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton MonitorProcess () const 7471c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7481c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton if (m_monitor_callback && ProcessIDIsValid()) 7491c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7501c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::StartMonitoringChildProcess (m_monitor_callback, 7511c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton, 7521c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton GetProcessID(), 7531c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals); 7541c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return true; 7551c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7561c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return false; 7571c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7581c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 7591c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 760e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 761b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_working_dir; 762b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_plugin_name; 763527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_shell; 764b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags m_flags; // Bitwise OR of bits from lldb::LaunchFlags 765b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::vector<FileAction> m_file_actions; // File actions for any other files 766527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 7671c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::MonitorChildProcessCallback m_monitor_callback; 7681c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *m_monitor_callback_baton; 7691c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool m_monitor_signals; 770527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton}; 771527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 772527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 773527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// ProcessLaunchInfo 774527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// 775527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// Describes any information that is required to launch a process. 776527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 777527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 778527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonclass ProcessAttachInfo : public ProcessInstanceInfo 779527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton{ 780527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonpublic: 781527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo() : 782527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 783527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 784527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 785527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch (false) 786527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 787527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 788527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 789527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo (const ProcessLaunchInfo &launch_info) : 790527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 791527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 792527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 793527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch (false) 794527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 795527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfo::operator= (launch_info); 796527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (launch_info.GetProcessPluginName()); 797527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (launch_info.GetResumeCount()); 798527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 799527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 800527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 801527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetWaitForLaunch () const 802527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 803527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_wait_for_launch; 804527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 805527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 806527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 807527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetWaitForLaunch (bool b) 808527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 809527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = b; 810527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 811527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 812527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 813527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 814527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 815527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 816527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 817527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 818527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 819527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 820527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 821527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 822527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 823527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 824527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 825527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetProcessPluginName () const 826527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 827527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_plugin_name.empty()) 828527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 829527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_plugin_name.c_str(); 830527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 831527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 832527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 833527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (const char *plugin) 834527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 835527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (plugin && plugin[0]) 836527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.assign (plugin); 837527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 838527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 839527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 840527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 841527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 842527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Clear () 843527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 844527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo::Clear(); 845527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 846527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 847527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = false; 848527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 849527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 850527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 851527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfoSpecified () const 852527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 853527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetExecutableFile()) 854527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 855527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetProcessID() != LLDB_INVALID_PROCESS_ID) 856527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 857527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetParentProcessID() != LLDB_INVALID_PROCESS_ID) 858527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 859527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return false; 860527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 861527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonprotected: 862527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_plugin_name; 863527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 864527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool m_wait_for_launch; 865e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 866e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 867b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchCommandOptions : public Options 86824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton{ 86924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonpublic: 870b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 871b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchCommandOptions (CommandInterpreter &interpreter) : 872b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Options(interpreter) 873b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 874143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton // Keep default values of all options in one place: OptionParsingStarting () 875143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting (); 876b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 877b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 878b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ~ProcessLaunchCommandOptions () 879b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 880b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 881b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 882b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error 883143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton SetOptionValue (uint32_t option_idx, const char *option_arg); 884b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 885b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 886143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting () 887b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 888b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton launch_info.Clear(); 889b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 890b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 891b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const OptionDefinition* 892b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetDefinitions () 893b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 894b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return g_option_table; 895b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 896b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 897b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Options table: Required for subclasses of Options. 898b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 899b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static OptionDefinition g_option_table[]; 900b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 901b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Instance variables to hold the values for command options. 902b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 903b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo launch_info; 904b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 905b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 906b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 907b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfoMatch 908b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 909b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A class to help matching one ProcessInstanceInfo to another. 910b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 911b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 912b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoMatch 913b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 914b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 915b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch () : 91624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 91724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (lldb_private::eNameMatchIgnore), 91824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 91924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 92024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 92124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 922b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch (const char *process_name, 923527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton lldb_private::NameMatchType process_name_match_type) : 92424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 92524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (process_name_match_type), 92624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 92724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 928527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_match_info.GetExecutableFile().SetFile(process_name, false); 92924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 93024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 931b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo & 93224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () 93324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 93424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 93524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 93624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 937b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 93824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () const 93924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 94024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 94124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 94224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 94324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 94424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetMatchAllUsers () const 94524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 94624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_all_users; 94724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 94824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 94924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 95024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetMatchAllUsers (bool b) 95124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 95224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users = b; 95324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 95424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 95524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType 95624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetNameMatchType () const 95724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 95824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_name_match_type; 95924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 96024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 96124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 96224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetNameMatchType (lldb_private::NameMatchType name_match_type) 96324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 96424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type = name_match_type; 96524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 96624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 96724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 96824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton NameMatches (const char *process_name) const; 96924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 97024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 971b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Matches (const ProcessInstanceInfo &proc_info) const; 97224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 97324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 97424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton MatchAllProcesses () const; 97524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 97624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Clear (); 97724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 97824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonprotected: 979b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo m_match_info; 98024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType m_name_match_type; 98124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool m_match_all_users; 98224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton}; 98324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 984b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoList 985e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 986e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 987b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoList () : 988e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos() 989e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 990e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 991e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 992e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 993e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear() 994e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 995e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.clear(); 996e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 997e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 998e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton uint32_t 999e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetSize() 1000e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1001e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos.size(); 1002e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1003e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1004e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1005b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Append (const ProcessInstanceInfo &info) 1006e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1007e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.push_back (info); 1008e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1009e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1010e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 1011e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameAtIndex (uint32_t idx) 1012e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1013e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1014e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetName(); 1015e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return NULL; 1016e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1017e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1018e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 1019e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameLengthAtIndex (uint32_t idx) 1020e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1021e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1022e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetNameLength(); 1023e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return 0; 1024e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1025e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1026e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 1027e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessIDAtIndex (uint32_t idx) 1028e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1029e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1030e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetProcessID(); 10312bc9eb3ba78efc64a273729b480bafc3bbaa433aJohnny Chen return 0; 1032e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1033e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1034e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton bool 1035b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetInfoAtIndex (uint32_t idx, ProcessInstanceInfo &info) 1036e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1037e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1038e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1039e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton info = m_infos[idx]; 1040e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return true; 1041e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1042e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return false; 1043e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1044e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 104524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton // You must ensure "idx" is valid before calling this function 1046b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 104724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfoAtIndex (uint32_t idx) const 104824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 104924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton assert (idx < m_infos.size()); 105024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_infos[idx]; 105124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 105224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1053e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 1054b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton typedef std::vector<ProcessInstanceInfo> collection; 1055e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton collection m_infos; 1056e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 1057e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 10586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 105921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// This class tracks the Modification state of the process. Things that can currently modify 106021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// the program are running the program (which will up the StopID) and writing memory (which 106121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// will up the MemoryID.) 106221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// FIXME: Should we also include modification of register states? 106321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 106421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamclass ProcessModID 106521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 106621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend bool operator== (const ProcessModID &lhs, const ProcessModID &rhs); 106721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghampublic: 106821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID () : 10690296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id (0), 10700296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id (0), 10710296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_memory_id (0), 10720296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume (0), 10730296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression (false) 107421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 107521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 107621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID (const ProcessModID &rhs) : 107721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id (rhs.m_stop_id), 107821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id (rhs.m_memory_id) 107921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 108021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 108121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham const ProcessModID & operator= (const ProcessModID &rhs) 108221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 108321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (this != &rhs) 108421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 108521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = rhs.m_stop_id; 108621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id = rhs.m_memory_id; 108721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 108821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return *this; 108921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 109021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 109121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ~ProcessModID () {} 109221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 10930296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpStopID () { 10940296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id++; 10950296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 10960296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 109721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void BumpMemoryID () { m_memory_id++; } 109821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 10990296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpResumeID () { 11000296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id++; 11010296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (m_running_user_expression > 0) 11020296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume = m_resume_id; 11030296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11040296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 110521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetStopID() const { return m_stop_id; } 110621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetMemoryID () const { return m_memory_id; } 11070296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetResumeID () const { return m_resume_id; } 11080296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetLastUserExpressionResumeID () const { return m_last_user_expression_resume; } 110921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 111021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool MemoryIDEqual (const ProcessModID &compare) const 111121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 111221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_memory_id == compare.m_memory_id; 111321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 111421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 111521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool StopIDEqual (const ProcessModID &compare) const 111621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 111721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id == compare.m_stop_id; 111821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 111921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 112021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void SetInvalid () 112121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 112221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = UINT32_MAX; 112321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 112421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 112521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool IsValid () const 112621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 112721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id != UINT32_MAX; 112821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 11290296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 11300296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 11310296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on) 11320296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 11330296fe73a7cb1482226b1303a795ede00e12d677Jim 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); 11340296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (on) 11350296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression++; 11360296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham else 11370296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression--; 11380296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11390296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 114021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamprivate: 114121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_stop_id; 11420296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_resume_id; 114321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_memory_id; 11440296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_last_user_expression_resume; 11450296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_running_user_expression; 114621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham}; 114721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator== (const ProcessModID &lhs, const ProcessModID &rhs) 114821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 114921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (lhs.StopIDEqual (rhs) 115021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham && lhs.MemoryIDEqual (rhs)) 115121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 115221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 115321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 115421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 115521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 115621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator!= (const ProcessModID &lhs, const ProcessModID &rhs) 115721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 115821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (!lhs.StopIDEqual (rhs) 115921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham || !lhs.MemoryIDEqual (rhs)) 116021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 116121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 116221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 116321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 116421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 116524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 116624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 116724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 116824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 116924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 1170567e7f3ba16eb48cb9fd6a2f26f2f7269eb6983cGreg Clayton public ReferenceCountedBaseVirtual<Process>, 117124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 117224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 117324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 11746e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public PluginInterface, 11756e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public ProcessInstanceSettings 117624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 117724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 1178d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Inghamfriend class ClangFunction; // For WaitForStateChangeEventsPrivate 117921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectProcessLaunch; 118021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class ProcessEventData; 118121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectBreakpointCommand; 118221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class StopInfo; 118324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 118424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 118524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 118624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 118824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 119024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 119124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 119224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 119324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 1194e28824e0b988221c7eedf8e3d212527d2bdac6a7Eli Friedman eBroadcastBitSTDERR = (1 << 3) 119524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 119624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 119724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 119824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 119924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 120024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 120124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 120224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 1203360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 120424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 120524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 120624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 120724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 120924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 121024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 121124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 121224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 121324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 121424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 121524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 121624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 121724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 121824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 122024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 122124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 12223ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham friend class Process; 12233ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 122424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 122524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 122624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 122724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 122824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 122924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 123024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 123124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 123224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 123324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 123424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 123524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 123624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 12373ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetProcessSP() const 12383ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 12393ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_process_sp; 12403ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 124124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 12423ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetState() const 12433ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 12443ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_state; 12453ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 124624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 12473ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetRestarted () const 12483ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 12493ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_restarted; 12503ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 12513ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool 12523ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterrupted () const 12533ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 12543ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_interrupted; 12553ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 125624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 125724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 125824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 125924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 126124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 126224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 126424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 126524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 126724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 126824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 127024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 127124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 127324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 127424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 127624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 127724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 127824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 12793ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterruptedFromEvent (const Event *event_ptr); 12803ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 12813ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static void 12823ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterruptedInEvent (Event *event_ptr, bool new_value); 12833ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 12843ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static bool 128524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 128624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 128724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 128824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 128924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 12903ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetUpdateStateOnRemoval() 12913ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 12926cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham m_update_state++; 12933ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 129424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 12953ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetRestarted (bool new_value) 12963ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 12973ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_restarted = new_value; 12983ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 12993ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham void 13003ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterrupted (bool new_value) 13013ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13023ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_interrupted = new_value; 13033ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 130424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 130524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 130624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 130724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 13086cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham int m_update_state; 13093ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool m_interrupted; 131024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 131124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 13136e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1314d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton class SettingsController : public UserSettingsController 13156e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice { 13166e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public: 13176e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1318d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton SettingsController (); 13196e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 13206e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 1321d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton ~SettingsController (); 13226e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 13236e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry global_settings_table[]; 13246e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry instance_settings_table[]; 13256e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 13266e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice protected: 13276e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 13286e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice lldb::InstanceSettingsSP 1329d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton CreateInstanceSettings (const char *instance_name); 13306e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 13316e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice private: 13326e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 13336e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice // Class-wide settings. 13346e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1335d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton DISALLOW_COPY_AND_ASSIGN (SettingsController); 13366e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice }; 13376e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 133821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 133924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 134024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1341990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 13422a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsInitialize (); 1343990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1344990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 13452a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsTerminate (); 1346990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1347990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static lldb::UserSettingsControllerSP & 1348990de7bb41d3afec6b789155408ff322187d8682Greg Clayton GetSettingsController (); 13496e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 13501ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice void 13511ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice UpdateInstanceName (); 13521ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice 1353395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 135424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 135524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 135624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 135724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 135824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 136024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 136124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 136224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 136324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 136424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 136524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 136624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 136724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 136824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 136924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 137024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 137124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 137224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 137324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 137424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 137524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 137624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 137724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 137824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 137924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 138024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 138124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 138224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 138324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 138424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 138524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 138624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static Process* 138724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner FindPlugin (Target &target, const char *plugin_name, Listener &listener); 138824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 139224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 139324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 139424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 139524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 139624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 139724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 139824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 139924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 140024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 140124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 140224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 140324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 140424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 140524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 140624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 140724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 14081c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool exited, 140924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 141024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 141124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1412395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton lldb::ByteOrder 1413395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetByteOrder () const; 1414395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 1415395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton uint32_t 1416395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetAddressByteSize () const; 1417395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 141824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 141924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 142024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1421fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 142224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 142324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 142424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 142524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 142624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 142724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 142824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 142924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 14308d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton CanDebug (Target &target, 14318d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton bool plugin_specified_by_name) = 0; 143224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 143324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 143424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 143524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 143624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 143824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 143924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 144024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 144124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 144224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 144324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 144424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 144524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 144624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 144724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 144824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 144924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 145024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 145124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 145224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 145324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 145424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 145524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 145624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 145724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 145824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 145924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 146024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 146224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 146324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 146524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 146624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1467452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1468452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1469452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 147024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 147124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 147224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 147324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 147424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 147624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 147724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 148024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 148124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 148224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 148324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1485de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1486de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1487de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 148824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 148924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 149024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 149124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 149224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 149336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Launch (const ProcessLaunchInfo &launch_info); 149424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 1496527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// Attach to an existing process using the process attach info. 149724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 149824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 1499527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// subclasses. It will first call WillAttach (lldb::pid_t) 1500527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// or WillAttach (const char *), and if that returns \b 1501527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// true, DoAttach (lldb::pid_t) or DoAttach (const char *) will 150224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 150324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 150424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 150624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 150724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 150924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 151024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 151124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 1513527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Attach (ProcessAttachInfo &attach_info); 151424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1515e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1516e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton ConnectRemote (const char *remote_url); 15177508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1518dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool 1519ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton GetShouldDetach () const 1520dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham { 1521ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton return m_should_detach; 1522dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham } 1523ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 1524ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton void 1525ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton SetShouldDetach (bool b) 1526ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton { 1527ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_should_detach = b; 1528ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton } 1529ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 15307508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 153124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 153224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 153324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 153424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 153524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 153624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 153724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 153824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 153924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 154124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 154224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 154524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 154624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 154724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 154824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15490baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Load a shared library into this process. 15500baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 15510baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Try and load a shared library into the current process. This 15520baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// call might fail in the dynamic loader plug-in says it isn't safe 15530baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// to try and load shared libraries at the moment. 15540baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 15550baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[in] image_spec 15560baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// The image file spec that points to the shared library that 15570baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// you want to load. 15580baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 15590baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[out] error 15600baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// An error object that gets filled in with any errors that 15610baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// might occur when trying to load the shared library. 15620baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 15630baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @return 15640baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// A token that represents the shared library that can be 15650baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// later used to unload the shared library. A value of 15660baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// LLDB_INVALID_IMAGE_TOKEN will be returned if the shared 15670baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// library can't be opened. 15680baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 15690baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual uint32_t 15700baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton LoadImage (const FileSpec &image_spec, Error &error); 15710baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 15720baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual Error 15730baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton UnloadImage (uint32_t image_token); 15740baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 15750baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 157724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 157924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 158024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 158124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 158224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 158324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 158424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 158624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 158724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 158824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 158924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 159024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 159124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 159224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 159324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 159424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 159524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 159624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 159724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 159824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 159924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 160024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 160224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 160324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 160624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 160724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 160824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 160924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 161024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 161124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 161224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 161324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 161424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 161524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 161624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 161724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 161824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 161924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 162024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 162124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 162224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 162324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 162424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 162524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 162624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 162724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 162824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 162924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 163024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 163124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 163224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 163324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 163424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 163524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 16363ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 163724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Resume (); 163824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 164324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 16443ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// If the process is successfully halted, a eStateStopped 16453ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// process event with GetInterrupted will be broadcast. If false, we will 16463ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// halt the process with no events generated by the halt. 164724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 16493ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// Returns an error object. If the error is empty, the process is halted. 16503ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// otherwise the halt has failed. 165124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 16523ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 165324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 165424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 165524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 165624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 165724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 165824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 165924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 166024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 166124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 166224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 166324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 16643ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 166524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 166624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 166724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 166824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 166924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 167024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 167124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 167224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 167324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 167424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 167524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 167624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 16773ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 167824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 167924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 168024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 168224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 168324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 168424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 168524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 168624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 168724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 168824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 16893ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 169024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 169124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 169224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 1693395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetUnixSignals () 1694395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1695395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_unix_signals; 1696395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 169724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 169824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 169924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 170024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 170124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 170224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 170324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 170424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 170524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 170624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 170724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 170824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 170924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 171024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 171124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 171254e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 171324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 171424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 171524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 171624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 171724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 171824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 171924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 172124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 172224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 172424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 172524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 172624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 172754e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 172824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 172924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 173024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 173124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1732e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1733e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton DoConnectRemote (const char *remote_url) 1734e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton { 1735e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton Error error; 1736e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton error.SetErrorString ("remote connections are not supported"); 1737e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton return error; 1738e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton } 1739e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton 174024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 174124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 174224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 174424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 174524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 174724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 174824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 174924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 175024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 175154e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithID (lldb::pid_t pid) = 0; 175224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 175324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 175424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 175524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 175724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 175824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 175924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 176024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 176124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 176224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 176324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 176424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 176524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 176624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 176724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 176824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 176954e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithName (const char *process_name, bool wait_for_launch) 177024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 177124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 177224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 177324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 177424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 177524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 177624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 177724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 177824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 177924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 178024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 178124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 178224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 178324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 178424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 178524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 178624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 178724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 178824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 178924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 179024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 179124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 179224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 179324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 179424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 179524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 179624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 179724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 179824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 179924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 180024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 180124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 180324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 180424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 180524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 180624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 180724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 180824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 180924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 181124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 181224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 181324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 181524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 181624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 181824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 181924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1820452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1821452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1822452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 182324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 182424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 182524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 182624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 182724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 182824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 182924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 183024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 183124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 183224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 183324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 183424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 183524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 183624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 183724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1838de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1839de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1840de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 184124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 184224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 184324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 184424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 184524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 184636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton DoLaunch (Module *exe_module, 184736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const ProcessLaunchInfo &launch_info) = 0; 184824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 185024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 185124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 185224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 185324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 185424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 185524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 185624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 185724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 186024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 186224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 186424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 186524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 186724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 186824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 187024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 187124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 187224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 187424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 187524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 187724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 187824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 187924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 188024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 188224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 188324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 188424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 188524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 188624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 188724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 188824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 188924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 189024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoResume () = 0; 189124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 189224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 189424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 189524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 189624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 189724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 189924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 190024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 190124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 190224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 190324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 190424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 190624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 190724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 190924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 191024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 191124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 191224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 191324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 191424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 191524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 191624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1917360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt must produce one and only one stop StateChanged event if it actually 1918360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// stops the process. If the stop happens through some natural event (for 1919360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// instance a SIGSTOP), then forwarding that event will do. Otherwise, you must 1920360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// generate the event manually. Note also, the private event thread is stopped when 1921360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt is run to prevent the events generated while halting to trigger 1922360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// other state changes before the halt is complete. 19233ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 19243ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// @param[out] caused_stop 192520d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// If true, then this Halt caused the stop, otherwise, the 192620d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// process was already stopped. 19273ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 192824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 192924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 193024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 193124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 193224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 19333ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham DoHalt (bool &caused_stop) = 0; 193424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 193524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 193624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 193724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 193824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 193924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 194024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 194124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 194224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 194324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 194424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 194524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 194624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 194724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 194824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 194924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 195024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 195124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 195224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 195324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 195424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 195524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 195624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 195724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 195824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 196124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 196224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 196324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 196424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 196524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 196724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDetach () = 0; 196824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 196924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 197024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 197124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 197224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 197324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 197424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 197524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 197624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 197724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 197924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 198024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 198124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 198224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 198324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 198424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 198524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 198624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 198724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 198824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 199024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 199124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 199224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 199324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 199424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 199524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 199624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 199724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 199824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 199924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoSignal (int signal) = 0; 200024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 200424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 200524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 200724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 200824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 200924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 201024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 201124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 201224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 201324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 201424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 201524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 201624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 201724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 201824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 201924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 202024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 202124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 202224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 202324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 202424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 202524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 202624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 202724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 202824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 202924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 203024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 203124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 203224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 203324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 203424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 203524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 203724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 203824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 203924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 204124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 204324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 204424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 204524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 2047395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () 2048395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2049395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2050395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 205124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 205324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 205424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 205624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 205724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 205824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 205924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 2060395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () const 2061395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2062395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2063395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 2064395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 206524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 206624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 206724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 206824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 206924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 207024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 207124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 207224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 207324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 207424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 207524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 2076360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2077b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResults 2078360f53f3c216ee4fb433da0a367168785328a856Jim Ingham RunThreadPlan (ExecutionContext &exe_ctx, 2079360f53f3c216ee4fb433da0a367168785328a856Jim Ingham lldb::ThreadPlanSP &thread_plan_sp, 2080360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool stop_others, 2081360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool try_all_threads, 2082360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool discard_on_error, 2083360f53f3c216ee4fb433da0a367168785328a856Jim Ingham uint32_t single_thread_timeout_usec, 2084360f53f3c216ee4fb433da0a367168785328a856Jim Ingham Stream &errors); 2085360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2086360f53f3c216ee4fb433da0a367168785328a856Jim Ingham static const char * 2087b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResultAsCString (ExecutionResults result); 208824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2089abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton void 2090abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetStatus (Stream &ostrm); 2091abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 2092abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton size_t 2093abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetThreadStatus (Stream &ostrm, 2094abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton bool only_threads_with_stop_reason, 2095abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t start_frame, 2096abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames, 2097abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames_with_source); 2098abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 209924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 210024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 210224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 210324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 210524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 210624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210775c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 210875c703dd8b492bad25a987b96853626641ae7246Greg Clayton // Called internally 210975c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 211075c703dd8b492bad25a987b96853626641ae7246Greg Clayton void 211175c703dd8b492bad25a987b96853626641ae7246Greg Clayton CompleteAttach (); 211275c703dd8b492bad25a987b96853626641ae7246Greg Clayton 211324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 211424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 211524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 211624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 211724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 211824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 211924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 212024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 212124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 212224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 212324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 212424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 212524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 212624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 212724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 212824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 212924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 213024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 213124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 213224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 213324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 213424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 213524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 213624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 213724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 213824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 213924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 214024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 214121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// Get the Modification ID of the process. 214224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 214324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 214421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// The modification ID of the process. 214524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 214621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID 214721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetModID () const 214821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 214921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id; 215021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 215121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 21520296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham const ProcessModID & 21530296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetModIDRef () const 21540296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 21550296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id; 21560296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 21570296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 215824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 215921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetStopID () const 216021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 216121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id.GetStopID(); 216221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 216321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 21640296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 21650296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetResumeID () const 21660296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 21670296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetResumeID(); 21680296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 21690296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 21700296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 21710296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetLastUserExpressionResumeID () const 21720296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 21730296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetLastUserExpressionResumeID(); 21740296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 21750296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 217624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 217724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 217824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 217924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 218024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 218124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 218224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 218324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 218424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 218524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 218624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 218724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 218824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 218924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 219024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 219124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 219272e1c782ba1e4226da37af4722af608de9f39408Greg Clayton virtual bool 219324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 219424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 219524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 219624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 219724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 219824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 219924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 220024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 220124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 220224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 220324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 220424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 220524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 220624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 220724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 220824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 220924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 221024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 221124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 221224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 221324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 221424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 221524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 221624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 221724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 221824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 221924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 222024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 222124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 222224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 222324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 222424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 222524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 222624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 222724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 222824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 222924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 223024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 223124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 223224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 223324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 223424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 223524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 223624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 223724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 223824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 223924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 224124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 224224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 224324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 224524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 224624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 224724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 224924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 225024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 225124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 225224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 225324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 225424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 225524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 225624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 225724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 225824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 225924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 226024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 226124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 226224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 226324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 226424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 226524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 226624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 226724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2268b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2269b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// Read a NULL terminated C string from memory 2270b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// 2271b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// This function will read a cache page at a time until the NULL 2272b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// C stirng terminator is found. It will stop reading if the NULL 2273b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// termination byte isn't found before reading \a cstr_max_len 2274b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// bytes, and the results are always guaranteed to be NULL 2275b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// terminated (at most cstr_max_len - 1 bytes will be read). 2276b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2277b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 2278b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2279b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton char *cstr, 2280b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t cstr_max_len); 2281b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2282fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 2283fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ReadMemoryFromInferior (lldb::addr_t vm_addr, 2284fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *buf, 2285fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t size, 2286fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 2287fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 22886d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 22896d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// Reads an unsigned integer of the specified byte size from 22906d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// process memory. 22916d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 22926d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] load_addr 22936d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// A load address of the integer to read. 22946d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 22956d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] byte_size 22966d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The size in byte of the integer to read. 22976d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 2298c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] fail_value 2299c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value to return if we fail to read an integer. 2300c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 23016d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[out] error 23026d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// An error that indicates the success or failure of this 23036d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// operation. If error indicates success (error.Success()), 23046d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// then the value returned can be trusted, otherwise zero 23056d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// will be returned. 23066d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 23076d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @return 23086d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The unsigned integer that was read from the process memory 23096d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// space. If the integer was smaller than a uint64_t, any 23106d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// unused upper bytes will be zero filled. If the process 23116d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// byte order differs from the host byte order, the integer 23126d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// value will be appropriately byte swapped into host byte 23136d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// order. 23146d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 2315f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton uint64_t 2316c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadUnsignedIntegerFromMemory (lldb::addr_t load_addr, 2317c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t byte_size, 2318c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint64_t fail_value, 2319c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2320c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2321c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t 2322c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadPointerFromMemory (lldb::addr_t vm_addr, 2323c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2324c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2325c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool 2326c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WritePointerToMemory (lldb::addr_t vm_addr, 2327c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t ptr_value, 2328c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2329c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 233024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 233124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 233224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 233424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 233524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 233624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 233824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 233924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 234024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 234224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 234324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2344c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2345c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2346c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 234724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 234824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 234924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 235124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) = 0; 235224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 235324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2354c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// Write all or part of a scalar value to memory. 2355c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2356c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value contained in \a scalar will be swapped to match the 2357c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// byte order of the process that is being debugged. If \a size is 2358c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// less than the size of scalar, the least significate \a size bytes 2359c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// from scalar will be written. If \a size is larger than the byte 2360c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// size of scalar, then the extra space will be padded with zeros 2361c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// and the scalar value will be placed in the least significant 2362c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// bytes in memory. 2363c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2364c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] vm_addr 2365c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// A virtual load address that indicates where to start writing 2366c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// memory to. 2367c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2368c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] scalar 2369c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The scalar to write to the debugged process. 2370c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2371c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] size 2372c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// This value can be smaller or larger than the scalar value 2373c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// itself. If \a size is smaller than the size of \a scalar, 2374c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the least significant bytes in \a scalar will be used. If 2375c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// \a size is larger than the byte size of \a scalar, then 2376c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the extra space will be padded with zeros. If \a size is 2377c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// set to UINT32_MAX, then the size of \a scalar will be used. 2378c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2379c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2380c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2381c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2382c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @return 2383c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The number of bytes that were actually written. 2384c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 2385c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2386c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WriteScalarToMemory (lldb::addr_t vm_addr, 2387c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton const Scalar &scalar, 2388c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t size, 2389c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2390c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2391c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2392c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadScalarIntegerFromMemory (lldb::addr_t addr, 2393c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t byte_size, 2394c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool is_signed, 2395c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Scalar &scalar, 2396c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2397c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2398c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 239924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 240024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 240224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 240324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 240424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 240624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 240724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 240824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 241024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 241124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 241224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 241324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 241424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 241524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 241624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 241724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 241824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 241924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 242024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 242124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 242224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 242324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 242424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 242524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 242624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 242724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 242824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 242924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 243024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 243124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 243224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 243324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 243424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 243524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 243624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 243724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 243824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 243924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 244024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 244124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 244224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 244324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAllocateMemory (size_t size, uint32_t permissions, Error &error) = 0; 244424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 244524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 244624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 244724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 244824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 244924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 245024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 245124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 245224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 245324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 245424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 245524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 245624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 245724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 245824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 245924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 246024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2461b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// @param[in/out] error 2462b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// An error object to fill in if things go wrong. 246324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 246424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 246524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 246624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 246724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 246924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 247024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 247124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 24726cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Determines whether executing JIT-compiled code in this process 24736cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 24746cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 24756cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @return 24766cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 24776cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 24786cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan bool CanJIT (); 24796cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 24806cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 24816cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Sets whether executing JIT-compiled code in this process 24826cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 24836cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 24846cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @param[in] can_jit 24856cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 24866cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 24876cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan void SetCanJIT (bool can_jit); 24886cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 24896cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 249024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 249124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 249224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 249324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 249424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 249524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 249624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 249724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 249824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 249924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 250024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 250124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 250224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 250424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDeallocateMemory (lldb::addr_t ptr) = 0; 250524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 250724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 250824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 250924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 251024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 251124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 251224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 251324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 251424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 251524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 251624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 251724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 251824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 251924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 252024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 252124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 252224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 252324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 252424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 252524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 252624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 252724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 252824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 252924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 253024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 253124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 253224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 253324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 253424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 253524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 253624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 253724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 253824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 253924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 254024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 254124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 254224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 254324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 254424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 2545bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDOUT (char *buf, size_t buf_size, Error &error); 254624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 254724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 254824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 254924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 255024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 255124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 255224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 255324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 255424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 255524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 255624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 255724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 255824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 255924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 256024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 256124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 256224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 256324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 256424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 256524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 256624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 256724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 256824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 2569bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDERR (char *buf, size_t buf_size, Error &error); 257024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 257124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 257224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 257324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 257424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 257524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 257624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 257724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 257824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 257924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 258024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 2581b1888f24fa181489840b9acf193e224d125d0776Greg Clayton size_t 2582b1888f24fa181489840b9acf193e224d125d0776Greg Clayton GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site); 258324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 258424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 258524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpoint (BreakpointSite *bp_site) = 0; 258624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 258724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 258824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpoint (BreakpointSite *bp_site) = 0; 258924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 259024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 259124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 259224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 259324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 259424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 259524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 259624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 259724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 259824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 259924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 260024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 260124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 260224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 260324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 260424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 260524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 260624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 260724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 260824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 260924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 261024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 261124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 261224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 261324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 261424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 261524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 26163fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 261724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CreateBreakpointSite (lldb::BreakpointLocationSP &owner, 261824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 261924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 262024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 262124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 262224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 262324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 262424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 262524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 262624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 262724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 262824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 262924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 263024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 263124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 263224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 263324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 263424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 263524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 263624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 263724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 263824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 263924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 264024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2641ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen EnableWatchpoint (Watchpoint *wp); 264224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 264324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2644ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen DisableWatchpoint (Watchpoint *wp); 264524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 264624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 264724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 264824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 264924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t 265037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list) = 0; 265137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 265237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton void 265337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadListIfNeeded (); 265424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 265524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 2656395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () 2657395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2658395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 2659395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 266024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 266324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 266424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 266624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 266724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 266824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 266924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 267024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 267124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 267224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessToStop (const TimeValue *timeout); 267324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 267424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 267524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 267624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 267724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 267824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 267963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 268024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2681f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham class 2682f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker 2683f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2684f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham public: 2685f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker (Process &process, Listener *listener) : 2686f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process (process), 2687f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_listener (listener) 2688f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2689f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.HijackProcessEvents (listener); 2690f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 2691f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ~ProcessEventHijacker () 2692f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2693f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.RestoreProcessEvents(); 2694f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 2695f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 2696f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham private: 2697f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Process &m_process; 2698f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Listener *m_listener; 2699f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham }; 2700f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham friend class ProcessEventHijacker; 270124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 270263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// If you need to ensure that you and only you will hear about some public 270363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// event, then make a new listener, set to listen to process events, and 270463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// then call this with that listener. Then you will have to wait on that 270563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// listener explicitly for events (rather than using the GetNextEvent & WaitFor* 270663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// calls above. Be sure to call RestoreProcessEvents when you are done. 270763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 270863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @param[in] listener 270963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// This is the new listener to whom all process events will be delivered. 271063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 271163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @return 271263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Returns \b true if the new listener could be installed, 271363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// \b false otherwise. 271463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 271563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham bool 271663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham HijackProcessEvents (Listener *listener); 271763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 271863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 271963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Restores the process event broadcasting to its normal state. 272063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 272163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 272263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham void 272363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham RestoreProcessEvents (); 272463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 272563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghamprotected: 272663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 272724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 272824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 272924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 273024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 273124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 273224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 273324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 273424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 273524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 273624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 273724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 273824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 273924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 274024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 274124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 274224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 274363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghampublic: 274475906e4ec98af3717e415727a8d663a4e246bb4fGreg Clayton const lldb::ABISP & 274524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 274624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 274775c703dd8b492bad25a987b96853626641ae7246Greg Clayton DynamicLoader * 274875c703dd8b492bad25a987b96853626641ae7246Greg Clayton GetDynamicLoader () 274975c703dd8b492bad25a987b96853626641ae7246Greg Clayton { 275075c703dd8b492bad25a987b96853626641ae7246Greg Clayton return m_dyld_ap.get(); 275175c703dd8b492bad25a987b96853626641ae7246Greg Clayton } 275275c703dd8b492bad25a987b96853626641ae7246Greg Clayton 275337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton OperatingSystem * 275437f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton GetOperatingSystem () 275537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton { 275637f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton return m_os_ap.get(); 275737f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton } 275837f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 275937f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 2760642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual LanguageRuntime * 2761642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetLanguageRuntime (lldb::LanguageType language); 2762642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 2763642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual CPPLanguageRuntime * 2764642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetCPPLanguageRuntime (); 2765642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 2766642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual ObjCLanguageRuntime * 2767642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetObjCLanguageRuntime (); 276824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 276924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 277024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 2771f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 2772f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 2773f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 2774d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham return m_dynamic_checkers_ap.get(); 2775f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 2776f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 2777f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 2778f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 2779d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham m_dynamic_checkers_ap.reset(dynamic_checkers); 2780f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 278124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2782c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 2783c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to set the lldb in the mode where it breaks on new thread 2784c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// creations, and then auto-restarts. This is useful when you are trying 2785c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// to run only one thread, but either that thread or the kernel is creating 2786c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// new threads in the process. If you stop when the thread is created, you 2787c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// can immediately suspend it, and keep executing only the one thread you intend. 2788c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 2789c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 2790c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 2791c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 2792c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 279355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 279455e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StartNoticingNewThreads() 279555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 279655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 279755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 279855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 2799c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 2800c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to turn off the stop & notice new threads mode. 2801c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 2802c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 2803c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 2804c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 2805c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 280655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 280755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StopNoticingNewThreads() 280855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 280955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 281055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 281155e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 28120296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 28130296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on); 28140296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 281524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 281624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 281724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 281824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Target * 2819395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateTarget () 2820395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2821395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return &m_target; 2822395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 282324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Process * 2825395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateProcess () 2826395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2827395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return this; 2828395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 282924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Thread * 2831395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateThread () 2832395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2833395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 2834395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 283524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual StackFrame * 2837395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateStackFrame () 2838395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2839395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 2840395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 284124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 2843a830adbcd63d1995a01e6e18da79893c1426ca43Greg Clayton CalculateExecutionContext (ExecutionContext &exe_ctx); 284424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP 284624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSP (); 284724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 2849c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 285021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // NextEventAction provides a way to register an action on the next 285121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // event that is delivered to this process. There is currently only 285221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // one next event action allowed in the process at one time. If a 285321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // new "NextEventAction" is added while one is already present, the 285421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // old action will be discarded (with HandleBeingUnshipped called 285521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // after it is discarded.) 2856c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 2857c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class NextEventAction 2858c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2859c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 2860c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham typedef enum EventActionResult 2861c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2862c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionSuccess, 2863c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionRetry, 2864c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionExit 2865c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } EventActionResult; 2866c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2867c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction (Process *process) : 2868c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham m_process(process) 28692d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 28702d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 28712d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 28722d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 28732d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~NextEventAction() 28742d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 28752d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 2876c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2877c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp) = 0; 2878c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual void HandleBeingUnshipped () {}; 2879c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted () = 0; 2880c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString() = 0; 2881c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham protected: 2882c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham Process *m_process; 2883c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 2884c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2885c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham void SetNextEventAction (Process::NextEventAction *next_event_action) 2886c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 288768bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham if (m_next_event_action_ap.get()) 288868bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap->HandleBeingUnshipped(); 288968bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham 289068bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap.reset(next_event_action); 2891c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } 2892c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2893c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // This is the completer for Attaching: 2894c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class AttachCompletionHandler : public NextEventAction 2895c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2896c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 28972d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton AttachCompletionHandler (Process *process, uint32_t exec_count) : 28982d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton NextEventAction (process), 28992d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton m_exec_count (exec_count) 29002d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 29012d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 29022d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 29032d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 29042d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~AttachCompletionHandler() 29052d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 29062d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 2907c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2908c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp); 2909c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted (); 2910c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString(); 2911c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham private: 29122d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton uint32_t m_exec_count; 2913c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham std::string m_exit_string; 2914c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 2915c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2916f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham bool 2917f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham HijackPrivateProcessEvents (Listener *listener); 2918f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 2919f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham void 2920f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham RestorePrivateProcessEvents (); 2921a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton 2922a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton bool 2923a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton PrivateStateThreadIsValid () const 2924a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton { 2925a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton return m_private_state_thread != LLDB_INVALID_HOST_THREAD; 2926a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton } 2927fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 292824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 292924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 293024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 293124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 293224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 293324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 293424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 293524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 293624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 293724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 293824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 293921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID m_mod_id; ///< Tracks the state of the process over stops and other alterations. 294024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 294124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 294224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 294324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 294424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 29450baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton std::vector<lldb::addr_t> m_image_tokens; 294624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 294724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend 294824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ///< to insert in the target. 294975c703dd8b492bad25a987b96853626641ae7246Greg Clayton std::auto_ptr<DynamicLoader> m_dyld_ap; 2950d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers_ap; ///< The functions used by the expression parser to validate data that expressions use. 295137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton std::auto_ptr<OperatingSystem> m_os_ap; 295224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 295324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 2954861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderSP m_process_input_reader; 2955861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb_private::Communication m_stdio_communication; 295620d338fad87eba91de65aa9bec76e01c04472848Greg Clayton lldb_private::Mutex m_stdio_communication_mutex; 2957861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice std::string m_stdout_data; 2958bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton std::string m_stderr_data; 2959fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache m_memory_cache; 2960613b8739a4d489b7f1c571288d5786768c024205Greg Clayton AllocatedMemoryCache m_allocated_memory_cache; 2961ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton bool m_should_detach; /// Should we detach if the process object goes away with an explicit call to Kill or Detach? 2962fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 2963642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham typedef std::map<lldb::LanguageType, lldb::LanguageRuntimeSP> LanguageRuntimeCollection; 2964642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham LanguageRuntimeCollection m_language_runtimes; 29657e2f91cb958c8670774cb2190db7b858618b5b9bGreg Clayton std::auto_ptr<NextEventAction> m_next_event_action_ap; 296624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29676cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan enum { 29686cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITDontKnow= 0, 29696cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITYes, 29706cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITNo 29716cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan } m_can_jit; 29726cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 297324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 297424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 297524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 297624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 297724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 297824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 297924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 298024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 298124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 298224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 298324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 298424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 298524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 298624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StartPrivateStateThread (); 298724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 298824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 298924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 299024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 299124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 299224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 299324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 299424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 299524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 299624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 299724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 299824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 299924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 300024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 300124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 300224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 300324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 300424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 300524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 300624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 300724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 300824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 300924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 301024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 301124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 301224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 301324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 301424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 301524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 301624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 301724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 301824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 301924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 302024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 302124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 302224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 302324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 302424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 3025861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3026861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3027861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice AppendSTDOUT (const char *s, size_t len); 3028861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3029bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton void 3030bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton AppendSTDERR (const char *s, size_t len); 3031bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton 3032861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static void 3033861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len); 3034861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3035861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3036861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PushProcessInputReader (); 3037861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3038861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3039861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PopProcessInputReader (); 3040861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3041861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3042861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ResetProcessInputReader (); 3043861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3044861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3045861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice SetUpProcessInputReader (int file_descriptor); 3046861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3047861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static size_t 3048861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ProcessInputReaderCallback (void *baton, 3049861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice InputReader &reader, 3050861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderAction notification, 3051861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice const char *bytes, 3052861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice size_t bytes_len); 3053861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3054861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 305524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 305624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 305724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 305824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 305924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 30606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 306124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 306224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 306324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 306424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 306524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 306624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 306724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 3068