Skip to content

[lldb] Fix stepping into Objective-C interop ctors #10697

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: swift/release/6.2
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ enum class ThunkKind {
AllocatingInit,
PartialApply,
ObjCAttribute,
NonObjCAttributeOnCtor,
Reabstraction,
ProtocolConformance,
};
Expand All @@ -55,6 +56,7 @@ enum class ThunkAction {
StepIntoConformance,
StepIntoAllocatingInit,
StepThrough,
RunToObjcCInteropCtor,
};

} // namespace
Expand Down Expand Up @@ -313,6 +315,10 @@ static ThunkKind GetThunkKind(Symbol *symbol) {
switch (main_node->getKind()) {
case Node::Kind::ObjCAttribute:
return ThunkKind::ObjCAttribute;
case Node::Kind::NonObjCAttribute:
if (hasChild(nodes, Node::Kind::Constructor))
return ThunkKind::NonObjCAttributeOnCtor;
break;
case Node::Kind::ProtocolWitness:
if (hasChild(main_node, Node::Kind::ProtocolConformance))
return ThunkKind::ProtocolConformance;
Expand Down Expand Up @@ -342,6 +348,8 @@ static const char *GetThunkKindName(ThunkKind kind) {
return "GetThunkTarget";
case ThunkKind::ObjCAttribute:
return "GetThunkTarget";
case ThunkKind::NonObjCAttributeOnCtor:
return "RunToObjcCInteropCtor";
case ThunkKind::Reabstraction:
return "GetThunkTarget";
case ThunkKind::ProtocolConformance:
Expand All @@ -363,6 +371,8 @@ static ThunkAction GetThunkAction(ThunkKind kind) {
return ThunkAction::StepThrough;
case ThunkKind::ProtocolConformance:
return ThunkAction::StepIntoConformance;
case ThunkKind::NonObjCAttributeOnCtor:
return ThunkAction::RunToObjcCInteropCtor;
}
}

Expand Down Expand Up @@ -419,6 +429,66 @@ CreateRunThroughTaskSwitchingTrampolines(Thread &thread,
return nullptr;
}

/// Demangle `symbol_name` and extracts the text at the node described by
/// `node_path`, if it exists; otherwise, returns an empty string.
static std::string FindClassName(StringRef symbol_name,
llvm::ArrayRef<Node::Kind> node_path) {
swift::Demangle::Context ctx;
NodePointer demangled_node =
SwiftLanguageRuntime::DemangleSymbolAsNode(symbol_name, ctx);

if (!demangled_node) {
std::string symbol_name_str = symbol_name.str();
LLDB_LOGF(GetLog(LLDBLog::Step),
"SwiftLanguageRuntime: failed to demangle %s.",
symbol_name_str.c_str());
return "";
}
NodePointer class_node = childAtPath(demangled_node, node_path);

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Even if childAtPath handles null NodePointer arguments, still seem easier to follow if you checked the return here.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will do.

If we're taking this approach, it would be worth being consistent everywhere (in a separate patch) and changing childAtPath to take a reference instead, so that it no longer accepts nullptrs by definition.

While I believe the current approach leads to more succinct code, either one is fine as long as we're consistent. The only undesirable outcome is the middle ground where the callee handles nullptrs but callers are also expected to be checking. Either we trust the API to do things correctly (the API said it would when it declared itself taking a pointer), or we change the API to take a reference. APIs that accept pointers but don't handle null are bad APIs.

Copy link
Author

@felipepiovezan felipepiovezan May 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ops, I forgot to do this. Will push another patch shortly

edit: done

if (!class_node || !class_node->hasText()) {
std::string node_str = getNodeTreeAsString(demangled_node);
LLDB_LOGF(GetLog(LLDBLog::Step),
"SwiftLanguageRuntime: failed to extract name from "
"demangle node: %s",
node_str.c_str());
return "";
}
return class_node->getText().str();
}

/// If sc_list is non-empty, returns a plan that runs to any of its addresses.
/// Otherwise, returns nullptr.
static ThreadPlanSP
CreateThreadPlanRunToSCInList(Thread &thread, const SymbolContextList &sc_list,
bool stop_others) {
std::vector<addr_t> load_addresses;
Target &target = thread.GetProcess()->GetTarget();
for (const SymbolContext &sc : sc_list) {
const Symbol *ctor_symbol = sc.symbol;
if (ctor_symbol)
load_addresses.push_back(ctor_symbol->GetLoadAddress(&target));
}

if (load_addresses.empty()) {
LLDB_LOG(GetLog(LLDBLog::Step),
"SwiftLanguageRuntime: empty sc_list found.");
return {};
}
return std::make_shared<ThreadPlanRunToAddress>(thread, load_addresses,
stop_others);
}

/// Search all modules for `target_func` and creates a RunToAddress plan
/// targeting all symbols found.
static ThreadPlanSP CreateRunToAddressPlan(StringRef target_func,
Thread &thread, bool stop_others) {
ModuleList modules = thread.GetProcess()->GetTarget().GetImages();
SymbolContextList sc_list;
modules.FindFunctionSymbols(ConstString(target_func), eFunctionNameTypeFull,
sc_list);
return CreateThreadPlanRunToSCInList(thread, sc_list, stop_others);
}

static lldb::ThreadPlanSP GetStepThroughTrampolinePlan(Thread &thread,
bool stop_others) {
// Here are the trampolines we have at present.
Expand Down Expand Up @@ -475,19 +545,32 @@ static lldb::ThreadPlanSP GetStepThroughTrampolinePlan(Thread &thread,
log->Printf(
"Stepped to thunk \"%s\" (kind: %s) stepping to target: \"%s\".",
symbol_name, GetThunkKindName(thunk_kind), thunk_target.c_str());
return CreateRunToAddressPlan(thunk_target, thread, stop_others);
}
case ThunkAction::RunToObjcCInteropCtor: {
static constexpr auto class_path = {
Node::Kind::Constructor, Node::Kind::Class, Node::Kind::Identifier};
std::string class_name = FindClassName(symbol_name, class_path);
if (class_name.empty()) {
LLDB_LOGF(log,
"SwiftLanguageRuntime: could not derive class name from symbol "
"\"%s\".",
symbol_name);
return nullptr;
}
std::string ctor_name = llvm::formatv("{0} init", class_name);
LLDB_LOGF(log,
"SwiftLanguageRuntime: running to objective C constructor \"%s\" "
"from swift.",
ctor_name.c_str());

ModuleList modules = thread.GetProcess()->GetTarget().GetImages();
SymbolContextList sc_list;
modules.FindFunctionSymbols(ConstString(thunk_target),
eFunctionNameTypeFull, sc_list);
if (sc_list.GetSize() == 1 && sc_list[0].symbol) {
Symbol &thunk_symbol = *sc_list[0].symbol;
Address target_address = thunk_symbol.GetAddress();
if (target_address.IsValid())
return std::make_shared<ThreadPlanRunToAddress>(thread, target_address,
stop_others);
}
return nullptr;
ModuleFunctionSearchOptions options{/*include_symbols*/ true,
/*include_inlines*/ true};
ModuleList modules = thread.GetProcess()->GetTarget().GetImages();
modules.FindFunctions(RegularExpression(ctor_name), options, sc_list);

return CreateThreadPlanRunToSCInList(thread, sc_list, stop_others);
}
case ThunkAction::StepIntoConformance: {
// The TTW symbols encode the protocol conformance requirements
Expand Down Expand Up @@ -582,37 +665,19 @@ static lldb::ThreadPlanSP GetStepThroughTrampolinePlan(Thread &thread,
}
case ThunkAction::StepIntoAllocatingInit: {
LLDB_LOGF(log, "Stepping into allocating init: \"%s\"", symbol_name);
swift::Demangle::Context ctx;
NodePointer demangled_node =
SwiftLanguageRuntime::DemangleSymbolAsNode(symbol_name, ctx);

using Kind = Node::Kind;
NodePointer class_node = childAtPath(
demangled_node, {Kind::Allocator, Kind::Class, Kind::Identifier});
if (!class_node || !class_node->hasText()) {
std::string node_str = getNodeTreeAsString(demangled_node);
LLDB_LOGF(log,
"Failed to extract constructor name from demangle node: %s",
node_str.c_str());
static constexpr auto class_path = {Kind::Allocator, Kind::Class,
Kind::Identifier};
std::string class_name = FindClassName(symbol_name, class_path);
if (class_name.empty())
return nullptr;
}

ModuleFunctionSearchOptions options{/*include_symbols*/ true,
/*include_inlines*/ true};
std::string ctor_name = llvm::formatv("{0}.init", class_node->getText());
std::string ctor_name = llvm::formatv("{0}.init", class_name);
SymbolContextList sc_list;
sc.module_sp->FindFunctions(RegularExpression(ctor_name), options, sc_list);
std::vector<addr_t> load_addresses;
Target &target = thread.GetProcess()->GetTarget();
for (const SymbolContext &ctor_sc : sc_list) {
const Symbol *ctor_symbol = ctor_sc.symbol;
if (ctor_symbol)
load_addresses.push_back(ctor_symbol->GetLoadAddress(&target));
}
if (load_addresses.empty())
return nullptr;
return std::make_shared<ThreadPlanRunToAddress>(thread, load_addresses,
stop_others);
return CreateThreadPlanRunToSCInList(thread, sc_list, stop_others);
}
case ThunkAction::StepThrough: {
if (log)
Expand Down
11 changes: 11 additions & 0 deletions lldb/test/API/lang/swift/step_into_objc_interop_init/Foo.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
#import <Foundation/Foundation.h>

@interface Foo : NSObject

@property (nonnull) NSArray<NSString *> *values;

- (nonnull id)init;
- (nonnull id)initWithString:(nonnull NSString *)value;
- (nonnull id)initWithString:(nonnull NSString *)value andOtherString:(nonnull NSString *) otherValue;

@end
18 changes: 18 additions & 0 deletions lldb/test/API/lang/swift/step_into_objc_interop_init/Foo.m
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
#import "Foo.h"

@implementation Foo

- (id)init {
}

- (id)initWithString:(nonnull NSString *)value {
self->_values = @[value];
return self;
}

- (nonnull id)initWithString:(nonnull NSString *)value andOtherString:(nonnull NSString *) otherValue {
self->_values = @[value, otherValue];
return self;
}

@end
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
SWIFT_SOURCES := main.swift
SWIFT_BRIDGING_HEADER := bridging-header.h
OBJC_SOURCES := Foo.m
SWIFT_OBJC_INTEROP := 1

include Makefile.rules
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
import lldb
from lldbsuite.test.lldbtest import *
from lldbsuite.test.decorators import *
import lldbsuite.test.lldbutil as lldbutil


class TestSwiftObjcProtocol(TestBase):
def skip_debug_info_libraries(self):
if platform.system() == "Darwin":
lib_name = "libswiftCore.dylib"
else:
lib_name = "libswiftCore.so"

self.dbg.HandleCommand(
"settings set "
"target.process.thread.step-avoid-libraries {}".format(lib_name)
)

@skipUnlessDarwin
@swiftTest
def test(self):
self.build()
(target, process, thread, breakpoint) = lldbutil.run_to_source_breakpoint(
self, "break here", lldb.SBFileSpec("main.swift")
)

self.skip_debug_info_libraries()
# Go to the first constructor, assert we can step into it.
thread.StepInto()
self.assertEqual(thread.stop_reason, lldb.eStopReasonPlanComplete)
self.assertIn("-[Foo init]", thread.frames[0].GetFunctionName())

# Go back to "work" function
thread.StepOut()
self.assertEqual(thread.stop_reason, lldb.eStopReasonPlanComplete)
self.assertIn("work", thread.frames[0].GetFunctionName())

# Go to the next constructor call.
thread.StepOver()
self.assertEqual(thread.stop_reason, lldb.eStopReasonPlanComplete)
self.assertIn("work", thread.frames[0].GetFunctionName())

# Assert we can step into it.
thread.StepInto()
self.assertEqual(thread.stop_reason, lldb.eStopReasonPlanComplete)
self.assertIn("-[Foo initWithString:]", thread.frames[0].GetFunctionName())

# Go back to "work" function
thread.StepOut()
self.assertEqual(thread.stop_reason, lldb.eStopReasonPlanComplete)
self.assertIn("work", thread.frames[0].GetFunctionName())
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
#import "Foo.h"
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
func work() {
let noParams = Foo() // break here
let oneParam = Foo(string: "Bar")
print("done")
}

work()