1//===-- ThreadPlanCallFunction.h --------------------------------*- C++ -*-===//
2//
3//                     The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9
10#ifndef liblldb_ThreadPlanCallFunction_h_
11#define liblldb_ThreadPlanCallFunction_h_
12
13// C Includes
14// C++ Includes
15// Other libraries and framework includes
16// Project includes
17#include "lldb/lldb-private.h"
18#include "lldb/Target/Thread.h"
19#include "lldb/Target/ThreadPlan.h"
20
21namespace lldb_private {
22
23class ThreadPlanCallFunction : public ThreadPlan
24{
25    // Create a thread plan to call a function at the address passed in the "function"
26    // argument.  If you plan to call GetReturnValueObject, then pass in the
27    // return type, otherwise just pass in an invalid ClangASTType.
28public:
29    ThreadPlanCallFunction (Thread &thread,
30                            const Address &function,
31                            const ClangASTType &return_type,
32                            lldb::addr_t arg,
33                            bool stop_other_threads,
34                            bool unwind_on_error = true,
35                            bool ignore_breakpoints = false,
36                            lldb::addr_t *this_arg = 0,
37                            lldb::addr_t *cmd_arg = 0);
38
39    ThreadPlanCallFunction (Thread &thread,
40                            const Address &function,
41                            const ClangASTType &return_type,
42                            bool stop_other_threads,
43                            bool unwind_on_error,
44                            bool ignore_breakpoints,
45                            lldb::addr_t *arg1_ptr = NULL,
46                            lldb::addr_t *arg2_ptr = NULL,
47                            lldb::addr_t *arg3_ptr = NULL,
48                            lldb::addr_t *arg4_ptr = NULL,
49                            lldb::addr_t *arg5_ptr = NULL,
50                            lldb::addr_t *arg6_ptr = NULL);
51
52    virtual
53    ~ThreadPlanCallFunction ();
54
55    virtual void
56    GetDescription (Stream *s, lldb::DescriptionLevel level);
57
58    virtual bool
59    ValidatePlan (Stream *error);
60
61    virtual bool
62    ShouldStop (Event *event_ptr);
63
64    virtual Vote
65    ShouldReportStop(Event *event_ptr);
66
67    virtual bool
68    StopOthers ();
69
70    virtual void
71    SetStopOthers (bool new_value);
72
73    virtual lldb::StateType
74    GetPlanRunState ();
75
76    virtual void
77    DidPush ();
78
79    virtual bool
80    WillStop ();
81
82    virtual bool
83    MischiefManaged ();
84
85    // To get the return value from a function call you must create a
86    // lldb::ValueSP that contains a valid clang type in its context and call
87    // RequestReturnValue. The ValueSP will be stored and when the function is
88    // done executing, the object will check if there is a requested return
89    // value. If there is, the return value will be retrieved using the
90    // ABI::GetReturnValue() for the ABI in the process. Then after the thread
91    // plan is complete, you can call "GetReturnValue()" to retrieve the value
92    // that was extracted.
93
94    virtual lldb::ValueObjectSP
95    GetReturnValueObject ()
96    {
97        return m_return_valobj_sp;
98    }
99
100    // Return the stack pointer that the function received
101    // on entry.  Any stack address below this should be
102    // considered invalid after the function has been
103    // cleaned up.
104    lldb::addr_t
105    GetFunctionStackPointer()
106    {
107        return m_function_sp;
108    }
109
110    // Classes that derive from ClangFunction, and implement
111    // their own WillPop methods should call this so that the
112    // thread state gets restored if the plan gets discarded.
113    virtual void
114    WillPop ();
115
116    // If the thread plan stops mid-course, this will be the stop reason that interrupted us.
117    // Once DoTakedown is called, this will be the real stop reason at the end of the function call.
118    // If it hasn't been set for one or the other of these reasons, we'll return the PrivateStopReason.
119    // This is needed because we want the CallFunction thread plans not to show up as the stop reason.
120    // But if something bad goes wrong, it is nice to be able to tell the user what really happened.
121
122    virtual lldb::StopInfoSP
123    GetRealStopInfo()
124    {
125        if (m_real_stop_info_sp)
126            return m_real_stop_info_sp;
127        else
128            return GetPrivateStopInfo ();
129    }
130
131    lldb::addr_t
132    GetStopAddress ()
133    {
134        return m_stop_address;
135    }
136
137    virtual bool
138    RestoreThreadState();
139
140protected:
141    void ReportRegisterState (const char *message);
142
143    virtual bool
144    DoPlanExplainsStop (Event *event_ptr);
145
146private:
147
148    bool
149    ConstructorSetup (Thread &thread,
150                      ABI *& abi,
151                      lldb::addr_t &start_load_addr,
152                      lldb::addr_t &function_load_addr);
153
154    void
155    DoTakedown (bool success);
156
157    void
158    SetBreakpoints ();
159
160    void
161    ClearBreakpoints ();
162
163    bool
164    BreakpointsExplainStop ();
165
166    bool                                            m_valid;
167    bool                                            m_stop_other_threads;
168    Address                                         m_function_addr;
169    Address                                         m_start_addr;
170    lldb::addr_t                                    m_function_sp;
171    Thread::RegisterCheckpoint                      m_register_backup;
172    lldb::ThreadPlanSP                              m_subplan_sp;
173    LanguageRuntime                                *m_cxx_language_runtime;
174    LanguageRuntime                                *m_objc_language_runtime;
175    Thread::ThreadStateCheckpoint                   m_stored_thread_state;
176    lldb::StopInfoSP                                m_real_stop_info_sp; // In general we want to hide call function
177                                                                         // thread plans, but for reporting purposes,
178                                                                         // it's nice to know the real stop reason.
179                                                                         // This gets set in DoTakedown.
180    StreamString                                    m_constructor_errors;
181    ClangASTType                                    m_return_type;
182    lldb::ValueObjectSP                             m_return_valobj_sp;  // If this contains a valid pointer, use the ABI to extract values when complete
183    bool                                            m_takedown_done;    // We want to ensure we only do the takedown once.  This ensures that.
184    lldb::addr_t                                    m_stop_address;     // This is the address we stopped at.  Also set in DoTakedown;
185    bool                                            m_unwind_on_error;
186    bool                                            m_ignore_breakpoints;
187
188    DISALLOW_COPY_AND_ASSIGN (ThreadPlanCallFunction);
189};
190
191} // namespace lldb_private
192
193#endif  // liblldb_ThreadPlanCallFunction_h_
194