diff options
Diffstat (limited to 'lldb/test/API/python_api')
| -rw-r--r-- | lldb/test/API/python_api/absolute_symbol/TestAbsoluteSymbol.py | 80 | ||||
| -rw-r--r-- | lldb/test/API/python_api/absolute_symbol/absolute.yaml | 36 |
2 files changed, 116 insertions, 0 deletions
diff --git a/lldb/test/API/python_api/absolute_symbol/TestAbsoluteSymbol.py b/lldb/test/API/python_api/absolute_symbol/TestAbsoluteSymbol.py new file mode 100644 index 0000000..f51bd2d --- /dev/null +++ b/lldb/test/API/python_api/absolute_symbol/TestAbsoluteSymbol.py @@ -0,0 +1,80 @@ +""" +Test absolute symbols in ELF files to make sure they don't create sections and +to verify that symbol values and size can still be accessed via SBSymbol APIs. +""" + +from lldbsuite.test.decorators import * +from lldbsuite.test.lldbtest import * +from lldbsuite.test import lldbutil +import os + +class TestAbsoluteSymbol(TestBase): + + @no_debug_info_test + def test_absolute_symbol(self): + ''' + Load an ELF file that contains two symbols: + - "absolute" which is a symbol with the section SHN_ABS + - "main" which is a code symbol in .text + + Index st_name st_value st_size st_info st_other st_shndx Name + ======= ---------- ------------------ ------------------ ----------------------------------- -------- -------- =========================== + [ 0] 0x00000000 0x0000000000000000 0x0000000000000000 0x00 (STB_LOCAL STT_NOTYPE ) 0x00 0 + [ 1] 0x00000001 0x0000000000001000 0x0000000000000004 0x12 (STB_GLOBAL STT_FUNC ) 0x00 1 main + [ 2] 0x00000006 0xffffffff80000000 0x0000000000000009 0x10 (STB_GLOBAL STT_NOTYPE ) 0x00 SHN_ABS absolute + + We used to create sections for symbols whose section ID was SHN_ABS + and this caused problems as the new sections could interfere with + with address resolution. Absolute symbols' values are not addresses + and should not be treated this way. + + New APIs were added to SBSymbol to allow access to the raw integer + value and size of symbols so symbols whose value was not an address + could be accessed. Prior to this commit, you could only call: + + SBAddress SBSymbol::GetStartAddress() + SBAddress SBSymbol::GetEndAddress() + + If the symbol's value was not an address, you couldn't access the + raw value because the above accessors would return invalid SBAddress + objects if the value wasn't an address. New APIs were added for this: + + uint64_t SBSymbol::GetValue() + uint64_t SBSymbol::GetSize(); + ''' + src_dir = self.getSourceDir() + yaml_path = os.path.join(src_dir, "absolute.yaml") + yaml_base, ext = os.path.splitext(yaml_path) + obj_path = self.getBuildArtifact("a.out") + self.yaml2obj(yaml_path, obj_path) + + # Create a target with the object file we just created from YAML + target = self.dbg.CreateTarget(obj_path) + self.assertTrue(target, VALID_TARGET) + + module = target.modules[0] + + # Make sure the 'main' symbol is valid and has address values. Also make + # sure we can access the raw file address and size via the new APIS. + symbol = module.FindSymbol('main') + self.assertTrue(symbol.IsValid()) + self.assertTrue(symbol.GetStartAddress().IsValid()) + self.assertTrue(symbol.GetEndAddress().IsValid()) + self.assertEqual(symbol.GetValue(), 0x1000) + self.assertEqual(symbol.GetSize(), 0x4) + + # Make sure the 'absolute' symbol is valid and has no address values. + # Also make sure we can access the raw file address and size via the new + # APIS. + symbol = module.FindSymbol('absolute') + self.assertTrue(symbol.IsValid()) + self.assertFalse(symbol.GetStartAddress().IsValid()) + self.assertFalse(symbol.GetEndAddress().IsValid()) + self.assertEqual(symbol.GetValue(), 0xffffffff80000000) + self.assertEqual(symbol.GetSize(), 9) + + # Make sure no sections were created for the absolute symbol with a + # prefix of ".absolute." followed by the symbol name as they interfere + # with address lookups if they are treated like real sections. + for section in module.sections: + self.assertTrue(section.GetName() != ".absolute.absolute") diff --git a/lldb/test/API/python_api/absolute_symbol/absolute.yaml b/lldb/test/API/python_api/absolute_symbol/absolute.yaml new file mode 100644 index 0000000..24b5c84 --- /dev/null +++ b/lldb/test/API/python_api/absolute_symbol/absolute.yaml @@ -0,0 +1,36 @@ +--- !ELF +FileHeader: + Class: ELFCLASS64 + Data: ELFDATA2LSB + OSABI: ELFOSABI_FREEBSD + Type: ET_EXEC + Machine: EM_X86_64 + Entry: 0xFFFFFFFF8037C000 +Sections: + - Name: .text + Type: SHT_PROGBITS + Flags: [ SHF_ALLOC, SHF_EXECINSTR ] + Address: 0x1000 + AddressAlign: 0x4 + Content: "c3c3c3c3" +ProgramHeaders: + - Type: PT_LOAD + Flags: [ PF_X, PF_R ] + VAddr: 0x1000 + PAddr: 0x1000 + Align: 0x4 + FirstSec: .text + LastSec: .text +Symbols: + - Name: main + Type: STT_FUNC + Section: .text + Binding: STB_GLOBAL + Value: 0x1000 + Size: 0x4 + - Name: absolute + Index: SHN_ABS + Binding: STB_GLOBAL + Value: 0xFFFFFFFF80000000 + Size: 0x9 + |