"""
Test basics of mini dump debugging.
"""
import lldb
from lldbsuite.test.decorators import *
from lldbsuite.test.lldbtest import *
from lldbsuite.test import lldbutil
class MiniDumpTestCase(TestBase):
NO_DEBUG_INFO_TESTCASE = True
def test_process_info_in_mini_dump(self):
"""Test that lldb can read the process information from the minidump."""
# target create -c fizzbuzz_no_heap.dmp
self.dbg.CreateTarget("")
self.target = self.dbg.GetSelectedTarget()
self.process = self.target.LoadCore("fizzbuzz_no_heap.dmp")
self.assertTrue(self.process, PROCESS_IS_VALID)
self.assertEqual(self.process.GetNumThreads(), 1)
self.assertEqual(self.process.GetProcessID(), 4440)
def test_thread_info_in_mini_dump(self):
"""Test that lldb can read the thread information from the minidump."""
# target create -c fizzbuzz_no_heap.dmp
self.dbg.CreateTarget("")
self.target = self.dbg.GetSelectedTarget()
self.process = self.target.LoadCore("fizzbuzz_no_heap.dmp")
# This process crashed due to an access violation (0xc0000005) in its
# one and only thread.
self.assertEqual(self.process.GetNumThreads(), 1)
thread = self.process.GetThreadAtIndex(0)
self.assertStopReason(thread.GetStopReason(), lldb.eStopReasonException)
stop_description = thread.GetStopDescription(256)
self.assertIn("0xc0000005", stop_description)
def test_modules_in_mini_dump(self):
"""Test that lldb can read the list of modules from the minidump."""
# target create -c fizzbuzz_no_heap.dmp
self.dbg.CreateTarget("")
self.target = self.dbg.GetSelectedTarget()
self.process = self.target.LoadCore("fizzbuzz_no_heap.dmp")
self.assertTrue(self.process, PROCESS_IS_VALID)
expected_modules = [
{
"filename": r"C:\Users\amccarth\Documents\Visual Studio 2013\Projects\fizzbuzz\Debug\fizzbuzz.exe",
"uuid": "0F45B791-9A96-46F9-BF8F-2D6076EA421A-00000011",
},
{
"filename": r"C:\Windows\SysWOW64\ntdll.dll",
"uuid": "BBB0846A-402C-4052-A16B-67650BBFE6B0-00000002",
},
{
"filename": r"C:\Windows\SysWOW64\kernel32.dll",
"uuid": "E5CB7E1B-005E-4113-AB98-98D6913B52D8-00000002",
},
{
"filename": r"C:\Windows\SysWOW64\KERNELBASE.dll",
"uuid": "0BF95241-CB0D-4BD4-AC5D-186A6452E522-00000001",
},
{
"filename": r"C:\Windows\System32\MSVCP120D.dll",
"uuid": "3C05516E-57E7-40EB-8D3F-9722C5BD80DD-00000001",
},
{
"filename": r"C:\Windows\System32\MSVCR120D.dll",
"uuid": "6382FB86-46C4-4046-AE42-8D97B3F91FF2-00000001",
},
]
self.assertEqual(self.target.GetNumModules(), len(expected_modules))
for module, expected in zip(self.target.modules, expected_modules):
self.assertTrue(module.IsValid())
self.assertEqual(module.file.fullpath, expected["filename"])
self.assertEqual(module.GetUUIDString(), expected["uuid"])
def test_breakpad_uuid_matching(self):
"""Test that the uuid computation algorithms in minidump and breakpad
files match."""
self.target = self.dbg.CreateTarget("")
self.process = self.target.LoadCore("fizzbuzz_no_heap.dmp")
self.assertTrue(self.process, PROCESS_IS_VALID)
self.expect(
"target symbols add fizzbuzz.syms",
substrs=[
"symbol file",
"fizzbuzz.syms",
"has been added to",
"fizzbuzz.exe",
],
),
self.assertTrue(self.target.modules[0].FindSymbol("main"))
@skipIfLLVMTargetMissing("X86")
def test_stack_info_in_mini_dump(self):
"""Test that we can see a trivial stack in a VS-generate mini dump."""
# target create -c fizzbuzz_no_heap.dmp
self.dbg.CreateTarget("")
self.target = self.dbg.GetSelectedTarget()
self.process = self.target.LoadCore("fizzbuzz_no_heap.dmp")
self.assertEqual(self.process.GetNumThreads(), 1)
thread = self.process.GetThreadAtIndex(0)
pc_list = [
0x00164D14,
0x00167C79,
0x00167E6D,
0x7510336A,
0x77759882,
0x77759855,
]
self.assertEqual(thread.GetNumFrames(), len(pc_list))
for i in range(len(pc_list)):
frame = thread.GetFrameAtIndex(i)
self.assertTrue(frame.IsValid())
self.assertEqual(frame.GetPC(), pc_list[i])
self.assertTrue(frame.GetModule().IsValid())
@skipUnlessWindows # Minidump saving works only on windows
def test_deeper_stack_in_mini_dump(self):
"""Test that we can examine a more interesting stack in a mini dump."""
self.build()
exe = self.getBuildArtifact("a.out")
core = self.getBuildArtifact("core.dmp")
try:
# Set a breakpoint and capture a mini dump.
target = self.dbg.CreateTarget(exe)
breakpoint = target.BreakpointCreateByName("bar")
process = target.LaunchSimple(
None, None, self.get_process_working_directory()
)
self.assertState(process.GetState(), lldb.eStateStopped)
self.assertTrue(process.SaveCore(core))
self.assertTrue(os.path.isfile(core))
self.assertSuccess(process.Kill())
# Launch with the mini dump, and inspect the stack.
target = self.dbg.CreateTarget(None)
process = target.LoadCore(core)
thread = process.GetThreadAtIndex(0)
expected_stack = {0: "bar", 1: "foo", 2: "main"}
self.assertGreaterEqual(thread.GetNumFrames(), len(expected_stack))
for index, name in expected_stack.items():
frame = thread.GetFrameAtIndex(index)
self.assertTrue(frame.IsValid())
function_name = frame.GetFunctionName()
self.assertIn(name, function_name)
finally:
# Clean up the mini dump file.
self.assertTrue(self.dbg.DeleteTarget(target))
if os.path.isfile(core):
os.unlink(core)
@skipUnlessWindows # Minidump saving works only on windows
def test_local_variables_in_mini_dump(self):
"""Test that we can examine local variables in a mini dump."""
self.build()
exe = self.getBuildArtifact("a.out")
core = self.getBuildArtifact("core.dmp")
try:
# Set a breakpoint and capture a mini dump.
target = self.dbg.CreateTarget(exe)
breakpoint = target.BreakpointCreateByName("bar")
process = target.LaunchSimple(
None, None, self.get_process_working_directory()
)
self.assertState(process.GetState(), lldb.eStateStopped)
self.assertTrue(process.SaveCore(core))
self.assertTrue(os.path.isfile(core))
self.assertSuccess(process.Kill())
# Launch with the mini dump, and inspect a local variable.
target = self.dbg.CreateTarget(None)
process = target.LoadCore(core)
thread = process.GetThreadAtIndex(0)
frame = thread.GetFrameAtIndex(0)
value = frame.EvaluateExpression("x")
self.assertEqual(value.GetValueAsSigned(), 3)
finally:
# Clean up the mini dump file.
self.assertTrue(self.dbg.DeleteTarget(target))
if os.path.isfile(core):
os.unlink(core)
Codebase Browser
llvm