llvm/lldb/test/API/functionalities/postmortem/elf-core/thread_crash/TestLinuxCoreThreads.py

"""
Test signal reporting when debugging with linux core files.
"""


import lldb
from lldbsuite.test.decorators import *
from lldbsuite.test.lldbtest import *
from lldbsuite.test import lldbutil


class LinuxCoreThreadsTestCase(TestBase):
    NO_DEBUG_INFO_TESTCASE = True

    _i386_pid = 5193
    _x86_64_pid = 5222

    # Thread id for the failing thread.
    _i386_tid = 5195
    _x86_64_tid = 5250

    @skipIf(oslist=["windows"])
    @skipIf(triple="^mips")
    def test_i386(self):
        """Test that lldb can read the process information from an i386 linux core file."""
        self.do_test("linux-i386", self._i386_pid, self._i386_tid)

    @skipIf(oslist=["windows"])
    @skipIf(triple="^mips")
    def test_x86_64(self):
        """Test that lldb can read the process information from an x86_64 linux core file."""
        self.do_test("linux-x86_64", self._x86_64_pid, self._x86_64_tid)

    @skipIf(oslist=["windows"])
    @skipIf(triple="^mips")
    def test_fs_gs_base(self):
        """Tests fs_base/gs_base registers can be read from linux coredump."""
        target = self.dbg.CreateTarget(None)
        process = target.LoadCore("linux-x86_64.core")
        self.assertTrue(process, PROCESS_IS_VALID)

        # The fs_base/gs_base registers in linux-x86_64.core are parsed by
        # using "eu-readelf -n linux-x86_64.core" to verify.
        fs_base_values = [0x00007FC295017700, 0x00007FC294FFF740, 0x00007FC29501F700]
        gs_base_values = [0, 0, 0]

        for i in range(process.GetNumThreads()):
            thread = process.GetThreadAtIndex(i)
            self.assertTrue(thread.IsValid(), "current thread is valid")

            current_frame = thread.GetFrameAtIndex(0)
            self.assertTrue(current_frame.IsValid(), "current frame is valid")

            reg_fs_base = current_frame.FindRegister("fs_base")
            reg_gs_base = current_frame.FindRegister("gs_base")
            self.assertTrue(reg_fs_base.IsValid(), "fs_base is not available")
            self.assertTrue(reg_gs_base.IsValid(), "gs_base is not available")

            self.assertEqual(
                reg_fs_base.GetValueAsSigned(-1),
                fs_base_values[i],
                f"fs_base read is different from expected",
            )

            self.assertEqual(
                reg_gs_base.GetValueAsSigned(-1),
                gs_base_values[i],
                f"gs_base read is different from expected",
            )
        self.dbg.DeleteTarget(target)

    def do_test(self, filename, pid, tid):
        target = self.dbg.CreateTarget("")
        process = target.LoadCore(filename + ".core")
        self.assertTrue(process, PROCESS_IS_VALID)
        self.assertEqual(process.GetNumThreads(), 3)
        self.assertEqual(process.GetProcessID(), pid)

        for thread in process:
            # Verify that if we try to read memory from a PT_LOAD that has
            # p_filesz of zero that we don't get bytes from the next section
            # that actually did have bytes. The addresses below were found by
            # dumping the program headers of linux-i386.core and
            # linux-x86_64.core and verifying that they had a p_filesz of zero.
            mem_err = lldb.SBError()
            if process.GetAddressByteSize() == 4:
                bytes_read = process.ReadMemory(0x8048000, 4, mem_err)
            else:
                bytes_read = process.ReadMemory(0x400000, 4, mem_err)
            self.assertEqual(bytes_read, None)
            reason = thread.GetStopReason()
            if thread.GetThreadID() == tid:
                self.assertStopReason(reason, lldb.eStopReasonSignal)
                signal = thread.GetStopReasonDataAtIndex(1)
                # Check we got signal 4 (SIGILL)
                self.assertEqual(signal, 4)
            else:
                signal = thread.GetStopReasonDataAtIndex(1)
                # Check we got no signal on the other threads
                self.assertEqual(signal, 0)

        self.dbg.DeleteTarget(target)