Jonas Devlieghere
59d60d0960
On WebAssembly clang only wires a 0- or 2-argument main to the program entry point: EmitMainVoidAlias emits the __main_void alias for a no-argument main, and the 2-argument form is mangled to __main_argc_argv. A 3-argument main(argc, argv, envp) matches neither, so main is never connected to the entry point and is left as an undefined-weak stub whose body is `unreachable`. The affected inferiors trap with "Exception: unreachable" before reaching main (even when run outside the debugger) so any test using them fails on wasm. Drop the unused third parameter, and where the environment is actually iterated read it from `environ` instead. The inferiors now run on WebAssembly and behave identically on other platforms.
265 lines
9.9 KiB
Python
265 lines
9.9 KiB
Python
"""
|
|
Test that the Python operating system plugin works correctly
|
|
"""
|
|
|
|
|
|
import os
|
|
import lldb
|
|
from lldbsuite.test.decorators import *
|
|
from lldbsuite.test.lldbtest import *
|
|
import lldbsuite.test.lldbutil as lldbutil
|
|
|
|
|
|
class PluginPythonOSPlugin(TestBase):
|
|
NO_DEBUG_INFO_TESTCASE = True
|
|
|
|
def test_python_os_plugin(self):
|
|
"""Test that the Python operating system plugin works correctly"""
|
|
self.build()
|
|
self.run_python_os_funcionality()
|
|
|
|
@skipIfWindows # This is flaky on Windows
|
|
def test_run_python_os_step(self):
|
|
"""Test that the Python operating system plugin works correctly when single stepping a virtual thread"""
|
|
self.build()
|
|
self.run_python_os_step()
|
|
|
|
def verify_os_thread_registers(self, thread):
|
|
frame = thread.GetFrameAtIndex(0)
|
|
registers = frame.GetRegisters().GetValueAtIndex(0)
|
|
reg_value = thread.GetThreadID() + 1
|
|
for reg in registers:
|
|
self.assertEqual(
|
|
reg.GetValueAsUnsigned(),
|
|
reg_value,
|
|
"Verify the registers contains the correct value",
|
|
)
|
|
reg_value = reg_value + 1
|
|
|
|
def run_python_os_funcionality(self):
|
|
"""Test that the Python operating system plugin works correctly"""
|
|
|
|
# Set debugger into synchronous mode
|
|
self.dbg.SetAsync(False)
|
|
|
|
# Create a target by the debugger.
|
|
exe = self.getBuildArtifact("a.out")
|
|
python_os_plugin_path = os.path.join(self.getSourceDir(), "operating_system.py")
|
|
target = self.dbg.CreateTarget(exe)
|
|
self.assertTrue(target, VALID_TARGET)
|
|
|
|
# Set breakpoints inside and outside methods that take pointers to the
|
|
# containing struct.
|
|
lldbutil.run_break_set_by_source_regexp(self, "// Set breakpoint here")
|
|
|
|
# Register our shared libraries for remote targets so they get
|
|
# automatically uploaded
|
|
arguments = None
|
|
environment = None
|
|
|
|
# Now launch the process, and do not stop at entry point.
|
|
process = target.LaunchSimple(
|
|
arguments, environment, self.get_process_working_directory()
|
|
)
|
|
self.assertTrue(process, PROCESS_IS_VALID)
|
|
|
|
# Make sure there are no OS plug-in created thread when we first stop
|
|
# at our breakpoint in main
|
|
thread = process.GetThreadByID(0x111111111)
|
|
self.assertFalse(
|
|
thread.IsValid(),
|
|
"Make sure there is no thread 0x111111111 before we load the python OS plug-in",
|
|
)
|
|
thread = process.GetThreadByID(0x222222222)
|
|
self.assertFalse(
|
|
thread.IsValid(),
|
|
"Make sure there is no thread 0x222222222 before we load the python OS plug-in",
|
|
)
|
|
thread = process.GetThreadByID(0x333333333)
|
|
self.assertFalse(
|
|
thread.IsValid(),
|
|
"Make sure there is no thread 0x333333333 before we load the python OS plug-in",
|
|
)
|
|
|
|
# Now load the python OS plug-in which should update the thread list and we should have
|
|
# OS plug-in created threads with the IDs: 0x111111111, 0x222222222,
|
|
# 0x333333333
|
|
command = (
|
|
"settings set target.process.python-os-plugin-path '%s'"
|
|
% python_os_plugin_path
|
|
)
|
|
self.dbg.HandleCommand(command)
|
|
|
|
# Verify our OS plug-in threads showed up
|
|
thread = process.GetThreadByID(0x111111111)
|
|
self.assertTrue(
|
|
thread.IsValid(),
|
|
"Make sure there is a thread 0x111111111 after we load the python OS plug-in",
|
|
)
|
|
self.verify_os_thread_registers(thread)
|
|
thread = process.GetThreadByID(0x222222222)
|
|
self.assertTrue(
|
|
thread.IsValid(),
|
|
"Make sure there is a thread 0x222222222 after we load the python OS plug-in",
|
|
)
|
|
self.verify_os_thread_registers(thread)
|
|
thread = process.GetThreadByID(0x333333333)
|
|
self.assertTrue(
|
|
thread.IsValid(),
|
|
"Make sure there is a thread 0x333333333 after we load the python OS plug-in",
|
|
)
|
|
self.verify_os_thread_registers(thread)
|
|
|
|
# Now clear the OS plug-in path to make the OS plug-in created threads
|
|
# disappear
|
|
self.dbg.HandleCommand("settings clear target.process.python-os-plugin-path")
|
|
|
|
# Verify the threads are gone after unloading the python OS plug-in
|
|
thread = process.GetThreadByID(0x111111111)
|
|
self.assertFalse(
|
|
thread.IsValid(),
|
|
"Make sure there is no thread 0x111111111 after we unload the python OS plug-in",
|
|
)
|
|
thread = process.GetThreadByID(0x222222222)
|
|
self.assertFalse(
|
|
thread.IsValid(),
|
|
"Make sure there is no thread 0x222222222 after we unload the python OS plug-in",
|
|
)
|
|
thread = process.GetThreadByID(0x333333333)
|
|
self.assertFalse(
|
|
thread.IsValid(),
|
|
"Make sure there is no thread 0x333333333 after we unload the python OS plug-in",
|
|
)
|
|
|
|
tid_regex = re.compile(r"tid = ((0x)?[0-9a-fA-F]+)")
|
|
|
|
def get_tid_from_thread_info_command(self, thread, use_backing_thread):
|
|
interp = self.dbg.GetCommandInterpreter()
|
|
result = lldb.SBCommandReturnObject()
|
|
|
|
backing_thread_arg = ""
|
|
if use_backing_thread:
|
|
backing_thread_arg = "--backing-thread"
|
|
|
|
interp.HandleCommand(
|
|
"thread info {0} {1}".format(thread.GetIndexID(), backing_thread_arg),
|
|
result,
|
|
True,
|
|
)
|
|
self.assertTrue(result.Succeeded(), "failed to run thread info")
|
|
match = self.tid_regex.search(result.GetOutput())
|
|
self.assertNotEqual(match, None)
|
|
return int(match.group(1), 0)
|
|
|
|
def run_python_os_step(self):
|
|
"""Test that the Python operating system plugin works correctly and allows single stepping of a virtual thread that is backed by a real thread"""
|
|
|
|
# Set debugger into synchronous mode
|
|
self.dbg.SetAsync(False)
|
|
|
|
# Create a target by the debugger.
|
|
exe = self.getBuildArtifact("a.out")
|
|
python_os_plugin_path = os.path.join(
|
|
self.getSourceDir(), "operating_system2.py"
|
|
)
|
|
target = self.dbg.CreateTarget(exe)
|
|
self.assertTrue(target, VALID_TARGET)
|
|
|
|
# Set breakpoints inside and outside methods that take pointers to the
|
|
# containing struct.
|
|
lldbutil.run_break_set_by_source_regexp(self, "// Set breakpoint here")
|
|
stop_line = line_number("main.c", "// Set breakpoint here")
|
|
|
|
# Register our shared libraries for remote targets so they get
|
|
# automatically uploaded
|
|
arguments = None
|
|
environment = None
|
|
|
|
# Now launch the process, and do not stop at entry point.
|
|
process = target.LaunchSimple(
|
|
arguments, environment, self.get_process_working_directory()
|
|
)
|
|
self.assertTrue(process, PROCESS_IS_VALID)
|
|
|
|
core_thread_zero = process.GetThreadAtIndex(0)
|
|
|
|
# Make sure there are no OS plug-in created thread when we first stop
|
|
# at our breakpoint in main
|
|
thread = process.GetThreadByID(0x111111111)
|
|
self.assertFalse(
|
|
thread.IsValid(),
|
|
"Make sure there is no thread 0x111111111 before we load the python OS plug-in",
|
|
)
|
|
|
|
# Now load the python OS plug-in which should update the thread list and we should have
|
|
# OS plug-in created threads with the IDs: 0x111111111, 0x222222222,
|
|
# 0x333333333
|
|
command = (
|
|
"settings set target.process.python-os-plugin-path '%s'"
|
|
% python_os_plugin_path
|
|
)
|
|
self.dbg.HandleCommand(command)
|
|
|
|
# Verify our OS plug-in threads showed up
|
|
thread = process.GetThreadByID(0x111111111)
|
|
self.assertTrue(
|
|
thread.IsValid(),
|
|
"Make sure there is a thread 0x111111111 after we load the python OS plug-in",
|
|
)
|
|
# This OS plugin does not set thread names / queue names, so it should
|
|
# inherit the core thread's name.
|
|
self.assertEqual(core_thread_zero.GetName(), thread.GetName())
|
|
self.assertEqual(core_thread_zero.GetQueueName(), thread.GetQueueName())
|
|
|
|
frame = thread.GetFrameAtIndex(0)
|
|
self.assertTrue(
|
|
frame.IsValid(), "Make sure we get a frame from thread 0x111111111"
|
|
)
|
|
line_entry = frame.GetLineEntry()
|
|
|
|
self.assertEqual(
|
|
line_entry.GetFileSpec().GetFilename(),
|
|
"main.c",
|
|
"Make sure we stopped on the breakpoint line in main.c",
|
|
)
|
|
self.assertEqual(
|
|
line_entry.GetLine(),
|
|
stop_line,
|
|
"Make sure we stopped on the breakpoint line in main.c",
|
|
)
|
|
|
|
# Now single step thread 0x111111111 and make sure it does what we need
|
|
# it to
|
|
thread.StepOver()
|
|
|
|
tid_os = self.get_tid_from_thread_info_command(thread, False)
|
|
self.assertEqual(tid_os, 0x111111111)
|
|
tid_real = self.get_tid_from_thread_info_command(thread, True)
|
|
self.assertNotEqual(tid_os, tid_real)
|
|
|
|
frame = thread.GetFrameAtIndex(0)
|
|
self.assertTrue(
|
|
frame.IsValid(), "Make sure we get a frame from thread 0x111111111"
|
|
)
|
|
line_entry = frame.GetLineEntry()
|
|
|
|
self.assertEqual(
|
|
line_entry.GetFileSpec().GetFilename(),
|
|
"main.c",
|
|
"Make sure we stepped to the next line in main.c",
|
|
)
|
|
self.assertEqual(
|
|
line_entry.GetLine(),
|
|
stop_line + 1,
|
|
"Make sure we stepped to the next line in main.c",
|
|
)
|
|
|
|
thread_bp_number = lldbutil.run_break_set_by_source_regexp(
|
|
self, "Set tid-specific breakpoint here", num_expected_locations=1
|
|
)
|
|
breakpoint = target.FindBreakpointByID(thread_bp_number)
|
|
# This breakpoint should not be hit.
|
|
breakpoint.SetThreadID(123)
|
|
process.Continue()
|
|
self.assertState(process.GetState(), lldb.eStateExited)
|