1//===-- AppleObjCRuntime.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_SOURCE_PLUGINS_LANGUAGERUNTIME_OBJC_APPLEOBJCRUNTIME_APPLEOBJCRUNTIME_H
10#define LLDB_SOURCE_PLUGINS_LANGUAGERUNTIME_OBJC_APPLEOBJCRUNTIME_APPLEOBJCRUNTIME_H
11
12
13#include "AppleObjCTrampolineHandler.h"
14#include "AppleThreadPlanStepThroughObjCTrampoline.h"
15#include "lldb/Target/LanguageRuntime.h"
16#include "lldb/lldb-private.h"
17
18#include "Plugins/LanguageRuntime/ObjC/ObjCLanguageRuntime.h"
19#include <optional>
20
21namespace lldb_private {
22
23class AppleObjCRuntime : public lldb_private::ObjCLanguageRuntime {
24public:
25 ~AppleObjCRuntime() override;
26
27 // Static Functions
28 // Note there is no CreateInstance, Initialize & Terminate functions here,
29 // because
30 // you can't make an instance of this generic runtime.
31
32 static char ID;
33
34 static void Initialize();
35
36 static void Terminate();
37
38 bool isA(const void *ClassID) const override {
39 return ClassID == &ID || ObjCLanguageRuntime::isA(ClassID);
40 }
41
42 static bool classof(const LanguageRuntime *runtime) {
43 return runtime->isA(ClassID: &ID);
44 }
45
46 // These are generic runtime functions:
47 bool GetObjectDescription(Stream &str, Value &value,
48 ExecutionContextScope *exe_scope) override;
49
50 bool GetObjectDescription(Stream &str, ValueObject &object) override;
51
52 bool CouldHaveDynamicValue(ValueObject &in_value) override;
53
54 bool GetDynamicTypeAndAddress(ValueObject &in_value,
55 lldb::DynamicValueType use_dynamic,
56 TypeAndOrName &class_type_or_name,
57 Address &address,
58 Value::ValueType &value_type) override;
59
60 TypeAndOrName FixUpDynamicType(const TypeAndOrName &type_and_or_name,
61 ValueObject &static_value) override;
62
63 // These are the ObjC specific functions.
64
65 bool IsModuleObjCLibrary(const lldb::ModuleSP &module_sp) override;
66
67 bool ReadObjCLibrary(const lldb::ModuleSP &module_sp) override;
68
69 bool HasReadObjCLibrary() override { return m_read_objc_library; }
70
71 lldb::ThreadPlanSP GetStepThroughTrampolinePlan(Thread &thread,
72 bool stop_others) override;
73
74 // Get the "libobjc.A.dylib" module from the current target if we can find
75 // it, also cache it once it is found to ensure quick lookups.
76 lldb::ModuleSP GetObjCModule();
77
78 // Sync up with the target
79
80 void ModulesDidLoad(const ModuleList &module_list) override;
81
82 void SetExceptionBreakpoints() override;
83
84 void ClearExceptionBreakpoints() override;
85
86 bool ExceptionBreakpointsAreSet() override;
87
88 bool ExceptionBreakpointsExplainStop(lldb::StopInfoSP stop_reason) override;
89
90 lldb::SearchFilterSP CreateExceptionSearchFilter() override;
91
92 static std::tuple<FileSpec, ConstString> GetExceptionThrowLocation();
93
94 lldb::ValueObjectSP GetExceptionObjectForThread(
95 lldb::ThreadSP thread_sp) override;
96
97 lldb::ThreadSP GetBacktraceThreadFromException(
98 lldb::ValueObjectSP thread_sp) override;
99
100 uint32_t GetFoundationVersion();
101
102 virtual void GetValuesForGlobalCFBooleans(lldb::addr_t &cf_true,
103 lldb::addr_t &cf_false);
104
105 virtual bool IsTaggedPointer (lldb::addr_t addr) { return false; }
106
107protected:
108 // Call CreateInstance instead.
109 AppleObjCRuntime(Process *process);
110
111 bool CalculateHasNewLiteralsAndIndexing() override;
112
113 static bool AppleIsModuleObjCLibrary(const lldb::ModuleSP &module_sp);
114
115 static ObjCRuntimeVersions GetObjCVersion(Process *process,
116 lldb::ModuleSP &objc_module_sp);
117
118 void ReadObjCLibraryIfNeeded(const ModuleList &module_list);
119
120 Address *GetPrintForDebuggerAddr();
121
122 std::unique_ptr<Address> m_PrintForDebugger_addr;
123 bool m_read_objc_library;
124 std::unique_ptr<lldb_private::AppleObjCTrampolineHandler>
125 m_objc_trampoline_handler_up;
126 lldb::BreakpointSP m_objc_exception_bp_sp;
127 lldb::ModuleWP m_objc_module_wp;
128 std::unique_ptr<FunctionCaller> m_print_object_caller_up;
129
130 std::optional<uint32_t> m_Foundation_major;
131};
132
133} // namespace lldb_private
134
135#endif // LLDB_SOURCE_PLUGINS_LANGUAGERUNTIME_OBJC_APPLEOBJCRUNTIME_APPLEOBJCRUNTIME_H
136

source code of lldb/source/Plugins/LanguageRuntime/ObjC/AppleObjCRuntime/AppleObjCRuntime.h