Process.h revision cf5927ee246f5e431162f2753ed9e040dd060fe5
124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//===-- Process.h -----------------------------------------------*- C++ -*-===// 224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// The LLVM Compiler Infrastructure 424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// This file is distributed under the University of Illinois Open Source 624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// License. See LICENSE.TXT for details. 724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//===----------------------------------------------------------------------===// 924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef liblldb_Process_h_ 1124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#define liblldb_Process_h_ 1224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// C Includes 1407c51d09d4b61891cdc37f44bb332dc286b4de2fBenjamin Kramer#include <limits.h> 15b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton#include <spawn.h> 16b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 1724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// C++ Includes 1824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include <list> 19b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton#include <iosfwd> 20ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton#include <vector> 2124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Other libraries and framework includes 2324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Project includes 2424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/lldb-private.h" 25e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Core/ArchSpec.h" 2624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Broadcaster.h" 27861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice#include "lldb/Core/Communication.h" 2824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Error.h" 2924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/Event.h" 30a9385537809ef342c843c5ab972e513742652047Greg Clayton#include "lldb/Core/RangeMap.h" 317508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham#include "lldb/Core/StringList.h" 3224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/ThreadSafeValue.h" 3324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/PluginInterface.h" 346e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice#include "lldb/Core/UserSettingsController.h" 3524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Breakpoint/BreakpointSiteList.h" 36a48fe1637ec6a381e500633c087f76662e364c20Sean Callanan#include "lldb/Expression/ClangPersistentVariables.h" 37f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan#include "lldb/Expression/IRDynamicChecks.h" 38ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton#include "lldb/Host/FileSpec.h" 391c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton#include "lldb/Host/Host.h" 40a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton#include "lldb/Host/ReadWriteLock.h" 41e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Args.h" 42e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton#include "lldb/Interpreter/Options.h" 4324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ExecutionContextScope.h" 44613b8739a4d489b7f1c571288d5786768c024205Greg Clayton#include "lldb/Target/Memory.h" 4524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/ThreadList.h" 4624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Target/UnixSignals.h" 47464c6161464694412b7472129e789248f1cf21b9Greg Clayton#include "lldb/Utility/PseudoTerminal.h" 4824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 5024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 51b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 52b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceSettings 53b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeclass ProcessInstanceSettings : public InstanceSettings 556e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice{ 566e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticepublic: 576e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 58334d33a19fd28cf41cba74cc61cf149e7101a603Greg Clayton ProcessInstanceSettings (const lldb::UserSettingsControllerSP &owner_sp, bool live_instance = true, const char *name = NULL); 596e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 606e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings (const ProcessInstanceSettings &rhs); 616e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 626e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 636e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ~ProcessInstanceSettings (); 646e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 656e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice ProcessInstanceSettings& 666e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice operator= (const ProcessInstanceSettings &rhs); 676e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 686e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 696e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 706e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice UpdateInstanceSettingsVariable (const ConstString &var_name, 716e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *index_value, 726e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const char *value, 736e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &instance_name, 746e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const SettingEntry &entry, 75b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton VarSetOperationType op, 766e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice Error &err, 776e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 786e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 79bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice bool 806e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice GetInstanceSettingsValue (const SettingEntry &entry, 816e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice const ConstString &var_name, 825bc8c97d62b2e399bd90fb7e00c903d7887412abCaroline Tice StringList &value, 83bcb5b454767121980d937d2610ba762fdb575c45Caroline Tice Error *err); 846e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 856e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 866e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Ticeprotected: 876e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 886e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice void 896e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, 906e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice bool pending); 916e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 920021c97fbd17e38113d2e76b93c94ee05213ee45Johnny Chen const ConstString 936e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice CreateInstanceName (); 946e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice}; 956e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 96b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 97b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInfo 98b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 99b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A base class for information for a process. This can be used to fill 100b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// out information for a process prior to launching it, or it can be 101b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// used for an instance of a process and can be filled in with the 102b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// existing values for that process. 103b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 104e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonclass ProcessInfo 105e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 106e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 107e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo () : 108ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable (), 109b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 110b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment (), 111444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 112444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 113e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch(), 114b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (LLDB_INVALID_PROCESS_ID) 115e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 116e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 117b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 118e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ProcessInfo (const char *name, 119e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec &arch, 120e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t pid) : 121b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_executable (name, false), 122b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments (), 123b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment(), 124444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid (UINT32_MAX), 125444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid (UINT32_MAX), 126e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch (arch), 127b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_pid (pid) 128e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 129e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 130e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 131e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 132e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear () 133e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 134ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton m_executable.Clear(); 135b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arguments.Clear(); 136b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_environment.Clear(); 137444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_uid = UINT32_MAX; 138444e35b5fdf15a25a427285650f06f1390e62c75Greg Clayton m_gid = UINT32_MAX; 139e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_arch.Clear(); 140e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = LLDB_INVALID_PROCESS_ID; 141e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 142e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 143e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 144e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetName() const 145e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 146ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetCString(); 147e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 148b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 149e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 150e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetNameLength() const 151e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 152ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable.GetFilename().GetLength(); 153e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 154e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 155ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton FileSpec & 156ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () 157ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 158ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 159e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 16036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 16136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 16236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetExecutableFile (const FileSpec &exe_file, bool add_exe_file_as_first_arg) 16336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file) 16536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable = exe_file; 16736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (add_exe_file_as_first_arg) 16836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 16936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton char filename[PATH_MAX]; 17036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (exe_file.GetPath(filename, sizeof(filename))) 171c86723f0a71f5d929f4543c544d9255da52ea49dHan Ming Ong m_arguments.InsertArgumentAtIndex (0, filename); 17236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton else 17536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 17636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton m_executable.Clear(); 17736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 17936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 180ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton const FileSpec & 181ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton GetExecutableFile () const 18224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 183ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton return m_executable; 18424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 18524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 186a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 187b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetUserID() const 188a733c04608cc94592a15d27583529588e19db552Greg Clayton { 189b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid; 190a733c04608cc94592a15d27583529588e19db552Greg Clayton } 191b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 192a733c04608cc94592a15d27583529588e19db552Greg Clayton uint32_t 193b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetGroupID() const 194a733c04608cc94592a15d27583529588e19db552Greg Clayton { 195b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid; 196a733c04608cc94592a15d27583529588e19db552Greg Clayton } 19724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 19824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 199b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton UserIDIsValid () const 20024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 201b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_uid != UINT32_MAX; 20224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 20324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 20424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 205b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GroupIDIsValid () const 20624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 207b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_gid != UINT32_MAX; 20824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 20924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 210a733c04608cc94592a15d27583529588e19db552Greg Clayton void 211b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetUserID (uint32_t uid) 212a733c04608cc94592a15d27583529588e19db552Greg Clayton { 213b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_uid = uid; 214a733c04608cc94592a15d27583529588e19db552Greg Clayton } 215a733c04608cc94592a15d27583529588e19db552Greg Clayton 216a733c04608cc94592a15d27583529588e19db552Greg Clayton void 217b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetGroupID (uint32_t gid) 218a733c04608cc94592a15d27583529588e19db552Greg Clayton { 219b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_gid = gid; 220a733c04608cc94592a15d27583529588e19db552Greg Clayton } 221b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 222e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton ArchSpec & 223e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () 224e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 225e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 226e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 227b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 228e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const ArchSpec & 229e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetArchitecture () const 230e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 231e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_arch; 232e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 233b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 234e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 235e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessID () const 236e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 237e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_pid; 238e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 239e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 240e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 241e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton SetProcessID (lldb::pid_t pid) 242e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 243e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_pid = pid; 244e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 245e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 246a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 247a733c04608cc94592a15d27583529588e19db552Greg Clayton ProcessIDIsValid() const 248a733c04608cc94592a15d27583529588e19db552Greg Clayton { 249a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_pid != LLDB_INVALID_PROCESS_ID; 250a733c04608cc94592a15d27583529588e19db552Greg Clayton } 251b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 252b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 253b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Dump (Stream &s, Platform *platform) const; 254b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 255b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 256b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () 257b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 258b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 259b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 260b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 261b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 262b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetArguments () const 263b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 264b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_arguments; 265b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 266b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 267b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 26836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetArguments (const Args& args, 26936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable, 27036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable_and_argument); 271b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 27236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton void 27336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetArguments (char const **argv, 27436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable, 27536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton bool first_arg_is_executable_and_argument); 27636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 277b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args & 278b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () 279b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 280b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 281b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 282b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 283b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Args & 284b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEnvironmentEntries () const 285b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 286b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_environment; 287b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 288b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 289b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 290b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileSpec m_executable; 291b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_arguments; 292b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Args m_environment; 293b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_uid; 294b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_gid; 295b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ArchSpec m_arch; 296b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_pid; 297b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 298b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 299b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 300b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfo 301b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 302b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes an existing process and any discoverable information that 303b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// pertains to that process. 304b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 305b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfo : public ProcessInfo 306b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 307b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 308b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo () : 309b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (), 310b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 311b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 312b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 313b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 314b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 315b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 316b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo (const char *name, 317b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ArchSpec &arch, 318b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t pid) : 319b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo (name, arch, pid), 320b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid (UINT32_MAX), 321b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid (UINT32_MAX), 322b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid (LLDB_INVALID_PROCESS_ID) 323b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 324b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 325b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 326b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 327b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 328b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 329b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 330b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = UINT32_MAX; 331b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = UINT32_MAX; 332b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_parent_pid = LLDB_INVALID_PROCESS_ID; 333b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 334b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 335b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 336b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveUserID() const 337b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 338b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid; 339b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 340b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 341b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t 342b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetEffectiveGroupID() const 343b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 344b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid; 345b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 346b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 347b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 348b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveUserIDIsValid () const 349b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 350b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_euid != UINT32_MAX; 351b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 352b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 353b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 354b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton EffectiveGroupIDIsValid () const 355b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 356b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_egid != UINT32_MAX; 357b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 358b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 359b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 360b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveUserID (uint32_t uid) 361b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 362b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_euid = uid; 363b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 364b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 365b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 366b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetEffectiveGroupID (uint32_t gid) 367b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 368b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_egid = gid; 369b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 370a733c04608cc94592a15d27583529588e19db552Greg Clayton 371a733c04608cc94592a15d27583529588e19db552Greg Clayton lldb::pid_t 372a733c04608cc94592a15d27583529588e19db552Greg Clayton GetParentProcessID () const 373a733c04608cc94592a15d27583529588e19db552Greg Clayton { 374a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid; 375a733c04608cc94592a15d27583529588e19db552Greg Clayton } 376a733c04608cc94592a15d27583529588e19db552Greg Clayton 377a733c04608cc94592a15d27583529588e19db552Greg Clayton void 378a733c04608cc94592a15d27583529588e19db552Greg Clayton SetParentProcessID (lldb::pid_t pid) 379a733c04608cc94592a15d27583529588e19db552Greg Clayton { 380a733c04608cc94592a15d27583529588e19db552Greg Clayton m_parent_pid = pid; 381a733c04608cc94592a15d27583529588e19db552Greg Clayton } 382a733c04608cc94592a15d27583529588e19db552Greg Clayton 383a733c04608cc94592a15d27583529588e19db552Greg Clayton bool 384a733c04608cc94592a15d27583529588e19db552Greg Clayton ParentProcessIDIsValid() const 385a733c04608cc94592a15d27583529588e19db552Greg Clayton { 386a733c04608cc94592a15d27583529588e19db552Greg Clayton return m_parent_pid != LLDB_INVALID_PROCESS_ID; 387a733c04608cc94592a15d27583529588e19db552Greg Clayton } 38824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 38924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 39024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Dump (Stream &s, Platform *platform) const; 39124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 39224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton static void 393b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpTableHeader (Stream &s, Platform *platform, bool show_args, bool verbose); 394b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 395b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 396b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton DumpAsTableRow (Stream &s, Platform *platform, bool show_args, bool verbose) const; 397b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 398b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonprotected: 399b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_euid; 400b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton uint32_t m_egid; 401b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton lldb::pid_t m_parent_pid; 402b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 4031c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 404b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 405b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 406b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessLaunchInfo 407b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 408b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// Describes any information that is required to launch a process. 409b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 410b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 411b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchInfo : public ProcessInfo 412b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 413b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 414b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 415b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton class FileAction 416b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 417b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton public: 41836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton enum Action 41936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 42036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionNone, 42136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionClose, 42236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionDuplicate, 42336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton eFileActionOpen 42436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton }; 42536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 426b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 427b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction () : 428b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action (eFileActionNone), 429b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd (-1), 430b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg (-1), 431b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path () 432b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 433b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 434b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 435b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 436b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear() 437b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 438b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_action = eFileActionNone; 439b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_fd = -1; 440b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_arg = -1; 441b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_path.clear(); 442b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 443b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 444b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 445b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Close (int fd); 446b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 447b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 448b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Duplicate (int fd, int dup_fd); 449b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 450b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton bool 451b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Open (int fd, const char *path, bool read, bool write); 452b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 453b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static bool 454b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AddPosixSpawnFileAction (posix_spawn_file_actions_t *file_actions, 455b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction *info, 456b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Log *log, 457b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error& error); 458b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 45936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 46036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFD () const 461b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 46236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_fd; 46336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 46436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 46536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Action 46636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetAction () const 46736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 46836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_action; 46936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton int 47236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetActionArgument () const 47336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 47436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_arg; 47536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 47636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 47736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char * 47836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetPath () const 47936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 48036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_path.empty()) 48136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 48236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return m_path.c_str(); 48336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 484b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 48536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton protected: 486b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Action m_action; // The action for this file 487b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_fd; // An existing file descriptor 488b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton int m_arg; // oflag for eFileActionOpen*, dup_fd for eFileActionDuplicate 489b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_path; // A file path to use for opening after fork or posix_spawn 490b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton }; 491b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 492b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo () : 493b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo(), 494ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_working_dir (), 495ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_plugin_name (), 496ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_shell (), 497ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_flags (0), 498ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_file_actions (), 499464c6161464694412b7472129e789248f1cf21b9Greg Clayton m_pty (), 500ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_resume_count (0), 501ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback (NULL), 502ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_callback_baton (NULL), 503ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_monitor_signals (false) 504b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 505b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 506b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 50736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo (const char *stdin_path, 50836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stdout_path, 50936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *stderr_path, 51036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const char *working_directory, 51136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton uint32_t launch_flags) : 51236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessInfo(), 5131c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_working_dir (), 5141c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_plugin_name (), 5151c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_shell (), 5161c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_flags (launch_flags), 5171c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_file_actions (), 518464c6161464694412b7472129e789248f1cf21b9Greg Clayton m_pty (), 5191c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_resume_count (0), 5201c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback (NULL), 5211c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton (NULL), 5221c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals (false) 52336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52495ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (stdin_path) 52536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 52636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 52736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = true; 52895ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool write = false; 52995ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (file_action.Open(STDIN_FILENO, stdin_path, read, write)) 53036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 53136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 53236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (stdout_path) 53336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 53436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 53536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool read = false; 53636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const bool write = true; 53736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (file_action.Open(STDOUT_FILENO, stdout_path, read, write)) 53836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 53936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 54095ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (stderr_path) 54136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 54236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton ProcessLaunchInfo::FileAction file_action; 54395ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool read = false; 54495ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton const bool write = true; 54595ec1688db0efe51509ad9356052f5004d8856e0Greg Clayton if (file_action.Open(STDERR_FILENO, stderr_path, read, write)) 54636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton AppendFileAction (file_action); 54736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 54836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (working_directory) 54936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton SetWorkingDirectory(working_directory); 55036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 551abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 552b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 553b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendFileAction (const FileAction &info) 554b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 555b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.push_back(info); 556b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 557b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 558abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 559b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendCloseFileAction (int fd) 560b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 561b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 562abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Close (fd)) 563abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 564abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 565abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 566abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 567abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 568b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 569b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 570abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 5710a8dcacde404c520f1131c641041dceb9f68b6faGreg Clayton AppendDuplicateFileAction (int fd, int dup_fd) 572b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 573b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 574abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Duplicate (fd, dup_fd)) 575abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 576abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 577abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 578abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 579abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 580b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 581b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 582abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 583b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendOpenFileAction (int fd, const char *path, bool read, bool write) 584b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 585b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 586abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, path, read, write)) 587abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 588abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 589abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 590abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 591abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 592b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 593b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 594abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton bool 595b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton AppendSuppressFileAction (int fd, bool read, bool write) 596b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 597b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton FileAction file_action; 598abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton if (file_action.Open (fd, "/dev/null", read, write)) 599abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton { 600abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton AppendFileAction (file_action); 601abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return true; 602abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton } 603abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton return false; 604b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 605abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton 606abb3302051246273eb92cca203c9a1b9d9736e05Greg Clayton void 607464c6161464694412b7472129e789248f1cf21b9Greg Clayton FinalizeFileActions (Target *target, 608464c6161464694412b7472129e789248f1cf21b9Greg Clayton bool default_to_use_pty); 609b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 610b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 611b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetNumFileActions () const 612b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 613b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_file_actions.size(); 614b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 615b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 616b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const FileAction * 617b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFileActionAtIndex (size_t idx) const 618b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 619b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (idx < m_file_actions.size()) 620b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return &m_file_actions[idx]; 621b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 622b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 623b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 62436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton const FileAction * 62536bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton GetFileActionForFD (int fd) const 62636bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 62736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton for (uint32_t idx=0, count=m_file_actions.size(); idx < count; ++idx) 62836bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton { 62936bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton if (m_file_actions[idx].GetFD () == fd) 63036bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return &m_file_actions[idx]; 63136bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 63236bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton return NULL; 63336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton } 63436bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton 635b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags & 636b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () 637b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 638b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 639b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 640b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 641b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const Flags & 642b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetFlags () const 643b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 644b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_flags; 645b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 646b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 647b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 648b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetWorkingDirectory () const 649b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 650b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_working_dir.empty()) 651b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 652b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_working_dir.c_str(); 653b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 65424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 65524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 656b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetWorkingDirectory (const char *working_dir) 657b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 658b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (working_dir && working_dir[0]) 659b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.assign (working_dir); 660b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 661b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 662b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 663ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 664b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 665b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SwapWorkingDirectory (std::string &working_dir) 666ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 667b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.swap (working_dir); 668b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 669b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 670b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 671b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const char * 672b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetProcessPluginName () const 673b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 674b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (m_plugin_name.empty()) 675b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return NULL; 676b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return m_plugin_name.c_str(); 677b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 678b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 679b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 680b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton SetProcessPluginName (const char *plugin) 681b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 682b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton if (plugin && plugin[0]) 683b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.assign (plugin); 684b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton else 685b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 686ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 687ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton 688527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 689527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetShell () const 690527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 691527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_shell.empty()) 692527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 693527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_shell.c_str(); 694527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 695527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 696527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 697527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetShell (const char * path) 698527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 699527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (path && path[0]) 700527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 701527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.assign (path); 702527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Set (lldb::eLaunchFlagLaunchInShell); 703527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 704527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 705527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 706527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 707527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_flags.Clear (lldb::eLaunchFlagLaunchInShell); 708527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 709527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 710527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 711527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 712527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 713527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 714527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 715527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 716527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 717527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 718527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 719527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 720527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 721527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 722527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 723b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 724b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Clear () 725ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton { 726b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInfo::Clear(); 727b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_working_dir.clear(); 728b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_plugin_name.clear(); 729527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_shell.clear(); 730b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_flags.Clear(); 731b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton m_file_actions.clear(); 732527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 733ff39f746ebaa3710c44ba49bd9b0a6cf05f60a3fGreg Clayton } 734a733c04608cc94592a15d27583529588e19db552Greg Clayton 735527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 73697471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton ConvertArgumentsForLaunchingInShell (Error &error, 73797471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool localhost, 73897471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool will_debug, 73997471184b8823c949bc68bbf54ea3edf3845a750Greg Clayton bool first_arg_is_full_shell_command); 740527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 7411c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void 7421c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton SetMonitorProcessCallback (Host::MonitorChildProcessCallback callback, 7431c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *baton, 7441c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool monitor_signals) 7451c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7461c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback = callback; 7471c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton = baton; 7481c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals = monitor_signals; 7491c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7501c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 7511c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool 7521c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton MonitorProcess () const 7531c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7541c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton if (m_monitor_callback && ProcessIDIsValid()) 7551c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton { 7561c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::StartMonitoringChildProcess (m_monitor_callback, 7571c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_callback_baton, 7581c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton GetProcessID(), 7591c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton m_monitor_signals); 7601c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return true; 7611c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7621c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton return false; 7631c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton } 7641c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 765464c6161464694412b7472129e789248f1cf21b9Greg Clayton lldb_utility::PseudoTerminal & 766464c6161464694412b7472129e789248f1cf21b9Greg Clayton GetPTY () 767464c6161464694412b7472129e789248f1cf21b9Greg Clayton { 768464c6161464694412b7472129e789248f1cf21b9Greg Clayton return m_pty; 769464c6161464694412b7472129e789248f1cf21b9Greg Clayton } 7701c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton 771e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 772b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_working_dir; 773b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::string m_plugin_name; 774527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_shell; 775b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Flags m_flags; // Bitwise OR of bits from lldb::LaunchFlags 776b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton std::vector<FileAction> m_file_actions; // File actions for any other files 777464c6161464694412b7472129e789248f1cf21b9Greg Clayton lldb_utility::PseudoTerminal m_pty; 778527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 7791c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton Host::MonitorChildProcessCallback m_monitor_callback; 7801c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton void *m_monitor_callback_baton; 7811c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool m_monitor_signals; 782527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton}; 783527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 784527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 785527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// ProcessLaunchInfo 786527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// 787527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton// Describes any information that is required to launch a process. 788527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton//---------------------------------------------------------------------- 789527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 790527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonclass ProcessAttachInfo : public ProcessInstanceInfo 791527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton{ 792527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonpublic: 793527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo() : 794527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 795527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 796527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 797527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch (false) 798527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 799527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 800527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 801527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessAttachInfo (const ProcessLaunchInfo &launch_info) : 802527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo(), 803527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name (), 804527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count (0), 805527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch (false) 806527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 807527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfo::operator= (launch_info); 808527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (launch_info.GetProcessPluginName()); 809527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (launch_info.GetResumeCount()); 810527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 811527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 812527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 813527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetWaitForLaunch () const 814527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 815527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_wait_for_launch; 816527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 817527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 818527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 819527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetWaitForLaunch (bool b) 820527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 821527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = b; 822527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 823527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 824527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t 825527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetResumeCount () const 826527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 827527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_resume_count; 828527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 829527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 830527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 831527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetResumeCount (uint32_t c) 832527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 833527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = c; 834527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 835527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 836527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton const char * 837527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton GetProcessPluginName () const 838527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 839527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (m_plugin_name.empty()) 840527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return NULL; 841527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return m_plugin_name.c_str(); 842527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 843527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 844527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 845527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton SetProcessPluginName (const char *plugin) 846527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 847527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (plugin && plugin[0]) 848527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.assign (plugin); 849527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton else 850527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 851527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 852527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 853527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton void 854527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Clear () 855527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 856527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInstanceInfo::Clear(); 857527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_plugin_name.clear(); 858527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_resume_count = 0; 859527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_wait_for_launch = false; 860527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 861527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton 862527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool 863527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton ProcessInfoSpecified () const 864527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton { 865527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetExecutableFile()) 866527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 867527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetProcessID() != LLDB_INVALID_PROCESS_ID) 868527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 869527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton if (GetParentProcessID() != LLDB_INVALID_PROCESS_ID) 870527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return true; 871527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton return false; 872527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton } 873527154d8e532f27f25af226c9e1dac607c48b5d1Greg Claytonprotected: 874527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton std::string m_plugin_name; 875527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton uint32_t m_resume_count; // How many times do we resume after launching 876527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton bool m_wait_for_launch; 877e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 878e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 879b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessLaunchCommandOptions : public Options 88024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton{ 88124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonpublic: 882b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 883b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchCommandOptions (CommandInterpreter &interpreter) : 884b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Options(interpreter) 885b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 886143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton // Keep default values of all options in one place: OptionParsingStarting () 887143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting (); 888b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 889b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 890b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ~ProcessLaunchCommandOptions () 891b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 892b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 893b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 894b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Error 895143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton SetOptionValue (uint32_t option_idx, const char *option_arg); 896b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 897b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton void 898143fcc3a15425659b381502ed4e1e50a3e726f36Greg Clayton OptionParsingStarting () 899b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 900b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton launch_info.Clear(); 901b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 902b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 903b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const OptionDefinition* 904b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetDefinitions () 905b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton { 906b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton return g_option_table; 907b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton } 908b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 909b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Options table: Required for subclasses of Options. 910b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 911b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton static OptionDefinition g_option_table[]; 912b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 913b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton // Instance variables to hold the values for command options. 914b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 915b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessLaunchInfo launch_info; 916b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton}; 917b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 918b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 919b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// ProcessInstanceInfoMatch 920b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// 921b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton// A class to help matching one ProcessInstanceInfo to another. 922b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton//---------------------------------------------------------------------- 923b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 924b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoMatch 925b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton{ 926b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonpublic: 927b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch () : 92824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 929a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton m_name_match_type (eNameMatchIgnore), 93024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 93124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 93224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 93324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 934b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoMatch (const char *process_name, 935a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType process_name_match_type) : 93624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_info (), 93724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type (process_name_match_type), 93824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users (false) 93924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 940527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton m_match_info.GetExecutableFile().SetFile(process_name, false); 94124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 94224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 943b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo & 94424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () 94524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 94624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 94724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 94824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 949b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 95024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfo () const 95124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 95224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_info; 95324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 95424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 95524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 95624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetMatchAllUsers () const 95724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 95824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_match_all_users; 95924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 96024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 96124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 96224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton SetMatchAllUsers (bool b) 96324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 96424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_match_all_users = b; 96524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 96624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 967a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType 96824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetNameMatchType () const 96924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 97024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_name_match_type; 97124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 97224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 97324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 974a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton SetNameMatchType (NameMatchType name_match_type) 97524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 97624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton m_name_match_type = name_match_type; 97724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 97824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 97924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 98024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton NameMatches (const char *process_name) const; 98124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 98224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 983b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Matches (const ProcessInstanceInfo &proc_info) const; 98424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 98524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool 98624bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton MatchAllProcesses () const; 98724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton void 98824bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton Clear (); 98924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 99024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Claytonprotected: 991b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfo m_match_info; 992a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton NameMatchType m_name_match_type; 99324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton bool m_match_all_users; 99424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton}; 99524bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 996b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Claytonclass ProcessInstanceInfoList 997e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton{ 998e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonpublic: 999b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ProcessInstanceInfoList () : 1000e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos() 1001e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1002e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1003e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1004e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1005e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton Clear() 1006e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1007e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.clear(); 1008e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1009e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1010e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton uint32_t 1011e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetSize() 1012e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1013e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos.size(); 1014e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1015e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1016e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton void 1017b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton Append (const ProcessInstanceInfo &info) 1018e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1019e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton m_infos.push_back (info); 1020e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1021e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1022e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton const char * 1023e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameAtIndex (uint32_t idx) 1024e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1025e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1026e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetName(); 1027e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return NULL; 1028e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1029e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1030e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton size_t 1031e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessNameLengthAtIndex (uint32_t idx) 1032e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1033e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1034e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetNameLength(); 1035e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return 0; 1036e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1037e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1038e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton lldb::pid_t 1039e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton GetProcessIDAtIndex (uint32_t idx) 1040e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1041e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1042e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return m_infos[idx].GetProcessID(); 10432bc9eb3ba78efc64a273729b480bafc3bbaa433aJohnny Chen return 0; 1044e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1045e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 1046e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton bool 1047b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton GetInfoAtIndex (uint32_t idx, ProcessInstanceInfo &info) 1048e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1049e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton if (idx < m_infos.size()) 1050e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton { 1051e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton info = m_infos[idx]; 1052e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return true; 1053e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1054e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton return false; 1055e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton } 1056e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 105724bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton // You must ensure "idx" is valid before calling this function 1058b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton const ProcessInstanceInfo & 105924bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton GetProcessInfoAtIndex (uint32_t idx) const 106024bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton { 106124bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton assert (idx < m_infos.size()); 106224bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton return m_infos[idx]; 106324bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton } 106424bc5d9bfad2a1c562c27e7cf37e1c56d85c45e7Greg Clayton 1065e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Claytonprotected: 1066b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton typedef std::vector<ProcessInstanceInfo> collection; 1067e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton collection m_infos; 1068e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton}; 1069e4b9c1fb338ee1ada72e6a3c198afb342d68c5c1Greg Clayton 10706e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 107121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// This class tracks the Modification state of the process. Things that can currently modify 107221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// the program are running the program (which will up the StopID) and writing memory (which 107321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// will up the MemoryID.) 107421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham// FIXME: Should we also include modification of register states? 107521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 107621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamclass ProcessModID 107721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 107821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend bool operator== (const ProcessModID &lhs, const ProcessModID &rhs); 107921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghampublic: 108021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID () : 10810296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id (0), 10820296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id (0), 10830296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_memory_id (0), 10840296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume (0), 10850296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression (false) 108621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 108721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 108821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID (const ProcessModID &rhs) : 108921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id (rhs.m_stop_id), 109021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id (rhs.m_memory_id) 109121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham {} 109221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 109321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham const ProcessModID & operator= (const ProcessModID &rhs) 109421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 109521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (this != &rhs) 109621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 109721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = rhs.m_stop_id; 109821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_memory_id = rhs.m_memory_id; 109921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 110021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return *this; 110121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 110221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 110321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ~ProcessModID () {} 110421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 11050296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpStopID () { 11060296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_stop_id++; 11070296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11080296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 110921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void BumpMemoryID () { m_memory_id++; } 111021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 11110296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void BumpResumeID () { 11120296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_resume_id++; 11130296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (m_running_user_expression > 0) 11140296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_last_user_expression_resume = m_resume_id; 11150296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11160296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 111721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetStopID() const { return m_stop_id; } 111821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t GetMemoryID () const { return m_memory_id; } 11190296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetResumeID () const { return m_resume_id; } 11200296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t GetLastUserExpressionResumeID () const { return m_last_user_expression_resume; } 112121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 112221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool MemoryIDEqual (const ProcessModID &compare) const 112321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 112421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_memory_id == compare.m_memory_id; 112521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 112621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 112721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool StopIDEqual (const ProcessModID &compare) const 112821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 112921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id == compare.m_stop_id; 113021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 113121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 113221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham void SetInvalid () 113321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 113421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham m_stop_id = UINT32_MAX; 113521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 113621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 113721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham bool IsValid () const 113821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 113921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_stop_id != UINT32_MAX; 114021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 11410296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 11420296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 11430296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on) 11440296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 11450296fe73a7cb1482226b1303a795ede00e12d677Jim 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); 11460296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham if (on) 11470296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression++; 11480296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham else 11490296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham m_running_user_expression--; 11500296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 11510296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 115221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamprivate: 115321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_stop_id; 11540296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_resume_id; 115521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham uint32_t m_memory_id; 11560296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_last_user_expression_resume; 11570296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t m_running_user_expression; 115821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham}; 115921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator== (const ProcessModID &lhs, const ProcessModID &rhs) 116021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 116121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (lhs.StopIDEqual (rhs) 116221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham && lhs.MemoryIDEqual (rhs)) 116321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 116421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 116521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 116621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 116721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 116821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghaminline bool operator!= (const ProcessModID &lhs, const ProcessModID &rhs) 116921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham{ 117021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham if (!lhs.StopIDEqual (rhs) 117121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham || !lhs.MemoryIDEqual (rhs)) 117221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return true; 117321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham else 117421f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return false; 117521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham} 1176a9385537809ef342c843c5ab972e513742652047Greg Clayton 1177a9385537809ef342c843c5ab972e513742652047Greg Claytonclass MemoryRegionInfo 1178a9385537809ef342c843c5ab972e513742652047Greg Clayton{ 1179a9385537809ef342c843c5ab972e513742652047Greg Claytonpublic: 1180a9385537809ef342c843c5ab972e513742652047Greg Clayton typedef Range<lldb::addr_t, lldb::addr_t> RangeType; 11811f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 11821f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda enum OptionalBool { 11831f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eDontKnow = -1, 11841f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eNo = 0, 11851f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda eYes = 1 11861f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda }; 11871f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 1188a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo () : 1189a9385537809ef342c843c5ab972e513742652047Greg Clayton m_range (), 11901f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read (eDontKnow), 11911f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_write (eDontKnow), 11921f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_execute (eDontKnow) 1193a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1194a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1195a9385537809ef342c843c5ab972e513742652047Greg Clayton 1196a9385537809ef342c843c5ab972e513742652047Greg Clayton ~MemoryRegionInfo () 1197a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1198a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1199a9385537809ef342c843c5ab972e513742652047Greg Clayton 1200a9385537809ef342c843c5ab972e513742652047Greg Clayton RangeType & 1201a9385537809ef342c843c5ab972e513742652047Greg Clayton GetRange() 1202a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1203a9385537809ef342c843c5ab972e513742652047Greg Clayton return m_range; 1204a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1205a9385537809ef342c843c5ab972e513742652047Greg Clayton 1206a9385537809ef342c843c5ab972e513742652047Greg Clayton void 1207a9385537809ef342c843c5ab972e513742652047Greg Clayton Clear() 1208a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1209a9385537809ef342c843c5ab972e513742652047Greg Clayton m_range.Clear(); 12101f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read = m_write = m_execute = eDontKnow; 1211a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1212a9385537809ef342c843c5ab972e513742652047Greg Clayton 1213a9385537809ef342c843c5ab972e513742652047Greg Clayton const RangeType & 1214a9385537809ef342c843c5ab972e513742652047Greg Clayton GetRange() const 1215a9385537809ef342c843c5ab972e513742652047Greg Clayton { 1216a9385537809ef342c843c5ab972e513742652047Greg Clayton return m_range; 1217a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12181f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12191f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12201f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetReadable () const 1221a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12221f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_read; 1223a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12241f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12251f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12261f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetWritable () const 1227a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12281f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_write; 12291f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda } 12301f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 12311f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool 12321f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetExecutable () const 12331f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda { 12341f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return m_execute; 1235a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1236a9385537809ef342c843c5ab972e513742652047Greg Clayton 1237a9385537809ef342c843c5ab972e513742652047Greg Clayton void 12381f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetReadable (OptionalBool val) 1239a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12401f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_read = val; 1241a9385537809ef342c843c5ab972e513742652047Greg Clayton } 12421f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 1243a9385537809ef342c843c5ab972e513742652047Greg Clayton void 12441f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetWritable (OptionalBool val) 1245a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12461f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_write = val; 1247a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1248a9385537809ef342c843c5ab972e513742652047Greg Clayton 1249a9385537809ef342c843c5ab972e513742652047Greg Clayton void 12501f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda SetExecutable (OptionalBool val) 1251a9385537809ef342c843c5ab972e513742652047Greg Clayton { 12521f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda m_execute = val; 1253a9385537809ef342c843c5ab972e513742652047Greg Clayton } 1254a9385537809ef342c843c5ab972e513742652047Greg Clayton 1255a9385537809ef342c843c5ab972e513742652047Greg Claytonprotected: 1256a9385537809ef342c843c5ab972e513742652047Greg Clayton RangeType m_range; 12571f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_read; 12581f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_write; 12591f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda OptionalBool m_execute; 1260a9385537809ef342c843c5ab972e513742652047Greg Clayton}; 126121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 126224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 126324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @class Process Process.h "lldb/Target/Process.h" 126424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner/// @brief A plug-in interface definition class for debugging a process. 126524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//---------------------------------------------------------------------- 126624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass Process : 1267598df88bd6fc33c6fb330bc859bdc277795501f3Greg Clayton public STD_ENABLE_SHARED_FROM_THIS(Process), 126824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public UserID, 126924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public Broadcaster, 127024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public ExecutionContextScope, 12716e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public PluginInterface, 12726e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public ProcessInstanceSettings 127324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 127424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerfriend class ThreadList; 1275d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Inghamfriend class ClangFunction; // For WaitForStateChangeEventsPrivate 127621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectProcessLaunch; 127721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class ProcessEventData; 127821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class CommandObjectBreakpointCommand; 127921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Inghamfriend class StopInfo; 128024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 128124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 128224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 128324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 128424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Broadcaster event bits definitions. 128524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 128624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 128724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 128824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitStateChanged = (1 << 0), 128924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitInterrupt = (1 << 1), 129024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastBitSTDOUT = (1 << 2), 1291e28824e0b988221c7eedf8e3d212527d2bdac6a7Eli Friedman eBroadcastBitSTDERR = (1 << 3) 129224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 129324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 129424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum 129524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 129624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlStop = (1<<0), 129724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlPause = (1<<1), 129824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner eBroadcastInternalStateControlResume = (1<<2) 129924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 13005a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 1301761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton typedef Range<lldb::addr_t, lldb::addr_t> LoadRange; 1302a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // We use a read/write lock to allow on or more clients to 1303a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // access the process state while the process is stopped (reader). 1304a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // We lock the write lock to control access to the process 1305a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // while it is running (readers, or clients that want the process 1306a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // stopped can block waiting for the process to stop, or just 1307a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // try to lock it to see if they can immediately access the stopped 1308a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // process. If the try read lock fails, then the process is running. 1309a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef ReadWriteLock::ReadLocker StopLocker; 1310a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef ReadWriteLock::WriteLocker RunLocker; 1311761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton 13125a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham // These two functions fill out the Broadcaster interface: 13135a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 13145a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham static ConstString &GetStaticBroadcasterClass (); 13155a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 13165a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham virtual ConstString &GetBroadcasterClass() const 13175a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham { 13185a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham return GetStaticBroadcasterClass(); 13195a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham } 13205a15e6927b5b3234fb3e688717297ba6b5dd6ad7Jim Ingham 132124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 132224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A notification structure that can be used by clients to listen 132324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for changes in a process's lifetime. 132424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 132524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see RegisterNotificationCallbacks (const Notifications&) 132624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see UnregisterNotificationCallbacks (const Notifications&) 132724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 132824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 132924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner typedef struct 133024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 133124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *baton; 133224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*initialize)(void *baton, Process *process); 133324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void (*process_state_changed) (void *baton, Process *process, lldb::StateType state); 133424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } Notifications; 133524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 133624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner class ProcessEventData : 133724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public EventData 133824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 13393ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham friend class Process; 13403ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 134124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public: 134224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (); 134324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ProcessEventData (const lldb::ProcessSP &process, lldb::StateType state); 134424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 134524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual ~ProcessEventData(); 134624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 134724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const ConstString & 134824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavorString (); 134924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual const ConstString & 135124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetFlavor () const; 135224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 135324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::ProcessSP & 13543ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetProcessSP() const 13553ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13563ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_process_sp; 13573ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 135824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 13593ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetState() const 13603ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13613ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_state; 13623ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 136324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 13643ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetRestarted () const 13653ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13663ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_restarted; 13673ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 13683ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool 13693ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterrupted () const 13703ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 13713ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham return m_interrupted; 13723ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 137324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 137424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 137524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Dump (Stream *s) const; 137624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 137724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 137824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoOnRemoval (Event *event_ptr); 137924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static const Process::ProcessEventData * 138124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetEventDataFromEvent (const Event *event_ptr); 138224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::ProcessSP 138424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetProcessFromEvent (const Event *event_ptr); 138524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static lldb::StateType 138724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetStateFromEvent (const Event *event_ptr); 138824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 138924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 139024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetRestartedFromEvent (const Event *event_ptr); 139124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void 139324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetRestartedInEvent (Event *event_ptr, bool new_value); 139424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 139524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 13963ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham GetInterruptedFromEvent (const Event *event_ptr); 13973ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 13983ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static void 13993ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterruptedInEvent (Event *event_ptr, bool new_value); 14003ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham 14013ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham static bool 140224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetUpdateStateOnRemoval (Event *event_ptr); 140324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner private: 140524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 140624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 14073ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetUpdateStateOnRemoval() 14083ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14096cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham m_update_state++; 14103ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 141124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 14123ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetRestarted (bool new_value) 14133ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14143ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_restarted = new_value; 14153ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 14163ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham void 14173ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham SetInterrupted (bool new_value) 14183ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham { 14193ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham m_interrupted = new_value; 14203ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham } 142124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 142224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ProcessSP m_process_sp; 142324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType m_state; 142424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool m_restarted; // For "eStateStopped" events, this is true if the target was automatically restarted. 14256cf4d2b31bf208cd6e48d4e37af671ab9b451446Jim Ingham int m_update_state; 14263ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham bool m_interrupted; 142724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (ProcessEventData); 142824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 142924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 14306e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1431d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton class SettingsController : public UserSettingsController 14326e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice { 14336e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice public: 14346e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1435d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton SettingsController (); 14366e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14376e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice virtual 1438d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton ~SettingsController (); 14396e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14406e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry global_settings_table[]; 14416e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice static SettingEntry instance_settings_table[]; 14426e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14436e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice protected: 14446e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14456e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice lldb::InstanceSettingsSP 1446d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton CreateInstanceSettings (const char *instance_name); 14476e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14486e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice private: 14496e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14506e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice // Class-wide settings. 14516e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 1452d0a5a23d734da7a2170802ccd096f53b8a527811Greg Clayton DISALLOW_COPY_AND_ASSIGN (SettingsController); 14536e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice }; 14546e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 145521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 145624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 145724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1458990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 14592a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsInitialize (); 1460990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1461990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static void 14622a456816c5d7c575f2e141acd48bb5f8085d9910Caroline Tice SettingsTerminate (); 1463990de7bb41d3afec6b789155408ff322187d8682Greg Clayton 1464990de7bb41d3afec6b789155408ff322187d8682Greg Clayton static lldb::UserSettingsControllerSP & 1465990de7bb41d3afec6b789155408ff322187d8682Greg Clayton GetSettingsController (); 14666e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 14671ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice void 14681ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice UpdateInstanceName (); 14691ebef44c126bd3a615b3ad844c46a82a82efa0e7Caroline Tice 1470395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 147124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 147224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Construct with a shared pointer to a target, and the Process listener. 147324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 147424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Process(Target &target, Listener &listener); 147524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 147624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 147724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Destructor. 147824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 147924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The destructor is virtual since this class is designed to be 148024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// inherited from by the plug-in instance. 148124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 148224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 148324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~Process(); 148424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 148524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 148624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Find a Process plug-in that can debug \a module using the 148724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently selected architecture. 148824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 148924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Scans all loaded plug-in interfaces that implement versions of 149024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the Process plug-in interface and returns the first instance 149124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that can debug the file. 149224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 149324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module_sp 149424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module shared pointer that this process will debug. 149524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 149624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] plugin_name 149724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If NULL, select the best plug-in for the binary. If non-NULL 149824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// then look for a plugin whose PluginInfo's name matches 149924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this string. 150024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 150124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::CanDebug () 150224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 150346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton static lldb::ProcessSP 150446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton FindPlugin (Target &target, 150546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const char *plugin_name, 150646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Listener &listener, 150746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const FileSpec *crash_file_path); 150824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 150924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 151124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 151224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Static function that can be used with the \b host function 151324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Host::StartMonitoringChildProcess (). 151424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 151524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function can be used by lldb_private::Process subclasses 151624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when they want to watch for a local process and have its exit 151724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// status automatically set when the host child process exits. 151824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses should call Host::StartMonitoringChildProcess () 151924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// with: 152024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback = Process::SetHostProcessExitStatus 152124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback_baton = NULL 152224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// pid = Process::GetID() 152324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// monitor_signals = false 152424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 152524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static bool 152624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetProcessExitStatus (void *callback_baton, // The callback baton which should be set to NULL 152724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::pid_t pid, // The process ID we want to monitor 15281c4642c6ab741d85c98d4288cf922c9a2ef77007Greg Clayton bool exited, 152924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int signo, // Zero for no signal 153024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int status); // Exit value of process if signal is zero 153124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1532395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton lldb::ByteOrder 1533395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetByteOrder () const; 1534395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 1535395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton uint32_t 1536395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetAddressByteSize () const; 1537395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 153824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 153924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a plug-in instance can debug the file in \a module. 154024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1541fe424a92fc6fd92f810d243912461fe028a2b63cGreg Clayton /// Each plug-in is given a chance to say whether it can debug 154224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the file in \a module. If the Process plug-in instance can 154324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug a file on the current system, it should return \b true. 154424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 154524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 154624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if this Process plug-in instance can 154724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// debug the executable, \b false otherwise. 154824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 154924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 15508d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton CanDebug (Target &target, 15518d2ea2888a4acb7f140f9af64ddd2b16b2dee870Greg Clayton bool plugin_specified_by_name) = 0; 155224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 155324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 155424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 155524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This object is about to be destroyed, do any necessary cleanup. 155624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 155724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses that override this method should always call this 155824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// superclass method. 155924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 156124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Finalize(); 156224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 156324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 156424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 156524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 156624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using the 156724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// target object's executable module's file as the file to launch. 156824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Arguments are given in \a argv, and the environment variables 156924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// are in \a envp. Standard input and output files can be 157024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// optionally re-directed to \a stdin_path, \a stdout_path, and 157124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stderr_path. 157224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 157324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 157424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. It will first call Process::WillLaunch (Module *) 157524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and if that returns \b true, Process::DoLaunch (Module*, 157624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// char const *[],char const *[],const char *,const char *, 157724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// const char *) will be called to actually do the launching. If 157824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// DoLaunch returns \b true, then Process::DidLaunch() will be 157924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// called. 158024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 158124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 158224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 158324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 158424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 158524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 158624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1587452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 1588452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 1589452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 159024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 159124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 159224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 159324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 159424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 159524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 159624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 159724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 159824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 159924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 160024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 160124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 160224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 160324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 160424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1605de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 1606de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 1607de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 160824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 160924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// An error object. Call GetID() to get the process ID if 161024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the error object is success. 161124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 161224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 161336bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton Launch (const ProcessLaunchInfo &launch_info); 161424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 161546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton virtual Error 161646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton LoadCore (); 161746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 161846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton virtual Error 161946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoLoadCore () 162046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 162146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 162246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support loading core files.", GetShortPluginName()); 162346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 162446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 16259ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton 16269ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton //------------------------------------------------------------------ 16279ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// Get the dynamic loader plug-in for this process. 16289ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// 16299ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// The default action is to let the DynamicLoader plug-ins check 16309ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// the main executable and the DynamicLoader will select itself 16319ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// automatically. Subclasses can override this if inspecting the 16329ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// executable is not desired, or if Process subclasses can only 16339ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton /// use a specific DynamicLoader plug-in. 16349ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton //------------------------------------------------------------------ 16359ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton virtual DynamicLoader * 16369ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton GetDynamicLoader (); 163746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 163824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 1639527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// Attach to an existing process using the process attach info. 164024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 1642527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// subclasses. It will first call WillAttach (lldb::pid_t) 1643527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// or WillAttach (const char *), and if that returns \b 1644527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton /// true, DoAttach (lldb::pid_t) or DoAttach (const char *) will 164524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be called to actually do the attach. If DoAttach returns \b 164624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// true, then Process::DidAttach() will be called. 164724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 164824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 164924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 165024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 165124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 165224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 165324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 165424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 165524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 1656527154d8e532f27f25af226c9e1dac607c48b5d1Greg Clayton Attach (ProcessAttachInfo &attach_info); 165724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1658e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1659e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton ConnectRemote (const char *remote_url); 16607508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham 1661dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham bool 1662ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton GetShouldDetach () const 1663dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham { 1664ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton return m_should_detach; 1665dbcf98c194742f911c963854084c66aa49a5e513Jim Ingham } 1666ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 1667ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton void 1668ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton SetShouldDetach (bool b) 1669ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton { 1670ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton m_should_detach = b; 1671ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton } 1672ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton 16737508e732818c32e1cfeaaf7d1d507fe3834ce9d2Jim Ingham //------------------------------------------------------------------ 167424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the image information address for the current process. 167524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 167624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Some runtimes have system functions that can help dynamic 167724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// loaders locate the dynamic loader information needed to observe 167824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// shared libraries being loaded or unloaded. This function is 167924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// in the Process interface (as opposed to the DynamicLoader 168024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface) to ensure that remote debugging can take advantage of 168124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// this functionality. 168224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 168324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 168424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the dynamic loader information, or 168524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if this is not supported by this 168624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// interface. 168724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 168824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 168924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetImageInfoAddress (); 169024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 169124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 16920baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Load a shared library into this process. 16930baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 16940baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// Try and load a shared library into the current process. This 16950baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// call might fail in the dynamic loader plug-in says it isn't safe 16960baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// to try and load shared libraries at the moment. 16970baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 16980baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[in] image_spec 16990baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// The image file spec that points to the shared library that 17000baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// you want to load. 17010baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 17020baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @param[out] error 17030baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// An error object that gets filled in with any errors that 17040baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// might occur when trying to load the shared library. 17050baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// 17060baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// @return 17070baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// A token that represents the shared library that can be 17080baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// later used to unload the shared library. A value of 17090baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// LLDB_INVALID_IMAGE_TOKEN will be returned if the shared 17100baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton /// library can't be opened. 17110baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 17120baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual uint32_t 17130baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton LoadImage (const FileSpec &image_spec, Error &error); 17140baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 17150baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton virtual Error 17160baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton UnloadImage (uint32_t image_token); 17170baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton 17180baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton //------------------------------------------------------------------ 171924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Register for process and thread notifications. 172024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can register nofication callbacks by filling out a 172224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::Notifications structure and calling this function. 172324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 172524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 172624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 172724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 172824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 172924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 173024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 173124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 173224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RegisterNotificationCallbacks (const Process::Notifications& callbacks); 173324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 173424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 173524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Unregister for process and thread notifications. 173624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 173724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Clients can unregister nofication callbacks by passing a copy of 173824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the original baton and callbacks in \a callbacks. 173924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] callbacks 174124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A structure that contains the notification baton and 174224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// callback functions. 174324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 174524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the notification callbacks were 174624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// successfully removed from the process, \b false otherwise. 174724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 174824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Process::Notifications 174924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 175024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef SWIG 175124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 175224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnregisterNotificationCallbacks (const Process::Notifications& callbacks); 175324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif 175424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 175524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Built in Process Control functions 175624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 175724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 175824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 175924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 176024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 176124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 176224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 176324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 176424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 176524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 176624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 176724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. This function will take care of disabling any 176824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// breakpoints that threads may be stopped at, single stepping, and 176924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// re-enabling breakpoints, and enabling the basic flow control 177024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that the plug-in instances need not worry about. 177124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1772027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// N.B. This function also sets the Write side of the Run Lock, 1773027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// which is unset when the corresponding stop event is pulled off 1774027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// the Public Event Queue. If you need to resume the process without 1775027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// setting the Run Lock, use PrivateResume (though you should only do 1776027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// that from inside the Process class. 1777027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// 177824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 177924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 178024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 178124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 178224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 178324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 178424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 17853ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 1786027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham Resume(); 1787027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham 178824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 178924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 179024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 179124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 179224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 17933ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// If the process is successfully halted, a eStateStopped 17943ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// process event with GetInterrupted will be broadcast. If false, we will 17953ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// halt the process with no events generated by the halt. 179624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 179724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 17983ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// Returns an error object. If the error is empty, the process is halted. 17993ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// otherwise the halt has failed. 180024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18013ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 180224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Halt (); 180324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 180424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 180524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 180624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 180724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 180824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 180924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 181024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 181124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 181224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18133ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 181424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Detach (); 181524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 181624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 181724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Kills the process and shuts down all threads that were spawned 181824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to track and monitor the process. 181924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 182024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 182124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 182224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 182324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 182424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 182524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18263ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 182724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Destroy(); 182824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 182924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 183024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 183124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 183224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 183324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses. 183424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 183524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 183624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 183724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 18383ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham Error 183924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Signal (int signal); 184024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual UnixSignals & 1842395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetUnixSignals () 1843395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 1844395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_unix_signals; 1845395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 184624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 184724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 184824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Plug-in Process Control Overrides 184924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //================================================================== 185024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 185124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 185224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 185324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 185424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 185524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 185624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 185724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 185824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 185924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 186154e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithID (lldb::pid_t pid) 186224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 186324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 186424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 186524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 186624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 186724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before attaching to a process. 186824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 186924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before attaching a 187024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 187124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 187224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 187324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 187424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 187524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 187654e7afa84d945f9137f9372ecde432f9e1a702fcGreg Clayton WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) 187724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 187824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 187924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 188024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1881e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton virtual Error 1882e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton DoConnectRemote (const char *remote_url) 1883e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton { 1884e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton Error error; 1885e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton error.SetErrorString ("remote connections are not supported"); 1886e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton return error; 1887e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton } 1888e71e258286a1713dbb2d366d8b81ff2f28e0216fGreg Clayton 188924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a process ID. 189124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 189224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] pid 189324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process ID that we should attempt to attach to. 189424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 189524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 189624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 189724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 189824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 189924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 190046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoAttachToProcessWithID (lldb::pid_t pid) 190146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 190246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 190346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support attaching to a process by pid", GetShortPluginName()); 190446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 190546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 190624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 190724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 1908d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Attach to an existing process using a process ID. 1909d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 1910d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] pid 1911d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// The process ID that we should attempt to attach to. 1912d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 1913d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] attach_info 1914d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Information on how to do the attach. For example, GetUserID() 1915d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// will return the uid to attach as. 1916d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 1917d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @return 1918d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Returns \a pid if attaching was successful, or 1919d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// LLDB_INVALID_PROCESS_ID if attaching fails. 1920d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// hanming : need flag 1921d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong //------------------------------------------------------------------ 1922d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong virtual Error 1923d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong DoAttachToProcessWithID (lldb::pid_t pid, const ProcessAttachInfo &attach_info) 1924d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong { 1925d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong Error error; 1926d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong error.SetErrorStringWithFormat("error: %s does not support attaching to a process by pid", GetShortPluginName()); 1927d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong return error; 1928d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong } 1929d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong 1930d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong //------------------------------------------------------------------ 193124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Attach to an existing process using a partial process name. 193224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 193324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] process_name 193424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The name of the process to attach to. 193524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 193624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] wait_for_launch 193724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If \b true, wait for the process to be launched and attach 193824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// as soon as possible after it does launch. If \b false, then 193924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// search for a matching process the currently exists. 194024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 1941d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// @param[in] attach_info 1942d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// Information on how to do the attach. For example, GetUserID() 1943d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// will return the uid to attach as. 1944d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong /// 194524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 194624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \a pid if attaching was successful, or 194724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_PROCESS_ID if attaching fails. 194824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 194924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 1950d1040dd360c07305a30d33b5d4501cb9dfb03114Han Ming Ong DoAttachToProcessWithName (const char *process_name, bool wait_for_launch, const ProcessAttachInfo &attach_info) 195124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 195224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error error; 195324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("attach by name is not supported"); 195424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return error; 195524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 195624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 195724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 195824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after attaching a process. 195924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 196024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after attaching to 196124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 196224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 196424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidAttach () {} 196524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 196624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 196724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 196824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before launching to a process. 196924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 197024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before launching a 197124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 197224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 197324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 197424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 197524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 197624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 197724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillLaunch (Module* module) 197824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 197924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 198024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 198124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 198224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 198324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process. 198424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 198524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Launch a new process by spawning a new process using \a module's 198624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// file as the file to launch. Arguments are given in \a argv, 198724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and the environment variables are in \a envp. Standard input 198824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// and output files can be optionally re-directed to \a stdin_path, 198924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \a stdout_path, and \a stderr_path. 199024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 199124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] module 199224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The module from which to extract the file specification and 199324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launch. 199424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 199524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] argv 199624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The argument array. 199724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 199824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] envp 199924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The environment array. 200024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2001452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// @param[in] launch_flags 2002452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// Flags to modify the launch (@see lldb::LaunchFlags) 2003452bf613496c7290c6b7a1a1eb28efbce63fd3b9Greg Clayton /// 200424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdin_path 200524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDIN of the new 200624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 200724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 200824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 200924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stdout_path 201024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDOUT of the new 201124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 201224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 201324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 201424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] stderr_path 201524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The path to use when re-directing the STDERR of the new 201624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. If all stdXX_path arguments are NULL, a pseudo 201724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// terminal will be used. 201824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2019de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// @param[in] working_directory 2020de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// The working directory to have the child process run in 2021de915beb5febe597505ba33fdc2c39eea2abdbd4Greg Clayton /// 202224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 202324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A new valid process ID, or LLDB_INVALID_PROCESS_ID if 202424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// launching fails. 202524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 202624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 202736bc5ea5a48c19421d44f559e2165c105657b809Greg Clayton DoLaunch (Module *exe_module, 202846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton const ProcessLaunchInfo &launch_info) 202946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 203046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 203146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support launching processes", GetShortPluginName()); 203246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 203346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 203446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 203524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 203624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 203724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after launching a process. 203824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 203924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after launching 204024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 204124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 204324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidLaunch () {} 204424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 204524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 204624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 204724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 204824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before resuming to a process. 204924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before resuming a 205124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 205224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 205324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 205424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 205524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 205624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 205724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillResume () { return Error(); } 205824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 205924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 206024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Resumes all of a process's threads as configured using the 206124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Thread run control functions. 206224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 206324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Threads for a process should be updated with one of the run 206424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// control actions (resume, step, or suspend) that they should take 206524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// when the process is resumed. If no run control action is given 206624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to a thread it will be resumed by default. 206724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 206824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 206924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully resumes using 207024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the thread run control actions, \b false otherwise. 207124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 207224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Resume() 207324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Step() 207424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see Thread:Suspend() 207524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 207624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 207746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoResume () 207846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 207946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 208046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support resuming processes", GetShortPluginName()); 208146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 208246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 208346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 208424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 208524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 208624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after resuming a process. 208724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 208824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after resuming 208924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 209024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 209124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 209224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidResume () {} 209324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 209424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 209524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 209624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before halting to a process. 209724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 209824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before halting a 209924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// process. 210024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 210124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 210224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 210324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 210424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 210524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillHalt () { return Error(); } 210624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 210724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 210824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Halts a running process. 210924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2110360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt must produce one and only one stop StateChanged event if it actually 2111360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// stops the process. If the stop happens through some natural event (for 2112360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// instance a SIGSTOP), then forwarding that event will do. Otherwise, you must 2113360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// generate the event manually. Note also, the private event thread is stopped when 2114360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// DoHalt is run to prevent the events generated while halting to trigger 2115360f53f3c216ee4fb433da0a367168785328a856Jim Ingham /// other state changes before the halt is complete. 21163ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 21173ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// @param[out] caused_stop 211820d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// If true, then this Halt caused the stop, otherwise, the 211920d338fad87eba91de65aa9bec76e01c04472848Greg Clayton /// process was already stopped. 21203ae449a5c3b4f51afc0da22cfeaef00c303c0accJim Ingham /// 212124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 212224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully halts, \b false 212324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 212424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 212524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 212646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoHalt (bool &caused_stop) 212746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 212846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 212946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support halting processes", GetShortPluginName()); 213046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 213146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 213246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 213324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 213424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 213524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after halting a process. 213624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 213724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after halting 213824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a process. 213924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 214024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 214124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidHalt () {} 214224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 214324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 214424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before detaching from a process. 214524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 214624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before detaching 214724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 214824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 214924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 215024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 215124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 215224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 215324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDetach () 215424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 215524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return Error(); 215624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 215724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 215824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 215924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Detaches from a running or stopped process. 216024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 216124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 216224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process successfully detaches, \b 216324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// false otherwise. 216424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 216524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 216646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoDetach () 216746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 216846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 216946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support detaching from processes", GetShortPluginName()); 217046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 217146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 217246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 217324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 217424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 217524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after detaching from a process. 217624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 217724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after detaching 217824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// from a process. 217924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 218024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 218124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDetach () {} 218224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 218324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 218424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called before sending a signal to a process. 218524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 218624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code before sending a 218724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 218824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 218924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 219024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns no error if it is safe to proceed with a call to 219124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoSignal(int), otherwise an error describing what 219224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// prevents the signal from being sent. 219324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 219424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 219524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillSignal () { return Error(); } 219624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 219724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 219824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sends a process a UNIX signal \a signal. 219924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 220024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 220124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns an error object. 220224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 220324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 220446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoSignal (int signal) 220546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 220646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 220746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support senging signals to processes", GetShortPluginName()); 220846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 220946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 221024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 221124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 221224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WillDestroy () { return Error(); } 221324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 221424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 221524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoDestroy () = 0; 221624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 221724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 221824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidDestroy () { } 221924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 222024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 222124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 222224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Called after sending a signal to a process. 222324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 222424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Allow Process plug-ins to execute some code after sending a 222524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// signal to a process. 222624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 222724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 222824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidSignal () {} 222924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 223024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 223124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Currently called as part of ShouldStop. 223224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// FIXME: Should really happen when the target stops before the 223324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event is taken from the queue... 223424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 223524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This callback is called as the event 223624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// is about to be queued up to allow Process plug-ins to execute 223724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// some code prior to clients being notified that a process was 223824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// stopped. Common operations include updating the thread list, 223924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// invalidating any thread state (registers, stack, etc) prior to 224024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// letting the notification go out. 224124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 224324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 224424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RefreshStateAfterStop () = 0; 224524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 224624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 224724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the target object pointer for this module. 224824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 224924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 225024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A Target object pointer to the target that owns this 225124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 225224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 225324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & 2254395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () 2255395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2256395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2257395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 225824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 225924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 226024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the const target object pointer for this module. 226124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 226224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 226324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A const Target object pointer to the target that owns this 226424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// module. 226524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 226624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const Target & 2267395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetTarget () const 2268395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2269395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_target; 2270395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 2271395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton 2272cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton //------------------------------------------------------------------ 2273cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// Flush all data in the process. 2274cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// 2275cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// Flush the memory caches, all threads, and any other cached data 2276cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// in the process. 2277cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// 2278cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// This function can be called after a world changing event like 2279cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// adding a new symbol file, or after the process makes a large 2280cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton /// context switch (from boot ROM to booted into an OS). 2281cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton //------------------------------------------------------------------ 2282cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton void 2283cf5927ee246f5e431162f2753ed9e040dd060fe5Greg Clayton Flush (); 228424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 228524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 228624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get accessor for the current process state. 228724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 228824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 228924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The current state of the process. 229024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 229124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 229224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 229324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 229424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetState (); 2295360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2296b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResults 2297360f53f3c216ee4fb433da0a367168785328a856Jim Ingham RunThreadPlan (ExecutionContext &exe_ctx, 2298360f53f3c216ee4fb433da0a367168785328a856Jim Ingham lldb::ThreadPlanSP &thread_plan_sp, 2299360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool stop_others, 2300360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool try_all_threads, 2301360f53f3c216ee4fb433da0a367168785328a856Jim Ingham bool discard_on_error, 2302360f53f3c216ee4fb433da0a367168785328a856Jim Ingham uint32_t single_thread_timeout_usec, 2303360f53f3c216ee4fb433da0a367168785328a856Jim Ingham Stream &errors); 2304360f53f3c216ee4fb433da0a367168785328a856Jim Ingham 2305360f53f3c216ee4fb433da0a367168785328a856Jim Ingham static const char * 2306b344843f75ef893762c93fd0a22d2d45712ce74dGreg Clayton ExecutionResultAsCString (ExecutionResults result); 230724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2308abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton void 2309abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetStatus (Stream &ostrm); 2310abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 2311abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton size_t 2312abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton GetThreadStatus (Stream &ostrm, 2313abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton bool only_threads_with_stop_reason, 2314abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t start_frame, 2315abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames, 2316abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton uint32_t num_frames_with_source); 2317abe0fed36d83e1c37af9dae90c2d25db742b4515Greg Clayton 231824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 231924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 232024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 232124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetState (lldb::EventSP &event_sp); 232224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 232324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 232424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetPrivateState (); 232524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 232675c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 2327027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// The "private" side of resuming a process. This doesn't alter the 2328027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// state of m_run_lock, but just causes the process to resume. 2329027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// 2330027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// @return 2331027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham /// An Error object describing the success or failure of the resume. 2332027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham //------------------------------------------------------------------ 2333027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham Error 2334027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham PrivateResume (); 2335027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham 2336027aaa74a914823ab4c9cf8f3274d179e97fdb53Jim Ingham //------------------------------------------------------------------ 233775c703dd8b492bad25a987b96853626641ae7246Greg Clayton // Called internally 233875c703dd8b492bad25a987b96853626641ae7246Greg Clayton //------------------------------------------------------------------ 233975c703dd8b492bad25a987b96853626641ae7246Greg Clayton void 234075c703dd8b492bad25a987b96853626641ae7246Greg Clayton CompleteAttach (); 234175c703dd8b492bad25a987b96853626641ae7246Greg Clayton 234224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 234324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 234424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get the exit status for a process. 234524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 234624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 234724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The process's return code, or -1 if the current process 234824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// state is not eStateExited. 234924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int 235124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitStatus (); 235224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 235324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 235424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get a textual description of what the process exited. 235524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 235624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 235724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The textual description of why the process exited, or NULL 235824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// if there is no description available. 235924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 236024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const char * 236124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetExitDescription (); 236224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 236324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 236424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 236524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DidExit () 236624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 236724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 236824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 236924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 237021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// Get the Modification ID of the process. 237124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 237224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 237321f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham /// The modification ID of the process. 237424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 237521f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham ProcessModID 237621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetModID () const 237721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 237821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id; 237921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 238021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 23810296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham const ProcessModID & 23820296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetModIDRef () const 23830296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 23840296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id; 23850296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 23860296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 238724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 238821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham GetStopID () const 238921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham { 239021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham return m_mod_id.GetStopID(); 239121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham } 239221f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham 23930296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 23940296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetResumeID () const 23950296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 23960296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetResumeID(); 23970296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 23980296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 23990296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham uint32_t 24000296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham GetLastUserExpressionResumeID () const 24010296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham { 24020296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham return m_mod_id.GetLastUserExpressionResumeID(); 24030296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham } 24040296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 240524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 240624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Set accessor for the process exit status (return code). 240724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 240824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Sometimes a child exits and the exit can be detected by global 240924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// functions (signal handler for SIGCHLD for example). This 241024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// accessor allows the exit status to be set from an external 241124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// source. 241224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 241324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Setting this will cause a eStateExited event to be posted to 241424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the process event queue. 241524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 241624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] exit_status 241724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The value for the process's return code. 241824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 241924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @see lldb::StateType 242024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 242172e1c782ba1e4226da37af4722af608de9f39408Greg Clayton virtual bool 242224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetExitStatus (int exit_status, const char *cstr); 242324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 242424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 242524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Check if a process is still alive. 242624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 242724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 242824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the process is still valid, \b false 242924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// otherwise. 243024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 243124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool 243224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsAlive () = 0; 243324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 243424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 243524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the reading of memory from a process. 243624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 243724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Subclasses must override this function and can return fewer 243824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// bytes than requested when memory requests are too large. This 243924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// class will break up the memory requests and keep advancing the 244024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// arguments along as needed. 244124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 244224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 244324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 244424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 244524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 244624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 244724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 244824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 244924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 245024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 245124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 245224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 245324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 245424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. 245524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 245624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 245724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DoReadMemory (lldb::addr_t vm_addr, 245824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 245924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 246024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error) = 0; 246124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 246224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 246324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Read of memory from a process. 246424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 246524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will read memory from the current process's 246624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and remove any traps that may have been inserted 246724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// into the memory. 246824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 246924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 247024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 247124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoReadMemory (lldb::addr_t, size_t, void *). 247224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 247324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 247424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start reading 247524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory from. 247624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 247724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 247824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 247924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will receive the memory bytes. 248024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 248124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 248224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to read. 248324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 248424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 248524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually read into \a buf. If 248624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the returned number is greater than zero, yet less than \a 248724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// size, then this function will get called again with \a 248824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// vm_addr, \a buf, and \a size updated appropriately. Zero is 248924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// returned to indicate an error. 249024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 24919ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton virtual size_t 249224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ReadMemory (lldb::addr_t vm_addr, 249324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void *buf, 249424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t size, 249524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error &error); 249624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2497b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2498b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// Read a NULL terminated C string from memory 2499b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// 2500b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// This function will read a cache page at a time until the NULL 2501b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// C stirng terminator is found. It will stop reading if the NULL 2502b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// termination byte isn't found before reading \a cstr_max_len 2503b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// bytes, and the results are always guaranteed to be NULL 2504b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton /// terminated (at most cstr_max_len - 1 bytes will be read). 2505b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton //------------------------------------------------------------------ 2506b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton size_t 2507b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton ReadCStringFromMemory (lldb::addr_t vm_addr, 2508b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton char *cstr, 25094a2e33769873d68d5703da5742c0e248f46e3a72Greg Clayton size_t cstr_max_len, 25104a2e33769873d68d5703da5742c0e248f46e3a72Greg Clayton Error &error); 2511b72d0f098e45936fa72e26b1a026c603e17e2d6cGreg Clayton 2512fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t 2513fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton ReadMemoryFromInferior (lldb::addr_t vm_addr, 2514fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton void *buf, 2515fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton size_t size, 2516fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton Error &error); 2517fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 25186d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 25196d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// Reads an unsigned integer of the specified byte size from 25206d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// process memory. 25216d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 25226d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] load_addr 25236d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// A load address of the integer to read. 25246d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 25256d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[in] byte_size 25266d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The size in byte of the integer to read. 25276d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 2528c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] fail_value 2529c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value to return if we fail to read an integer. 2530c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 25316d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @param[out] error 25326d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// An error that indicates the success or failure of this 25336d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// operation. If error indicates success (error.Success()), 25346d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// then the value returned can be trusted, otherwise zero 25356d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// will be returned. 25366d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// 25376d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// @return 25386d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// The unsigned integer that was read from the process memory 25396d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// space. If the integer was smaller than a uint64_t, any 25406d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// unused upper bytes will be zero filled. If the process 25416d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// byte order differs from the host byte order, the integer 25426d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// value will be appropriately byte swapped into host byte 25436d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton /// order. 25446d29aebd9e7f8fa947dcc9c344aec2393922973dGreg Clayton //------------------------------------------------------------------ 2545f72fdeee129bbd7195f3db888b561ede689886aaGreg Clayton uint64_t 2546c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadUnsignedIntegerFromMemory (lldb::addr_t load_addr, 2547c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t byte_size, 2548c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint64_t fail_value, 2549c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2550c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2551c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t 2552c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadPointerFromMemory (lldb::addr_t vm_addr, 2553c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2554c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2555c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool 2556c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WritePointerToMemory (lldb::addr_t vm_addr, 2557c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton lldb::addr_t ptr_value, 2558c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2559c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 256024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 256124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually do the writing of memory to a process. 256224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 256324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 256424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 256524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 256624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 256724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 256824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 256924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 257024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 257124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 257224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 257324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2574c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2575c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2576c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 257724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 257824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 257924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 258024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 258146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error) 258246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 258346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support writing to processes", GetShortPluginName()); 258446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return 0; 258546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 258646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 258724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 258824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2589c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// Write all or part of a scalar value to memory. 2590c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2591c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The value contained in \a scalar will be swapped to match the 2592c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// byte order of the process that is being debugged. If \a size is 2593c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// less than the size of scalar, the least significate \a size bytes 2594c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// from scalar will be written. If \a size is larger than the byte 2595c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// size of scalar, then the extra space will be padded with zeros 2596c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// and the scalar value will be placed in the least significant 2597c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// bytes in memory. 2598c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2599c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] vm_addr 2600c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// A virtual load address that indicates where to start writing 2601c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// memory to. 2602c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2603c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] scalar 2604c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The scalar to write to the debugged process. 2605c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2606c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[in] size 2607c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// This value can be smaller or larger than the scalar value 2608c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// itself. If \a size is smaller than the size of \a scalar, 2609c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the least significant bytes in \a scalar will be used. If 2610c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// \a size is larger than the byte size of \a scalar, then 2611c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// the extra space will be padded with zeros. If \a size is 2612c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// set to UINT32_MAX, then the size of \a scalar will be used. 2613c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2614c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @param[out] error 2615c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// An error value in case the memory write fails. 2616c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// 2617c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// @return 2618c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton /// The number of bytes that were actually written. 2619c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 2620c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2621c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton WriteScalarToMemory (lldb::addr_t vm_addr, 2622c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton const Scalar &scalar, 2623c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t size, 2624c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2625c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2626c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton size_t 2627c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton ReadScalarIntegerFromMemory (lldb::addr_t addr, 2628c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton uint32_t byte_size, 2629c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton bool is_signed, 2630c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Scalar &scalar, 2631c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton Error &error); 2632c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton 2633c0fa53324d62a48257c092a3347d6e7236aa3152Greg Clayton //------------------------------------------------------------------ 263424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Write memory to a process. 263524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 263624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will write memory to the current process's 263724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// address space and maintain any traps that might be present due 263824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// to software breakpoints. 263924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 264024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function is not meant to be overridden by Process 264124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// subclasses, the subclasses should implement 264224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Process::DoWriteMemory (lldb::addr_t, size_t, void *). 264324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 264424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] vm_addr 264524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A virtual load address that indicates where to start writing 264624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// memory to. 264724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 264824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] buf 264924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A byte buffer that is at least \a size bytes long that 265024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// contains the data to write. 265124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 265224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 265324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes to write. 265424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 265524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 265624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes that were actually written. 265724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 265824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 265924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Error &error); 266024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 266224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 266324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually allocate memory in the process. 266424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 266524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 266624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 266724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 266824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 266924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 267024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 267124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 267224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 267324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 267424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 267524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 267624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 267724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::addr_t 267846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoAllocateMemory (size_t size, uint32_t permissions, Error &error) 267946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 268046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support allocating in the debug process", GetShortPluginName()); 268146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return LLDB_INVALID_ADDRESS; 268246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 268346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 268424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 268524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 268624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to allocating memory in the process. 268724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 268824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will allocate memory in the process's address 268924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space. This can't rely on the generic function calling mechanism, 269024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// since that requires this function. 269124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 269224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] size 269324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size of the allocation requested. 269424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 269524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] permissions 269624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Or together any of the lldb::Permissions bits. The permissions on 269724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// a given memory allocation can't be changed after allocation. Note 269824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// that a block that isn't set writable can still be written on from lldb, 269924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// just not by the process itself. 270024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 2701b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// @param[in/out] error 2702b9e8f6e7a374d9313f89193e90ae41ef91712e5bGreg Clayton /// An error object to fill in if things go wrong. 270324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 270424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The address of the allocated buffer in the process, or 270524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// LLDB_INVALID_ADDRESS if the allocation failed. 270624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 270724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 270824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::addr_t 270924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner AllocateMemory (size_t size, uint32_t permissions, Error &error); 271024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2711a9385537809ef342c843c5ab972e513742652047Greg Clayton virtual Error 2712a9385537809ef342c843c5ab972e513742652047Greg Clayton GetMemoryRegionInfo (lldb::addr_t load_addr, 2713a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo &range_info) 2714a9385537809ef342c843c5ab972e513742652047Greg Clayton { 2715a9385537809ef342c843c5ab972e513742652047Greg Clayton Error error; 2716a9385537809ef342c843c5ab972e513742652047Greg Clayton error.SetErrorString ("Process::GetMemoryRegionInfo() not supported"); 2717a9385537809ef342c843c5ab972e513742652047Greg Clayton return error; 2718a9385537809ef342c843c5ab972e513742652047Greg Clayton } 27191f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 2720b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton lldb::ModuleSP 2721b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton ReadModuleFromMemory (const FileSpec& file_spec, 27229ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton lldb::addr_t header_addr, 27239ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton bool add_image_to_target, 27249ce953807eb814a93b449dc243de4f7bf32c3115Greg Clayton bool load_sections_in_target); 2725b5a8f1498e1ddaeed5187a878d57ea0b74af9c26Greg Clayton 27261f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda //------------------------------------------------------------------ 27271f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// Attempt to get the attributes for a region of memory in the process. 27281f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 27291f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// It may be possible for the remote debug server to inspect attributes 27301f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// for a region of memory in the process, such as whether there is a 27311f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// valid page of memory at a given address or whether that page is 27321f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// readable/writable/executable by the process. 27331f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 27341f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @param[in] load_addr 27351f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// The address of interest in the process. 27361f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 27371f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @param[out] permissions 27381f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// If this call returns successfully, this bitmask will have 27391f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// its Permissions bits set to indicate whether the region is 27401f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// readable/writable/executable. If this call fails, the 27411f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// bitmask values are undefined. 27421f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// 27431f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// @return 27441f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// Returns true if it was able to determine the attributes of the 27451f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda /// memory region. False if not. 27461f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda //------------------------------------------------------------------ 27471f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 27481f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda virtual bool 27491f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda GetLoadAddressPermissions (lldb::addr_t load_addr, uint32_t &permissions) 2750a9385537809ef342c843c5ab972e513742652047Greg Clayton { 2751a9385537809ef342c843c5ab972e513742652047Greg Clayton MemoryRegionInfo range_info; 27521f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions = 0; 2753a9385537809ef342c843c5ab972e513742652047Greg Clayton Error error (GetMemoryRegionInfo (load_addr, range_info)); 27541f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (!error.Success()) 27551f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return false; 27561f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetReadable() == MemoryRegionInfo::eDontKnow 27571f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda || range_info.GetWritable() == MemoryRegionInfo::eDontKnow 27581f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda || range_info.GetExecutable() == MemoryRegionInfo::eDontKnow) 27591f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda { 27601f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return false; 27611f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda } 27621f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 27631f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetReadable() == MemoryRegionInfo::eYes) 27641f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsReadable; 27651f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 27661f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetWritable() == MemoryRegionInfo::eYes) 27671f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsWritable; 27681f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 27691f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda if (range_info.GetExecutable() == MemoryRegionInfo::eYes) 27701f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda permissions |= lldb::ePermissionsExecutable; 27711f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 27721f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda return true; 2773a9385537809ef342c843c5ab972e513742652047Greg Clayton } 27741f9c39c3c146f3c057575f53707e97019f402c46Jason Molenda 277524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 27766cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Determines whether executing JIT-compiled code in this process 27776cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 27786cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 27796cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @return 27806cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 27816cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 27826cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan bool CanJIT (); 27836cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 27846cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 27856cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// Sets whether executing JIT-compiled code in this process 27866cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// is possible. 27876cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// 27886cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// @param[in] can_jit 27896cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan /// True if execution of JIT code is possible; false otherwise. 27906cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 27916cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan void SetCanJIT (bool can_jit); 27926cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 27936cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan //------------------------------------------------------------------ 279424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Actually deallocate memory in the process. 279524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 279624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 279724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 279824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 279924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 280024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 280124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 280224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 280324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 280424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 280524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 280624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 280724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 280846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DoDeallocateMemory (lldb::addr_t ptr) 280946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 281046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 281146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support deallocating in the debug process", GetShortPluginName()); 281246c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 281346c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 281446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 281524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 281624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 281724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The public interface to deallocating memory in the process. 281824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 281924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This function will deallocate memory in the process's address 282024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// space that was allocated with AllocateMemory. 282124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 282224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] ptr 282324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A return value from AllocateMemory, pointing to the memory you 282424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// want to deallocate. 282524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 282624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 282724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// \btrue if the memory was deallocated, \bfalse otherwise. 282824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 282924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 283124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DeallocateMemory (lldb::addr_t ptr); 283224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 283324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 283424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDOUT. 283524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 283624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 283724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 283824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDOUT for the process if it is able. Events 283924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDOUT available that 284024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 284124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 284224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 284324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDOUT bytes that are 284424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 284524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 284624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 284724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 284824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 284924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 285024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 285124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 285224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDOUT data. 285324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 285424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 2855bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDOUT (char *buf, size_t buf_size, Error &error); 285624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 285724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 285824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Get any available STDERR. 285924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 286024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the process was launched without supplying valid file paths 286124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// for stdin, stdout, and stderr, then the Process class might 286224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// try to cache the STDERR for the process if it is able. Events 286324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// will be queued indicating that there is STDERR available that 286424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// can be retrieved using this function. 286524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 286624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf 286724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// A buffer that will receive any STDERR bytes that are 286824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// currently available. 286924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 287024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[out] buf_size 287124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The size in bytes for the buffer \a buf. 287224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 287324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 287424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// The number of bytes written into \a buf. If this value is 287524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// equal to \a buf_size, another call to this function should 287624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// be made to retrieve more STDERR data. 287724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 287824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 2879bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton GetSTDERR (char *buf, size_t buf_size, Error &error); 288024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 288124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t 288224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PutSTDIN (const char *buf, size_t buf_size, Error &error) 288324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 288424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner error.SetErrorString("stdin unsupported"); 288524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return 0; 288624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 288724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 288824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 288924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Breakpoints 289024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 2891b1888f24fa181489840b9acf193e224d125d0776Greg Clayton size_t 2892b1888f24fa181489840b9acf193e224d125d0776Greg Clayton GetSoftwareBreakpointTrapOpcode (BreakpointSite* bp_site); 289324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 289424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 289546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton EnableBreakpoint (BreakpointSite *bp_site) 289646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 289746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 289846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support enabling breakpoints", GetShortPluginName()); 289946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 290046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 290146c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 290224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 290324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 290446c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton DisableBreakpoint (BreakpointSite *bp_site) 290546c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton { 290646c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton Error error; 290746c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton error.SetErrorStringWithFormat("error: %s does not support disabling breakpoints", GetShortPluginName()); 290846c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton return error; 290946c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton } 291046c9a355af9b39db78c006b2a5cbf97d3c58d947Greg Clayton 291124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 291224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 291324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 291424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // read existing opcode, write breakpoint opcode, verify breakpoint opcode 291524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 291624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 291724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableSoftwareBreakpoint (BreakpointSite *bp_site); 291824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 291924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This is implemented completely using the lldb::Process API. Subclasses 292024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // don't need to implement this function unless the standard flow of 292124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // restoring original opcode in memory and verifying the restored opcode 292224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // doesn't work for a specific process plug-in. 292324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 292424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableSoftwareBreakpoint (BreakpointSite *bp_site); 292524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 292624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner BreakpointSiteList & 292724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList(); 292824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 292924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const BreakpointSiteList & 293024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetBreakpointSiteList() const; 293124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 293224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 293324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableAllBreakpointSites (); 293424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 293524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 293624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ClearBreakpointSiteByID (lldb::user_id_t break_id); 293724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 29383fd1f36c937575dbf57bae04c7ebaef78d8ecc1dStephen Wilson lldb::break_id_t 293913d24fb1817faa7ccc4cfd799113ba1a2b8968ebGreg Clayton CreateBreakpointSite (const lldb::BreakpointLocationSP &owner, 294024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool use_hardware); 294124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 294224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 294324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DisableBreakpointSiteByID (lldb::user_id_t break_id); 294424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 294524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Error 294624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner EnableBreakpointSiteByID (lldb::user_id_t break_id); 294724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 294824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 294924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // BreakpointLocations use RemoveOwnerFromBreakpointSite to remove 295024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // themselves from the owner's list of this breakpoint sites. This has to 295124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // be a static function because you can't be sure that removing the 295224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // breakpoint from it's containing map won't delete the breakpoint site, 295324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // and doing that in an instance method isn't copasetic. 295424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 295524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveOwnerFromBreakpointSite (lldb::user_id_t owner_id, 295624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::user_id_t owner_loc_id, 295724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::BreakpointSiteSP &bp_site_sp); 295824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 295924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 296024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Process Watchpoints (optional) 296124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //---------------------------------------------------------------------- 296224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2963ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen EnableWatchpoint (Watchpoint *wp); 296424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 296524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Error 2966ecd4feb5111432d2878e95461220c720cb2d24c8Johnny Chen DisableWatchpoint (Watchpoint *wp); 296724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 296824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 296924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Thread Queries 297024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 2971ae932359b80098532f3c3766fa9e6527352fbb67Greg Clayton virtual bool 297237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list) = 0; 297337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 297437f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton void 297537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton UpdateThreadListIfNeeded (); 297624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 297724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList & 2978395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton GetThreadList () 2979395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 2980395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton return m_thread_list; 2981395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 298224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 298324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 298424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t 298524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextThreadIndexID (); 298624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 298724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 298824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Event Handling 298924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 299024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 299124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetNextEvent (lldb::EventSP &event_sp); 299224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 299324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 299424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessToStop (const TimeValue *timeout); 299524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 299624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 299724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEvents (const TimeValue *timeout, lldb::EventSP &event_sp); 299824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 299924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Event * 300024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PeekAtStateChangedEvents (); 300163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 300224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3003f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham class 3004f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker 3005f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3006f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham public: 3007f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ProcessEventHijacker (Process &process, Listener *listener) : 3008f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process (process), 3009f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_listener (listener) 3010f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3011f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.HijackProcessEvents (listener); 3012f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 3013f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham ~ProcessEventHijacker () 3014f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham { 3015f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham m_process.RestoreProcessEvents(); 3016f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham } 3017f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 3018f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham private: 3019f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Process &m_process; 3020f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham Listener *m_listener; 3021f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham }; 3022f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham friend class ProcessEventHijacker; 302324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 302463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// If you need to ensure that you and only you will hear about some public 302563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// event, then make a new listener, set to listen to process events, and 302663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// then call this with that listener. Then you will have to wait on that 302763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// listener explicitly for events (rather than using the GetNextEvent & WaitFor* 302863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// calls above. Be sure to call RestoreProcessEvents when you are done. 302963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 303063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @param[in] listener 303163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// This is the new listener to whom all process events will be delivered. 303263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 303363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// @return 303463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Returns \b true if the new listener could be installed, 303563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// \b false otherwise. 303663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 303763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham bool 303863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham HijackProcessEvents (Listener *listener); 303963e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 304063e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 304163e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// Restores the process event broadcasting to its normal state. 304263e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham /// 304363e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 304463e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham void 304563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham RestoreProcessEvents (); 304663e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham 304763e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghamprotected: 304863e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Ingham //------------------------------------------------------------------ 304924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the part of the event handling that for a process event. 305024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// It decides what to do with the event and returns true if the 305124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// event needs to be propagated to the user, and false otherwise. 305224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// If the event is not propagated, this call will most likely set 305324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// the target to executing again. 305424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 305524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @param[in] event_ptr 305624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// This is the event we are handling. 305724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// 305824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// @return 305924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// Returns \b true if the event should be reported to the 306024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner /// user, \b false otherwise. 306124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 306224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 306324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ShouldBroadcastEvent (Event *event_ptr); 306424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 306563e24d7aeae8a7feb2aae0581e597b922749d4a1Jim Inghampublic: 306675906e4ec98af3717e415727a8d663a4e246bb4fGreg Clayton const lldb::ABISP & 306724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner GetABI (); 306824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 306937f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton OperatingSystem * 307037f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton GetOperatingSystem () 307137f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton { 307237f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton return m_os_ap.get(); 307337f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton } 307437f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 307537f962e785be99dc4f0c5e9d02416992ff03bbd0Greg Clayton 3076642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual LanguageRuntime * 3077e31176627725f4236c9ca049edc027756709780bJim Ingham GetLanguageRuntime (lldb::LanguageType language, bool retry_if_null = true); 3078642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 3079642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual CPPLanguageRuntime * 3080e31176627725f4236c9ca049edc027756709780bJim Ingham GetCPPLanguageRuntime (bool retry_if_null = true); 3081642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham 3082642036f22366d47ea8e6f8498bedb92b88f7f79fJim Ingham virtual ObjCLanguageRuntime * 3083e31176627725f4236c9ca049edc027756709780bJim Ingham GetObjCLanguageRuntime (bool retry_if_null = true); 3084e31176627725f4236c9ca049edc027756709780bJim Ingham 308524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 308624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner IsRunning () const; 3087f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 3088f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan DynamicCheckerFunctions *GetDynamicCheckers() 3089f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 3090d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham return m_dynamic_checkers_ap.get(); 3091f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 3092f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan 3093f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan void SetDynamicCheckers(DynamicCheckerFunctions *dynamic_checkers) 3094f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan { 3095d168690e51f9020b926d3d0d57dc9a2cfb2095a8Jim Ingham m_dynamic_checkers_ap.reset(dynamic_checkers); 3096f18d91c9bbd01152b29d84ab55ad2f0bbc9baf6cSean Callanan } 309724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3098c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 3099c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to set the lldb in the mode where it breaks on new thread 3100c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// creations, and then auto-restarts. This is useful when you are trying 3101c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// to run only one thread, but either that thread or the kernel is creating 3102c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// new threads in the process. If you stop when the thread is created, you 3103c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// can immediately suspend it, and keep executing only the one thread you intend. 3104c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 3105c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 3106c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 3107c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 3108c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 310955e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 311055e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StartNoticingNewThreads() 311155e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 311255e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 311355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 311455e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 3115c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 3116c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Call this to turn off the stop & notice new threads mode. 3117c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// 3118c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// @return 3119c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// Returns \b true if we were able to start up the notification 3120c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham /// \b false otherwise. 3121c7129c3ca353eb7f0bc8c2aa0d99b54de21b9de6Jim Ingham //------------------------------------------------------------------ 312255e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham virtual bool 312355e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham StopNoticingNewThreads() 312455e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham { 312555e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham return true; 312655e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham } 312755e01d8635032ee10cc06e0114213a76a8677be0Jim Ingham 31280296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham void 31290296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham SetRunningUserExpression (bool on); 31300296fe73a7cb1482226b1303a795ede00e12d677Jim Ingham 313124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 313224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // lldb::ExecutionContextScope pure virtual functions 313324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 3134289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::TargetSP 3135289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton CalculateTarget (); 3136289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3137289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::ProcessSP 3138395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateProcess () 3139395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3140289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return shared_from_this(); 3141395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 3142289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3143289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::ThreadSP 3144395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateThread () 3145395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3146289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return lldb::ThreadSP(); 3147395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 3148289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton 3149289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton virtual lldb::StackFrameSP 3150395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton CalculateStackFrame () 3151395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton { 3152289afcb5e26c2527a0d2e71f84e780b86bbcf90aGreg Clayton return lldb::StackFrameSP(); 3153395fc33dc4b06c048ed35047ec461bc092ef2df3Greg Clayton } 315424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 315524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual void 3156a830adbcd63d1995a01e6e18da79893c1426ca43Greg Clayton CalculateExecutionContext (ExecutionContext &exe_ctx); 315724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 3158464c6161464694412b7472129e789248f1cf21b9Greg Clayton void 3159464c6161464694412b7472129e789248f1cf21b9Greg Clayton SetSTDIOFileDescriptor (int file_descriptor); 3160464c6161464694412b7472129e789248f1cf21b9Greg Clayton 3161761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3162761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // Add a permanent region of memory that should never be read or 3163761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // written to. This can be used to ensure that memory reads or writes 3164761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // to certain areas of memory never end up being sent to the 3165761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // DoReadMemory or DoWriteMemory functions which can improve 3166761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // performance. 3167761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3168761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton void 3169761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton AddInvalidMemoryRegion (const LoadRange ®ion); 3170761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton 3171761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3172761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // Remove a permanent region of memory that should never be read or 3173761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton // written to that was previously added with AddInvalidMemoryRegion. 3174761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton //------------------------------------------------------------------ 3175761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton bool 3176761133029ba2d5bb0c21c3a871dede340b2775fcGreg Clayton RemoveInvalidMemoryRange (const LoadRange ®ion); 31771831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 31781831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham //------------------------------------------------------------------ 31791831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // If the setup code of a thread plan needs to do work that might involve 31801831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // calling a function in the target, it should not do that work directly 31811831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // in one of the thread plan functions (DidPush/WillResume) because 31821831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // such work needs to be handled carefully. Instead, put that work in 31831831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // a PreResumeAction callback, and register it with the process. It will 31841831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham // get done before the actual "DoResume" gets called. 31851831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham //------------------------------------------------------------------ 31861831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 31871831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham typedef bool (PreResumeActionCallback)(void *); 31881831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 31891831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham void 31901831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham AddPreResumeAction (PreResumeActionCallback callback, void *baton); 31911831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 31921831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham bool 31931831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham RunPreResumeActions (); 31941831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 31951831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham void 31961831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham ClearPreResumeActions (); 31971831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham 3198a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ReadWriteLock & 3199a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton GetRunLock () 3200a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton { 3201a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton return m_run_lock; 3202a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton } 3203a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton 320424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 3205c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 320621f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // NextEventAction provides a way to register an action on the next 320721f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // event that is delivered to this process. There is currently only 320821f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // one next event action allowed in the process at one time. If a 320921f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // new "NextEventAction" is added while one is already present, the 321021f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // old action will be discarded (with HandleBeingUnshipped called 321121f37ad875d4f50d1b4b3d307e120f6d27103730Jim Ingham // after it is discarded.) 3212c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham //------------------------------------------------------------------ 3213c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class NextEventAction 3214c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3215c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 3216c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham typedef enum EventActionResult 3217c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3218c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionSuccess, 3219c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionRetry, 3220c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham eEventActionExit 3221c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } EventActionResult; 3222c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3223c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham NextEventAction (Process *process) : 3224c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham m_process(process) 32252d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 32262d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 32272d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 32282d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 32292d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~NextEventAction() 32302d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 32312d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 3232c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3233c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp) = 0; 3234c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual void HandleBeingUnshipped () {}; 3235c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted () = 0; 3236c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString() = 0; 3237c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham protected: 3238c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham Process *m_process; 3239c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 3240c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3241c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham void SetNextEventAction (Process::NextEventAction *next_event_action) 3242c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 324368bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham if (m_next_event_action_ap.get()) 324468bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap->HandleBeingUnshipped(); 324568bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham 324668bffc51b218dc3a124820cb4d983204bf20be4aJim Ingham m_next_event_action_ap.reset(next_event_action); 3247c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham } 3248c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3249c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham // This is the completer for Attaching: 3250c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham class AttachCompletionHandler : public NextEventAction 3251c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham { 3252c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham public: 32532d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton AttachCompletionHandler (Process *process, uint32_t exec_count) : 32542d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton NextEventAction (process), 32552d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton m_exec_count (exec_count) 32562d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 32572d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 32582d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton 32592d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton virtual 32602d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton ~AttachCompletionHandler() 32612d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton { 32622d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton } 3263c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3264c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult PerformAction (lldb::EventSP &event_sp); 3265c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual EventActionResult HandleBeingInterrupted (); 3266c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham virtual const char *GetExitString(); 3267c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham private: 32682d9adb73af7520bec430e0585ca40467828e6ed1Greg Clayton uint32_t m_exec_count; 3269c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham std::string m_exit_string; 3270c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham }; 3271c2dc7c88cebe05cce059970cc907768256b28a42Jim Ingham 3272f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham bool 3273f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham HijackPrivateProcessEvents (Listener *listener); 3274f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham 3275f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham void 3276f9f40c20b210eea72ab042c63178ca000f005ed9Jim Ingham RestorePrivateProcessEvents (); 3277a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton 3278a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton bool 3279a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton PrivateStateThreadIsValid () const 3280a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton { 32811831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham return IS_VALID_LLDB_HOST_THREAD(m_private_state_thread); 3282a2f7423310044cf76d8d52aa9153b7fd8b226b49Greg Clayton } 3283fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton 328424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 3285a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton // Type definitions 3286a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton //------------------------------------------------------------------ 3287a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton typedef std::map<lldb::LanguageType, lldb::LanguageRuntimeSP> LanguageRuntimeCollection; 3288a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton 32895ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham struct PreResumeCallbackAndBaton 32905ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham { 32915ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham bool (*callback) (void *); 32925ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham void *baton; 32935ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham PreResumeCallbackAndBaton (PreResumeActionCallback in_callback, void *in_baton) : 32945ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham callback (in_callback), 32955ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham baton (in_baton) 32965ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham { 32975ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham } 32985ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham }; 32995ba82b9dfd5b9c6b8849a56bc74a6828d1dd109bJim Ingham 3300a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton //------------------------------------------------------------------ 330124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Member variables 330224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 330324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Target & m_target; ///< The target that owns this process. 330424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_public_state; 330524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadSafeValue<lldb::StateType> m_private_state; // The actual state of our process 330624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_broadcaster; // This broadcaster feeds state changed events into the private state thread's listener. 330724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Broadcaster m_private_state_control_broadcaster; // This is the control broadcaster, used to pause, resume & stop the private state thread. 330824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener m_private_state_listener; // This is the listener for the private state thread. 330924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Predicate<bool> m_private_state_control_wait; /// This Predicate is used to signal that a control operation is complete. 331024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::thread_t m_private_state_thread; // Thread ID for the thread that watches interal state events 3311a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ProcessModID m_mod_id; ///< Tracks the state of the process over stops and other alterations. 331224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner uint32_t m_thread_index_id; ///< Each thread is created with a 1 based index that won't get re-used. 331324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner int m_exit_status; ///< The exit status of the process, or -1 if not set. 331424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::string m_exit_string; ///< A textual description of why a process exited. 331524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ThreadList m_thread_list; ///< The threads for this process. 331624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner std::vector<Notifications> m_notifications; ///< The list of notifications that this process can deliver. 33170baa394cd55c6dfb7a6259d215d0dea2b708067bGreg Clayton std::vector<lldb::addr_t> m_image_tokens; 331824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner Listener &m_listener; 3319a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton BreakpointSiteList m_breakpoint_site_list; ///< This is the list of breakpoint locations we intend to insert in the target. 332075c703dd8b492bad25a987b96853626641ae7246Greg Clayton std::auto_ptr<DynamicLoader> m_dyld_ap; 3321a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton std::auto_ptr<DynamicCheckerFunctions> m_dynamic_checkers_ap; ///< The functions used by the expression parser to validate data that expressions use. 3322a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton std::auto_ptr<OperatingSystem> m_os_ap; 332324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner UnixSignals m_unix_signals; /// This is the current signal set for this process. 332424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::ABISP m_abi_sp; 3325861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderSP m_process_input_reader; 3326a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton Communication m_stdio_communication; 3327a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton Mutex m_stdio_communication_mutex; 3328861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice std::string m_stdout_data; 3329bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton std::string m_stderr_data; 3330fd119995f2693eb6e9e2ea3e685f9d872f5cd4f1Greg Clayton MemoryCache m_memory_cache; 3331613b8739a4d489b7f1c571288d5786768c024205Greg Clayton AllocatedMemoryCache m_allocated_memory_cache; 3332ffa43a6bc42bfcccae46eec9cf7bf73f17c328e9Greg Clayton bool m_should_detach; /// Should we detach if the process object goes away with an explicit call to Kill or Detach? 3333a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton LanguageRuntimeCollection m_language_runtimes; 33347e2f91cb958c8670774cb2190db7b858618b5b9bGreg Clayton std::auto_ptr<NextEventAction> m_next_event_action_ap; 33351831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham std::vector<PreResumeCallbackAndBaton> m_pre_resume_actions; 3336a894fe78bc15344a0025c1154e414c554ab31dd9Greg Clayton ReadWriteLock m_run_lock; 333724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 33386cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan enum { 33396cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITDontKnow= 0, 33406cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITYes, 33416cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan eCanJITNo 33426cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan } m_can_jit; 33436cf6c474742a23e7cb6b4f618bf1de711db90a85Sean Callanan 334424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 334524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const; 334624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 334724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 334824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SynchronouslyNotifyStateChanged (lldb::StateType state); 334924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 335024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 335124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPublicState (lldb::StateType new_state); 335224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 335324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 335424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SetPrivateState (lldb::StateType state); 335524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 335624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 33571831e78a6253392fca1c99e555e7adaa3f372647Jim Ingham StartPrivateStateThread (bool force = false); 335824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 335924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 336024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StopPrivateStateThread (); 336124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 336224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 336324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PausePrivateStateThread (); 336424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 336524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 336624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ResumePrivateStateThread (); 336724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 336824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static void * 336924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner PrivateStateThread (void *arg); 337024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 337124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void * 337224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner RunPrivateStateThread (); 337324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 337424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void 337524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner HandlePrivateEvent (lldb::EventSP &event_sp); 337624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 337724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 337824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForProcessStopPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 337924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 338024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // This waits for both the state change broadcaster, and the control broadcaster. 338124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // If control_only, it only waits for the control broadcaster. 338224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 338324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner bool 338424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp, bool control_only); 338524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 338624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 338724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForStateChangedEventsPrivate (const TimeValue *timeout, lldb::EventSP &event_sp); 338824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 338924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner lldb::StateType 339024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WaitForState (const TimeValue *timeout, 339124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const lldb::StateType *match_states, 339224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const uint32_t num_match_states); 339324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 339424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner size_t 339524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Error &error); 3396861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3397861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3398861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice AppendSTDOUT (const char *s, size_t len); 3399861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3400bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton void 3401bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton AppendSTDERR (const char *s, size_t len); 3402bd06ff435614ff4e884c40f3ea13e24f0cef96f7Greg Clayton 3403861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static void 3404861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice STDIOReadThreadBytesReceived (void *baton, const void *src, size_t src_len); 3405861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3406861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3407861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PushProcessInputReader (); 3408861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3409861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3410861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice PopProcessInputReader (); 3411861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3412861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice void 3413861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ResetProcessInputReader (); 3414861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3415861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice static size_t 3416861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice ProcessInputReaderCallback (void *baton, 3417861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice InputReader &reader, 3418861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice lldb::InputReaderAction notification, 3419861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice const char *bytes, 3420861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice size_t bytes_len); 3421861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 3422861efb3f6e225e45c45511d6da894633b36025a1Caroline Tice 342324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 342424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 342524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // For Process only 342624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 342724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner void ControlPrivateStateThread (uint32_t signal); 34286e4c5ce0f697eb9899a54854a2a9004e961b0de2Caroline Tice 342924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (Process); 343024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 343124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 343224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 343324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 343424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 343524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_Process_h_ 3436