File Manager

003 File Manager

Current Path: /usr/src/contrib/llvm-project/lldb/include/lldb/Target

usr / src / contrib / llvm-project / lldb / include / lldb / Target /

📁 ..
📄 ABI.h(7 KB)
📄 AssertFrameRecognizer.h(1.79 KB)
📄 DynamicLoader.h(12.8 KB)
📄 ExecutionContext.h(23.91 KB)
📄 ExecutionContextScope.h(2.07 KB)
📄 InstrumentationRuntime.h(3.06 KB)
📄 InstrumentationRuntimeStopInfo.h(1.3 KB)
📄 JITLoader.h(2.15 KB)
📄 JITLoaderList.h(1.17 KB)
📄 Language.h(9.42 KB)
📄 LanguageRuntime.h(6.71 KB)
📄 Memory.h(4.66 KB)
📄 MemoryHistory.h(998 B)
📄 MemoryRegionInfo.h(4.76 KB)
📄 ModuleCache.h(2.42 KB)
📄 OperatingSystem.h(2.66 KB)
📄 PathMappingList.h(4.09 KB)
📄 Platform.h(42.4 KB)
📄 Process.h(110.8 KB)
📄 ProcessStructReader.h(3.27 KB)
📄 Queue.h(5.04 KB)
📄 QueueItem.h(5.24 KB)
📄 QueueList.h(3.32 KB)
📄 RegisterCheckpoint.h(1.89 KB)
📄 RegisterContext.h(7.73 KB)
📄 RegisterContextUnwind.h(9.73 KB)
📄 RegisterNumber.h(1.71 KB)
📄 RemoteAwarePlatform.h(3.76 KB)
📄 SectionLoadHistory.h(2.79 KB)
📄 SectionLoadList.h(2.36 KB)
📄 StackFrame.h(20.05 KB)
📄 StackFrameList.h(5.83 KB)
📄 StackFrameRecognizer.h(5.65 KB)
📄 StackID.h(3.16 KB)
📄 StopInfo.h(6.92 KB)
📄 StructuredDataPlugin.h(7.14 KB)
📄 SystemRuntime.h(11.83 KB)
📄 Target.h(49.2 KB)
📄 TargetList.h(7.75 KB)
📄 Thread.h(49.21 KB)
📄 ThreadCollection.h(1.63 KB)
📄 ThreadList.h(4.65 KB)
📄 ThreadPlan.h(24.41 KB)
📄 ThreadPlanBase.h(1.79 KB)
📄 ThreadPlanCallFunction.h(5.55 KB)
📄 ThreadPlanCallFunctionUsingABI.h(1.98 KB)
📄 ThreadPlanCallOnFunctionExit.h(1.56 KB)
📄 ThreadPlanCallUserExpression.h(2.21 KB)
📄 ThreadPlanPython.h(2.11 KB)
📄 ThreadPlanRunToAddress.h(2.04 KB)
📄 ThreadPlanShouldStopHere.h(5.02 KB)
📄 ThreadPlanStack.h(5.48 KB)
📄 ThreadPlanStepInRange.h(4.66 KB)
📄 ThreadPlanStepInstruction.h(1.86 KB)
📄 ThreadPlanStepOut.h(3.67 KB)
📄 ThreadPlanStepOverBreakpoint.h(1.84 KB)
📄 ThreadPlanStepOverRange.h(1.83 KB)
📄 ThreadPlanStepRange.h(3.69 KB)
📄 ThreadPlanStepThrough.h(1.97 KB)
📄 ThreadPlanStepUntil.h(2.12 KB)
📄 ThreadPlanTracer.h(2.32 KB)
📄 ThreadSpec.h(3.35 KB)
📄 UnixSignals.h(4.25 KB)
📄 Unwind.h(2.4 KB)
📄 UnwindAssembly.h(1.81 KB)
📄 UnwindLLDB.h(5.69 KB)

Editing: StopInfo.h

//===-- StopInfo.h ----------------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//

#ifndef LLDB_TARGET_STOPINFO_H
#define LLDB_TARGET_STOPINFO_H

#include <string>

#include "lldb/Target/Process.h"
#include "lldb/Utility/StructuredData.h"
#include "lldb/lldb-public.h"

namespace lldb_private {

class StopInfo {
  friend class Process::ProcessEventData;
  friend class ThreadPlanBase;

public:
  // Constructors and Destructors
  StopInfo(Thread &thread, uint64_t value);

virtual ~StopInfo() {}

bool IsValid() const;

void SetThread(const lldb::ThreadSP &thread_sp) { m_thread_wp = thread_sp; }

lldb::ThreadSP GetThread() const { return m_thread_wp.lock(); }

// The value of the StopInfo depends on the StopReason.
  //
  // StopReason Meaning
  // ------------------------------------------------
  // eStopReasonBreakpoint       BreakpointSiteID
  // eStopReasonSignal           Signal number
  // eStopReasonWatchpoint       WatchpointLocationID
  // eStopReasonPlanComplete     No significance

uint64_t GetValue() const { return m_value; }

virtual lldb::StopReason GetStopReason() const = 0;

// ShouldStopSynchronous will get called before any thread plans are
  // consulted, and if it says we should resume the target, then we will just
  // immediately resume.  This should not run any code in or resume the target.

virtual bool ShouldStopSynchronous(Event *event_ptr) { return true; }

void OverrideShouldNotify(bool override_value) {
    m_override_should_notify = override_value ? eLazyBoolYes : eLazyBoolNo;
  }

// If should stop returns false, check if we should notify of this event
  virtual bool ShouldNotify(Event *event_ptr) {
    if (m_override_should_notify == eLazyBoolCalculate)
      return DoShouldNotify(event_ptr);
    else
      return m_override_should_notify == eLazyBoolYes;
  }

virtual void WillResume(lldb::StateType resume_state) {
    // By default, don't do anything
  }

virtual const char *GetDescription() { return m_description.c_str(); }

virtual void SetDescription(const char *desc_cstr) {
    if (desc_cstr && desc_cstr[0])
      m_description.assign(desc_cstr);
    else
      m_description.clear();
  }

virtual bool IsValidForOperatingSystemThread(Thread &thread) { return true; }

// Sometimes the thread plan logic will know that it wants a given stop to
  // stop or not, regardless of what the ordinary logic for that StopInfo would
  // dictate.  The main example of this is the ThreadPlanCallFunction, which
  // for instance knows - based on how that particular expression was executed
  // - whether it wants all breakpoints to auto-continue or not. Use
  // OverrideShouldStop on the StopInfo to implement this.

void OverrideShouldStop(bool override_value) {
    m_override_should_stop = override_value ? eLazyBoolYes : eLazyBoolNo;
  }

bool GetOverrideShouldStop() {
    return m_override_should_stop != eLazyBoolCalculate;
  }

bool GetOverriddenShouldStopValue() {
    return m_override_should_stop == eLazyBoolYes;
  }

StructuredData::ObjectSP GetExtendedInfo() { return m_extended_info; }

static lldb::StopInfoSP
  CreateStopReasonWithBreakpointSiteID(Thread &thread,
                                       lldb::break_id_t break_id);

// This creates a StopInfo for the thread where the should_stop is already
  // set, and won't be recalculated.
  static lldb::StopInfoSP CreateStopReasonWithBreakpointSiteID(
      Thread &thread, lldb::break_id_t break_id, bool should_stop);

static lldb::StopInfoSP CreateStopReasonWithWatchpointID(
      Thread &thread, lldb::break_id_t watch_id,
      lldb::addr_t watch_hit_addr = LLDB_INVALID_ADDRESS);

static lldb::StopInfoSP
  CreateStopReasonWithSignal(Thread &thread, int signo,
                             const char *description = nullptr);

static lldb::StopInfoSP CreateStopReasonToTrace(Thread &thread);

static lldb::StopInfoSP
  CreateStopReasonWithPlan(lldb::ThreadPlanSP &plan,
                           lldb::ValueObjectSP return_valobj_sp,
                           lldb::ExpressionVariableSP expression_variable_sp);

static lldb::StopInfoSP
  CreateStopReasonWithException(Thread &thread, const char *description);

static lldb::StopInfoSP CreateStopReasonWithExec(Thread &thread);

static lldb::ValueObjectSP
  GetReturnValueObject(lldb::StopInfoSP &stop_info_sp);

static lldb::ExpressionVariableSP
  GetExpressionVariable(lldb::StopInfoSP &stop_info_sp);

static lldb::ValueObjectSP
  GetCrashingDereference(lldb::StopInfoSP &stop_info_sp,
                         lldb::addr_t *crashing_address = nullptr);

protected:
  // Perform any action that is associated with this stop.  This is done as the
  // Event is removed from the event queue.  ProcessEventData::DoOnRemoval does
  // the job.

virtual void PerformAction(Event *event_ptr) {}

virtual bool DoShouldNotify(Event *event_ptr) { return false; }

// Stop the thread by default. Subclasses can override this to allow the
  // thread to continue if desired.  The ShouldStop method should not do
  // anything that might run code.  If you need to run code when deciding
  // whether to stop at this StopInfo, that must be done in the PerformAction.
  // The PerformAction will always get called before the ShouldStop.  This is
  // done by the ProcessEventData::DoOnRemoval, though the ThreadPlanBase needs
  // to consult this later on.
  virtual bool ShouldStop(Event *event_ptr) { return true; }

// Classes that inherit from StackID can see and modify these
  lldb::ThreadWP m_thread_wp; // The thread corresponding to the stop reason.
  uint32_t m_stop_id;   // The process stop ID for which this stop info is valid
  uint32_t m_resume_id; // This is the resume ID when we made this stop ID.
  uint64_t m_value; // A generic value that can be used for things pertaining to
                    // this stop info
  std::string m_description; // A textual description describing this stop.
  LazyBool m_override_should_notify;
  LazyBool m_override_should_stop;

StructuredData::ObjectSP
      m_extended_info; // The extended info for this stop info

// This determines whether the target has run since this stop info. N.B.
  // running to evaluate a user expression does not count.
  bool HasTargetRunSinceMe();

// MakeStopInfoValid is necessary to allow saved stop infos to resurrect
  // themselves as valid. It should only be used by
  // Thread::RestoreThreadStateFromCheckpoint and to make sure the one-step
  // needed for before-the-fact watchpoints does not prevent us from stopping
  void MakeStopInfoValid();

private:
  friend class Thread;

StopInfo(const StopInfo &) = delete;
  const StopInfo &operator=(const StopInfo &) = delete;
};

} // namespace lldb_private

#endif // LLDB_TARGET_STOPINFO_H

003 File Manager

Editing: StopInfo.h

Upload File

Create Folder