Skip to content

[lldb] Fix FindProcessImpl() for iOS simulators #139174

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

Merged
Merged
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
87 changes: 87 additions & 0 deletions lldb/packages/Python/lldbsuite/test/lldbutil.py
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@
# System modules
import errno
import io
import json
import os
import re
import sys
Expand Down Expand Up @@ -1704,3 +1705,89 @@ def packetlog_get_dylib_info(log):
expect_dylib_info_response = True

return dylib_info


# ========================
# Utilities for simulators
# ========================


def get_latest_apple_simulator(platform_name, log=None):
# Run simctl to list all simulators
cmd = ["xcrun", "simctl", "list", "-j", "devices"]
cmd_str = " ".join(cmd)
if log:
log(cmd_str)
sim_devices_str = subprocess.check_output(cmd).decode("utf-8")
sim_devices = json.loads(sim_devices_str)["devices"]

# Find an available simulator for the requested platform
device_uuid = None
device_runtime = None
for simulator in sim_devices:
if isinstance(simulator, dict):
runtime = simulator["name"]
devices = simulator["devices"]
else:
runtime = simulator
devices = sim_devices[simulator]
if not platform_name in runtime.lower():
continue
for device in devices:
if "availability" in device and device["availability"] != "(available)":
continue
if "isAvailable" in device and not device["isAvailable"]:
continue
if device_runtime and runtime < device_runtime:
continue
device_uuid = device["udid"]
device_runtime = runtime
# Stop searching in this runtime
break

return device_uuid


def launch_exe_in_apple_simulator(
device_uuid,
exe_path,
exe_args=[],
stderr_lines_to_read=0,
stderr_patterns=[],
log=None,
):
exe_path = os.path.realpath(exe_path)
cmd = [
"xcrun",
"simctl",
"spawn",
"-s",
device_uuid,
exe_path,
] + exe_args
if log:
log(" ".join(cmd))
sim_launcher = subprocess.Popen(cmd, stderr=subprocess.PIPE)

# Read stderr to try to find matches.
# Each pattern will return the value of group[1] of the first match in the stderr.
# Will read at most stderr_lines_to_read lines.
# Will early terminate when all matches have been found.
total_patterns = len(stderr_patterns)
matches_found = 0
matched_strings = [None] * total_patterns
for _ in range(0, stderr_lines_to_read):
stderr = sim_launcher.stderr.readline().decode("utf-8")
if not stderr:
continue
for i, pattern in enumerate(stderr_patterns):
if matched_strings[i] is not None:
continue
match = re.match(pattern, stderr)
if match:
matched_strings[i] = str(match.group(1))
matches_found += 1
if matches_found == total_patterns:
break

return exe_path, matched_strings
37 changes: 19 additions & 18 deletions lldb/source/Host/macosx/objcxx/Host.mm
Original file line number Diff line number Diff line change
Expand Up @@ -595,7 +595,9 @@ DataExtractor data(arg_data.GetBytes(), arg_data_size,
const llvm::Triple::ArchType triple_arch = triple.getArch();
const bool check_for_ios_simulator =
(triple_arch == llvm::Triple::x86 ||
triple_arch == llvm::Triple::x86_64);
triple_arch == llvm::Triple::x86_64 ||
triple_arch == llvm::Triple::aarch64);

const char *cstr = data.GetCStr(&offset);
if (cstr) {
process_info.GetExecutableFile().SetFile(cstr, FileSpec::Style::native);
Expand All @@ -621,21 +623,20 @@ DataExtractor data(arg_data.GetBytes(), arg_data_size,
}

Environment &proc_env = process_info.GetEnvironment();
while ((cstr = data.GetCStr(&offset))) {
if (cstr[0] == '\0')
break;

if (check_for_ios_simulator) {
if (strncmp(cstr, "SIMULATOR_UDID=", strlen("SIMULATOR_UDID=")) ==
0)
process_info.GetArchitecture().GetTriple().setOS(
llvm::Triple::IOS);
else
process_info.GetArchitecture().GetTriple().setOS(
llvm::Triple::MacOSX);
}

proc_env.insert(cstr);
bool is_simulator = false;
llvm::StringRef env_var;
while (!(env_var = data.GetCStr(&offset)).empty()) {
if (check_for_ios_simulator &&
env_var.starts_with("SIMULATOR_UDID="))
is_simulator = true;
proc_env.insert(env_var);
}
llvm::Triple &triple = process_info.GetArchitecture().GetTriple();
if (is_simulator) {
triple.setOS(llvm::Triple::IOS);
triple.setEnvironment(llvm::Triple::Simulator);
} else {
triple.setOS(llvm::Triple::MacOSX);
}
return true;
}
Expand Down Expand Up @@ -741,8 +742,8 @@ static bool GetMacOSXProcessUserAndGroup(ProcessInstanceInfo &process_info) {
!match_info.ProcessIDsMatch(process_info))
continue;

// Get CPU type first so we can know to look for iOS simulator is we have
// x86 or x86_64
// Get CPU type first so we can know to look for iOS simulator if we have
// a compatible type.
if (GetMacOSXProcessCPUType(process_info)) {
if (GetMacOSXProcessArgs(&match_info, process_info)) {
if (match_info.Matches(process_info))
Expand Down
5 changes: 4 additions & 1 deletion lldb/test/API/macosx/simulator/Makefile
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
C_SOURCES := hello.c
CFLAGS_EXTRAS := -D__STDC_LIMIT_MACROS -D__STDC_FORMAT_MACROS
ENABLE_THREADS := YES
CXX_SOURCES := hello.cpp
MAKE_DSYM := NO

include Makefile.rules
42 changes: 40 additions & 2 deletions lldb/test/API/macosx/simulator/TestSimulatorPlatform.py
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,9 @@ def check_debugserver(self, log, expected_platform, expected_version):
if expected_version:
self.assertEqual(aout_info["min_version_os_sdk"], expected_version)

def run_with(self, arch, os, vers, env, expected_load_command):
def run_with(
self, arch, os, vers, env, expected_load_command, expected_platform=None
):
env_list = [env] if env else []
triple = "-".join([arch, "apple", os + vers] + env_list)
sdk = lldbutil.get_xcode_sdk(os, env)
Expand Down Expand Up @@ -72,12 +74,47 @@ def run_with(self, arch, os, vers, env, expected_load_command):
log = self.getBuildArtifact("packets.log")
self.expect("log enable gdb-remote packets -f " + log)
lldbutil.run_to_source_breakpoint(
self, "break here", lldb.SBFileSpec("hello.c")
self, "break here", lldb.SBFileSpec("hello.cpp")
)
triple_re = "-".join([arch, "apple", os + vers + ".*"] + env_list)
self.expect("image list -b -t", patterns=[r"a\.out " + triple_re])
self.check_debugserver(log, os + env, vers)

if expected_platform is not None:
# Verify the platform name.
self.expect(
"platform status",
patterns=[r"Platform: " + expected_platform + "-simulator"],
)

# Launch exe in simulator and verify that `platform process list` can find the process.
# This separate launch is needed because the command ignores processes which are being debugged.
device_udid = lldbutil.get_latest_apple_simulator(
expected_platform, self.trace
)
_, matched_strings = lldbutil.launch_exe_in_apple_simulator(
device_udid,
self.getBuildArtifact("a.out"),
exe_args=[],
stderr_lines_to_read=1, # in hello.cpp, the pid is printed first
stderr_patterns=[r"PID: (.*)"],
log=self.trace,
)

# Make sure we found the PID.
self.assertIsNotNone(matched_strings[0])
pid = int(matched_strings[0])

# Verify that processes on the platform can be listed.
self.expect(
"platform process list",
patterns=[
r"\d+ matching processes were found on \"%s-simulator\""
% expected_platform,
r"%d .+ a.out" % pid,
],
)

@skipIfAsan
@skipUnlessDarwin
@skipIfDarwinEmbedded
Expand All @@ -90,6 +127,7 @@ def test_ios(self):
vers="",
env="simulator",
expected_load_command="LC_BUILD_VERSION",
expected_platform="ios",
)

@skipIfAsan
Expand Down
5 changes: 0 additions & 5 deletions lldb/test/API/macosx/simulator/hello.c

This file was deleted.

14 changes: 14 additions & 0 deletions lldb/test/API/macosx/simulator/hello.cpp
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
#include <stdio.h>
#include <thread>
#include <unistd.h>

static void print_pid() { fprintf(stderr, "PID: %d\n", getpid()); }

static void sleep() { std::this_thread::sleep_for(std::chrono::seconds(10)); }

int main(int argc, char **argv) {
print_pid();
puts("break here\n");
sleep();
return 0;
}
72 changes: 15 additions & 57 deletions lldb/test/API/tools/lldb-server/TestAppleSimulatorOSType.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,40 +14,12 @@ class TestAppleSimulatorOSType(gdbremote_testcase.GdbRemoteTestCaseBase):
READ_LINES = 10

def check_simulator_ostype(self, sdk, platform_name, arch=platform.machine()):
cmd = ["xcrun", "simctl", "list", "-j", "devices"]
cmd_str = " ".join(cmd)
self.trace(cmd_str)
sim_devices_str = subprocess.check_output(cmd).decode("utf-8")
# Get simulator
deviceUDID = None
try:
sim_devices = json.loads(sim_devices_str)["devices"]
deviceUDID = lldbutil.get_latest_apple_simulator(platform_name, self.trace)
except json.decoder.JSONDecodeError:
self.fail(
"Could not parse '{}' output. Authorization denied?".format(cmd_str)
)
# Find an available simulator for the requested platform
deviceUDID = None
deviceRuntime = None
for simulator in sim_devices:
if isinstance(simulator, dict):
runtime = simulator["name"]
devices = simulator["devices"]
else:
runtime = simulator
devices = sim_devices[simulator]
if not platform_name in runtime.lower():
continue
for device in devices:
if "availability" in device and device["availability"] != "(available)":
continue
if "isAvailable" in device and not device["isAvailable"]:
continue
if deviceRuntime and runtime < deviceRuntime:
continue
deviceUDID = device["udid"]
deviceRuntime = runtime
# Stop searching in this runtime
break

self.fail("Could not parse output. Authorization denied?")
if not deviceUDID:
self.skipTest(
"Could not find a simulator for {} ({})".format(platform_name, arch)
Expand Down Expand Up @@ -78,34 +50,20 @@ def check_simulator_ostype(self, sdk, platform_name, arch=platform.machine()):
},
compiler=clang,
)
exe_path = os.path.realpath(self.getBuildArtifact(exe_name))
cmd = [
"xcrun",
"simctl",
"spawn",
"-s",

# Launch the executable in the simulator
exe_path, matched_groups = lldbutil.launch_exe_in_apple_simulator(
deviceUDID,
exe_path,
"print-pid",
"sleep:10",
]
self.trace(" ".join(cmd))
sim_launcher = subprocess.Popen(cmd, stderr=subprocess.PIPE)
# Get the PID from the process output
pid = None

# Read the first READ_LINES to try to find the PID.
for _ in range(0, self.READ_LINES):
stderr = sim_launcher.stderr.readline().decode("utf-8")
if not stderr:
continue
match = re.match(r"PID: (.*)", stderr)
if match:
pid = int(match.group(1))
break
self.getBuildArtifact(exe_name),
["print-pid", "sleep:10"],
self.READ_LINES,
[r"PID: (.*)"],
self.trace,
)

# Make sure we found the PID.
self.assertIsNotNone(pid)
self.assertIsNotNone(matched_groups[0])
pid = int(matched_groups[0])

# Launch debug monitor attaching to the simulated process
server = self.connect_to_debug_monitor(attach_pid=pid)
Expand Down
Loading