LLDB mainline
|
#include <ProcessKDP.h>
Public Member Functions | |
ProcessKDP (lldb::TargetSP target_sp, lldb::ListenerSP listener) | |
~ProcessKDP () override | |
bool | CanDebug (lldb::TargetSP target_sp, bool plugin_specified_by_name) override |
Check if a plug-in instance can debug the file in module. | |
lldb_private::CommandObject * | GetPluginCommandObject () override |
Return a multi-word command object that can be used to expose plug-in specific commands. | |
lldb_private::Status | DoWillLaunch (lldb_private::Module *module) override |
Called before launching to a process. | |
lldb_private::Status | DoLaunch (lldb_private::Module *exe_module, lldb_private::ProcessLaunchInfo &launch_info) override |
Launch a new process. | |
lldb_private::Status | DoWillAttachToProcessWithID (lldb::pid_t pid) override |
Called before attaching to a process. | |
lldb_private::Status | DoWillAttachToProcessWithName (const char *process_name, bool wait_for_launch) override |
Called before attaching to a process. | |
lldb_private::Status | DoConnectRemote (llvm::StringRef remote_url) override |
Attach to a remote system via a URL. | |
lldb_private::Status | DoAttachToProcessWithID (lldb::pid_t pid, const lldb_private::ProcessAttachInfo &attach_info) override |
Attach to an existing process using a process ID. | |
lldb_private::Status | DoAttachToProcessWithName (const char *process_name, const lldb_private::ProcessAttachInfo &attach_info) override |
Attach to an existing process using a partial process name. | |
void | DidAttach (lldb_private::ArchSpec &process_arch) override |
Called after attaching a process. | |
lldb::addr_t | GetImageInfoAddress () override |
Get the image information address for the current process. | |
lldb_private::DynamicLoader * | GetDynamicLoader () override |
Get the dynamic loader plug-in for this process. | |
llvm::StringRef | GetPluginName () override |
lldb_private::Status | WillResume () override |
Called before resuming to a process. | |
lldb_private::Status | DoResume () override |
Resumes all of a process's threads as configured using the Thread run control functions. | |
lldb_private::Status | DoHalt (bool &caused_stop) override |
Halts a running process. | |
lldb_private::Status | DoDetach (bool keep_stopped) override |
Detaches from a running or stopped process. | |
lldb_private::Status | DoSignal (int signal) override |
Sends a process a UNIX signal signal. | |
lldb_private::Status | DoDestroy () override |
void | RefreshStateAfterStop () override |
Currently called as part of ShouldStop. | |
bool | IsAlive () override |
Check if a process is still alive. | |
size_t | DoReadMemory (lldb::addr_t addr, void *buf, size_t size, lldb_private::Status &error) override |
Actually do the reading of memory from a process. | |
size_t | DoWriteMemory (lldb::addr_t addr, const void *buf, size_t size, lldb_private::Status &error) override |
Actually do the writing of memory to a process. | |
lldb::addr_t | DoAllocateMemory (size_t size, uint32_t permissions, lldb_private::Status &error) override |
Actually allocate memory in the process. | |
lldb_private::Status | DoDeallocateMemory (lldb::addr_t ptr) override |
Actually deallocate memory in the process. | |
lldb_private::Status | EnableBreakpointSite (lldb_private::BreakpointSite *bp_site) override |
lldb_private::Status | DisableBreakpointSite (lldb_private::BreakpointSite *bp_site) override |
CommunicationKDP & | GetCommunication () |
Public Member Functions inherited from lldb_private::Process | |
llvm::StringRef | GetBroadcasterClass () const override |
This needs to be filled in if you are going to register the broadcaster with the broadcaster manager and do broadcaster class matching. | |
~Process () override | |
Destructor. | |
lldb::ByteOrder | GetByteOrder () const |
uint32_t | GetAddressByteSize () const |
lldb::pid_t | GetID () const |
Returns the pid of the process or LLDB_INVALID_PROCESS_ID if there is no known pid. | |
void | SetID (lldb::pid_t new_pid) |
Sets the stored pid. | |
uint32_t | GetUniqueID () const |
virtual bool | CanDebug (lldb::TargetSP target, bool plugin_specified_by_name)=0 |
Check if a plug-in instance can debug the file in module. | |
virtual void | Finalize (bool destructing) |
This object is about to be destroyed, do any necessary cleanup. | |
bool | IsValid () const |
Return whether this object is valid (i.e. | |
virtual CommandObject * | GetPluginCommandObject () |
Return a multi-word command object that can be used to expose plug-in specific commands. | |
virtual void | DumpPluginHistory (Stream &s) |
The underlying plugin might store the low-level communication history for this session. | |
virtual Status | Launch (ProcessLaunchInfo &launch_info) |
Launch a new process. | |
virtual Status | LoadCore () |
virtual Status | DoLoadCore () |
void | SetShadowListener (lldb::ListenerSP shadow_listener_sp) |
The "ShadowListener" for a process is just an ordinary Listener that listens for all the Process event bits. | |
UtilityFunction * | GetLoadImageUtilityFunction (Platform *platform, llvm::function_ref< std::unique_ptr< UtilityFunction >()> factory) |
Get the cached UtilityFunction that assists in loading binary images into the process. | |
virtual DynamicLoader * | GetDynamicLoader () |
Get the dynamic loader plug-in for this process. | |
void | SetDynamicLoader (lldb::DynamicLoaderUP dyld) |
virtual DataExtractor | GetAuxvData () |
virtual llvm::Error | LoadModules () |
Sometimes processes know how to retrieve and load shared libraries. | |
virtual llvm::Expected< LoadedModuleInfoList > | GetLoadedModuleList () |
Query remote GDBServer for a detailed loaded library list. | |
virtual llvm::Expected< bool > | SaveCore (llvm::StringRef outfile) |
Save core dump into the specified file. | |
Status | CalculateCoreFileSaveRanges (const SaveCoreOptions &core_options, CoreFileMemoryRanges &ranges) |
Helper function for Process::SaveCore(...) that calculates the address ranges that should be saved. | |
std::vector< lldb::ThreadSP > | CalculateCoreFileThreadList (const SaveCoreOptions &core_options) |
Helper function for Process::SaveCore(...) that calculates the thread list based upon options set within a given core_options object. | |
virtual ArchSpec | GetSystemArchitecture () |
Get the system architecture for this process. | |
virtual SystemRuntime * | GetSystemRuntime () |
Get the system runtime plug-in for this process. | |
virtual Status | Attach (ProcessAttachInfo &attach_info) |
Attach to an existing process using the process attach info. | |
virtual Status | ConnectRemote (llvm::StringRef remote_url) |
Attach to a remote system via a URL. | |
bool | GetShouldDetach () const |
void | SetShouldDetach (bool b) |
const std::vector< lldb::addr_t > & | GetImageTokens () |
Get the image vector for the current process. | |
virtual lldb::addr_t | GetImageInfoAddress () |
Get the image information address for the current process. | |
virtual void | WillPublicStop () |
Called when the process is about to broadcast a public stop. | |
void | RegisterNotificationCallbacks (const Process::Notifications &callbacks) |
Register for process and thread notifications. | |
bool | UnregisterNotificationCallbacks (const Process::Notifications &callbacks) |
Unregister for process and thread notifications. | |
Status | Resume () |
Resumes all of a process's threads as configured using the Thread run control functions. | |
Status | ResumeSynchronous (Stream *stream) |
Resume a process, and wait for it to stop. | |
Status | Halt (bool clear_thread_plans=false, bool use_run_lock=true) |
Halts a running process. | |
Status | Detach (bool keep_stopped) |
Detaches from a running or stopped process. | |
Status | Destroy (bool force_kill) |
Kills the process and shuts down all threads that were spawned to track and monitor the process. | |
Status | Signal (int signal) |
Sends a process a UNIX signal signal. | |
void | SetUnixSignals (lldb::UnixSignalsSP &&signals_sp) |
const lldb::UnixSignalsSP & | GetUnixSignals () |
Status | WillAttachToProcessWithID (lldb::pid_t pid) |
Called before attaching to a process. | |
virtual Status | DoWillAttachToProcessWithID (lldb::pid_t pid) |
Called before attaching to a process. | |
Status | WillAttachToProcessWithName (const char *process_name, bool wait_for_launch) |
Called before attaching to a process. | |
virtual Status | DoWillAttachToProcessWithName (const char *process_name, bool wait_for_launch) |
Called before attaching to a process. | |
virtual Status | DoConnectRemote (llvm::StringRef remote_url) |
Attach to a remote system via a URL. | |
virtual Status | DoAttachToProcessWithID (lldb::pid_t pid, const ProcessAttachInfo &attach_info) |
Attach to an existing process using a process ID. | |
virtual Status | DoAttachToProcessWithName (const char *process_name, const ProcessAttachInfo &attach_info) |
Attach to an existing process using a partial process name. | |
virtual void | DidAttach (ArchSpec &process_arch) |
Called after attaching a process. | |
virtual void | DidExec () |
Called after a process re-execs itself. | |
virtual void | DoDidExec () |
Subclasses of Process should implement this function if they need to do anything after a process exec's itself. | |
virtual void | DidFork (lldb::pid_t child_pid, lldb::tid_t child_tid) |
Called after a reported fork. | |
virtual void | DidVFork (lldb::pid_t child_pid, lldb::tid_t child_tid) |
Called after a reported vfork. | |
virtual void | DidVForkDone () |
Called after reported vfork completion. | |
Status | WillLaunch (Module *module) |
Called before launching to a process. | |
virtual Status | DoWillLaunch (Module *module) |
Called before launching to a process. | |
virtual Status | DoLaunch (Module *exe_module, ProcessLaunchInfo &launch_info) |
Launch a new process. | |
virtual void | DidLaunch () |
Called after launching a process. | |
virtual Status | WillResume () |
Called before resuming to a process. | |
virtual Status | DoResume () |
Resumes all of a process's threads as configured using the Thread run control functions. | |
virtual void | DidResume () |
Called after resuming a process. | |
virtual Status | WillHalt () |
Called before halting to a process. | |
virtual Status | DoHalt (bool &caused_stop) |
Halts a running process. | |
virtual void | DidHalt () |
Called after halting a process. | |
virtual Status | WillDetach () |
Called before detaching from a process. | |
virtual Status | DoDetach (bool keep_stopped) |
Detaches from a running or stopped process. | |
virtual void | DidDetach () |
Called after detaching from a process. | |
virtual bool | DetachRequiresHalt () |
virtual Status | WillSignal () |
Called before sending a signal to a process. | |
virtual Status | DoSignal (int signal) |
Sends a process a UNIX signal signal. | |
virtual Status | WillDestroy () |
virtual Status | DoDestroy ()=0 |
virtual void | DidDestroy () |
virtual bool | DestroyRequiresHalt () |
virtual void | DidSignal () |
Called after sending a signal to a process. | |
virtual void | RefreshStateAfterStop ()=0 |
Currently called as part of ShouldStop. | |
virtual llvm::VersionTuple | GetHostOSVersion () |
Sometimes the connection to a process can detect the host OS version that the process is running on. | |
virtual llvm::VersionTuple | GetHostMacCatalystVersion () |
Target & | GetTarget () |
Get the target object pointer for this module. | |
const Target & | GetTarget () const |
Get the const target object pointer for this module. | |
void | Flush () |
Flush all data in the process. | |
lldb::StateType | GetState () |
Get accessor for the current process state. | |
lldb::ExpressionResults | RunThreadPlan (ExecutionContext &exe_ctx, lldb::ThreadPlanSP &thread_plan_sp, const EvaluateExpressionOptions &options, DiagnosticManager &diagnostic_manager) |
void | GetStatus (Stream &ostrm) |
size_t | GetThreadStatus (Stream &ostrm, bool only_threads_with_stop_reason, uint32_t start_frame, uint32_t num_frames, uint32_t num_frames_with_source, bool stop_format) |
void | SendAsyncInterrupt (Thread *thread=nullptr) |
Send an async interrupt request. | |
virtual void | ModulesDidLoad (ModuleList &module_list) |
virtual lldb_private::StructuredData::ObjectSP | GetLoadedDynamicLibrariesInfos (lldb::addr_t image_list_address, lldb::addr_t image_count) |
Retrieve the list of shared libraries that are loaded for this process This method is used on pre-macOS 10.12, pre-iOS 10, pre-tvOS 10, pre- watchOS 3 systems. | |
virtual lldb_private::StructuredData::ObjectSP | GetLoadedDynamicLibrariesInfos () |
virtual lldb_private::StructuredData::ObjectSP | GetLoadedDynamicLibrariesInfos (const std::vector< lldb::addr_t > &load_addresses) |
virtual lldb_private::StructuredData::ObjectSP | GetSharedCacheInfo () |
virtual lldb_private::StructuredData::ObjectSP | GetDynamicLoaderProcessState () |
void | PrintWarningOptimization (const SymbolContext &sc) |
Print a user-visible warning about a module being built with optimization. | |
void | PrintWarningUnsupportedLanguage (const SymbolContext &sc) |
Print a user-visible warning about a function written in a language that this version of LLDB doesn't support. | |
virtual bool | GetProcessInfo (ProcessInstanceInfo &info) |
virtual lldb_private::UUID | FindModuleUUID (const llvm::StringRef path) |
int | GetExitStatus () |
Get the exit status for a process. | |
const char * | GetExitDescription () |
Get a textual description of what the process exited. | |
virtual void | DidExit () |
lldb::addr_t | GetCodeAddressMask () |
Get the current address mask in the Process. | |
lldb::addr_t | GetDataAddressMask () |
lldb::addr_t | GetHighmemCodeAddressMask () |
The highmem masks are for targets where we may have different masks for low memory versus high memory addresses, and they will be left as LLDB_INVALID_ADDRESS_MASK normally, meaning the base masks should be applied to all addresses. | |
lldb::addr_t | GetHighmemDataAddressMask () |
void | SetCodeAddressMask (lldb::addr_t code_address_mask) |
void | SetDataAddressMask (lldb::addr_t data_address_mask) |
void | SetHighmemCodeAddressMask (lldb::addr_t code_address_mask) |
void | SetHighmemDataAddressMask (lldb::addr_t data_address_mask) |
lldb::addr_t | FixCodeAddress (lldb::addr_t pc) |
Some targets might use bits in a code address to indicate a mode switch, ARM uses bit zero to signify a code address is thumb, so any ARM ABI plug-ins would strip those bits. | |
lldb::addr_t | FixDataAddress (lldb::addr_t pc) |
lldb::addr_t | FixAnyAddress (lldb::addr_t pc) |
Use this method when you do not know, or do not care what kind of address you are fixing. | |
ProcessModID | GetModID () const |
Get the Modification ID of the process. | |
const ProcessModID & | GetModIDRef () const |
uint32_t | GetStopID () const |
uint32_t | GetResumeID () const |
uint32_t | GetLastUserExpressionResumeID () const |
uint32_t | GetLastNaturalStopID () const |
lldb::EventSP | GetStopEventForStopID (uint32_t stop_id) const |
virtual bool | SetExitStatus (int exit_status, llvm::StringRef exit_string) |
Set accessor for the process exit status (return code). | |
virtual bool | IsAlive () |
Check if a process is still alive. | |
virtual bool | IsLiveDebugSession () const |
virtual FileSpec | GetCoreFile () const |
Provide a way to retrieve the core dump file that is loaded for debugging. | |
virtual bool | WarnBeforeDetach () const |
Before lldb detaches from a process, it warns the user that they are about to lose their debug session. | |
virtual size_t | ReadMemory (lldb::addr_t vm_addr, void *buf, size_t size, Status &error) |
Read of memory from a process. | |
size_t | ReadMemoryFromInferior (lldb::addr_t vm_addr, void *buf, size_t size, Status &error) |
Read of memory from a process. | |
size_t | ReadCStringFromMemory (lldb::addr_t vm_addr, char *cstr, size_t cstr_max_len, Status &error) |
Read a NULL terminated C string from memory. | |
size_t | ReadCStringFromMemory (lldb::addr_t vm_addr, std::string &out_str, Status &error) |
uint64_t | ReadUnsignedIntegerFromMemory (lldb::addr_t load_addr, size_t byte_size, uint64_t fail_value, Status &error) |
Reads an unsigned integer of the specified byte size from process memory. | |
int64_t | ReadSignedIntegerFromMemory (lldb::addr_t load_addr, size_t byte_size, int64_t fail_value, Status &error) |
lldb::addr_t | ReadPointerFromMemory (lldb::addr_t vm_addr, Status &error) |
bool | WritePointerToMemory (lldb::addr_t vm_addr, lldb::addr_t ptr_value, Status &error) |
virtual size_t | DoWriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Status &error) |
Actually do the writing of memory to a process. | |
size_t | WriteScalarToMemory (lldb::addr_t vm_addr, const Scalar &scalar, size_t size, Status &error) |
Write all or part of a scalar value to memory. | |
size_t | ReadScalarIntegerFromMemory (lldb::addr_t addr, uint32_t byte_size, bool is_signed, Scalar &scalar, Status &error) |
size_t | WriteMemory (lldb::addr_t vm_addr, const void *buf, size_t size, Status &error) |
Write memory to a process. | |
virtual lldb::addr_t | DoAllocateMemory (size_t size, uint32_t permissions, Status &error) |
Actually allocate memory in the process. | |
virtual Status | WriteObjectFile (std::vector< ObjectFile::LoadableData > entries) |
lldb::addr_t | AllocateMemory (size_t size, uint32_t permissions, Status &error) |
The public interface to allocating memory in the process. | |
lldb::addr_t | CallocateMemory (size_t size, uint32_t permissions, Status &error) |
The public interface to allocating memory in the process, this also clears the allocated memory. | |
llvm::Expected< const MemoryTagManager * > | GetMemoryTagManager () |
If this architecture and process supports memory tagging, return a tag manager that can be used to maniupulate those memory tags. | |
virtual llvm::Expected< std::vector< lldb::addr_t > > | ReadMemoryTags (lldb::addr_t addr, size_t len) |
Read memory tags for the range addr to addr+len. | |
Status | WriteMemoryTags (lldb::addr_t addr, size_t len, const std::vector< lldb::addr_t > &tags) |
Write memory tags for a range of memory. | |
virtual lldb::addr_t | ResolveIndirectFunction (const Address *address, Status &error) |
Resolve dynamically loaded indirect functions. | |
Status | GetMemoryRegionInfo (lldb::addr_t load_addr, MemoryRegionInfo &range_info) |
Locate the memory region that contains load_addr. | |
virtual Status | GetMemoryRegions (lldb_private::MemoryRegionInfos ®ion_list) |
Obtain all the mapped memory regions within this process. | |
virtual std::optional< uint32_t > | GetWatchpointSlotCount () |
Get the number of watchpoints supported by this target. | |
bool | GetWatchpointReportedAfter () |
Whether lldb will be notified about watchpoints after the instruction has completed executing, or if the instruction is rolled back and it is notified before it executes. | |
lldb::ModuleSP | ReadModuleFromMemory (const FileSpec &file_spec, lldb::addr_t header_addr, size_t size_to_read=512) |
virtual bool | GetLoadAddressPermissions (lldb::addr_t load_addr, uint32_t &permissions) |
Attempt to get the attributes for a region of memory in the process. | |
bool | CanJIT () |
Determines whether executing JIT-compiled code in this process is possible. | |
void | SetCanJIT (bool can_jit) |
Sets whether executing JIT-compiled code in this process is possible. | |
bool | CanInterpretFunctionCalls () |
Determines whether executing function calls using the interpreter is possible for this process. | |
void | SetCanInterpretFunctionCalls (bool can_interpret_function_calls) |
Sets whether executing function calls using the interpreter is possible for this process. | |
void | SetCanRunCode (bool can_run_code) |
Sets whether executing code in this process is possible. | |
virtual Status | DoDeallocateMemory (lldb::addr_t ptr) |
Actually deallocate memory in the process. | |
Status | DeallocateMemory (lldb::addr_t ptr) |
The public interface to deallocating memory in the process. | |
virtual size_t | GetSTDOUT (char *buf, size_t buf_size, Status &error) |
Get any available STDOUT. | |
virtual size_t | GetSTDERR (char *buf, size_t buf_size, Status &error) |
Get any available STDERR. | |
virtual size_t | PutSTDIN (const char *buf, size_t buf_size, Status &error) |
Puts data into this process's STDIN. | |
virtual size_t | GetAsyncProfileData (char *buf, size_t buf_size, Status &error) |
Get any available profile data. | |
size_t | GetSoftwareBreakpointTrapOpcode (BreakpointSite *bp_site) |
virtual Status | EnableBreakpointSite (BreakpointSite *bp_site) |
virtual Status | DisableBreakpointSite (BreakpointSite *bp_site) |
virtual Status | EnableSoftwareBreakpoint (BreakpointSite *bp_site) |
virtual Status | DisableSoftwareBreakpoint (BreakpointSite *bp_site) |
StopPointSiteList< lldb_private::BreakpointSite > & | GetBreakpointSiteList () |
const StopPointSiteList< lldb_private::BreakpointSite > & | GetBreakpointSiteList () const |
void | DisableAllBreakpointSites () |
Status | ClearBreakpointSiteByID (lldb::user_id_t break_id) |
lldb::break_id_t | CreateBreakpointSite (const lldb::BreakpointLocationSP &owner, bool use_hardware) |
Status | DisableBreakpointSiteByID (lldb::user_id_t break_id) |
Status | EnableBreakpointSiteByID (lldb::user_id_t break_id) |
void | RemoveConstituentFromBreakpointSite (lldb::user_id_t site_id, lldb::user_id_t constituent_id, lldb::BreakpointSiteSP &bp_site_sp) |
virtual Status | EnableWatchpoint (lldb::WatchpointSP wp_sp, bool notify=true) |
virtual Status | DisableWatchpoint (lldb::WatchpointSP wp_sp, bool notify=true) |
bool | UpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list) |
Update the thread list. | |
void | UpdateThreadListIfNeeded () |
ThreadList & | GetThreadList () |
StopPointSiteList< lldb_private::WatchpointResource > & | GetWatchpointResourceList () |
ThreadList & | GetExtendedThreadList () |
ThreadList::ThreadIterable | Threads () |
uint32_t | GetNextThreadIndexID (uint64_t thread_id) |
lldb::ThreadSP | CreateOSPluginThread (lldb::tid_t tid, lldb::addr_t context) |
bool | HasAssignedIndexIDToThread (uint64_t sb_thread_id) |
uint32_t | AssignIndexIDToThread (uint64_t thread_id) |
virtual void | UpdateQueueListIfNeeded () |
QueueList & | GetQueueList () |
QueueList::QueueIterable | Queues () |
lldb::StateType | GetNextEvent (lldb::EventSP &event_sp) |
lldb::StateType | WaitForProcessToStop (const Timeout< std::micro > &timeout, lldb::EventSP *event_sp_ptr=nullptr, bool wait_always=true, lldb::ListenerSP hijack_listener=lldb::ListenerSP(), Stream *stream=nullptr, bool use_run_lock=true, SelectMostRelevant select_most_relevant=DoNoSelectMostRelevantFrame) |
uint32_t | GetIOHandlerID () const |
void | SyncIOHandler (uint32_t iohandler_id, const Timeout< std::micro > &timeout) |
Waits for the process state to be running within a given msec timeout. | |
lldb::StateType | GetStateChangedEvents (lldb::EventSP &event_sp, const Timeout< std::micro > &timeout, lldb::ListenerSP hijack_listener) |
Event * | PeekAtStateChangedEvents () |
bool | HijackProcessEvents (lldb::ListenerSP listener_sp) |
If you need to ensure that you and only you will hear about some public event, then make a new listener, set to listen to process events, and then call this with that listener. | |
void | RestoreProcessEvents () |
Restores the process event broadcasting to its normal state. | |
bool | StateChangedIsHijackedForSynchronousResume () |
bool | StateChangedIsExternallyHijacked () |
const lldb::ABISP & | GetABI () |
OperatingSystem * | GetOperatingSystem () |
std::vector< LanguageRuntime * > | GetLanguageRuntimes () |
LanguageRuntime * | GetLanguageRuntime (lldb::LanguageType language) |
bool | IsPossibleDynamicValue (ValueObject &in_value) |
bool | IsRunning () const |
DynamicCheckerFunctions * | GetDynamicCheckers () |
void | SetDynamicCheckers (DynamicCheckerFunctions *dynamic_checkers) |
bool | PruneThreadPlansForTID (lldb::tid_t tid) |
Prune ThreadPlanStacks for unreported threads. | |
void | PruneThreadPlans () |
Prune ThreadPlanStacks for all unreported threads. | |
ThreadPlanStack * | FindThreadPlans (lldb::tid_t tid) |
Find the thread plan stack associated with thread with tid. | |
bool | DumpThreadPlansForTID (Stream &strm, lldb::tid_t tid, lldb::DescriptionLevel desc_level, bool internal, bool condense_trivial, bool skip_unreported_plans) |
Dump the thread plans associated with thread with tid. | |
void | DumpThreadPlans (Stream &strm, lldb::DescriptionLevel desc_level, bool internal, bool condense_trivial, bool skip_unreported_plans) |
Dump all the thread plans for this process. | |
virtual bool | StartNoticingNewThreads () |
Call this to set the lldb in the mode where it breaks on new thread creations, and then auto-restarts. | |
virtual bool | StopNoticingNewThreads () |
Call this to turn off the stop & notice new threads mode. | |
void | SetRunningUserExpression (bool on) |
void | SetRunningUtilityFunction (bool on) |
lldb::TargetSP | CalculateTarget () override |
lldb::ProcessSP | CalculateProcess () override |
lldb::ThreadSP | CalculateThread () override |
lldb::StackFrameSP | CalculateStackFrame () override |
void | CalculateExecutionContext (ExecutionContext &exe_ctx) override |
Reconstruct the object's execution context into sc. | |
void | SetSTDIOFileDescriptor (int file_descriptor) |
void | AddInvalidMemoryRegion (const LoadRange ®ion) |
bool | RemoveInvalidMemoryRange (const LoadRange ®ion) |
void | AddPreResumeAction (PreResumeActionCallback callback, void *baton) |
bool | RunPreResumeActions () |
void | ClearPreResumeActions () |
void | ClearPreResumeAction (PreResumeActionCallback callback, void *baton) |
ProcessRunLock & | GetRunLock () |
bool | CurrentThreadIsPrivateStateThread () |
virtual Status | SendEventData (const char *data) |
lldb::ThreadCollectionSP | GetHistoryThreads (lldb::addr_t addr) |
lldb::InstrumentationRuntimeSP | GetInstrumentationRuntime (lldb::InstrumentationRuntimeType type) |
virtual bool | GetModuleSpec (const FileSpec &module_file_spec, const ArchSpec &arch, ModuleSpec &module_spec) |
Try to fetch the module specification for a module with the given file name and architecture. | |
virtual void | PrefetchModuleSpecs (llvm::ArrayRef< FileSpec > module_file_specs, const llvm::Triple &triple) |
virtual Status | GetFileLoadAddress (const FileSpec &file, bool &is_loaded, lldb::addr_t &load_addr) |
Try to find the load address of a file. | |
virtual StructuredData::DictionarySP | GetMetadata () |
Fetch process defined metadata. | |
StructuredData::DictionarySP | GetExtendedCrashInfoDict () |
Fetch extended crash information held by the process. | |
void | ResetExtendedCrashInfoDict () |
size_t | AddImageToken (lldb::addr_t image_ptr) |
lldb::addr_t | GetImagePtrFromToken (size_t token) const |
void | ResetImageToken (size_t token) |
Address | AdvanceAddressToNextBranchInstruction (Address default_stop_addr, AddressRange range_bounds) |
Find the next branch instruction to set a breakpoint on. | |
virtual Status | ConfigureStructuredData (llvm::StringRef type_name, const StructuredData::ObjectSP &config_sp) |
Configure asynchronous structured data feature. | |
void | BroadcastStructuredData (const StructuredData::ObjectSP &object_sp, const lldb::StructuredDataPluginSP &plugin_sp) |
Broadcasts the given structured data object from the given plugin. | |
lldb::StructuredDataPluginSP | GetStructuredDataPlugin (llvm::StringRef type_name) const |
Returns the StructuredDataPlugin associated with a given type name, if there is one. | |
virtual void * | GetImplementation () |
virtual void | ForceScriptedState (lldb::StateType state) |
SourceManager::SourceFileCache & | GetSourceFileCache () |
lldb::addr_t | FindInMemory (lldb::addr_t low, lldb::addr_t high, const uint8_t *buf, size_t size) |
Find a pattern within a memory region. | |
AddressRanges | FindRangesInMemory (const uint8_t *buf, uint64_t size, const AddressRanges &ranges, size_t alignment, size_t max_matches, Status &error) |
lldb::addr_t | FindInMemory (const uint8_t *buf, uint64_t size, const AddressRange &range, size_t alignment, Status &error) |
Public Member Functions inherited from lldb_private::ProcessProperties | |
ProcessProperties (lldb_private::Process *process) | |
~ProcessProperties () override | |
bool | GetDisableMemoryCache () const |
uint64_t | GetMemoryCacheLineSize () const |
Args | GetExtraStartupCommands () const |
void | SetExtraStartupCommands (const Args &args) |
FileSpec | GetPythonOSPluginPath () const |
uint32_t | GetVirtualAddressableBits () const |
void | SetVirtualAddressableBits (uint32_t bits) |
uint32_t | GetHighmemVirtualAddressableBits () const |
void | SetHighmemVirtualAddressableBits (uint32_t bits) |
void | SetPythonOSPluginPath (const FileSpec &file) |
bool | GetIgnoreBreakpointsInExpressions () const |
void | SetIgnoreBreakpointsInExpressions (bool ignore) |
bool | GetUnwindOnErrorInExpressions () const |
void | SetUnwindOnErrorInExpressions (bool ignore) |
bool | GetStopOnSharedLibraryEvents () const |
void | SetStopOnSharedLibraryEvents (bool stop) |
bool | GetDisableLangRuntimeUnwindPlans () const |
void | SetDisableLangRuntimeUnwindPlans (bool disable) |
bool | GetDetachKeepsStopped () const |
void | SetDetachKeepsStopped (bool keep_stopped) |
bool | GetWarningsOptimization () const |
bool | GetWarningsUnsupportedLanguage () const |
bool | GetStopOnExec () const |
std::chrono::seconds | GetUtilityExpressionTimeout () const |
std::chrono::seconds | GetInterruptTimeout () const |
bool | GetOSPluginReportsAllThreads () const |
void | SetOSPluginReportsAllThreads (bool does_report) |
bool | GetSteppingRunsAllThreads () const |
FollowForkMode | GetFollowForkMode () const |
Public Member Functions inherited from lldb_private::Properties | |
Properties () | |
Properties (const lldb::OptionValuePropertiesSP &collection_sp) | |
virtual | ~Properties () |
virtual lldb::OptionValuePropertiesSP | GetValueProperties () const |
virtual lldb::OptionValueSP | GetPropertyValue (const ExecutionContext *exe_ctx, llvm::StringRef property_path, Status &error) const |
virtual Status | SetPropertyValue (const ExecutionContext *exe_ctx, VarSetOperationType op, llvm::StringRef property_path, llvm::StringRef value) |
virtual Status | DumpPropertyValue (const ExecutionContext *exe_ctx, Stream &strm, llvm::StringRef property_path, uint32_t dump_mask, bool is_json=false) |
virtual void | DumpAllPropertyValues (const ExecutionContext *exe_ctx, Stream &strm, uint32_t dump_mask, bool is_json=false) |
virtual void | DumpAllDescriptions (CommandInterpreter &interpreter, Stream &strm) const |
size_t | Apropos (llvm::StringRef keyword, std::vector< const Property * > &matching_properties) const |
template<typename T > | |
T | GetPropertyAtIndexAs (uint32_t idx, T default_value, const ExecutionContext *exe_ctx=nullptr) const |
template<typename T , typename U = typename std::remove_pointer<T>::type, std::enable_if_t< std::is_pointer_v< T >, bool > = true> | |
const U * | GetPropertyAtIndexAs (uint32_t idx, const ExecutionContext *exe_ctx=nullptr) const |
template<typename T > | |
bool | SetPropertyAtIndex (uint32_t idx, T t, const ExecutionContext *exe_ctx=nullptr) const |
Public Member Functions inherited from lldb_private::Broadcaster | |
Broadcaster (lldb::BroadcasterManagerSP manager_sp, std::string name) | |
Construct with a broadcaster with a name. | |
virtual | ~Broadcaster () |
Destructor. | |
void | CheckInWithManager () |
void | BroadcastEvent (lldb::EventSP &event_sp) |
Broadcast an event which has no associated data. | |
void | BroadcastEventIfUnique (lldb::EventSP &event_sp) |
void | BroadcastEvent (uint32_t event_type, const lldb::EventDataSP &event_data_sp) |
void | BroadcastEvent (uint32_t event_type) |
void | BroadcastEventIfUnique (uint32_t event_type) |
void | Clear () |
virtual void | AddInitialEventsToListener (const lldb::ListenerSP &listener_sp, uint32_t requested_events) |
uint32_t | AddListener (const lldb::ListenerSP &listener_sp, uint32_t event_mask) |
Listen for any events specified by event_mask. | |
const std::string & | GetBroadcasterName () |
Get this broadcaster's name. | |
bool | GetEventNames (Stream &s, const uint32_t event_mask, bool prefix_with_broadcaster_name) const |
Get the event name(s) for one or more event bits. | |
void | SetEventName (uint32_t event_mask, const char *name) |
Set the name for an event bit. | |
const char * | GetEventName (uint32_t event_mask) const |
bool | EventTypeHasListeners (uint32_t event_type) |
bool | RemoveListener (const lldb::ListenerSP &listener_sp, uint32_t event_mask=UINT32_MAX) |
Removes a Listener from this broadcasters list and frees the event bits specified by event_mask that were previously acquired by listener (assuming listener was listening to this object) for other listener objects to use. | |
bool | HijackBroadcaster (const lldb::ListenerSP &listener_sp, uint32_t event_mask=UINT32_MAX) |
Provides a simple mechanism to temporarily redirect events from broadcaster. | |
bool | IsHijackedForEvent (uint32_t event_mask) |
void | RestoreBroadcaster () |
Restore the state of the Broadcaster from a previous hijack attempt. | |
virtual llvm::StringRef | GetBroadcasterClass () const |
This needs to be filled in if you are going to register the broadcaster with the broadcaster manager and do broadcaster class matching. | |
lldb::BroadcasterManagerSP | GetManager () |
void | SetPrimaryListener (lldb::ListenerSP listener_sp) |
lldb::ListenerSP | GetPrimaryListener () |
Public Member Functions inherited from lldb_private::ExecutionContextScope | |
virtual | ~ExecutionContextScope ()=default |
virtual lldb::TargetSP | CalculateTarget ()=0 |
virtual lldb::ProcessSP | CalculateProcess ()=0 |
virtual lldb::ThreadSP | CalculateThread ()=0 |
virtual lldb::StackFrameSP | CalculateStackFrame ()=0 |
virtual void | CalculateExecutionContext (ExecutionContext &exe_ctx)=0 |
Reconstruct the object's execution context into sc. | |
Public Member Functions inherited from lldb_private::PluginInterface | |
PluginInterface ()=default | |
virtual | ~PluginInterface ()=default |
virtual llvm::StringRef | GetPluginName ()=0 |
PluginInterface (const PluginInterface &)=delete | |
PluginInterface & | operator= (const PluginInterface &)=delete |
Static Public Member Functions | |
static lldb::ProcessSP | CreateInstance (lldb::TargetSP target_sp, lldb::ListenerSP listener_sp, const lldb_private::FileSpec *crash_file_path, bool can_connect) |
static void | Initialize () |
static void | DebuggerInitialize (lldb_private::Debugger &debugger) |
static void | Terminate () |
static llvm::StringRef | GetPluginNameStatic () |
static llvm::StringRef | GetPluginDescriptionStatic () |
Static Public Member Functions inherited from lldb_private::Process | |
static llvm::StringRef | GetStaticBroadcasterClass () |
static void | SettingsInitialize () |
static void | SettingsTerminate () |
static ProcessProperties & | GetGlobalProperties () |
static lldb::ProcessSP | FindPlugin (lldb::TargetSP target_sp, llvm::StringRef plugin_name, lldb::ListenerSP listener_sp, const FileSpec *crash_file_path, bool can_connect) |
Find a Process plug-in that can debug module using the currently selected architecture. | |
static bool | SetProcessExitStatus (lldb::pid_t pid, bool exited, int signo, int status) |
Static function that can be used with the host function Host::StartMonitoringChildProcess (). | |
static bool | HandleProcessStateChangedEvent (const lldb::EventSP &event_sp, Stream *stream, SelectMostRelevant select_most_relevant, bool &pop_process_io_handler) |
Centralize the code that handles and prints descriptions for process state changes. | |
Static Public Member Functions inherited from lldb_private::Properties | |
static llvm::StringRef | GetExperimentalSettingsName () |
static bool | IsSettingExperimental (llvm::StringRef setting) |
Protected Types | |
enum | { eBroadcastBitAsyncContinue = (1 << 0) , eBroadcastBitAsyncThreadShouldExit = (1 << 1) } |
Protected Types inherited from lldb_private::Process | |
enum | { eCanJITDontKnow = 0 , eCanJITYes , eCanJITNo } |
typedef std::map< lldb::LanguageType, lldb::LanguageRuntimeSP > | LanguageRuntimeCollection |
Protected Types inherited from lldb_private::Broadcaster | |
typedef std::shared_ptr< BroadcasterImpl > | BroadcasterImplSP |
typedef std::weak_ptr< BroadcasterImpl > | BroadcasterImplWP |
Protected Member Functions | |
bool | IsRunning (lldb::StateType state) |
bool | IsStepping (lldb::StateType state) |
bool | CanResume (lldb::StateType state) |
bool | HasExited (lldb::StateType state) |
bool | GetHostArchitecture (lldb_private::ArchSpec &arch) |
bool | ProcessIDIsValid () const |
void | Clear () |
bool | DoUpdateThreadList (lldb_private::ThreadList &old_thread_list, lldb_private::ThreadList &new_thread_list) override |
Update the thread list following process plug-in's specific logic. | |
lldb::ThreadSP | GetKernelThread () |
bool | StartAsyncThread () |
void | StopAsyncThread () |
void * | AsyncThread () |
Protected Member Functions inherited from lldb_private::Process | |
virtual JITLoaderList & | GetJITLoaders () |
Process (lldb::TargetSP target_sp, lldb::ListenerSP listener_sp) | |
Construct with a shared pointer to a target, and the Process listener. | |
Process (lldb::TargetSP target_sp, lldb::ListenerSP listener_sp, const lldb::UnixSignalsSP &unix_signals_sp) | |
Construct with a shared pointer to a target, the Process listener, and the appropriate UnixSignalsSP for the process. | |
virtual llvm::Expected< TraceSupportedResponse > | TraceSupported () |
Get the processor tracing type supported for this process. | |
virtual llvm::Error | TraceStart (const llvm::json::Value &request) |
Start tracing a process or its threads. | |
virtual llvm::Error | TraceStop (const TraceStopRequest &request) |
Stop tracing a live process or its threads. | |
virtual llvm::Expected< std::string > | TraceGetState (llvm::StringRef type) |
Get the current tracing state of the process and its threads. | |
virtual llvm::Expected< std::vector< uint8_t > > | TraceGetBinaryData (const TraceGetBinaryDataRequest &request) |
Get binary data given a trace technology and a data identifier. | |
bool | CallVoidArgVoidPtrReturn (const Address *address, lldb::addr_t &returned_func, bool trap_exceptions=false) |
virtual bool | DoUpdateThreadList (ThreadList &old_thread_list, ThreadList &new_thread_list)=0 |
Update the thread list following process plug-in's specific logic. | |
virtual size_t | DoReadMemory (lldb::addr_t vm_addr, void *buf, size_t size, Status &error)=0 |
Actually do the reading of memory from a process. | |
virtual void | DoFindInMemory (lldb::addr_t start_addr, lldb::addr_t end_addr, const uint8_t *buf, size_t size, AddressRanges &matches, size_t alignment, size_t max_matches) |
virtual Status | DoGetMemoryRegionInfo (lldb::addr_t load_addr, MemoryRegionInfo &range_info) |
DoGetMemoryRegionInfo is called by GetMemoryRegionInfo after it has removed non address bits from load_addr. | |
virtual std::optional< bool > | DoGetWatchpointReportedAfter () |
Provide an override value in the subclass for lldb's CPU-based logic for whether watchpoint exceptions are received before or after an instruction executes. | |
virtual lldb::ThreadSP | HandleThreadAsyncInterrupt (uint8_t signo, const std::string &description) |
Handle thread specific async interrupt and return the original thread that requested the async interrupt. | |
lldb::StateType | GetPrivateState () |
Status | PrivateResume () |
The "private" side of resuming a process. | |
void | CompleteAttach () |
void | SetNextEventAction (Process::NextEventAction *next_event_action) |
bool | PrivateStateThreadIsValid () const |
void | ForceNextEventDelivery () |
void | MapSupportedStructuredDataPlugins (const StructuredData::Array &supported_type_names) |
Loads any plugins associated with asynchronous structured data and maps the relevant supported type name to the plugin. | |
bool | RouteAsyncStructuredData (const StructuredData::ObjectSP object_sp) |
Route the incoming structured data dictionary to the right plugin. | |
virtual bool | SupportsMemoryTagging () |
Check whether the process supports memory tagging. | |
virtual llvm::Expected< std::vector< uint8_t > > | DoReadMemoryTags (lldb::addr_t addr, size_t len, int32_t type) |
Does the final operation to read memory tags. | |
virtual Status | DoWriteMemoryTags (lldb::addr_t addr, size_t len, int32_t type, const std::vector< uint8_t > &tags) |
Does the final operation to write memory tags. | |
size_t | RemoveBreakpointOpcodesFromBuffer (lldb::addr_t addr, size_t size, uint8_t *buf) const |
void | SynchronouslyNotifyStateChanged (lldb::StateType state) |
void | SetPublicState (lldb::StateType new_state, bool restarted) |
void | SetPrivateState (lldb::StateType state) |
bool | StartPrivateStateThread (bool is_secondary_thread=false) |
void | StopPrivateStateThread () |
void | PausePrivateStateThread () |
void | ResumePrivateStateThread () |
void | HandlePrivateEvent (lldb::EventSP &event_sp) |
Status | HaltPrivate () |
lldb::StateType | WaitForProcessStopPrivate (lldb::EventSP &event_sp, const Timeout< std::micro > &timeout) |
bool | GetEventsPrivate (lldb::EventSP &event_sp, const Timeout< std::micro > &timeout, bool control_only) |
lldb::StateType | GetStateChangedEventsPrivate (lldb::EventSP &event_sp, const Timeout< std::micro > &timeout) |
size_t | WriteMemoryPrivate (lldb::addr_t addr, const void *buf, size_t size, Status &error) |
void | AppendSTDOUT (const char *s, size_t len) |
void | AppendSTDERR (const char *s, size_t len) |
void | BroadcastAsyncProfileData (const std::string &one_profile_data) |
bool | PushProcessIOHandler () |
bool | PopProcessIOHandler () |
bool | ProcessIOHandlerIsActive () |
bool | ProcessIOHandlerExists () const |
Status | StopForDestroyOrDetach (lldb::EventSP &exit_event_sp) |
virtual Status | UpdateAutomaticSignalFiltering () |
void | LoadOperatingSystemPlugin (bool flush) |
void | SetAddressableBitMasks (AddressableBits bit_masks) |
Protected Member Functions inherited from lldb_private::Broadcaster | |
BroadcasterImplSP | GetBroadcasterImpl () |
const char * | GetHijackingListenerName () |
Private Member Functions | |
ProcessKDP (const ProcessKDP &)=delete | |
const ProcessKDP & | operator= (const ProcessKDP &)=delete |
Friends | |
class | ThreadKDP |
class | CommunicationKDP |
Definition at line 30 of file ProcessKDP.h.
|
protected |
Enumerator | |
---|---|
eBroadcastBitAsyncContinue | |
eBroadcastBitAsyncThreadShouldExit |
Definition at line 155 of file ProcessKDP.h.
ProcessKDP::ProcessKDP | ( | lldb::TargetSP | target_sp, |
lldb::ListenerSP | listener | ||
) |
Definition at line 145 of file ProcessKDP.cpp.
References eBroadcastBitAsyncContinue, eBroadcastBitAsyncThreadShouldExit, GetGlobalPluginProperties(), m_async_broadcaster, m_comm, lldb_private::Broadcaster::SetEventName(), and CommunicationKDP::SetPacketTimeout().
|
override |
Definition at line 162 of file ProcessKDP.cpp.
References Clear(), and lldb_private::Process::Finalize().
|
privatedelete |
|
protected |
Definition at line 737 of file ProcessKDP.cpp.
References eBroadcastBitAsyncContinue, eBroadcastBitAsyncThreadShouldExit, lldb::eStateStopped, lldb_private::Process::GetID(), GetKernelThread(), lldb_private::GetLog(), LLDB_LOGF, m_async_broadcaster, m_async_thread, m_comm, lldb_private::Listener::MakeListener(), lldb_private::HostThread::Reset(), lldb_private::Process::SetPrivateState(), USEC_PER_SEC, and CommunicationKDP::WaitForPacketWithTimeoutMicroSeconds().
Referenced by StartAsyncThread().
|
overridevirtual |
Check if a plug-in instance can debug the file in module.
Each plug-in is given a chance to say whether it can debug the file in module. If the Process plug-in instance can debug a file on the current system, it should return true.
Implements lldb_private::Process.
Definition at line 113 of file ProcessKDP.cpp.
References lldb_private::ObjectFile::eStrataKernel, lldb_private::ObjectFile::eTypeExecutable, lldb_private::Module::GetArchitecture(), lldb_private::Module::GetObjectFile(), lldb_private::ObjectFile::GetStrata(), lldb_private::ArchSpec::GetTriple(), and lldb_private::ObjectFile::GetType().
|
inlineprotected |
Definition at line 142 of file ProcessKDP.h.
References lldb::eStateStopped.
|
protected |
Definition at line 675 of file ProcessKDP.cpp.
References lldb_private::ThreadList::Clear(), and lldb_private::Process::m_thread_list.
Referenced by ~ProcessKDP().
|
static |
Definition at line 103 of file ProcessKDP.cpp.
Referenced by Initialize(), and Terminate().
|
static |
Definition at line 696 of file ProcessKDP.cpp.
References lldb_private::PluginManager::CreateSettingForProcessPlugin(), GetGlobalPluginProperties(), lldb_private::PluginManager::GetSettingForProcessPlugin(), and lldb_private::Properties::GetValueProperties().
Referenced by Initialize().
|
overridevirtual |
Called after attaching a process.
[in] | process_arch | If you can figure out the process architecture after attach, fill it in here. |
Allow Process plug-ins to execute some code after attaching to a process.
Reimplemented from lldb_private::Process.
Definition at line 385 of file ProcessKDP.cpp.
References lldb_private::Process::DidAttach(), GetHostArchitecture(), lldb_private::Process::GetID(), lldb_private::GetLog(), LLDB_INVALID_PROCESS_ID, and LLDB_LOGF.
|
overridevirtual |
Reimplemented from lldb_private::Process.
Definition at line 651 of file ProcessKDP.cpp.
References lldb_private::Process::DisableSoftwareBreakpoint(), lldb_private::BreakpointSite::eExternal, error(), lldb_private::Status::FromErrorString(), lldb_private::StoppointSite::GetLoadAddress(), lldb_private::BreakpointSite::GetType(), lldb_private::BreakpointSite::IsEnabled(), CommunicationKDP::IsRunning(), CommunicationKDP::LocalBreakpointsAreSupported(), m_comm, lldb_private::Process::m_destroy_in_process, CommunicationKDP::SendRequestBreakpoint(), and lldb_private::BreakpointSite::SetEnabled().
|
overridevirtual |
Actually allocate memory in the process.
This function will allocate memory in the process's address space. This can't rely on the generic function calling mechanism, since that requires this function.
[in] | size | The size of the allocation requested. |
Reimplemented from lldb_private::Process.
Definition at line 618 of file ProcessKDP.cpp.
References error(), lldb_private::Status::FromErrorString(), and LLDB_INVALID_ADDRESS.
|
overridevirtual |
Attach to an existing process using a process ID.
[in] | pid | The process ID that we should attempt to attach to. |
[in] | attach_info | Information on how to do the attach. For example, GetUserID() will return the uid to attach as. |
Reimplemented from lldb_private::Process.
Definition at line 368 of file ProcessKDP.cpp.
References error(), and lldb_private::Status::FromErrorString().
|
overridevirtual |
Attach to an existing process using a partial process name.
[in] | process_name | The name of the process to attach to. |
[in] | attach_info | Information on how to do the attach. For example, GetUserID() will return the uid to attach as. |
Reimplemented from lldb_private::Process.
Definition at line 377 of file ProcessKDP.cpp.
References error(), and lldb_private::Status::FromErrorString().
|
overridevirtual |
Attach to a remote system via a URL.
[in] | remote_url | The URL format that we are connecting to. |
Reimplemented from lldb_private::Process.
Definition at line 207 of file ProcessKDP.cpp.
References lldb_private::Communication::Disconnect(), lldb_private::PluginManager::DownloadObjectAndSymbolFile(), lldb::eConnectionStatusSuccess, lldb_private::eLoadDependentsNo, error(), lldb::eStateStopped, lldb_private::Status::FromErrorString(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::ModuleSpec::GetArchitecture(), lldb_private::Target::GetArchitecture(), lldb_private::Debugger::GetAsyncOutputStream(), lldb_private::Target::GetDebugger(), lldb_private::Target::GetDefaultDebugFileSearchPaths(), lldb_private::Target::GetExecutableModule(), lldb_private::ModuleSpec::GetFileSpec(), GetHostArchitecture(), CommunicationKDP::GetKernelVersion(), CommunicationKDP::GetLoadAddress(), lldb_private::TCPSocket::GetLocalPortNumber(), DynamicLoaderDarwinKernel::GetPluginNameStatic(), lldb_private::ModuleSpec::GetSymbolFileSpec(), lldb_private::Process::GetTarget(), lldb_private::Process::GetThreadList(), lldb_private::ModuleSpec::GetUUID(), CommunicationKDP::GetUUID(), CommunicationKDP::GetVersion(), lldb_private::FileSystem::Instance(), lldb_private::UUID::IsValid(), LLDB_INVALID_ADDRESS, lldb_private::PluginManager::LocateExecutableObjectFile(), lldb_private::PluginManager::LocateExecutableSymbolFile(), m_comm, m_dyld_plugin_name, m_kernel_load_addr, lldb_private::ArchSpec::MergeFrom(), CommunicationKDP::RemoteIsDarwinKernel(), CommunicationKDP::RemoteIsEFI(), CommunicationKDP::SendRequestConnect(), CommunicationKDP::SendRequestReattach(), lldb_private::Target::SetArchitecture(), lldb_private::Process::SetCanJIT(), lldb_private::Communication::SetConnection(), lldb_private::Target::SetExecutableModule(), lldb_private::Process::SetID(), lldb_private::Process::SetPrivateState(), and lldb_private::Process::UpdateThreadListIfNeeded().
|
overridevirtual |
Actually deallocate memory in the process.
This function will deallocate memory in the process's address space that was allocated with AllocateMemory.
[in] | ptr | A return value from AllocateMemory, pointing to the memory you want to deallocate. |
Reimplemented from lldb_private::Process.
Definition at line 625 of file ProcessKDP.cpp.
References error(), and lldb_private::Status::FromErrorString().
|
overridevirtual |
Implements lldb_private::Process.
Definition at line 569 of file ProcessKDP.cpp.
References DoDetach().
|
overridevirtual |
Detaches from a running or stopped process.
Reimplemented from lldb_private::Process.
Definition at line 535 of file ProcessKDP.cpp.
References lldb_private::Communication::Clear(), lldb_private::Communication::Disconnect(), error(), lldb::eStateDetached, lldb_private::GetLog(), lldb_private::Communication::IsConnected(), CommunicationKDP::IsRunning(), LLDB_LOGF, m_comm, lldb_private::Log::PutCString(), lldb_private::Process::ResumePrivateStateThread(), CommunicationKDP::SendRequestDisconnect(), lldb_private::Process::SetPrivateState(), and StopAsyncThread().
Referenced by DoDestroy().
|
overridevirtual |
Halts a running process.
DoHalt must produce one and only one stop StateChanged event if it actually stops the process. If the stop happens through some natural event (for instance a SIGSTOP), then forwarding that event will do. Otherwise, you must generate the event manually. This function is called from the context of the private state thread.
[out] | caused_stop | If true, then this Halt caused the stop, otherwise, the process was already stopped. |
Reimplemented from lldb_private::Process.
Definition at line 519 of file ProcessKDP.cpp.
References error(), lldb::eStateStopped, lldb_private::Status::FromErrorString(), CommunicationKDP::IsRunning(), m_comm, lldb_private::Process::m_destroy_in_process, and lldb_private::Process::SetPrivateState().
|
overridevirtual |
Launch a new process.
Launch a new process by spawning a new process using exe_module's file as the file to launch. Launch details are provided in launch_info.
[in] | exe_module | The module from which to extract the file specification and launch. |
[in] | launch_info | Details (e.g. arguments, stdio redirection, etc.) for the requested launch. |
Reimplemented from lldb_private::Process.
Definition at line 359 of file ProcessKDP.cpp.
References error(), and lldb_private::Status::FromErrorString().
|
overridevirtual |
Actually do the reading of memory from a process.
Subclasses must override this function and can return fewer bytes than requested when memory requests are too large. This class will break up the memory requests and keep advancing the arguments along as needed.
[in] | vm_addr | A virtual load address that indicates where to start reading memory from. |
[in] | size | The number of bytes to read. |
[out] | buf | A byte buffer that is at least size bytes long that will receive the memory bytes. |
[out] | error | An error that indicates the success or failure of this operation. If error indicates success (error.Success()), then the value returned can be trusted, otherwise zero will be returned. |
Implements lldb_private::Process.
Definition at line 582 of file ProcessKDP.cpp.
References error(), lldb_private::Status::FromErrorString(), lldb_private::Communication::IsConnected(), m_comm, and CommunicationKDP::SendRequestReadMemory().
|
overridevirtual |
Resumes all of a process's threads as configured using the Thread run control functions.
Threads for a process should be updated with one of the run control actions (resume, step, or suspend) that they should take when the process is resumed. If no run control action is given to a thread it will be resumed by default.
Reimplemented from lldb_private::Process.
Definition at line 405 of file ProcessKDP.cpp.
References lldb_private::Broadcaster::BroadcastEvent(), eBroadcastBitAsyncContinue, error(), lldb::eStateRunning, lldb::eStateStepping, lldb::eStateSuspended, lldb_private::ThreadList::FindThreadByProtocolID(), lldb_private::Status::FromErrorString(), lldb_private::Status::FromErrorStringWithFormat(), g_kernel_tid, lldb_private::GetLog(), lldb_private::HostThread::IsJoinable(), LLDB_LOGF, m_async_broadcaster, m_async_thread, m_comm, lldb_private::Process::m_thread_list, CommunicationKDP::SendRequestResume(), lldb_private::Process::SetPrivateState(), StartAsyncThread(), and lldb_private::StateAsCString().
|
overridevirtual |
Sends a process a UNIX signal signal.
Reimplemented from lldb_private::Process.
Definition at line 677 of file ProcessKDP.cpp.
References error(), and lldb_private::Status::FromErrorString().
|
overrideprotectedvirtual |
Update the thread list following process plug-in's specific logic.
This method should only be invoked by UpdateThreadList.
Implements lldb_private::Process.
Definition at line 496 of file ProcessKDP.cpp.
References lldb_private::ThreadCollection::AddThread(), lldb_private::ThreadList::FindThreadByProtocolID(), g_kernel_tid, lldb_private::Process::GetID(), GetKernelThread(), lldb_private::GetLog(), lldb_private::ThreadList::GetSize(), and LLDB_LOGV.
|
overridevirtual |
Called before attaching to a process.
Allow Process plug-ins to execute some code before attaching a process.
Reimplemented from lldb_private::Process.
Definition at line 178 of file ProcessKDP.cpp.
References error(), and lldb_private::Status::FromErrorString().
|
overridevirtual |
Called before attaching to a process.
Allow Process plug-ins to execute some code before attaching a process.
Reimplemented from lldb_private::Process.
Definition at line 185 of file ProcessKDP.cpp.
References error(), and lldb_private::Status::FromErrorString().
|
overridevirtual |
Called before launching to a process.
Allow Process plug-ins to execute some code before launching a process.
Reimplemented from lldb_private::Process.
Definition at line 171 of file ProcessKDP.cpp.
References error(), and lldb_private::Status::FromErrorString().
|
overridevirtual |
Actually do the writing of memory to a process.
[in] | vm_addr | A virtual load address that indicates where to start writing memory to. |
[in] | buf | A byte buffer that is at least size bytes long that contains the data to write. |
[in] | size | The number of bytes to write. |
[out] | error | An error value in case the memory write fails. |
Reimplemented from lldb_private::Process.
Definition at line 610 of file ProcessKDP.cpp.
References error(), lldb_private::Status::FromErrorString(), lldb_private::Communication::IsConnected(), m_comm, and CommunicationKDP::SendRequestWriteMemory().
|
overridevirtual |
Reimplemented from lldb_private::Process.
Definition at line 632 of file ProcessKDP.cpp.
References lldb_private::BreakpointSite::eExternal, lldb_private::Process::EnableSoftwareBreakpoint(), error(), lldb_private::Status::FromErrorString(), lldb_private::StoppointSite::GetLoadAddress(), lldb_private::StoppointSite::HardwareRequired(), lldb_private::BreakpointSite::IsEnabled(), CommunicationKDP::LocalBreakpointsAreSupported(), m_comm, CommunicationKDP::SendRequestBreakpoint(), lldb_private::BreakpointSite::SetEnabled(), and lldb_private::BreakpointSite::SetType().
|
inline |
Definition at line 127 of file ProcessKDP.h.
References m_comm.
Referenced by ThreadKDP::CreateRegisterContextForFrame(), CommandObjectProcessKDPPacketSend::DoExecute(), RegisterContextKDP_arm::DoReadDBG(), RegisterContextKDP_arm64::DoReadDBG(), RegisterContextKDP_arm::DoReadEXC(), RegisterContextKDP_arm64::DoReadEXC(), RegisterContextKDP_i386::DoReadEXC(), RegisterContextKDP_x86_64::DoReadEXC(), RegisterContextKDP_arm::DoReadFPU(), RegisterContextKDP_arm64::DoReadFPU(), RegisterContextKDP_i386::DoReadFPU(), RegisterContextKDP_x86_64::DoReadFPU(), RegisterContextKDP_arm::DoReadGPR(), RegisterContextKDP_arm64::DoReadGPR(), RegisterContextKDP_i386::DoReadGPR(), RegisterContextKDP_x86_64::DoReadGPR(), RegisterContextKDP_arm::DoWriteDBG(), RegisterContextKDP_arm64::DoWriteDBG(), RegisterContextKDP_arm::DoWriteEXC(), RegisterContextKDP_arm64::DoWriteEXC(), RegisterContextKDP_i386::DoWriteEXC(), RegisterContextKDP_x86_64::DoWriteEXC(), RegisterContextKDP_arm::DoWriteFPU(), RegisterContextKDP_arm64::DoWriteFPU(), RegisterContextKDP_i386::DoWriteFPU(), RegisterContextKDP_x86_64::DoWriteFPU(), RegisterContextKDP_arm::DoWriteGPR(), RegisterContextKDP_arm64::DoWriteGPR(), RegisterContextKDP_i386::DoWriteGPR(), and RegisterContextKDP_x86_64::DoWriteGPR().
|
overridevirtual |
Get the dynamic loader plug-in for this process.
The default action is to let the DynamicLoader plug-ins check the main executable and the DynamicLoader will select itself automatically. Subclasses can override this if inspecting the executable is not desired, or if Process subclasses can only use a specific DynamicLoader plug-in.
Reimplemented from lldb_private::Process.
Definition at line 397 of file ProcessKDP.cpp.
References lldb_private::DynamicLoader::FindPlugin(), m_dyld_plugin_name, and lldb_private::Process::m_dyld_up.
|
protected |
Definition at line 193 of file ProcessKDP.cpp.
References lldb_private::ArchSpec::Clear(), lldb_private::eArchTypeMachO, CommunicationKDP::GetCPUSubtype(), CommunicationKDP::GetCPUType(), lldb_private::ArchSpec::GetTriple(), m_comm, and lldb_private::ArchSpec::SetArchitecture().
Referenced by DidAttach(), and DoConnectRemote().
|
overridevirtual |
Get the image information address for the current process.
Some runtimes have system functions that can help dynamic loaders locate the dynamic loader information needed to observe shared libraries being loaded or unloaded. This function is in the Process interface (as opposed to the DynamicLoader interface) to ensure that remote debugging can take advantage of this functionality.
Reimplemented from lldb_private::Process.
Definition at line 395 of file ProcessKDP.cpp.
References m_kernel_load_addr.
|
protected |
Definition at line 484 of file ProcessKDP.cpp.
References g_kernel_tid, and m_kernel_thread_wp.
Referenced by AsyncThread(), and DoUpdateThreadList().
|
overridevirtual |
Return a multi-word command object that can be used to expose plug-in specific commands.
This object will be used to resolve plug-in commands and can be triggered by a call to:
(lldb) process command <args>
Reimplemented from lldb_private::Process.
Definition at line 979 of file ProcessKDP.cpp.
References lldb_private::Process::GetTarget(), and m_command_sp.
|
static |
Definition at line 94 of file ProcessKDP.cpp.
Referenced by Initialize().
|
inlineoverridevirtual |
Implements lldb_private::PluginInterface.
Definition at line 88 of file ProcessKDP.h.
References GetPluginNameStatic().
|
inlinestatic |
Definition at line 44 of file ProcessKDP.h.
Referenced by GetPluginName(), and Initialize().
|
inlineprotected |
Definition at line 144 of file ProcessKDP.h.
References lldb::eStateExited.
|
static |
Definition at line 684 of file ProcessKDP.cpp.
References CreateInstance(), DebuggerInitialize(), GetPluginDescriptionStatic(), GetPluginNameStatic(), lldb_private::ProcessKDPLog::Initialize(), and lldb_private::PluginManager::RegisterPlugin().
|
overridevirtual |
Check if a process is still alive.
Reimplemented from lldb_private::Process.
Definition at line 577 of file ProcessKDP.cpp.
References lldb_private::Process::IsAlive(), lldb_private::Communication::IsConnected(), and m_comm.
|
inlineprotected |
Definition at line 134 of file ProcessKDP.h.
References lldb::eStateRunning, and IsStepping().
|
inlineprotected |
Definition at line 138 of file ProcessKDP.h.
References lldb::eStateStepping.
Referenced by IsRunning().
|
privatedelete |
|
protected |
|
overridevirtual |
Currently called as part of ShouldStop.
FIXME: Should really happen when the target stops before the event is taken from the queue...
This callback is called as the event is about to be queued up to allow Process plug-ins to execute some code prior to clients being notified that a process was stopped. Common operations include updating the thread list, invalidating any thread state (registers, stack, etc) prior to letting the notification go out.
Implements lldb_private::Process.
Definition at line 513 of file ProcessKDP.cpp.
References lldb_private::Process::m_thread_list, and lldb_private::ThreadList::RefreshStateAfterStop().
|
protected |
Definition at line 706 of file ProcessKDP.cpp.
References AsyncThread(), lldb_private::GetLog(), lldb_private::HostThread::IsJoinable(), lldb_private::ThreadLauncher::LaunchThread(), LLDB_LOG_ERROR, LLDB_LOGF, and m_async_thread.
Referenced by DoResume().
|
protected |
Definition at line 725 of file ProcessKDP.cpp.
References lldb_private::Broadcaster::BroadcastEvent(), eBroadcastBitAsyncThreadShouldExit, lldb_private::GetLog(), lldb_private::HostThread::IsJoinable(), lldb_private::HostThread::Join(), LLDB_LOGF, m_async_broadcaster, and m_async_thread.
Referenced by DoDetach().
|
static |
Definition at line 99 of file ProcessKDP.cpp.
References CreateInstance(), and lldb_private::PluginManager::UnregisterPlugin().
|
overridevirtual |
Called before resuming to a process.
Allow Process plug-ins to execute some code before resuming a process.
Reimplemented from lldb_private::Process.
Definition at line 403 of file ProcessKDP.cpp.
|
friend |
Definition at line 131 of file ProcessKDP.h.
|
friend |
Definition at line 130 of file ProcessKDP.h.
|
protected |
Definition at line 164 of file ProcessKDP.h.
Referenced by AsyncThread(), DoResume(), ProcessKDP(), and StopAsyncThread().
|
protected |
Definition at line 165 of file ProcessKDP.h.
Referenced by AsyncThread(), DoResume(), StartAsyncThread(), and StopAsyncThread().
|
protected |
Broadcaster event bits definitions.
Definition at line 163 of file ProcessKDP.h.
Referenced by AsyncThread(), DisableBreakpointSite(), DoConnectRemote(), DoDetach(), DoHalt(), DoReadMemory(), DoResume(), DoWriteMemory(), EnableBreakpointSite(), GetCommunication(), GetHostArchitecture(), IsAlive(), and ProcessKDP().
|
protected |
Definition at line 168 of file ProcessKDP.h.
Referenced by GetPluginCommandObject().
|
protected |
Definition at line 166 of file ProcessKDP.h.
Referenced by DoConnectRemote(), and GetDynamicLoader().
|
protected |
Definition at line 167 of file ProcessKDP.h.
Referenced by DoConnectRemote(), and GetImageInfoAddress().
|
protected |
Definition at line 169 of file ProcessKDP.h.
Referenced by GetKernelThread().