Process.h revision 2d9adb73af7520bec430e0585ca40467828e6ed1
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" 38e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Args.h" 39e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Options.h" 4024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 41613b8739a4d489b7f1c571288d5786768c024205Greg Clayton#include "lldb/Target/Memory.h" 4224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ThreadList.h" 4324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/UnixSignals.h" 4424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 4624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 47b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 48b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceSettings 49b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 506e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeclass ProcessInstanceSettings : public InstanceSettings 516e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice{ 526e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticepublic: 536e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 54004afcb95736e97d071b1dd9b5254800e11e581cCaroline Tice ProcessInstanceSettings (UserSettingsController &owner, bool live_instance = true, const char *name = NULL); 556e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 566e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings (const ProcessInstanceSettings &rhs); 576e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 596e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ~ProcessInstanceSettings (); 606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings& 626e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice operator= (const ProcessInstanceSettings &rhs); 636e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 646e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 656e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 666e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice UpdateInstanceSettingsVariable (const ConstString &var_name, 676e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *index_value, 686e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *value, 696e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &instance_name, 706e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const SettingEntry &entry, 71b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton VarSetOperationType op, 726e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Error &err, 736e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 746e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 75bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice bool 766e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice GetInstanceSettingsValue (const SettingEntry &entry, 776e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &var_name, 785bc8c97d62b2e399bd90fb7e00c903d7887412abCaroline Tice StringList &value, 79bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice Error *err); 806e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 816e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 826e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprotected: 836e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 846e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 856e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, 866e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 876e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 880021c97fbd17e38113d2e76b93c94ee05213ee45Johnny Chen const ConstString 896e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CreateInstanceName (); 906e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice}; 916e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 92b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 93b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInfo 94b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 95b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A base class for information for a process. This can be used to fill 96b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// out information for a process prior to launching it, or it can be 97b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// used for an instance of a process and can be filled in with the 98b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// existing values for that process. 99b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 100e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonclass ProcessInfo 101e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 102e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 103e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo () : 104ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable (), 105b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 106b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment (), 107444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 108444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 109e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch(), 110b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (LLDB_INVALID_PROCESS_ID) 111e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 112e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 113b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 114e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo (const char *name, 115e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec &arch, 116e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t pid) : 117b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_executable (name, false), 118b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 119b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment(), 120444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 121444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 122e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch (arch), 123b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (pid) 124e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 125e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 126e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 127e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 128e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear () 129e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 130ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.Clear(); 131b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments.Clear(); 132b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment.Clear(); 133444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid = UINT32_MAX; 134444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid = UINT32_MAX; 135e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch.Clear(); 136e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = LLDB_INVALID_PROCESS_ID; 137e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 138e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 139e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 140e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetName() const 141e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 142ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetCString(); 143e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 144b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 145e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 146e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetNameLength() const 147e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 148ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetLength(); 149e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 150e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 151e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 152e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetName (const char *name) 153e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 154ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.GetFilename().SetCString (name); 155ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 156ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 157ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton FileSpec & 158ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () 159ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 160ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 161e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 16236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 16336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 16436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetExecutableFile (const FileSpec &exe_file, bool add_exe_file_as_first_arg) 16536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file) 16736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable = exe_file; 16936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 17036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 17136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.Clear(); 17236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton char filename[PATH_MAX]; 17336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file.GetPath(filename, sizeof(filename))) 17436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.AppendArgument (filename); 17536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton else 17836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 17936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable.Clear(); 18036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 18136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_arguments.Clear(); 18236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 18336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 18436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 185ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton const FileSpec & 186ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () const 18724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 188ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 18924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 19024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 191a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 192b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetUserID() const 193a733c04608cc94592a15d27583529588e19db552Greg Clayton { 194b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid; 195a733c04608cc94592a15d27583529588e19db552Greg Clayton } 196b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 197a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 198b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetGroupID() const 199a733c04608cc94592a15d27583529588e19db552Greg Clayton { 200b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid; 201a733c04608cc94592a15d27583529588e19db552Greg Clayton } 20224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 20324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 204b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton UserIDIsValid () const 20524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 206b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid != UINT32_MAX; 20724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 20824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 20924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 210b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GroupIDIsValid () const 21124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 212b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid != UINT32_MAX; 21324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 21424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 215a733c04608cc94592a15d27583529588e19db552Greg Clayton void 216b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetUserID (uint32_t uid) 217a733c04608cc94592a15d27583529588e19db552Greg Clayton { 218b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid = uid; 219a733c04608cc94592a15d27583529588e19db552Greg Clayton } 220a733c04608cc94592a15d27583529588e19db552Greg Clayton 221a733c04608cc94592a15d27583529588e19db552Greg Clayton void 222b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetGroupID (uint32_t gid) 223a733c04608cc94592a15d27583529588e19db552Greg Clayton { 224b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid = gid; 225a733c04608cc94592a15d27583529588e19db552Greg Clayton } 226b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 227e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ArchSpec & 228e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () 229e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 230e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 231e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 232b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 233e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec & 234e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () const 235e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 236e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 237e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 238b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 239e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 240e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessID () const 241e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 242e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_pid; 243e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 244e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 245e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 246e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetProcessID (lldb::pid_t pid) 247e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 248e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = pid; 249e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 250e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 251a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 252a733c04608cc94592a15d27583529588e19db552Greg Clayton ProcessIDIsValid() const 253a733c04608cc94592a15d27583529588e19db552Greg Clayton { 254a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_pid != LLDB_INVALID_PROCESS_ID; 255a733c04608cc94592a15d27583529588e19db552Greg Clayton } 256b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 257b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 258b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Dump (Stream &s, Platform *platform) const; 259b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 260b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 261b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () 262b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 263b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 264b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 265b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 266b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 267b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () const 268b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 269b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 270b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 271b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 272b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 27336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetArguments (const Args& args, 27436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable, 27536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable_and_argument); 276b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 27736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 27836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetArguments (char const **argv, 27936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable, 28036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable_and_argument); 28136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 282b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 283b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () 284b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 285b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 286b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 287b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 288b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 289b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () const 290b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 291b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 292b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 293b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 294b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 295b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileSpec m_executable; 296b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_arguments; 297b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_environment; 298b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_uid; 299b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_gid; 300b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ArchSpec m_arch; 301b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_pid; 302b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 303b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 304b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 305b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfo 306b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 307b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes an existing process and any discoverable information that 308b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// pertains to that process. 309b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 310b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfo : public ProcessInfo 311b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 312b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 313b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo () : 314b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (), 315b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 316b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 317b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 318b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 319b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 320b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 321b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo (const char *name, 322b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ArchSpec &arch, 323b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t pid) : 324b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (name, arch, pid), 325b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 326b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 327b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 328b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 329b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 330b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 331b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 332b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 333b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 334b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 335b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = UINT32_MAX; 336b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = UINT32_MAX; 337b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid = LLDB_INVALID_PROCESS_ID; 338b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 339b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 340b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 341b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveUserID() const 342b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 343b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid; 344b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 345b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 346b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 347b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveGroupID() const 348b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 349b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid; 350b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 351b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 352b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 353b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveUserIDIsValid () const 354b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 355b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid != UINT32_MAX; 356b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 357b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 358b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 359b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveGroupIDIsValid () const 360b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 361b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid != UINT32_MAX; 362b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 363b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 364b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 365b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveUserID (uint32_t uid) 366b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 367b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = uid; 368b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 369b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 370b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 371b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveGroupID (uint32_t gid) 372b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 373b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = gid; 374b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 375a733c04608cc94592a15d27583529588e19db552Greg Clayton 376a733c04608cc94592a15d27583529588e19db552Greg Clayton lldb::pid_t 377a733c04608cc94592a15d27583529588e19db552Greg Clayton GetParentProcessID () const 378a733c04608cc94592a15d27583529588e19db552Greg Clayton { 379a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid; 380a733c04608cc94592a15d27583529588e19db552Greg Clayton } 381a733c04608cc94592a15d27583529588e19db552Greg Clayton 382a733c04608cc94592a15d27583529588e19db552Greg Clayton void 383a733c04608cc94592a15d27583529588e19db552Greg Clayton SetParentProcessID (lldb::pid_t pid) 384a733c04608cc94592a15d27583529588e19db552Greg Clayton { 385a733c04608cc94592a15d27583529588e19db552Greg Clayton m_parent_pid = pid; 386a733c04608cc94592a15d27583529588e19db552Greg Clayton } 387a733c04608cc94592a15d27583529588e19db552Greg Clayton 388a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 389a733c04608cc94592a15d27583529588e19db552Greg Clayton ParentProcessIDIsValid() const 390a733c04608cc94592a15d27583529588e19db552Greg Clayton { 391a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid != LLDB_INVALID_PROCESS_ID; 392a733c04608cc94592a15d27583529588e19db552Greg Clayton } 39324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 39424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 39524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Dump (Stream &s, Platform *platform) const; 39624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 39724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton static void 398b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose); 399b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 400b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 401b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const; 402b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 403b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 404b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_euid; 405b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_egid; 406b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_parent_pid; 407b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 408b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 409b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 410b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 411b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessLaunchInfo 412b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 413b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes any information that is required to launch a process. 414b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 415b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 416b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchInfo : public ProcessInfo 417b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 418b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 419b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 420b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton class FileAction 421b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 422b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton public: 42336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton enum Action 42436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 42536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionNone, 42636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionClose, 42736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionDuplicate, 42836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionOpen 42936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton }; 43036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 431b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 432b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction () : 433b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action (eFileActionNone), 434b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd (-1), 435b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg (-1), 436b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path () 437b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 438b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 439b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 440b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 441b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear() 442b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 443b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action = eFileActionNone; 444b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd = -1; 445b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg = -1; 446b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path.clear(); 447b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 448b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 449b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 450b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Close (int fd); 451b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 452b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 453b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Duplicate (int fd, int dup_fd); 454b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 455b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 456b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Open (int fd, const char *path, bool read, bool write); 457b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 458b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static bool 459b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AddPosixSpawnFileAction (posix_spawn_file_actions_t *file_actions, 460b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction *info, 461b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Log *log, 462b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error& error); 463b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 46436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 46536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFD () const 466b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 46736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_fd; 46836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 46936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Action 47136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetAction () const 47236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 47336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_action; 47436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 47736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetActionArgument () const 47836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 47936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_arg; 48036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 48136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 48236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char * 48336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetPath () const 48436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 48536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_path.empty()) 48636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 48736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_path.c_str(); 48836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 489b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 49036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton protected: 491b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Action m_action; // The action for this file 492b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_fd; // An existing file descriptor 493b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_arg; // oflag for eFileActionOpen*, dup_fd for eFileActionDuplicate 494b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_path; // A file path to use for opening after fork or posix_spawn 495b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton }; 496b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 497b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo () : 498b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo(), 49936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_flags () 500b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 501b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 502b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 50336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo (const char *stdin_path, 50436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stdout_path, 50536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stderr_path, 50636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *working_directory, 50736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton uint32_t launch_flags) : 50836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessInfo(), 50936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_flags (launch_flags) 51036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 51136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stderr_path) 51236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 51336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 51436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 51536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 51636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDERR_FILENO, stderr_path, read, write)) 51736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 51836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 51936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdout_path) 52036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 52236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = false; 52336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 52436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDOUT_FILENO, stdout_path, read, write)) 52536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 52636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 52736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdin_path) 52836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 53036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 53136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = false; 53236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDIN_FILENO, stdin_path, read, write)) 53336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 53436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 53536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (working_directory) 53636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetWorkingDirectory(working_directory); 53736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 538abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 539b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 540b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (const FileAction &info) 541b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 542b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.push_back(info); 543b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 544b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 545abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 546b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendCloseFileAction (int fd) 547b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 548b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 549abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Close (fd)) 550abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 551abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 552abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 553abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 554abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 555b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 556b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 557abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 558b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendDuplciateFileAction (int fd, int dup_fd) 559b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 560b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 561abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Duplicate (fd, dup_fd)) 562abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 563abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 564abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 565abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 566abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 567b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 568b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 569abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 570b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendOpenFileAction (int fd, const char *path, bool read, bool write) 571b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 572b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 573abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, path, read, write)) 574abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 575abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 576abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 577abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 578abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 579b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 580b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 581abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 582b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendSuppressFileAction (int fd, bool read, bool write) 583b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 584b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 585abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, "/dev/null", read, write)) 586abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 587abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 588abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 589abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 590abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 591b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 592abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 593abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton void 594abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton FinalizeFileActions (Target *target, Process *process); 595b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 596b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 597b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetNumFileActions () const 598b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 599b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_file_actions.size(); 600b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 601b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 602b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction * 603b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFileActionAtIndex (size_t idx) const 604b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 605b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (idx < m_file_actions.size()) 606b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return &m_file_actions[idx]; 607b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 608b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 609b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 61036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const FileAction * 61136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFileActionForFD (int fd) const 61236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 61336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton for (uint32_t idx=0, count=m_file_actions.size(); idx < count; ++idx) 61436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 61536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_file_actions[idx].GetFD () == fd) 61636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return &m_file_actions[idx]; 61736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 61836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 61936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 62036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 621b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags & 622b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () 623b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 624b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 625b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 626b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 627b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Flags & 628b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () const 629b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 630b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 631b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 632b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 633b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 634b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetWorkingDirectory () const 635b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 636b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_working_dir.empty()) 637b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 638b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_working_dir.c_str(); 639b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 64024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 64124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 642b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetWorkingDirectory (const char *working_dir) 643b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 644b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (working_dir && working_dir[0]) 645b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.assign (working_dir); 646b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 647b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 648b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 649ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 650b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 651b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SwapWorkingDirectory (std::string &working_dir) 652ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 653b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.swap (working_dir); 654b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 655b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 656b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 657b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 658b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetProcessPluginName () const 659b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 660b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_plugin_name.empty()) 661b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 662b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_plugin_name.c_str(); 663b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 664b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 665b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 666b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetProcessPluginName (const char *plugin) 667b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 668b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (plugin && plugin[0]) 669b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.assign (plugin); 670b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 671b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 672ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 673ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 674b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 675b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 676ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 677b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 678b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 679b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 680b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_flags.Clear(); 681b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.clear(); 682ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 683a733c04608cc94592a15d27583529588e19db552Greg Clayton 684e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 685b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_working_dir; 686b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_plugin_name; 687b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags m_flags; // Bitwise OR of bits from lldb::LaunchFlags 688b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::vector<FileAction> m_file_actions; // File actions for any other files 689e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 690e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 691b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchCommandOptions : public Options 69224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton{ 69324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonpublic: 694b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 695b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchCommandOptions (CommandInterpreter &interpreter) : 696b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Options(interpreter) 697b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 698143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton // Keep default values of all options in one place: OptionParsingStarting () 699143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting (); 700b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 701b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 702b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ~ProcessLaunchCommandOptions () 703b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 704b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 705b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 706b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error 707143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton SetOptionValue (uint32_t option_idx, const char *option_arg); 708b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 709b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 710143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting () 711b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 712b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton launch_info.Clear(); 713b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 714b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 715b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const OptionDefinition* 716b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetDefinitions () 717b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 718b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return g_option_table; 719b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 720b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 721b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Options table: Required for subclasses of Options. 722b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 723b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static OptionDefinition g_option_table[]; 724b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 725b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Instance variables to hold the values for command options. 726b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 727b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo launch_info; 728b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 729b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 730b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 731b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfoMatch 732b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 733b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A class to help matching one ProcessInstanceInfo to another. 734b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 735b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 736b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoMatch 737b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 738b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 739b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch () : 74024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 74124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (lldb_private::eNameMatchIgnore), 74224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 74324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 74424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 74524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 746b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch (const char *process_name, 74724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType process_name_match_type) : 74824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 74924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (process_name_match_type), 75024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 75124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 75224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info.SetName (process_name); 75324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 75424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 755b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo & 75624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () 75724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 75824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 75924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 76024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 761b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 76224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () const 76324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 76424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 76524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 76624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 76724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 76824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetMatchAllUsers () const 76924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 77024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_all_users; 77124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 77224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 77324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 77424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetMatchAllUsers (bool b) 77524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 77624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users = b; 77724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 77824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 77924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType 78024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetNameMatchType () const 78124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 78224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_name_match_type; 78324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 78424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 78524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 78624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetNameMatchType (lldb_private::NameMatchType name_match_type) 78724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 78824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type = name_match_type; 78924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 79024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 79124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 79224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton NameMatches (const char *process_name) const; 79324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 79424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 795b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Matches (const ProcessInstanceInfo &proc_info) const; 79624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 79724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 79824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton MatchAllProcesses () const; 79924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 80024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Clear (); 80124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 80224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonprotected: 803b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo m_match_info; 80424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton lldb_private::NameMatchType m_name_match_type; 80524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool m_match_all_users; 80624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton}; 80724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 808b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoList 809e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 810e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 811b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoList () : 812e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos() 813e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 814e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 815e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 816e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 817e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear() 818e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 819e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.clear(); 820e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 821e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 822e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton uint32_t 823e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetSize() 824e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 825e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos.size(); 826e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 827e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 828e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 829b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Append (const ProcessInstanceInfo &info) 830e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 831e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.push_back (info); 832e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 833e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 834e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 835e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameAtIndex (uint32_t idx) 836e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 837e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 838e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetName(); 839e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return NULL; 840e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 841e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 842e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 843e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameLengthAtIndex (uint32_t idx) 844e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 845e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 846e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetNameLength(); 847e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return 0; 848e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 849e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 850e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 851e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessIDAtIndex (uint32_t idx) 852e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 853e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 854e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetProcessID(); 8552bc9eb3ba78efc64a273729b480bafc3bbaa433aJohnny Chen return 0; 856e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 857e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 858e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton bool 859b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetInfoAtIndex (uint32_t idx, ProcessInstanceInfo &info) 860e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 861e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 862e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 863e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton info = m_infos[idx]; 864e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return true; 865e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 866e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return false; 867e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 868e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 86924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton // You must ensure "idx" is valid before calling this function 870b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 87124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfoAtIndex (uint32_t idx) const 87224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 87324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton assert (idx < m_infos.size()); 87424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_infos[idx]; 87524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 87624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 877e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 878b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton typedef std::vector<ProcessInstanceInfo> collection; 879e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton collection m_infos; 880e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 881e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 8826e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 88321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// This class tracks the Modification state of the process. Things that can currently modify 88421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// the program are running the program (which will up the StopID) and writing memory (which 88521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// will up the MemoryID.) 88621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// FIXME: Should we also include modification of register states? 88721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 88821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamclass ProcessModID 88921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 89021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend bool operator== (const ProcessModID &lhs, const ProcessModID &rhs); 89121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghampublic: 89221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID () : 8930296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id (0), 8940296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id (0), 8950296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_memory_id (0), 8960296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume (0), 8970296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression (false) 89821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 89921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 90021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID (const ProcessModID &rhs) : 90121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id (rhs.m_stop_id), 90221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id (rhs.m_memory_id) 90321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 90421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 90521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham const ProcessModID & operator= (const ProcessModID &rhs) 90621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 90721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (this != &rhs) 90821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 90921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = rhs.m_stop_id; 91021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id = rhs.m_memory_id; 91121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 91221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return *this; 91321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 91421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 91521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ~ProcessModID () {} 91621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 9170296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpStopID () { 9180296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id++; 9190296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 9200296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 92121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void BumpMemoryID () { m_memory_id++; } 92221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 9230296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpResumeID () { 9240296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id++; 9250296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (m_running_user_expression > 0) 9260296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume = m_resume_id; 9270296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 9280296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 92921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetStopID() const { return m_stop_id; } 93021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetMemoryID () const { return m_memory_id; } 9310296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetResumeID () const { return m_resume_id; } 9320296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetLastUserExpressionResumeID () const { return m_last_user_expression_resume; } 93321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 93421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool MemoryIDEqual (const ProcessModID &compare) const 93521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 93621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_memory_id == compare.m_memory_id; 93721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 93821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 93921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool StopIDEqual (const ProcessModID &compare) const 94021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 94121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id == compare.m_stop_id; 94221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 94321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 94421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void SetInvalid () 94521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 94621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = UINT32_MAX; 94721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 94821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 94921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool IsValid () const 95021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 95121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id != UINT32_MAX; 95221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 9530296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 9540296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 9550296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on) 9560296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 9570296fe73a7cb1482226b1303a795ede00e12d677Jim 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); 9580296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (on) 9590296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression++; 9600296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham else 9610296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression--; 9620296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 9630296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 96421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamprivate: 96521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_stop_id; 9660296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_resume_id; 96721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_memory_id; 9680296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_last_user_expression_resume; 9690296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_running_user_expression; 97021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham}; 97121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator== (const ProcessModID &lhs, const ProcessModID &rhs) 97221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 97321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (lhs.StopIDEqual (rhs) 97421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham && lhs.MemoryIDEqual (rhs)) 97521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 97621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 97721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 97821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 97921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 98021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator!= (const ProcessModID &lhs, const ProcessModID &rhs) 98121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 98221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (!lhs.StopIDEqual (rhs) 98321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham || !lhs.MemoryIDEqual (rhs)) 98421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 98521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 98621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 98721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 98821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 98924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 99024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 99124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 99224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 99324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 994567e7f3ba16eb48cb9fd6a2f26f2f7269eb6983cGreg Clayton public ReferenceCountedBaseVirtual<Process>, 99524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 99624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 99724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 9986e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public PluginInterface, 9996e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public ProcessInstanceSettings 100024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 100124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 1002d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Inghamfriend class ClangFunction; // For WaitForStateChangeEventsPrivate 100321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectProcessLaunch; 100421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class ProcessEventData; 100521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectBreakpointCommand; 100621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class StopInfo; 100724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 100824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 100924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 101024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 101124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 101224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 101324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 101424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 101524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 101624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 101724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 1018e28824e0b988221c7eedf8e3d212527d2bdac6a7Eli Friedman eBroadcastBitSTDERR = (1 << 3) 101924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 102024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 102124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 102224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 102324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 102424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 102524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 102624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 1027360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 102824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 102924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 103024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 103124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 103224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 103324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 103424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 103524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 103624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 103724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 103824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 103924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 104024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 104124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 104224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 104324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 104424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 104524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 10463ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham friend class Process; 10473ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 104824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 104924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 105024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 105124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 105224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 105324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 105424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 105524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 105624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 105724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 105824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 105924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 106024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 10613ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetProcessSP() const 10623ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 10633ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_process_sp; 10643ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 106524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 10663ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetState() const 10673ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 10683ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_state; 10693ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 107024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 10713ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetRestarted () const 10723ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 10733ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_restarted; 10743ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 10753ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool 10763ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterrupted () const 10773ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 10783ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_interrupted; 10793ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 108024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 108124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 108224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 108324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 108424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 108524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 108624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 108724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 108824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 108924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 109124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 109224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 109424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 109524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 109724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 109824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 109924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 110024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 110124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 110224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 11033ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterruptedFromEvent (const Event *event_ptr); 11043ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 11053ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static void 11063ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterruptedInEvent (Event *event_ptr, bool new_value); 11073ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 11083ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static bool 110924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 111024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 111124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 111224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 111324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 11143ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetUpdateStateOnRemoval() 11153ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 11166cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham m_update_state++; 11173ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 111824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 11193ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetRestarted (bool new_value) 11203ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 11213ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_restarted = new_value; 11223ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 11233ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham void 11243ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterrupted (bool new_value) 11253ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 11263ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_interrupted = new_value; 11273ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 112824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 112924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 113024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 113124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 11326cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham int m_update_state; 11333ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool m_interrupted; 113424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 113524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 113624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 11376e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1138d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton class SettingsController : public UserSettingsController 11396e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice { 11406e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public: 11416e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1142d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton SettingsController (); 11436e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11446e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 1145d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton ~SettingsController (); 11466e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11476e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry global_settings_table[]; 11486e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry instance_settings_table[]; 11496e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11506e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice protected: 11516e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11526e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice lldb::InstanceSettingsSP 1153d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton CreateInstanceSettings (const char *instance_name); 11546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11556e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice private: 11566e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11576e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice // Class-wide settings. 11586e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1159d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton DISALLOW_COPY_AND_ASSIGN (SettingsController); 11606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice }; 11616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 116221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 116324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 116424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1165990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 11662a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsInitialize (); 1167990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1168990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 11692a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsTerminate (); 1170990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1171990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static lldb::UserSettingsControllerSP & 1172990de7bb41d3afec6b789155408ff322187d8682Greg Clayton GetSettingsController (); 11736e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 11741ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice void 11751ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice UpdateInstanceName (); 11761ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice 1177395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 117824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 117924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 118024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 118224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 118324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 118524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 118624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 118724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 118824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 118924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 119024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 119124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 119224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 119324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 119424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 119524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 119624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 119724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 119824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 119924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 120124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 120224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 120424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 120524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 120624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 120724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 120824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 120924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 121024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static Process* 121124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner FindPlugin (Target &target, const char *plugin_name, Listener &listener); 121224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 121524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 121624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 121724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 121824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 121924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 122024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 122124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 122224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 122324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 122424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 122524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 122624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 122724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 122824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 122924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 123024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 123124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 123224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 123324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 123424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1235395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton lldb::ByteOrder 1236395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetByteOrder () const; 1237395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 1238395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton uint32_t 1239395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetAddressByteSize () const; 1240395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 124124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 124224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 124324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1244fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 124524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 124624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 124724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 124824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 124924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 125024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 125124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 125224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 12538d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton CanDebug (Target &target, 12548d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton bool plugin_specified_by_name) = 0; 125524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 125624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 125724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 125824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 125924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 126024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 126124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 126224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 126324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 126424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 126524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 126624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 126724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 126824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 126924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 127024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 127124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 127224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 127324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 127424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 127524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 127624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 127724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 127824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 127924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 128024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 128124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 128224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 128324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 128424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 128524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 128624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 128724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 128824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 128924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1290452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1291452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1292452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 129324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 129424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 129524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 129624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 129724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 129824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 129924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 130024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 130124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 130224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 130324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 130424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 130524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 130624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 130724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1308de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1309de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1310de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 131124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 131224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 131324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 131424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 131524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 131636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Launch (const ProcessLaunchInfo &launch_info); 131724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 131824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 131924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 132024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 132124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 132224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillAttach (lldb::pid_t) 132324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoAttach (lldb::pid_t) will 132424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 132524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 132624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 132724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 132824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 132924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 133024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 133124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 133224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 133324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 133424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 13352d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton Attach (lldb::pid_t pid, uint32_t exec_count); 133624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 133724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 133824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process by process name. 133924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 134024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 134124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::WillAttach (const char *) and if that returns \b 134324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, Process::DoAttach (const char *) will be called to 134424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// actually do the attach. If DoAttach returns \b true, then 134524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DidAttach() will be called. 134624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 134724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 134824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A process name to match against the current process list. 134924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 135024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 135124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 135424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 135524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Attach (const char *process_name, bool wait_for_launch); 13567508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1357e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1358e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton ConnectRemote (const char *remote_url); 13597508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1360dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool 1361dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham AttachedToProcess() const 1362dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham { 1363dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham return m_attached_to_process; 1364dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham } 13657508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 13667508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 136724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 136824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 136924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 137024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 137124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 137224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 137324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 137424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 137524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 137624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 137724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 137824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 137924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 138024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 138124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 138224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 138324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 13850baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Load a shared library into this process. 13860baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 13870baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Try and load a shared library into the current process. This 13880baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// call might fail in the dynamic loader plug-in says it isn't safe 13890baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// to try and load shared libraries at the moment. 13900baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 13910baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[in] image_spec 13920baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// The image file spec that points to the shared library that 13930baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// you want to load. 13940baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 13950baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[out] error 13960baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// An error object that gets filled in with any errors that 13970baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// might occur when trying to load the shared library. 13980baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 13990baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @return 14000baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// A token that represents the shared library that can be 14010baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// later used to unload the shared library. A value of 14020baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// LLDB_INVALID_IMAGE_TOKEN will be returned if the shared 14030baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// library can't be opened. 14040baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 14050baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual uint32_t 14060baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton LoadImage (const FileSpec &image_spec, Error &error); 14070baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 14080baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual Error 14090baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton UnloadImage (uint32_t image_token); 14100baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 14110baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 141224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 141324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 141424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 141524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 141624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 141724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 141824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 141924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 142024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 142124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 142224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 142324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 142424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 142524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 142624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 142724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 142824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 142924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 143124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 143224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 143424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 143524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 143624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 143724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 143824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 143924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 144024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 144124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 144224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 144324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 144424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 144524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 144624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 144724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 144824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 144924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 145024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 145124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 145224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 145324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 145424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 145524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 145624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 145724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 145824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 145924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 146024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 146124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 146224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 146324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 146424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 146624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 146724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 146824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 146924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 147024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 147124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 14723ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 147324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Resume (); 147424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 147524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 147624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 147724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 14803ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// If the process is successfully halted, a eStateStopped 14813ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// process event with GetInterrupted will be broadcast. If false, we will 14823ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// halt the process with no events generated by the halt. 148324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 14853ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// Returns an error object. If the error is empty, the process is halted. 14863ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// otherwise the halt has failed. 148724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 14883ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 148924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 149024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 149124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 149224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 149324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 149424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 149524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 149624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 149724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 149824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 149924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15003ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 150124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 150224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 150324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 150524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 150624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 150824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 150924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 151024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 151124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 151224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15133ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 151424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 151524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 151824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 151924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 152024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 152124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 152224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 152324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 152424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 15253ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 152624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 152724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 152824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 1529395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetUnixSignals () 1530395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1531395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_unix_signals; 1532395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 153324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 153524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 153624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 153724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 153924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 154024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 154224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 154524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 154624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 154724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 154854e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 154924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 155024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 155124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 155224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 155324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 155424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 155524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 155624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 155724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 155824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 155924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 156024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 156124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 156354e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 156424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 156524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 156624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 156724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1568e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1569e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton DoConnectRemote (const char *remote_url) 1570e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton { 1571e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton Error error; 1572e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton error.SetErrorString ("remote connections are not supported"); 1573e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton return error; 1574e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton } 1575e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 157724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 157824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 158024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 158124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 158224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 158324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 158424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 158624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 158754e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithID (lldb::pid_t pid) = 0; 158824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 158924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 159024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 159124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 159224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 159324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 159424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 159524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 159624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 159724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 159824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 159924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 160124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 160224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 160324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 160554e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton DoAttachToProcessWithName (const char *process_name, bool wait_for_launch) 160624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 160724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 160824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 160924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 161024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 161124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 161224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 161324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 161424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 161524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 161624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 161724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 161824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 161924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 162024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 162224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 162324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 162424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 162524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 162624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 162724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 162824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 162924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 163024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 163124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 163224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 163324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 163424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 163524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 163624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 163724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 163824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 163924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 164224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 164324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 164424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 164524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 164724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 164824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 164924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 165024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 165124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 165224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 165324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 165424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 165524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1656452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1657452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1658452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 165924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 166024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 166124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 166224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 166324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 166424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 166524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 166624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 166724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 166824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 166924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 167024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 167124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 167224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 167324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1674de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1675de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1676de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 167724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 167824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 167924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 168024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 168236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton DoLaunch (Module *exe_module, 168336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const ProcessLaunchInfo &launch_info) = 0; 168424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 168524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 168724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 168824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 168924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 169024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 169124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 169224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 169324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 169424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 169524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 169624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 169724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 169824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 169924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 170024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 170124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 170224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 170324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 170424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 170524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 170624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 170724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 170824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 170924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 171024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 171124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 171324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 171424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 171524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 171624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 171724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 171824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 171924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 172024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 172224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 172324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 172424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 172524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 172624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoResume () = 0; 172724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 172824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 172924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 173024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 173124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 173224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 173324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 173424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 173524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 173624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 173724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 173824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 173924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 174024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 174224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 174324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 174524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 174624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 174724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 174824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 174924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 175024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 175124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 175224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1753360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt must produce one and only one stop StateChanged event if it actually 1754360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// stops the process. If the stop happens through some natural event (for 1755360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// instance a SIGSTOP), then forwarding that event will do. Otherwise, you must 1756360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// generate the event manually. Note also, the private event thread is stopped when 1757360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt is run to prevent the events generated while halting to trigger 1758360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// other state changes before the halt is complete. 17593ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 17603ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// @param[out] caused_stop 176120d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// If true, then this Halt caused the stop, otherwise, the 176220d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// process was already stopped. 17633ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 176424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 176524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 176624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 176724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 176824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 17693ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham DoHalt (bool &caused_stop) = 0; 177024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 177124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 177224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 177324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 177424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 177524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 177624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 177724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 177824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 177924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 178024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 178124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 178224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 178324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 178424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 178524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 178624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 178724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 178824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 178924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 179024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 179124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 179224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 179324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 179424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 179524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 179624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 179724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 179824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 179924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 180024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 180124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 180324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDetach () = 0; 180424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 180524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 180724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 180824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 180924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 181024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 181124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 181224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 181324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 181424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 181524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 181624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 181824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 181924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 182024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 182124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 182224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 182324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 182424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 182524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 182624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 182724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 182824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 182924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 183024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 183124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 183224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 183324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 183424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 183524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoSignal (int signal) = 0; 183624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 183724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 183824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 183924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 184024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 184124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 184324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 184424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 184624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 184724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 185024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 185124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 185224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 185324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 185424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 185524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 185624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 185724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 186124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 186224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 186324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 186524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 186624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 186724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 186824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 186924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 187024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 187324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 187424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 187524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 187724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 187924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 188024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 188124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 188224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 1883395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () 1884395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1885395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 1886395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 188724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 188824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 188924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 189024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 189124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 189224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 189324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 189424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 1896395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () const 1897395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1898395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 1899395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 1900395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 190124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 190224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 190324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 190424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 190624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 190724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 190824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 190924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 191024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 191124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 1912360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 1913b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResults 1914360f53f3c216ee4fb433da0a367168785328a856Jim Ingham RunThreadPlan (ExecutionContext &exe_ctx, 1915360f53f3c216ee4fb433da0a367168785328a856Jim Ingham lldb::ThreadPlanSP &thread_plan_sp, 1916360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool stop_others, 1917360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool try_all_threads, 1918360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool discard_on_error, 1919360f53f3c216ee4fb433da0a367168785328a856Jim Ingham uint32_t single_thread_timeout_usec, 1920360f53f3c216ee4fb433da0a367168785328a856Jim Ingham Stream &errors); 1921360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 1922360f53f3c216ee4fb433da0a367168785328a856Jim Ingham static const char * 1923b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResultAsCString (ExecutionResults result); 192424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1925abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton void 1926abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetStatus (Stream &ostrm); 1927abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 1928abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton size_t 1929abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetThreadStatus (Stream &ostrm, 1930abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton bool only_threads_with_stop_reason, 1931abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t start_frame, 1932abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames, 1933abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames_with_source); 1934abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 193524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 193624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 193724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 193824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 193924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 194024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 194124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 194224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 194375c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 194475c703dd8b492bad25a987b96853626641ae7246Greg Clayton // Called internally 194575c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 194675c703dd8b492bad25a987b96853626641ae7246Greg Clayton void 194775c703dd8b492bad25a987b96853626641ae7246Greg Clayton CompleteAttach (); 194875c703dd8b492bad25a987b96853626641ae7246Greg Clayton 194924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 195024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 195124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 195224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 195324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 195424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 195524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 195624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 195724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 195824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 195924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 196024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 196224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 196324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 196424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 196524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 196624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 196824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 196924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 197224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 197324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 197424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 197524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 197624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 197721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// Get the Modification ID of the process. 197824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 197924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 198021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// The modification ID of the process. 198124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID 198321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetModID () const 198421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 198521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id; 198621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 198721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 19880296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham const ProcessModID & 19890296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetModIDRef () const 19900296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 19910296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id; 19920296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 19930296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 199424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 199521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetStopID () const 199621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 199721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id.GetStopID(); 199821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 199921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 20000296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 20010296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetResumeID () const 20020296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 20030296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetResumeID(); 20040296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 20050296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 20060296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 20070296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetLastUserExpressionResumeID () const 20080296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 20090296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetLastUserExpressionResumeID(); 20100296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 20110296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 201224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 201324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 201424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 201524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 201624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 201724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 201824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 201924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 202024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 202124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 202224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 202324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 202424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 202524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 202624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 202724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 202872e1c782ba1e4226da37af4722af608de9f39408Greg Clayton virtual bool 202924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 203024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 203124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 203324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 203424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 203524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 203624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 203724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 203924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 204024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 204124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 204324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 204524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 204624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 204724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 204824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 204924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 205024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 205124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 205224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 205424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 205524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 205724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 205824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 205924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 206024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 206124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 206224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 206324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 206424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 206524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 206624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 206724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 206824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 206924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 207024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 207124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 207224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 207324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 207424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 207524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 207624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 207724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 207824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 207924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 208124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 208224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 208324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 208524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 208624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 208724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 208924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 209024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 209124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 209224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 209324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 209424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 209524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 209624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 209724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 209824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 209924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 210024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 210124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 210224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 210324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2104b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2105b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// Read a NULL terminated C string from memory 2106b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// 2107b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// This function will read a cache page at a time until the NULL 2108b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// C stirng terminator is found. It will stop reading if the NULL 2109b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// termination byte isn't found before reading \a cstr_max_len 2110b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// bytes, and the results are always guaranteed to be NULL 2111b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// terminated (at most cstr_max_len - 1 bytes will be read). 2112b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2113b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 2114b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2115b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton char *cstr, 2116b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t cstr_max_len); 2117b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2118fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 2119fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ReadMemoryFromInferior (lldb::addr_t vm_addr, 2120fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *buf, 2121fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t size, 2122fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 2123fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 21246d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 21256d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// Reads an unsigned integer of the specified byte size from 21266d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// process memory. 21276d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 21286d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] load_addr 21296d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// A load address of the integer to read. 21306d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 21316d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] byte_size 21326d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The size in byte of the integer to read. 21336d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 2134c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] fail_value 2135c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value to return if we fail to read an integer. 2136c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 21376d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[out] error 21386d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// An error that indicates the success or failure of this 21396d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// operation. If error indicates success (error.Success()), 21406d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// then the value returned can be trusted, otherwise zero 21416d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// will be returned. 21426d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 21436d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @return 21446d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The unsigned integer that was read from the process memory 21456d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// space. If the integer was smaller than a uint64_t, any 21466d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// unused upper bytes will be zero filled. If the process 21476d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// byte order differs from the host byte order, the integer 21486d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// value will be appropriately byte swapped into host byte 21496d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// order. 21506d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 2151f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton uint64_t 2152c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadUnsignedIntegerFromMemory (lldb::addr_t load_addr, 2153c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t byte_size, 2154c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint64_t fail_value, 2155c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2156c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2157c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t 2158c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadPointerFromMemory (lldb::addr_t vm_addr, 2159c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2160c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2161c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool 2162c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WritePointerToMemory (lldb::addr_t vm_addr, 2163c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t ptr_value, 2164c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2165c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 216624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 216724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 216824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 217024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 217124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 217224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 217324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 217424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 217524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 217624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 217724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 217824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 217924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2180c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2181c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2182c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 218324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 218424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 218524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 218624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 218724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) = 0; 218824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 218924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2190c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// Write all or part of a scalar value to memory. 2191c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2192c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value contained in \a scalar will be swapped to match the 2193c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// byte order of the process that is being debugged. If \a size is 2194c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// less than the size of scalar, the least significate \a size bytes 2195c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// from scalar will be written. If \a size is larger than the byte 2196c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// size of scalar, then the extra space will be padded with zeros 2197c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// and the scalar value will be placed in the least significant 2198c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// bytes in memory. 2199c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2200c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] vm_addr 2201c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// A virtual load address that indicates where to start writing 2202c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// memory to. 2203c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2204c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] scalar 2205c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The scalar to write to the debugged process. 2206c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2207c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] size 2208c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// This value can be smaller or larger than the scalar value 2209c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// itself. If \a size is smaller than the size of \a scalar, 2210c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the least significant bytes in \a scalar will be used. If 2211c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// \a size is larger than the byte size of \a scalar, then 2212c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the extra space will be padded with zeros. If \a size is 2213c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// set to UINT32_MAX, then the size of \a scalar will be used. 2214c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2215c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2216c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2217c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2218c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @return 2219c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The number of bytes that were actually written. 2220c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 2221c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2222c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WriteScalarToMemory (lldb::addr_t vm_addr, 2223c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton const Scalar &scalar, 2224c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t size, 2225c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2226c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2227c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2228c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadScalarIntegerFromMemory (lldb::addr_t addr, 2229c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t byte_size, 2230c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool is_signed, 2231c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Scalar &scalar, 2232c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2233c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2234c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 223524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 223624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 223724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 223824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 223924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 224024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 224224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 224324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 224424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 224624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 224724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 224824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 225024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 225124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 225224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 225324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 225424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 225524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 225624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 225724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 225824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 225924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 226024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 226124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 226224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 226324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 226424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 226524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 226624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 226724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 226824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 226924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 227024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 227124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 227224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 227324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 227424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 227524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 227624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 227724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 227824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 227924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoAllocateMemory (size_t size, uint32_t permissions, Error &error) = 0; 228024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 228124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 228224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 228324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 228524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 228624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 228724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 228924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 229024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 229124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 229224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 229324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 229424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 229524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 229624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2297b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// @param[in/out] error 2298b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// An error object to fill in if things go wrong. 229924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 230024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 230124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 230224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 230324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 230424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 230524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 230624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 230724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 23086cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Determines whether executing JIT-compiled code in this process 23096cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 23106cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 23116cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @return 23126cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 23136cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 23146cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan bool CanJIT (); 23156cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 23166cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 23176cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Sets whether executing JIT-compiled code in this process 23186cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 23196cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 23206cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @param[in] can_jit 23216cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 23226cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 23236cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan void SetCanJIT (bool can_jit); 23246cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 23256cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 232624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 232724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 232824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 232924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 233024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 233224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 233324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 233424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 233524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 233624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 233724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 233824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 233924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 234024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDeallocateMemory (lldb::addr_t ptr) = 0; 234124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 234224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 234324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 234424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 234624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 234724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 234924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 235024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 235124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 235224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 235324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 235424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 235624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 235724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 235824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 235924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 236024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 236124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 236224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 236324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 236424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 236524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 236624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 236724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 236824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 236924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 237024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 237124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 237224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 237324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 237424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 237524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 237624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 237724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 237824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 237924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 238024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 238124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDOUT (char *buf, size_t buf_size, Error &error) 238224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 238324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdout unsupported"); 238424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 238524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 238624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 238724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 238824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 238924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 239024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 239124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 239224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 239324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 239424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 239524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 239624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 239724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 239824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 239924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 240024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 240224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 240324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 240524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 240624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 240724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 240824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 240924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 241024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSTDERR (char *buf, size_t buf_size, Error &error) 241124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 241224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stderr unsupported"); 241324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 241424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 241524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 241624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 241724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 241824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 241924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 242024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 242124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 242224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 242324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 242424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 242524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 2426b1888f24fa181489840b9acf193e224d125d0776Greg Clayton size_t 2427b1888f24fa181489840b9acf193e224d125d0776Greg Clayton GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site); 242824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 242924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 243024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpoint (BreakpointSite *bp_site) = 0; 243124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 243224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 243324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpoint (BreakpointSite *bp_site) = 0; 243424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 243524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 243624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 243724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 243824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 243924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 244024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 244124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 244224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 244324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 244424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 244524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 244624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 244724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 244824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 244924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 245024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 245124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 245224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 245324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 245424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 245524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 245624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 245724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 245824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 245924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 246024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 24613fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 246224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner CreateBreakpointSite (lldb::BreakpointLocationSP &owner, 246324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 246424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 246624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 246724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 246924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 247024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 247124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 247224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 247324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 247424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 247524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 247624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 247724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 247824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 247924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 248024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 248124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 248224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 248324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 248424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 248524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2486ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen EnableWatchpoint (Watchpoint *wp); 248724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 248824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2489ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen DisableWatchpoint (Watchpoint *wp); 249024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 249124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 249224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 249324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 249424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t 249537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list) = 0; 249637f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 249737f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton void 249837f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadListIfNeeded (); 249924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 2501395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () 2502395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2503395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 2504395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 250524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 250724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 250824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 250924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 251024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 251124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 251224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 251324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 251424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 251524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 251624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 251724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessToStop (const TimeValue *timeout); 251824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 251924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 252024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 252124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 252224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 252324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 252463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 252524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2526f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham class 2527f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker 2528f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2529f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham public: 2530f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker (Process &process, Listener *listener) : 2531f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process (process), 2532f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_listener (listener) 2533f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2534f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.HijackProcessEvents (listener); 2535f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 2536f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ~ProcessEventHijacker () 2537f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 2538f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.RestoreProcessEvents(); 2539f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 2540f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 2541f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham private: 2542f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Process &m_process; 2543f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Listener *m_listener; 2544f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham }; 2545f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham friend class ProcessEventHijacker; 254624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 254763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// If you need to ensure that you and only you will hear about some public 254863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// event, then make a new listener, set to listen to process events, and 254963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// then call this with that listener. Then you will have to wait on that 255063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// listener explicitly for events (rather than using the GetNextEvent & WaitFor* 255163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// calls above. Be sure to call RestoreProcessEvents when you are done. 255263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 255363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @param[in] listener 255463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// This is the new listener to whom all process events will be delivered. 255563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 255663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @return 255763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Returns \b true if the new listener could be installed, 255863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// \b false otherwise. 255963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 256063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham bool 256163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham HijackProcessEvents (Listener *listener); 256263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 256363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 256463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Restores the process event broadcasting to its normal state. 256563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 256663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 256763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham void 256863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham RestoreProcessEvents (); 256963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 257063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghamprotected: 257163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 257224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 257324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 257424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 257524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 257624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 257724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 257824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 257924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 258024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 258124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 258224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 258324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 258424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 258524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 258624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 258724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 258863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghampublic: 258975906e4ec98af3717e415727a8d663a4e246bb4fGreg Clayton const lldb::ABISP & 259024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 259124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 259275c703dd8b492bad25a987b96853626641ae7246Greg Clayton DynamicLoader * 259375c703dd8b492bad25a987b96853626641ae7246Greg Clayton GetDynamicLoader () 259475c703dd8b492bad25a987b96853626641ae7246Greg Clayton { 259575c703dd8b492bad25a987b96853626641ae7246Greg Clayton return m_dyld_ap.get(); 259675c703dd8b492bad25a987b96853626641ae7246Greg Clayton } 259775c703dd8b492bad25a987b96853626641ae7246Greg Clayton 259837f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton OperatingSystem * 259937f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton GetOperatingSystem () 260037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton { 260137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton return m_os_ap.get(); 260237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton } 260337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 260437f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 2605642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual LanguageRuntime * 2606642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetLanguageRuntime (lldb::LanguageType language); 2607642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 2608642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual CPPLanguageRuntime * 2609642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetCPPLanguageRuntime (); 2610642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 2611642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual ObjCLanguageRuntime * 2612642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham GetObjCLanguageRuntime (); 261324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 261424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 261524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 2616f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 2617f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 2618f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 2619d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham return m_dynamic_checkers_ap.get(); 2620f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 2621f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 2622f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 2623f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 2624d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham m_dynamic_checkers_ap.reset(dynamic_checkers); 2625f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 262624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2627c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 2628c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to set the lldb in the mode where it breaks on new thread 2629c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// creations, and then auto-restarts. This is useful when you are trying 2630c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// to run only one thread, but either that thread or the kernel is creating 2631c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// new threads in the process. If you stop when the thread is created, you 2632c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// can immediately suspend it, and keep executing only the one thread you intend. 2633c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 2634c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 2635c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 2636c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 2637c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 263855e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 263955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StartNoticingNewThreads() 264055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 264155e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 264255e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 264355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 2644c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 2645c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to turn off the stop & notice new threads mode. 2646c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 2647c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 2648c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 2649c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 2650c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 265155e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 265255e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StopNoticingNewThreads() 265355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 265455e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 265555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 265655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 26570296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 26580296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on); 26590296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 266024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 266124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 266224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 266324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Target * 2664395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateTarget () 2665395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2666395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return &m_target; 2667395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 266824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Process * 2670395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateProcess () 2671395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2672395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return this; 2673395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 267424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 267524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Thread * 2676395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateThread () 2677395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2678395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 2679395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 268024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 268124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual StackFrame * 2682395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateStackFrame () 2683395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2684395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return NULL; 2685395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 268624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 268724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 2688a830adbcd63d1995a01e6e18da79893c1426ca43Greg Clayton CalculateExecutionContext (ExecutionContext &exe_ctx); 268924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 269024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP 269124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetSP (); 269224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 269324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 2694c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 269521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // NextEventAction provides a way to register an action on the next 269621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // event that is delivered to this process. There is currently only 269721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // one next event action allowed in the process at one time. If a 269821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // new "NextEventAction" is added while one is already present, the 269921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // old action will be discarded (with HandleBeingUnshipped called 270021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // after it is discarded.) 2701c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 2702c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class NextEventAction 2703c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2704c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 2705c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham typedef enum EventActionResult 2706c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2707c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionSuccess, 2708c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionRetry, 2709c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionExit 2710c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } EventActionResult; 2711c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2712c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction (Process *process) : 2713c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham m_process(process) 27142d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 27152d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 27162d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 27172d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 27182d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~NextEventAction() 27192d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 27202d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 2721c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2722c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp) = 0; 2723c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual void HandleBeingUnshipped () {}; 2724c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted () = 0; 2725c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString() = 0; 2726c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham protected: 2727c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham Process *m_process; 2728c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 2729c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2730c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham void SetNextEventAction (Process::NextEventAction *next_event_action) 2731c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 273268bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham if (m_next_event_action_ap.get()) 273368bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap->HandleBeingUnshipped(); 273468bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham 273568bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap.reset(next_event_action); 2736c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } 2737c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2738c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // This is the completer for Attaching: 2739c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class AttachCompletionHandler : public NextEventAction 2740c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 2741c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 27422d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton AttachCompletionHandler (Process *process, uint32_t exec_count) : 27432d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton NextEventAction (process), 27442d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton m_exec_count (exec_count) 27452d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 27462d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 27472d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 27482d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 27492d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~AttachCompletionHandler() 27502d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 27512d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 2752c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2753c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp); 2754c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted (); 2755c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString(); 2756c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham private: 27572d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton uint32_t m_exec_count; 2758c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham std::string m_exit_string; 2759c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 2760c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 2761f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham bool 2762f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham HijackPrivateProcessEvents (Listener *listener); 2763f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 2764f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham void 2765f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham RestorePrivateProcessEvents (); 2766a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton 2767a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton bool 2768a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton PrivateStateThreadIsValid () const 2769a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton { 2770a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton return m_private_state_thread != LLDB_INVALID_HOST_THREAD; 2771a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton } 2772fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 277324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 277424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 277524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 277624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 277724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 277824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 277924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 278024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 278124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 278224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 278324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 278421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID m_mod_id; ///< Tracks the state of the process over stops and other alterations. 278524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 278624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 278724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 278824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 278924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 27900baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton std::vector<lldb::addr_t> m_image_tokens; 279124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 279224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend 279324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ///< to insert in the target. 279475c703dd8b492bad25a987b96853626641ae7246Greg Clayton std::auto_ptr<DynamicLoader> m_dyld_ap; 2795d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers_ap; ///< The functions used by the expression parser to validate data that expressions use. 279637f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton std::auto_ptr<OperatingSystem> m_os_ap; 279724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 279824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 2799861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderSP m_process_input_reader; 2800861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb_private::Communication m_stdio_communication; 280120d338fad87eba91de65aa9bec76e01c04472848Greg Clayton lldb_private::Mutex m_stdio_communication_mutex; 2802861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice std::string m_stdout_data; 2803fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache m_memory_cache; 2804613b8739a4d489b7f1c571288d5786768c024205Greg Clayton AllocatedMemoryCache m_allocated_memory_cache; 2805dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool m_attached_to_process; /// Did we launch the process or attach to it? 2806fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 2807642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham typedef std::map<lldb::LanguageType, lldb::LanguageRuntimeSP> LanguageRuntimeCollection; 2808642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham LanguageRuntimeCollection m_language_runtimes; 28097e2f91cb958c8670774cb2190db7b858618b5b9bGreg Clayton std::auto_ptr<NextEventAction> m_next_event_action_ap; 281024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 28116cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan enum { 28126cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITDontKnow= 0, 28136cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITYes, 28146cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITNo 28156cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan } m_can_jit; 28166cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 281724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 281824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 281924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 282124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 282224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 282424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 282524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 282724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 282824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 282924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 283024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StartPrivateStateThread (); 283124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 283324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 283424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 283624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 283724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 283924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 284024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 284224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 284324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 284524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 284624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 284724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 284824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 284924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 285024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 285124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 285224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 285324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 285424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 285524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 285624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 285724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 285824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 285924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 286024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 286124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 286224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 286324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 286424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 286524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 286624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 286724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 286824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 2869861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2870861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2871861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice AppendSTDOUT (const char *s, size_t len); 2872861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2873861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static void 2874861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len); 2875861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2876861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2877861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PushProcessInputReader (); 2878861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2879861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2880861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PopProcessInputReader (); 2881861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2882861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2883861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ResetProcessInputReader (); 2884861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2885861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 2886861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice SetUpProcessInputReader (int file_descriptor); 2887861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2888861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static size_t 2889861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ProcessInputReaderCallback (void *baton, 2890861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice InputReader &reader, 2891861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderAction notification, 2892861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice const char *bytes, 2893861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice size_t bytes_len); 2894861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 2895861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 289624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 289724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 289824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 289924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 290024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 29016e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 290224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 290324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 290424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 290524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 290624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 290724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 290824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 2909