LLDB  mainline
ThreadPlanStepOut.h
Go to the documentation of this file.
1 //===-- ThreadPlanStepOut.h -------------------------------------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #ifndef LLDB_TARGET_THREADPLANSTEPOUT_H
10 #define LLDB_TARGET_THREADPLANSTEPOUT_H
11 
12 #include "lldb/Target/Thread.h"
13 #include "lldb/Target/ThreadPlan.h"
15 
16 namespace lldb_private {
17 
19 public:
20  ThreadPlanStepOut(Thread &thread, SymbolContext *addr_context,
21  bool first_insn, bool stop_others, Vote stop_vote,
22  Vote run_vote, uint32_t frame_idx,
23  LazyBool step_out_avoids_code_without_debug_info,
24  bool continue_to_next_branch = false,
25  bool gather_return_value = true);
26 
27  ~ThreadPlanStepOut() override;
28 
29  void GetDescription(Stream *s, lldb::DescriptionLevel level) override;
30  bool ValidatePlan(Stream *error) override;
31  bool ShouldStop(Event *event_ptr) override;
32  bool StopOthers() override;
34  bool WillStop() override;
35  bool MischiefManaged() override;
36  void DidPush() override;
37  bool IsPlanStale() override;
38 
39  lldb::ValueObjectSP GetReturnValueObject() override {
40  return m_return_valobj_sp;
41  }
42 
43 protected:
44  void SetFlagsToDefault() override {
46  }
47 
48  bool DoPlanExplainsStop(Event *event_ptr) override;
49  bool DoWillResume(lldb::StateType resume_state, bool current_plan) override;
50  bool QueueInlinedStepPlan(bool queue_now);
51 
52 private:
53  static uint32_t s_default_flag_values; // These are the default flag values
54  // for the ThreadPlanStepThrough.
55 
62  lldb::ThreadPlanSP m_step_out_to_inline_plan_sp; // This plan implements step
63  // out to the real function
64  // containing
65  // an inlined frame so we can then step out of that.
66  lldb::ThreadPlanSP m_step_through_inline_plan_sp; // This plan then steps past
67  // the inlined frame(s).
68  lldb::ThreadPlanSP m_step_out_further_plan_sp; // This plan keeps stepping out
69  // if ShouldStopHere told us
70  // to.
72  std::vector<lldb::StackFrameSP> m_stepped_past_frames;
73  lldb::ValueObjectSP m_return_valobj_sp;
76 
77  friend lldb::ThreadPlanSP Thread::QueueThreadPlanForStepOut(
78  bool abort_other_plans, SymbolContext *addr_context, bool first_insn,
79  bool stop_others, Vote stop_vote, Vote run_vote, uint32_t frame_idx,
80  Status &status, LazyBool step_out_avoids_code_without_debug_info);
81 
82  void SetupAvoidNoDebug(LazyBool step_out_avoids_code_without_debug_info);
83  // Need an appropriate marker for the current stack so we can tell step out
84  // from step in.
85 
86  void CalculateReturnValue();
87 
88  ThreadPlanStepOut(const ThreadPlanStepOut &) = delete;
89  const ThreadPlanStepOut &operator=(const ThreadPlanStepOut &) = delete;
90 };
91 
92 } // namespace lldb_private
93 
94 #endif // LLDB_TARGET_THREADPLANSTEPOUT_H
bool DoPlanExplainsStop(Event *event_ptr) override
A class that represents a running process on the host machine.
bool ShouldStop(Event *event_ptr) override
int32_t break_id_t
Definition: lldb-types.h:88
A stream class that can stream formatted output to a file.
Definition: Stream.h:28
ThreadPlanStepOut(Thread &thread, SymbolContext *addr_context, bool first_insn, bool stop_others, Vote stop_vote, Vote run_vote, uint32_t frame_idx, LazyBool step_out_avoids_code_without_debug_info, bool continue_to_next_branch=false, bool gather_return_value=true)
bool QueueInlinedStepPlan(bool queue_now)
Defines a symbol context baton that can be handed other debug core functions.
Definition: SymbolContext.h:33
std::vector< lldb::StackFrameSP > m_stepped_past_frames
A class that describes a function.
Definition: Function.h:413
lldb::ThreadPlanSP m_step_out_further_plan_sp
DescriptionLevel
Description levels for "void GetDescription(Stream *, DescriptionLevel)" calls.
void SetupAvoidNoDebug(LazyBool step_out_avoids_code_without_debug_info)
lldb::ValueObjectSP m_return_valobj_sp
lldb::ThreadPlanSP m_step_out_to_inline_plan_sp
static llvm::raw_ostream & error(Stream &strm)
StateType
Process and Thread States.
ValueType Set(ValueType mask)
Set one or more flags by logical OR&#39;ing mask with the current flags.
Definition: Flags.h:73
bool ValidatePlan(Stream *error) override
Returns whether this plan could be successfully created.
void GetDescription(Stream *s, lldb::DescriptionLevel level) override
Print a description of this thread to the stream s.
uint64_t addr_t
Definition: lldb-types.h:83
bool DoWillResume(lldb::StateType resume_state, bool current_plan) override
lldb::ThreadPlanSP m_step_through_inline_plan_sp
const ThreadPlanStepOut & operator=(const ThreadPlanStepOut &)=delete
lldb::ValueObjectSP GetReturnValueObject() override
virtual lldb::ThreadPlanSP QueueThreadPlanForStepOut(bool abort_other_plans, SymbolContext *addr_context, bool first_insn, bool stop_other_threads, Vote stop_vote, Vote run_vote, uint32_t frame_idx, Status &status, LazyBool step_out_avoids_code_without_debug_info=eLazyBoolCalculate)
Queue the plan used to step out of the function at the current PC of thread.
Definition: Thread.cpp:1306
lldb::StateType GetPlanRunState() override
An error handling class.
Definition: Status.h:44