| """ |
| 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.stop_description |
| 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) |
