This is an archive of the discontinued LLVM Phabricator instance.

Differential D55356

Add a method to get the "base" file address of an object file
AbandonedPublic

Authored by labath on Dec 6 2018, 1:32 AM.

Details

Reviewers
clayborg
zturner
lemo
• espindola
amccarth
Summary

Object files generally have a "base" address, which is their preferred
address to be loaded into memory (in the sense that if they are loaded
at this address, then no runtime relocation is required). This is often
the lowest address corresponding to that object file, and various other
addresses are expressed relative to this base (relative virtual
addresses (RVAs) in PE/COFF parlor).

All three of our main object file formats already had such a concept
(it's usually needed to implement SetLoadAddress), but it was not
exposed in any way. The motivation for making this public is that the
symbol address in the breakpad format are written relative to this
address.

Diff Detail

Event Timeline

labath created this revision.Dec 6 2018, 1:32 AM
Herald added a reviewer: • espindola. · View Herald TranscriptDec 6 2018, 1:32 AM
Herald added subscribers: arichardson, emaste. · View Herald Transcript
Harbormaster completed remote builds in B25756: Diff 176937.Dec 6 2018, 1:32 AM
amccarth accepted this revision.Dec 6 2018, 11:04 AM
amccarth added a subscriber: amccarth.

LGTM.

lit/Modules/MachO/basic-info.yaml
10

Just so I understand, this 0x10000000 is supposed to correspond to the vmaddr of the TEXT section, right? There are a few other vmaddrs and addrs in the YAML that correspond to other addresses.

This revision is now accepted and ready to land.Dec 6 2018, 11:04 AM
clayborg requested changes to this revision.Dec 6 2018, 12:09 PM

This is already available with:

virtual lldb_private::Address ObjectFile::GetHeaderAddress();

It return a lldb_private::Address which is section offset, but nothing stopping us from returning a lldb_private::Address with no section and just the file address. For mach-o the mach header is in the __TEXT segment, but not true for other file formats. I am ok if we need to rename "GetHeaderAddress()" to something else.

This revision now requires changes to proceed.Dec 6 2018, 12:09 PM
clayborg added a comment.Dec 6 2018, 12:11 PM

Marked as requesting changes in case "GetBaseFileAddress() == GetHeaderAddress().GetFileAddress()" in all cases. If the base file address differs from where the object file header is located, then this change would work. Else we should use GetHeaderAddress() and possibly rename it if we want to

lemo added inline comments.Dec 6 2018, 2:10 PM
include/lldb/Symbol/ObjectFile.h
569

"file address" can mean an offset within a container file.

to avoid any confusion I'd use "base address" (or "image base address")

clayborg added inline comments.Dec 6 2018, 2:12 PM
include/lldb/Symbol/ObjectFile.h
569

"file address" is the correct LLDB term so I would leave this as is. File addresses in LLDB are addresses as they are represented within the object file itself. Load addresses at unique and map to a single address in a live process where shared libraries are slid around. So "file address" is the correct LLDB term.

labath planned changes to this revision.Dec 7 2018, 3:26 AM
In D55356#1321863, @clayborg wrote:

This is already available with:

virtual lldb_private::Address ObjectFile::GetHeaderAddress();

It return a lldb_private::Address which is section offset, but nothing stopping us from returning a lldb_private::Address with no section and just the file address. For mach-o the mach header is in the __TEXT segment, but not true for other file formats. I am ok if we need to rename "GetHeaderAddress()" to something else.

Thanks for pointing that out. I was very surprised that this functionality is not available already. It looks like all/most uses of GetHeaderAddress don't really care that there is a header located at that address, but are rather interested in it's property of being a base address for various calculations (the same thing that I am). So I've created D55422 to rename it to something more appropriate.

labath updated this revision to Diff 177717.Dec 11 2018, 8:10 AM

Rebase after comitting D55422. Now this patch just implements GetBaseAddress for
ELF and PECOFF object files, and adds tests.

Harbormaster completed remote builds in B25927: Diff 177717.Dec 11 2018, 8:10 AM
labath added a comment.Dec 11 2018, 8:43 AM

Actually, this now causes an lldb-mi test to fail, but it's not clear to me if the problem is in the test, or this patch. This issue happens when lldb-mi is printing the "library loaded" message after a module gets added to a not-yet-running target. It tries to print the load address by first getting the base address and then converting that to a load address.

Before this patch, that would always fail, because well.. ELF and PECOFF had this function unimplemented, and for MachO the base address was section-relative, and so it wasn't resolved to a load address without the section being loaded. However, with this patch, in the ELF (and presumably PECOFF) case, the load address is not section-relative and so the GetLoadAddress function happily returns the address.

Is this the expected behavior here? (i.e., object_file->GetLoadAddress().GetLoadAddress(target) returning a valid value even though the target is not running)

clayborg added a comment.Dec 11 2018, 9:42 AM
In D55356#1327099, @labath wrote:

Actually, this now causes an lldb-mi test to fail, but it's not clear to me if the problem is in the test, or this patch. This issue happens when lldb-mi is printing the "library loaded" message after a module gets added to a not-yet-running target. It tries to print the load address by first getting the base address and then converting that to a load address.

Before this patch, that would always fail, because well.. ELF and PECOFF had this function unimplemented, and for MachO the base address was section-relative, and so it wasn't resolved to a load address without the section being loaded. However, with this patch, in the ELF (and presumably PECOFF) case, the load address is not section-relative and so the GetLoadAddress function happily returns the address.

Is this the expected behavior here? (i.e., object_file->GetLoadAddress().GetLoadAddress(target) returning a valid value even though the target is not running)

Not unless someone has manually set the section load address in the test?

clayborg added a comment.Dec 11 2018, 9:53 AM
In D55356#1327224, @clayborg wrote:
In D55356#1327099, @labath wrote:

Actually, this now causes an lldb-mi test to fail, but it's not clear to me if the problem is in the test, or this patch. This issue happens when lldb-mi is printing the "library loaded" message after a module gets added to a not-yet-running target. It tries to print the load address by first getting the base address and then converting that to a load address.

Before this patch, that would always fail, because well.. ELF and PECOFF had this function unimplemented, and for MachO the base address was section-relative, and so it wasn't resolved to a load address without the section being loaded. However, with this patch, in the ELF (and presumably PECOFF) case, the load address is not section-relative and so the GetLoadAddress function happily returns the address.

Is this the expected behavior here? (i.e., object_file->GetLoadAddress().GetLoadAddress(target) returning a valid value even though the target is not running)

Not unless someone has manually set the section load address in the test?

But even if the test is setting the section load address, this won't work for anything else other than Darwin, so the test would need to be fixed,

labath added a comment.Dec 11 2018, 9:57 AM
In D55356#1327224, @clayborg wrote:
In D55356#1327099, @labath wrote:

Actually, this now causes an lldb-mi test to fail, but it's not clear to me if the problem is in the test, or this patch. This issue happens when lldb-mi is printing the "library loaded" message after a module gets added to a not-yet-running target. It tries to print the load address by first getting the base address and then converting that to a load address.

Before this patch, that would always fail, because well.. ELF and PECOFF had this function unimplemented, and for MachO the base address was section-relative, and so it wasn't resolved to a load address without the section being loaded. However, with this patch, in the ELF (and presumably PECOFF) case, the load address is not section-relative and so the GetLoadAddress function happily returns the address.

Is this the expected behavior here? (i.e., object_file->GetLoadAddress().GetLoadAddress(target) returning a valid value even though the target is not running)

Not unless someone has manually set the section load address in the test?

The test is not setting the load address manually. This simply falls out of how Address::GetLoadAddress is implemented:

addr_t Address::GetLoadAddress(Target *target) const {
  SectionSP section_sp(GetSection());
  if (section_sp) {
    ...
  } else {
    // We don't have a section so the offset is the load address
    return m_offset;
  }
}

So, where's the bug here? It's not clear to me how to change Address::GetLoadAddress to do something different than what it is doing now.

clayborg added a comment.Dec 11 2018, 10:53 AM
In D55356#1327242, @labath wrote:
In D55356#1327224, @clayborg wrote:
In D55356#1327099, @labath wrote:

Actually, this now causes an lldb-mi test to fail, but it's not clear to me if the problem is in the test, or this patch. This issue happens when lldb-mi is printing the "library loaded" message after a module gets added to a not-yet-running target. It tries to print the load address by first getting the base address and then converting that to a load address.

Before this patch, that would always fail, because well.. ELF and PECOFF had this function unimplemented, and for MachO the base address was section-relative, and so it wasn't resolved to a load address without the section being loaded. However, with this patch, in the ELF (and presumably PECOFF) case, the load address is not section-relative and so the GetLoadAddress function happily returns the address.

Is this the expected behavior here? (i.e., object_file->GetLoadAddress().GetLoadAddress(target) returning a valid value even though the target is not running)

Not unless someone has manually set the section load address in the test?

The test is not setting the load address manually. This simply falls out of how Address::GetLoadAddress is implemented:

addr_t Address::GetLoadAddress(Target *target) const {
  SectionSP section_sp(GetSection());
  if (section_sp) {
    ...
  } else {
    // We don't have a section so the offset is the load address
    return m_offset;
  }
}

So, where's the bug here? It's not clear to me how to change Address::GetLoadAddress to do something different than what it is doing now.

So this is a bug really. When there is no section, we should specify what the m_offset is using lldb_private::AddressType in maybe a new ivar name "m_offset_type". Then GetBaseAddress() would specify eAddressTypeFile. And the above code would become:

addr_t Address::GetLoadAddress(Target *target) const {
  SectionSP section_sp(GetSection());
  if (section_sp) {
    ...
  } else if (m_offset_type == eAddressTypeLoad) {
    // We don't have a section so the offset is the load address
    return m_offset;
  }
}

We just need to be careful and see if we can not make lldb_private::Address get any bigger byte size wise if we can at all avoid it.

jingham added a subscriber: jingham.Dec 11 2018, 11:10 AM
In D55356#1327280, @clayborg wrote:
In D55356#1327242, @labath wrote:
In D55356#1327224, @clayborg wrote:
In D55356#1327099, @labath wrote:

Actually, this now causes an lldb-mi test to fail, but it's not clear to me if the problem is in the test, or this patch. This issue happens when lldb-mi is printing the "library loaded" message after a module gets added to a not-yet-running target. It tries to print the load address by first getting the base address and then converting that to a load address.

Before this patch, that would always fail, because well.. ELF and PECOFF had this function unimplemented, and for MachO the base address was section-relative, and so it wasn't resolved to a load address without the section being loaded. However, with this patch, in the ELF (and presumably PECOFF) case, the load address is not section-relative and so the GetLoadAddress function happily returns the address.

Is this the expected behavior here? (i.e., object_file->GetLoadAddress().GetLoadAddress(target) returning a valid value even though the target is not running)

Not unless someone has manually set the section load address in the test?

The test is not setting the load address manually. This simply falls out of how Address::GetLoadAddress is implemented:

addr_t Address::GetLoadAddress(Target *target) const {
  SectionSP section_sp(GetSection());
  if (section_sp) {
    ...
  } else {
    // We don't have a section so the offset is the load address
    return m_offset;
  }
}

So, where's the bug here? It's not clear to me how to change Address::GetLoadAddress to do something different than what it is doing now.

So this is a bug really. When there is no section, we should specify what the m_offset is using lldb_private::AddressType in maybe a new ivar name "m_offset_type". Then GetBaseAddress() would specify eAddressTypeFile. And the above code would become:

addr_t Address::GetLoadAddress(Target *target) const {
  SectionSP section_sp(GetSection());
  if (section_sp) {
    ...
  } else if (m_offset_type == eAddressTypeLoad) {
    // We don't have a section so the offset is the load address
    return m_offset;
  }
}

We just need to be careful and see if we can not make lldb_private::Address get any bigger byte size wise if we can at all avoid it.

I must be missing something. If there's a file around so that we can express this address relative to the file, why would it ever not be expressed as a section + offset? If there's not a file around, then what does it mean to say this address ie eAddressTypeFile but we don't know the file?

labath mentioned this in D55706: ELF: more section creation cleanup.Dec 14 2018, 7:37 AM
labath mentioned this in rL349268: ELF: more section creation cleanup.Dec 15 2018, 5:49 AM
labath mentioned this in rLLDB349268: ELF: more section creation cleanup.
labath mentioned this in D55998: ELF: create "container" sections from PT_LOAD segments.Dec 21 2018, 6:03 AM
labath mentioned this in rL350742: ELF: create "container" sections from PT_LOAD segments.Jan 9 2019, 8:55 AM
labath mentioned this in rLLDB350742: ELF: create "container" sections from PT_LOAD segments.
labath mentioned this in D56537: ObjectFilePECOFF: Create a "container" section spanning the entire module image.Jan 10 2019, 4:02 AM
labath abandoned this revision.Feb 11 2019, 5:28 AM

This has been implemented for ELF in another way. PECOFF changes are waiting for review in D58050.

labath mentioned this in rL353916: ObjectFilePECOFF: Create a "container" section spanning the entire module image.Feb 12 2019, 11:17 PM
labath mentioned this in rLLDB353916: ObjectFilePECOFF: Create a "container" section spanning the entire module image.
labath mentioned this in rG7db8b5c4bdea: ObjectFilePECOFF: Create a "container" section spanning the entire module image.

Revision Contents

PathSize
include/
lldb/
Symbol/
5 lines
lit/
Modules/
ELF/
27 lines
MachO/
217 lines
PECOFF/
86 lines
1 line
2 lines
8 lines
source/
Plugins/
ObjectFile/
Breakpad/
2 lines
ELF/
2 lines
31 lines
JIT/
2 lines
Mach-O/
2 lines
6 lines
PECOFF/
2 lines
tools/
lldb-test/
2 lines

Diff 176937

include/lldb/Symbol/ObjectFile.h

Show First 20 Lines • Show All 560 Lines • ▼ Show 20 Linespublic:
/// ///
/// @return /// @return
/// Returns the entry address for this module. /// Returns the entry address for this module.
//------------------------------------------------------------------ //------------------------------------------------------------------
virtual lldb_private::Address GetHeaderAddress() { virtual lldb_private::Address GetHeaderAddress() {
return Address(m_memory_addr); return Address(m_memory_addr);
} }
/// Returns the base file address of an object file (also known as the
lemoUnsubmitted
Not Done
ReplyInline Actions

"file address" can mean an offset within a container file.

to avoid any confusion I'd use "base address" (or "image base address")

lemo: "file address" can mean an offset within a container file. to avoid any confusion I'd use…
clayborgUnsubmitted
Not Done
ReplyInline Actions

"file address" is the correct LLDB term so I would leave this as is. File addresses in LLDB are addresses as they are represented within the object file itself. Load addresses at unique and map to a single address in a live process where shared libraries are slid around. So "file address" is the correct LLDB term.

clayborg: "file address" is the correct LLDB term so I would leave this as is. File addresses in LLDB are…
/// preferred load address or image base address). This is typically the file
/// address of the first section in the file.
virtual lldb::addr_t GetBaseFileAddress() = 0;
virtual uint32_t GetNumThreadContexts() { return 0; } virtual uint32_t GetNumThreadContexts() { return 0; }
//------------------------------------------------------------------ //------------------------------------------------------------------
/// Some object files may have an identifier string embedded in them, e.g. /// Some object files may have an identifier string embedded in them, e.g.
/// in a Mach-O core file using the LC_IDENT load command (which is /// in a Mach-O core file using the LC_IDENT load command (which is
/// obsolete, but can still be found in some old files) /// obsolete, but can still be found in some old files)
/// ///
/// @return /// @return
▲ Show 20 Lines • Show All 256 Lines • Show Last 20 Lines

lit/Modules/ELF/basic-info.yaml

  • This file was added.
# REQUIRES: lld
# RUN: yaml2obj %s > %t.o
# RUN: ld.lld %t.o -o %t -image-base 0x47000
# RUN: lldb-test object-file %t | FileCheck %s
# CHECK: Plugin name: elf
# CHECK: Architecture: x86_64--
# CHECK: Executable: true
# CHECK: Stripped: false
# CHECK: Type: executable
# CHECK: Strata: user
# CHECK: Base VM address: 0x47000
--- !ELF
FileHeader:
Class: ELFCLASS64
Data: ELFDATA2LSB
Type: ET_REL
Machine: EM_X86_64
Sections:
- Name: .text
Type: SHT_PROGBITS
Flags: [ SHF_ALLOC, SHF_EXECINSTR ]
AddressAlign: 0x0000000000000010
Content: 554889E55DC3
...

lit/Modules/MachO/basic-info.yaml

  • This file was added.
# RUN: yaml2obj %s > %t
# RUN: lldb-test object-file %t | FileCheck %s
# CHECK: Plugin name: mach-o
# CHECK: Architecture: x86_64-apple-macosx10.4.0
# CHECK: Executable: true
# CHECK: Stripped: true
# CHECK: Type: executable
# CHECK: Strata: user
# CHECK: Base VM address: 0x100000000
amccarthUnsubmitted
Not Done
ReplyInline Actions

Just so I understand, this 0x10000000 is supposed to correspond to the vmaddr of the TEXT section, right? There are a few other vmaddrs and addrs in the YAML that correspond to other addresses.

amccarth: Just so I understand, this 0x10000000 is supposed to correspond to the vmaddr of the TEXT…
--- !mach-o
FileHeader:
magic: 0xFEEDFACF
cputype: 0x01000007
cpusubtype: 0x00000003
filetype: 0x00000002
ncmds: 12
sizeofcmds: 728
flags: 0x00000085
reserved: 0x00000000
LoadCommands:
- cmd: LC_SEGMENT_64
cmdsize: 72
segname: __PAGEZERO
vmaddr: 0
vmsize: 4294967296
fileoff: 0
filesize: 0
maxprot: 0
initprot: 0
nsects: 0
flags: 0
- cmd: LC_SEGMENT_64
cmdsize: 312
segname: __TEXT
vmaddr: 4294967296
vmsize: 4096
fileoff: 0
filesize: 4096
maxprot: 7
initprot: 5
nsects: 3
flags: 0
Sections:
- sectname: __text
segname: __TEXT
addr: 0x0000000100000F30
size: 22
offset: 0x00000F30
align: 4
reloff: 0x00000000
nreloc: 0
flags: 0x80000400
reserved1: 0x00000000
reserved2: 0x00000000
reserved3: 0x00000000
- sectname: __unwind_info
segname: __TEXT
addr: 0x0000000100000F48
size: 76
offset: 0x00000F48
align: 2
reloff: 0x00000000
nreloc: 0
flags: 0x00000000
reserved1: 0x00000000
reserved2: 0x00000000
reserved3: 0x00000000
- sectname: __eh_frame
segname: __TEXT
addr: 0x0000000100000F98
size: 104
offset: 0x00000F98
align: 3
reloff: 0x00000000
nreloc: 0
flags: 0x0000000B
reserved1: 0x00000000
reserved2: 0x00000000
reserved3: 0x00000000
- cmd: LC_SEGMENT_64
cmdsize: 72
segname: __LINKEDIT
vmaddr: 4294971392
vmsize: 4096
fileoff: 4096
filesize: 184
maxprot: 7
initprot: 1
nsects: 0
flags: 0
- cmd: LC_DYLD_INFO_ONLY
cmdsize: 48
rebase_off: 4096
rebase_size: 8
bind_off: 4104
bind_size: 8
weak_bind_off: 0
weak_bind_size: 0
lazy_bind_off: 0
lazy_bind_size: 0
export_off: 4112
export_size: 64
- cmd: LC_SYMTAB
cmdsize: 24
symoff: 4184
nsyms: 3
stroff: 4232
strsize: 48
- cmd: LC_DYSYMTAB
cmdsize: 80
ilocalsym: 0
nlocalsym: 0
iextdefsym: 0
nextdefsym: 3
iundefsym: 3
nundefsym: 0
tocoff: 0
ntoc: 0
modtaboff: 0
nmodtab: 0
extrefsymoff: 0
nextrefsyms: 0
indirectsymoff: 4232
nindirectsyms: 0
extreloff: 0
nextrel: 0
locreloff: 0
nlocrel: 0
- cmd: LC_LOAD_DYLINKER
cmdsize: 32
name: 12
PayloadString: '/usr/lib/dyld'
ZeroPadBytes: 7
- cmd: LC_VERSION_MIN_MACOSX
cmdsize: 16
version: 656384
sdk: 656384
- cmd: LC_SOURCE_VERSION
cmdsize: 16
version: 0
- cmd: LC_MAIN
cmdsize: 24
entryoff: 3888
stacksize: 0
- cmd: LC_FUNCTION_STARTS
cmdsize: 16
dataoff: 4176
datasize: 8
- cmd: LC_DATA_IN_CODE
cmdsize: 16
dataoff: 4184
datasize: 0
LinkEditData:
RebaseOpcodes:
- Opcode: REBASE_OPCODE_DONE
Imm: 0
BindOpcodes:
- Opcode: BIND_OPCODE_DONE
Imm: 0
Symbol: ''
ExportTrie:
TerminalSize: 0
NodeOffset: 0
Name: ''
Flags: 0x0000000000000000
Address: 0x0000000000000000
Other: 0x0000000000000000
ImportName: ''
Children:
- TerminalSize: 2
NodeOffset: 48
Name: __mh_execute_header
Flags: 0x0000000000000000
Address: 0x0000000000000000
Other: 0x0000000000000000
ImportName: ''
- TerminalSize: 3
NodeOffset: 52
Name: start
Flags: 0x0000000000000000
Address: 0x0000000000000F30
Other: 0x0000000000000000
ImportName: ''
- TerminalSize: 3
NodeOffset: 57
Name: dyld_stub_binder
Flags: 0x0000000000000000
Address: 0x0000000000000F40
Other: 0x0000000000000000
ImportName: ''
NameList:
- n_strx: 2
n_type: 0x0F
n_sect: 1
n_desc: 16
n_value: 4294967296
- n_strx: 22
n_type: 0x0F
n_sect: 1
n_desc: 0
n_value: 4294971200
- n_strx: 39
n_type: 0x0F
n_sect: 1
n_desc: 0
n_value: 4294971184
StringTable:
- ' '
- __mh_execute_header
- dyld_stub_binder
- start
- ''
- ''
- ''
...

lit/Modules/PECOFF/basic-info.yaml

  • This file was added.
# RUN: yaml2obj %s > %t
# RUN: lldb-test object-file %t | FileCheck %s
# CHECK: Plugin name: pe-coff
# CHECK: Architecture: x86_64-pc-windows-msvc
# CHECK: UUID:
# CHECK: Executable: true
# CHECK: Stripped: false
# CHECK: Type: executable
# CHECK: Strata: user
# CHECK: Base VM address: 0x40000000
--- !COFF
OptionalHeader:
AddressOfEntryPoint: 4096
ImageBase: 1073741824
SectionAlignment: 4096
FileAlignment: 512
MajorOperatingSystemVersion: 6
MinorOperatingSystemVersion: 0
MajorImageVersion: 0
MinorImageVersion: 0
MajorSubsystemVersion: 6
MinorSubsystemVersion: 0
Subsystem: IMAGE_SUBSYSTEM_WINDOWS_CUI
DLLCharacteristics: [ IMAGE_DLL_CHARACTERISTICS_HIGH_ENTROPY_VA, IMAGE_DLL_CHARACTERISTICS_DYNAMIC_BASE, IMAGE_DLL_CHARACTERISTICS_NX_COMPAT, IMAGE_DLL_CHARACTERISTICS_TERMINAL_SERVER_AWARE ]
SizeOfStackReserve: 1048576
SizeOfStackCommit: 4096
SizeOfHeapReserve: 1048576
SizeOfHeapCommit: 4096
ExportTable:
RelativeVirtualAddress: 0
Size: 0
ImportTable:
RelativeVirtualAddress: 0
Size: 0
ResourceTable:
RelativeVirtualAddress: 0
Size: 0
ExceptionTable:
RelativeVirtualAddress: 0
Size: 0
CertificateTable:
RelativeVirtualAddress: 0
Size: 0
BaseRelocationTable:
RelativeVirtualAddress: 0
Size: 0
Debug:
RelativeVirtualAddress: 8192
Size: 28
Architecture:
RelativeVirtualAddress: 0
Size: 0
GlobalPtr:
RelativeVirtualAddress: 0
Size: 0
TlsTable:
RelativeVirtualAddress: 0
Size: 0
LoadConfigTable:
RelativeVirtualAddress: 0
Size: 0
BoundImport:
RelativeVirtualAddress: 0
Size: 0
IAT:
RelativeVirtualAddress: 0
Size: 0
DelayImportDescriptor:
RelativeVirtualAddress: 0
Size: 0
ClrRuntimeHeader:
RelativeVirtualAddress: 0
Size: 0
header:
Machine: IMAGE_FILE_MACHINE_AMD64
Characteristics: [ IMAGE_FILE_EXECUTABLE_IMAGE, IMAGE_FILE_LARGE_ADDRESS_AWARE ]
sections:
- Name: .text
Characteristics: [ IMAGE_SCN_CNT_CODE, IMAGE_SCN_MEM_EXECUTE, IMAGE_SCN_MEM_READ ]
VirtualAddress: 1073745920
VirtualSize: 1
SectionData: C3
symbols: []
...

lit/Modules/build-id-case.yaml

# RUN: mkdir -p %t/.build-id/1b # RUN: mkdir -p %t/.build-id/1b
# RUN: yaml2obj %s > %t/.build-id/1b/8a73ac238390e32a7ff4ac8ebe4d6a41ecf5c9.debug # RUN: yaml2obj %s > %t/.build-id/1b/8a73ac238390e32a7ff4ac8ebe4d6a41ecf5c9.debug
# RUN: cd %t # RUN: cd %t
# RUN: llvm-objcopy --strip-all --add-gnu-debuglink=.build-id/1b/8a73ac238390e32a7ff4ac8ebe4d6a41ecf5c9.debug %t/.build-id/1b/8a73ac238390e32a7ff4ac8ebe4d6a41ecf5c9.debug %t/stripped.out # RUN: llvm-objcopy --strip-all --add-gnu-debuglink=.build-id/1b/8a73ac238390e32a7ff4ac8ebe4d6a41ecf5c9.debug %t/.build-id/1b/8a73ac238390e32a7ff4ac8ebe4d6a41ecf5c9.debug %t/stripped.out
# RUN: lldb-test object-file %t/stripped.out | FileCheck %s # RUN: lldb-test object-file %t/stripped.out | FileCheck %s
# CHECK: Name: .debug_frame # CHECK: Name: .debug_frame
# CHECK-NEXT: Type: dwarf-frame # CHECK-NEXT: Type: dwarf-frame
# CHECK-NEXT: VM address: 0
# CHECK-NEXT: VM size: 0 # CHECK-NEXT: VM size: 0
# CHECK-NEXT: File size: 8 # CHECK-NEXT: File size: 8
--- !ELF --- !ELF
FileHeader: FileHeader:
Class: ELFCLASS64 Class: ELFCLASS64
Data: ELFDATA2LSB Data: ELFDATA2LSB
Type: ET_EXEC Type: ET_EXEC
Show All 27 Lines

lit/Modules/compressed-sections.yaml

Show All 13 Lines - Name: .hello_elf
Content: 010000000800000001000000789c5330700848286898000009c802c1 Content: 010000000800000001000000789c5330700848286898000009c802c1
- Name: .bogus - Name: .bogus
Type: SHT_PROGBITS Type: SHT_PROGBITS
Flags: [ SHF_COMPRESSED ] Flags: [ SHF_COMPRESSED ]
Content: deadbeefbaadf00d Content: deadbeefbaadf00d
# CHECK: Name: .hello_elf # CHECK: Name: .hello_elf
# CHECK-NEXT: Type: regular # CHECK-NEXT: Type: regular
# CHECK-NEXT: VM address: 0
# CHECK-NEXT: VM size: 0 # CHECK-NEXT: VM size: 0
# CHECK-NEXT: File size: 28 # CHECK-NEXT: File size: 28
# CHECK-NEXT: Data: # CHECK-NEXT: Data:
# CHECK-NEXT: 20304050 60708090 # CHECK-NEXT: 20304050 60708090
# CHECK: Name: .bogus # CHECK: Name: .bogus
# CHECK-NEXT: Type: regular # CHECK-NEXT: Type: regular
# CHECK-NEXT: VM address: 0
# CHECK-NEXT: VM size: 0 # CHECK-NEXT: VM size: 0
# CHECK-NEXT: File size: 8 # CHECK-NEXT: File size: 8
# CHECK-NEXT: Data: () # CHECK-NEXT: Data: ()

lit/Modules/elf-section-types.yaml

# RUN: yaml2obj %s > %t # RUN: yaml2obj %s > %t
# RUN: lldb-test object-file %t | FileCheck %s # RUN: lldb-test object-file %t | FileCheck %s
# CHECK: Name: .text # CHECK: Name: .text
# CHECK-NEXT: Type: code # CHECK-NEXT: Type: code
# CHECK: Name: .debug_info # CHECK: Name: .debug_info
# CHECK-NEXT: Type: dwarf-info # CHECK-NEXT: Type: dwarf-info
# CHECK-NEXT: VM size: 0
# CHECK-NEXT: File size: 8
# CHECK: Name: .debug_types # CHECK: Name: .debug_types
# CHECK-NEXT: Type: dwarf-types # CHECK-NEXT: Type: dwarf-types
# CHECK-NEXT: VM size: 0
# CHECK-NEXT: File size: 8
# CHECK: Name: .debug_names # CHECK: Name: .debug_names
# CHECK-NEXT: Type: dwarf-names # CHECK-NEXT: Type: dwarf-names
# CHECK-NEXT: VM size: 0
# CHECK-NEXT: File size: 8
# CHECK: Name: .gnu_debugaltlink # CHECK: Name: .gnu_debugaltlink
# CHECK-NEXT: Type: dwarf-gnu-debugaltlink # CHECK-NEXT: Type: dwarf-gnu-debugaltlink
# CHECK-NEXT: VM size: 0
# CHECK-NEXT: File size: 8
# CHECK: Name: __codesection # CHECK: Name: __codesection
# CHECK-NEXT: Type: code # CHECK-NEXT: Type: code
--- !ELF --- !ELF
FileHeader: FileHeader:
Class: ELFCLASS64 Class: ELFCLASS64
Data: ELFDATA2LSB Data: ELFDATA2LSB
Show All 29 Lines

source/Plugins/ObjectFile/Breakpad/ObjectFileBreakpad.h

Show First 20 Lines • Show All 79 Lines • ▼ Show 20 Linespublic:
bool GetArchitecture(ArchSpec &arch) override; bool GetArchitecture(ArchSpec &arch) override;
bool GetUUID(UUID *uuid) override; bool GetUUID(UUID *uuid) override;
FileSpecList GetDebugSymbolFilePaths() override { return FileSpecList(); } FileSpecList GetDebugSymbolFilePaths() override { return FileSpecList(); }
uint32_t GetDependentModules(FileSpecList &files) override { return 0; } uint32_t GetDependentModules(FileSpecList &files) override { return 0; }
lldb::addr_t GetBaseFileAddress() override { return LLDB_INVALID_ADDRESS; }
Type CalculateType() override { return eTypeDebugInfo; } Type CalculateType() override { return eTypeDebugInfo; }
Strata CalculateStrata() override { return eStrataUser; } Strata CalculateStrata() override { return eStrataUser; }
size_t ReadSectionData(Section *section, lldb::offset_t section_offset, size_t ReadSectionData(Section *section, lldb::offset_t section_offset,
void *dst, size_t dst_len) override; void *dst, size_t dst_len) override;
size_t ReadSectionData(Section *section, size_t ReadSectionData(Section *section,
Show All 15 Lines

source/Plugins/ObjectFile/ELF/ObjectFileELF.h

Show First 20 Lines • Show All 128 Lines • ▼ Show 20 Linespublic:
uint32_t GetDependentModules(lldb_private::FileSpecList &files) override; uint32_t GetDependentModules(lldb_private::FileSpecList &files) override;
lldb_private::Address lldb_private::Address
GetImageInfoAddress(lldb_private::Target *target) override; GetImageInfoAddress(lldb_private::Target *target) override;
lldb_private::Address GetEntryPointAddress() override; lldb_private::Address GetEntryPointAddress() override;
lldb::addr_t GetBaseFileAddress() override;
ObjectFile::Type CalculateType() override; ObjectFile::Type CalculateType() override;
ObjectFile::Strata CalculateStrata() override; ObjectFile::Strata CalculateStrata() override;
size_t ReadSectionData(lldb_private::Section *section, size_t ReadSectionData(lldb_private::Section *section,
lldb::offset_t section_offset, void *dst, lldb::offset_t section_offset, void *dst,
size_t dst_len) override; size_t dst_len) override;
▲ Show 20 Lines • Show All 249 Lines • Show Last 20 Lines

source/Plugins/ObjectFile/ELF/ObjectFileELF.cpp

Show First 20 Lines • Show All 799 Lines • ▼ Show 20 Lines
bool ObjectFileELF::SetLoadAddress(Target &target, lldb::addr_t value, bool ObjectFileELF::SetLoadAddress(Target &target, lldb::addr_t value,
bool value_is_offset) { bool value_is_offset) {
ModuleSP module_sp = GetModule(); ModuleSP module_sp = GetModule();
if (module_sp) { if (module_sp) {
size_t num_loaded_sections = 0; size_t num_loaded_sections = 0;
SectionList *section_list = GetSectionList(); SectionList *section_list = GetSectionList();
if (section_list) { if (section_list) {
if (!value_is_offset) { if (!value_is_offset) {
bool found_offset = false; addr_t base = GetBaseFileAddress();
for (size_t i = 1, count = GetProgramHeaderCount(); i <= count; ++i) { if (base == LLDB_INVALID_ADDRESS)
const elf::ELFProgramHeader *header = GetProgramHeaderByIndex(i);
if (header == nullptr)
continue;
if (header->p_type != PT_LOAD || header->p_offset != 0)
continue;
value = value - header->p_vaddr;
found_offset = true;
break;
}
if (!found_offset)
return false; return false;
value -= base;
} }
const size_t num_sections = section_list->GetSize(); const size_t num_sections = section_list->GetSize();
size_t sect_idx = 0; size_t sect_idx = 0;
for (sect_idx = 0; sect_idx < num_sections; ++sect_idx) { for (sect_idx = 0; sect_idx < num_sections; ++sect_idx) {
// Iterate through the object file sections to find all of the sections // Iterate through the object file sections to find all of the sections
// that have SHF_ALLOC in their flag bits. // that have SHF_ALLOC in their flag bits.
▲ Show 20 Lines • Show All 221 Lines • ▼ Show 20 Lineslldb_private::Address ObjectFileELF::GetEntryPointAddress() {
if (!section_list) if (!section_list)
m_entry_point_address.SetOffset(offset); m_entry_point_address.SetOffset(offset);
else else
m_entry_point_address.ResolveAddressUsingFileSections(offset, section_list); m_entry_point_address.ResolveAddressUsingFileSections(offset, section_list);
return m_entry_point_address; return m_entry_point_address;
} }
addr_t ObjectFileELF::GetBaseFileAddress() {
for (size_t i = 1, count = GetProgramHeaderCount(); i <= count; ++i) {
const elf::ELFProgramHeader *header = GetProgramHeaderByIndex(i);
if (header == nullptr)
continue;
if (header->p_type != PT_LOAD || header->p_offset != 0)
continue;
return header->p_vaddr;
}
return LLDB_INVALID_ADDRESS;
}
//---------------------------------------------------------------------- //----------------------------------------------------------------------
// ParseDependentModules // ParseDependentModules
//---------------------------------------------------------------------- //----------------------------------------------------------------------
size_t ObjectFileELF::ParseDependentModules() { size_t ObjectFileELF::ParseDependentModules() {
if (m_filespec_ap.get()) if (m_filespec_ap.get())
return m_filespec_ap->GetSize(); return m_filespec_ap->GetSize();
m_filespec_ap.reset(new FileSpecList()); m_filespec_ap.reset(new FileSpecList());
▲ Show 20 Lines • Show All 2,417 Lines • Show Last 20 Lines

source/Plugins/ObjectFile/JIT/ObjectFileJIT.h

Show First 20 Lines • Show All 85 Lines • ▼ Show 20 Linespublic:
size_t size_t
ReadSectionData(lldb_private::Section *section, ReadSectionData(lldb_private::Section *section,
lldb_private::DataExtractor &section_data) override; lldb_private::DataExtractor &section_data) override;
lldb_private::Address GetEntryPointAddress() override; lldb_private::Address GetEntryPointAddress() override;
lldb_private::Address GetHeaderAddress() override; lldb_private::Address GetHeaderAddress() override;
lldb::addr_t GetBaseFileAddress() override { return LLDB_INVALID_ADDRESS; }
ObjectFile::Type CalculateType() override; ObjectFile::Type CalculateType() override;
ObjectFile::Strata CalculateStrata() override; ObjectFile::Strata CalculateStrata() override;
//------------------------------------------------------------------ //------------------------------------------------------------------
// PluginInterface protocol // PluginInterface protocol
//------------------------------------------------------------------ //------------------------------------------------------------------
lldb_private::ConstString GetPluginName() override; lldb_private::ConstString GetPluginName() override;
uint32_t GetPluginVersion() override; uint32_t GetPluginVersion() override;
protected: protected:
lldb::ObjectFileJITDelegateWP m_delegate_wp; lldb::ObjectFileJITDelegateWP m_delegate_wp;
}; };
#endif // liblldb_ObjectFileJIT_h_ #endif // liblldb_ObjectFileJIT_h_

source/Plugins/ObjectFile/Mach-O/ObjectFileMachO.h

Show First 20 Lines • Show All 100 Lines • ▼ Show 20 Linespublic:
lldb_private::FileSpecList GetReExportedLibraries() override { lldb_private::FileSpecList GetReExportedLibraries() override {
return m_reexported_dylibs; return m_reexported_dylibs;
} }
lldb_private::Address GetEntryPointAddress() override; lldb_private::Address GetEntryPointAddress() override;
lldb_private::Address GetHeaderAddress() override; lldb_private::Address GetHeaderAddress() override;
lldb::addr_t GetBaseFileAddress() override;
uint32_t GetNumThreadContexts() override; uint32_t GetNumThreadContexts() override;
std::string GetIdentifierString() override; std::string GetIdentifierString() override;
bool GetCorefileMainBinaryInfo (lldb::addr_t &address, lldb_private::UUID &uuid) override; bool GetCorefileMainBinaryInfo (lldb::addr_t &address, lldb_private::UUID &uuid) override;
lldb::RegisterContextSP lldb::RegisterContextSP
GetThreadContextAtIndex(uint32_t idx, lldb_private::Thread &thread) override; GetThreadContextAtIndex(uint32_t idx, lldb_private::Thread &thread) override;
▲ Show 20 Lines • Show All 101 Lines • Show Last 20 Lines

source/Plugins/ObjectFile/Mach-O/ObjectFileMachO.cpp

  • This file is larger than 256 KB, so syntax highlighting is disabled by default.
Show First 20 Lines • Show All 5,347 Lines • ▼ Show 20 Lines if (section_list) {
if (text_segment_sp) { if (text_segment_sp) {
header_addr.SetSection(text_segment_sp); header_addr.SetSection(text_segment_sp);
header_addr.SetOffset(0); header_addr.SetOffset(0);
} }
} }
return header_addr; return header_addr;
} }
addr_t ObjectFileMachO::GetBaseFileAddress() {
if (Section *sect = GetMachHeaderSection())
return sect->GetFileAddress();
return LLDB_INVALID_ADDRESS;
}
uint32_t ObjectFileMachO::GetNumThreadContexts() { uint32_t ObjectFileMachO::GetNumThreadContexts() {
ModuleSP module_sp(GetModule()); ModuleSP module_sp(GetModule());
if (module_sp) { if (module_sp) {
std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex()); std::lock_guard<std::recursive_mutex> guard(module_sp->GetMutex());
if (!m_thread_context_offsets_valid) { if (!m_thread_context_offsets_valid) {
m_thread_context_offsets_valid = true; m_thread_context_offsets_valid = true;
lldb::offset_t offset = MachHeaderSizeFromMagic(m_header.magic); lldb::offset_t offset = MachHeaderSizeFromMagic(m_header.magic);
FileRangeArray::Entry file_range; FileRangeArray::Entry file_range;
▲ Show 20 Lines • Show All 1,027 Lines • Show Last 20 Lines

source/Plugins/ObjectFile/PECOFF/ObjectFilePECOFF.h

Show First 20 Lines • Show All 111 Lines • ▼ Show 20 Linespublic:
bool GetArchitecture(lldb_private::ArchSpec &arch) override; bool GetArchitecture(lldb_private::ArchSpec &arch) override;
bool GetUUID(lldb_private::UUID *uuid) override; bool GetUUID(lldb_private::UUID *uuid) override;
uint32_t GetDependentModules(lldb_private::FileSpecList &files) override; uint32_t GetDependentModules(lldb_private::FileSpecList &files) override;
virtual lldb_private::Address GetEntryPointAddress() override; virtual lldb_private::Address GetEntryPointAddress() override;
lldb::addr_t GetBaseFileAddress() override { return m_image_base; }
ObjectFile::Type CalculateType() override; ObjectFile::Type CalculateType() override;
ObjectFile::Strata CalculateStrata() override; ObjectFile::Strata CalculateStrata() override;
//------------------------------------------------------------------ //------------------------------------------------------------------
// PluginInterface protocol // PluginInterface protocol
//------------------------------------------------------------------ //------------------------------------------------------------------
lldb_private::ConstString GetPluginName() override; lldb_private::ConstString GetPluginName() override;
▲ Show 20 Lines • Show All 156 Lines • Show Last 20 Lines

tools/lldb-test/lldb-test.cpp

Show First 20 Lines • Show All 744 Lines • ▼ Show 20 Lines for (const auto &File : opts::object::InputFilenames) {
Printer.formatLine("Plugin name: {0}", ObjectPtr->GetPluginName()); Printer.formatLine("Plugin name: {0}", ObjectPtr->GetPluginName());
Printer.formatLine("Architecture: {0}", Printer.formatLine("Architecture: {0}",
ModulePtr->GetArchitecture().GetTriple().getTriple()); ModulePtr->GetArchitecture().GetTriple().getTriple());
Printer.formatLine("UUID: {0}", ModulePtr->GetUUID().GetAsString()); Printer.formatLine("UUID: {0}", ModulePtr->GetUUID().GetAsString());
Printer.formatLine("Executable: {0}", ObjectPtr->IsExecutable()); Printer.formatLine("Executable: {0}", ObjectPtr->IsExecutable());
Printer.formatLine("Stripped: {0}", ObjectPtr->IsStripped()); Printer.formatLine("Stripped: {0}", ObjectPtr->IsStripped());
Printer.formatLine("Type: {0}", ObjectPtr->GetType()); Printer.formatLine("Type: {0}", ObjectPtr->GetType());
Printer.formatLine("Strata: {0}", ObjectPtr->GetStrata()); Printer.formatLine("Strata: {0}", ObjectPtr->GetStrata());
Printer.formatLine("Base VM address: {0:x}", ObjectPtr->GetBaseFileAddress());
size_t Count = Sections->GetNumSections(0); size_t Count = Sections->GetNumSections(0);
Printer.formatLine("Showing {0} sections", Count); Printer.formatLine("Showing {0} sections", Count);
for (size_t I = 0; I < Count; ++I) { for (size_t I = 0; I < Count; ++I) {
AutoIndent Indent(Printer, 2); AutoIndent Indent(Printer, 2);
auto S = Sections->GetSectionAtIndex(I); auto S = Sections->GetSectionAtIndex(I);
assert(S); assert(S);
Printer.formatLine("Index: {0}", I); Printer.formatLine("Index: {0}", I);
Printer.formatLine("Name: {0}", S->GetName().GetStringRef()); Printer.formatLine("Name: {0}", S->GetName().GetStringRef());
Printer.formatLine("Type: {0}", S->GetTypeAsCString()); Printer.formatLine("Type: {0}", S->GetTypeAsCString());
Printer.formatLine("VM address: {0:x}", S->GetFileAddress());
Printer.formatLine("VM size: {0}", S->GetByteSize()); Printer.formatLine("VM size: {0}", S->GetByteSize());
Printer.formatLine("File size: {0}", S->GetFileSize()); Printer.formatLine("File size: {0}", S->GetFileSize());
if (opts::object::SectionContents) { if (opts::object::SectionContents) {
DataExtractor Data; DataExtractor Data;
S->GetSectionData(Data); S->GetSectionData(Data);
ArrayRef<uint8_t> Bytes = {Data.GetDataStart(), Data.GetDataEnd()}; ArrayRef<uint8_t> Bytes = {Data.GetDataStart(), Data.GetDataEnd()};
Printer.formatBinary("Data: ", Bytes, 0); Printer.formatBinary("Data: ", Bytes, 0);
▲ Show 20 Lines • Show All 205 Lines • Show Last 20 Lines