Skip to content

Commit

Permalink
[llvm-dwarfdump] - Teach dwarfdump to decompress debug sections in zl…
Browse files Browse the repository at this point in the history
…ib style.

Before this llvm-dwarfdump only recognized zlib-gnu compression style of headers,
this patch adds support for zlib style. 
It looks reasonable to support both styles for dumping,
even if we are not going to suport generating of deprecated gnu one.

Differential revision: http://reviews.llvm.org/D20470

llvm-svn: 270540
  • Loading branch information
George Rimar committed May 24, 2016
1 parent 13a4937 commit 6bcbf4c
Show file tree
Hide file tree
Showing 10 changed files with 86 additions and 18 deletions.
1 change: 1 addition & 0 deletions llvm/include/llvm/Object/COFF.h
Expand Up @@ -694,6 +694,7 @@ class COFFObjectFile : public ObjectFile {
std::error_code getSectionContents(DataRefImpl Sec,
StringRef &Res) const override;
uint64_t getSectionAlignment(DataRefImpl Sec) const override;
bool isSectionCompressed(DataRefImpl Sec) const override;
bool isSectionText(DataRefImpl Sec) const override;
bool isSectionData(DataRefImpl Sec) const override;
bool isSectionBSS(DataRefImpl Sec) const override;
Expand Down
6 changes: 6 additions & 0 deletions llvm/include/llvm/Object/ELFObjectFile.h
Expand Up @@ -222,6 +222,7 @@ template <class ELFT> class ELFObjectFile : public ELFObjectFileBase {
std::error_code getSectionContents(DataRefImpl Sec,
StringRef &Res) const override;
uint64_t getSectionAlignment(DataRefImpl Sec) const override;
bool isSectionCompressed(DataRefImpl Sec) const override;
bool isSectionText(DataRefImpl Sec) const override;
bool isSectionData(DataRefImpl Sec) const override;
bool isSectionBSS(DataRefImpl Sec) const override;
Expand Down Expand Up @@ -583,6 +584,11 @@ uint64_t ELFObjectFile<ELFT>::getSectionAlignment(DataRefImpl Sec) const {
return getSection(Sec)->sh_addralign;
}

template <class ELFT>
bool ELFObjectFile<ELFT>::isSectionCompressed(DataRefImpl Sec) const {
return getSection(Sec)->sh_flags & ELF::SHF_COMPRESSED;
}

template <class ELFT>
bool ELFObjectFile<ELFT>::isSectionText(DataRefImpl Sec) const {
return getSection(Sec)->sh_flags & ELF::SHF_EXECINSTR;
Expand Down
1 change: 1 addition & 0 deletions llvm/include/llvm/Object/MachO.h
Expand Up @@ -222,6 +222,7 @@ class MachOObjectFile : public ObjectFile {
std::error_code getSectionContents(DataRefImpl Sec,
StringRef &Res) const override;
uint64_t getSectionAlignment(DataRefImpl Sec) const override;
bool isSectionCompressed(DataRefImpl Sec) const override;
bool isSectionText(DataRefImpl Sec) const override;
bool isSectionData(DataRefImpl Sec) const override;
bool isSectionBSS(DataRefImpl Sec) const override;
Expand Down
6 changes: 6 additions & 0 deletions llvm/include/llvm/Object/ObjectFile.h
Expand Up @@ -89,6 +89,7 @@ class SectionRef {
/// @brief Get the alignment of this section as the actual value (not log 2).
uint64_t getAlignment() const;

bool isCompressed() const;
bool isText() const;
bool isData() const;
bool isBSS() const;
Expand Down Expand Up @@ -214,6 +215,7 @@ class ObjectFile : public SymbolicFile {
virtual std::error_code getSectionContents(DataRefImpl Sec,
StringRef &Res) const = 0;
virtual uint64_t getSectionAlignment(DataRefImpl Sec) const = 0;
virtual bool isSectionCompressed(DataRefImpl Sec) const = 0;
virtual bool isSectionText(DataRefImpl Sec) const = 0;
virtual bool isSectionData(DataRefImpl Sec) const = 0;
virtual bool isSectionBSS(DataRefImpl Sec) const = 0;
Expand Down Expand Up @@ -380,6 +382,10 @@ inline uint64_t SectionRef::getAlignment() const {
return OwningObject->getSectionAlignment(SectionPimpl);
}

inline bool SectionRef::isCompressed() const {
return OwningObject->isSectionCompressed(SectionPimpl);
}

inline bool SectionRef::isText() const {
return OwningObject->isSectionText(SectionPimpl);
}
Expand Down
68 changes: 53 additions & 15 deletions llvm/lib/DebugInfo/DWARF/DWARFContext.cpp
Expand Up @@ -15,6 +15,7 @@
#include "llvm/DebugInfo/DWARF/DWARFUnitIndex.h"
#include "llvm/Support/Compression.h"
#include "llvm/Support/Dwarf.h"
#include "llvm/Support/ELF.h"
#include "llvm/Support/Format.h"
#include "llvm/Support/Path.h"
#include "llvm/Support/raw_ostream.h"
Expand Down Expand Up @@ -590,8 +591,8 @@ DWARFContext::getInliningInfoForAddress(uint64_t Address,
return InliningInfo;
}

static bool consumeCompressedDebugSectionHeader(StringRef &data,
uint64_t &OriginalSize) {
static bool consumeCompressedGnuHeader(StringRef &data,
uint64_t &OriginalSize) {
// Consume "ZLIB" prefix.
if (!data.startswith("ZLIB"))
return false;
Expand All @@ -606,6 +607,50 @@ static bool consumeCompressedDebugSectionHeader(StringRef &data,
return true;
}

static bool consumeCompressedZLibHeader(StringRef &Data, uint64_t &OriginalSize,
bool IsLE, bool Is64Bit) {
using namespace ELF;
uint64_t HdrSize = Is64Bit ? sizeof(Elf64_Chdr) : sizeof(Elf32_Chdr);
if (Data.size() < HdrSize)
return false;

DataExtractor Extractor(Data, IsLE, 0);
uint32_t Offset = 0;
if (Extractor.getUnsigned(&Offset, Is64Bit ? sizeof(Elf64_Word)
: sizeof(Elf32_Word)) !=
ELFCOMPRESS_ZLIB)
return false;

// Skip Elf64_Chdr::ch_reserved field.
if (Is64Bit)
Offset += sizeof(Elf64_Word);

OriginalSize = Extractor.getUnsigned(&Offset, Is64Bit ? sizeof(Elf64_Xword)
: sizeof(Elf32_Word));
Data = Data.substr(HdrSize);
return true;
}

static bool tryDecompress(StringRef &Name, StringRef &Data,
SmallString<32> &Out, bool ZLibStyle, bool IsLE,
bool Is64Bit) {
if (!zlib::isAvailable())
return false;

uint64_t OriginalSize;
bool Result =
ZLibStyle ? consumeCompressedZLibHeader(Data, OriginalSize, IsLE, Is64Bit)
: consumeCompressedGnuHeader(Data, OriginalSize);

if (!Result || zlib::uncompress(Data, Out, OriginalSize) != zlib::StatusOK)
return false;

// gnu-style names are started from "z", consume that.
if (!ZLibStyle)
Name = Name.substr(1);
return true;
}

DWARFContextInMemory::DWARFContextInMemory(const object::ObjectFile &Obj,
const LoadedObjectInfo *L)
: IsLittleEndian(Obj.isLittleEndian()),
Expand All @@ -631,20 +676,13 @@ DWARFContextInMemory::DWARFContextInMemory(const object::ObjectFile &Obj,

name = name.substr(name.find_first_not_of("._")); // Skip . and _ prefixes.

// Check if debug info section is compressed with zlib.
if (name.startswith("zdebug_")) {
uint64_t OriginalSize;
if (!zlib::isAvailable() ||
!consumeCompressedDebugSectionHeader(data, OriginalSize))
bool ZLibStyleCompressed = Section.isCompressed();
if (ZLibStyleCompressed || name.startswith("zdebug_")) {
SmallString<32> Out;
if (!tryDecompress(name, data, Out, ZLibStyleCompressed, IsLittleEndian,
AddressSize == 8))
continue;
UncompressedSections.resize(UncompressedSections.size() + 1);
if (zlib::uncompress(data, UncompressedSections.back(), OriginalSize) !=
zlib::StatusOK) {
UncompressedSections.pop_back();
continue;
}
// Make data point to uncompressed section contents and save its contents.
name = name.substr(1);
UncompressedSections.emplace_back(std::move(Out));
data = UncompressedSections.back();
}

Expand Down
4 changes: 4 additions & 0 deletions llvm/lib/Object/COFFObjectFile.cpp
Expand Up @@ -292,6 +292,10 @@ uint64_t COFFObjectFile::getSectionAlignment(DataRefImpl Ref) const {
return Sec->getAlignment();
}

bool COFFObjectFile::isSectionCompressed(DataRefImpl Sec) const {
return false;
}

bool COFFObjectFile::isSectionText(DataRefImpl Ref) const {
const coff_section *Sec = toSec(Ref);
return Sec->Characteristics & COFF::IMAGE_SCN_CNT_CODE;
Expand Down
4 changes: 4 additions & 0 deletions llvm/lib/Object/MachOObjectFile.cpp
Expand Up @@ -653,6 +653,10 @@ uint64_t MachOObjectFile::getSectionAlignment(DataRefImpl Sec) const {
return uint64_t(1) << Align;
}

bool MachOObjectFile::isSectionCompressed(DataRefImpl Sec) const {
return false;
}

bool MachOObjectFile::isSectionText(DataRefImpl Sec) const {
uint32_t Flags = getSectionFlags(this, Sec);
return Flags & MachO::S_ATTR_PURE_INSTRUCTIONS;
Expand Down
8 changes: 5 additions & 3 deletions llvm/test/DebugInfo/Inputs/dwarfdump-test-zlib.cc
Expand Up @@ -16,9 +16,11 @@ int main() {
return f(2, 3);
}

// Built with Clang 3.2 and ld.gold linker:
// Built with Clang 3.9 and GNU gold (GNU Binutils for Ubuntu 2.26) 1.11:
// $ mkdir -p /tmp/dbginfo
// $ cp dwarfdump-test-zlib.cc /tmp/dbginfo
// $ cd /tmp/dbginfo
// $ clang++ -g dwarfdump-test-zlib.cc -Wl,--compress-debug-sections=zlib \
// -o <output>
// $ clang++ -g dwarfdump-test-zlib.cc -Wl,--compress-debug-sections=zlib -o dwarfdump-test-zlib.elf-x86-64
// $ clang++ -g dwarfdump-test-zlib.cc -Wl,--compress-debug-sections=zlib-gnu -o dwarfdump-test-zlibgnu.elf-x86-64
// llvm-readobj -sections can be used to see that outputs really contain the compressed sections, also output in both
// cases is slightly smaller, that is because of compression.
Binary file not shown.
6 changes: 6 additions & 0 deletions llvm/test/DebugInfo/dwarfdump-zlib.test
@@ -1,6 +1,12 @@
REQUIRES: zlib

RUN: llvm-dwarfdump %p/Inputs/dwarfdump-test-zlib.elf-x86-64 | FileCheck %s
RUN: llvm-dwarfdump %p/Inputs/dwarfdump-test-zlibgnu.elf-x86-64 | FileCheck %s

CHECK: .debug_abbrev contents

// Dump content of a little section to check that both zlib and zlib gnu styles do
// the decompression correctly and result is the same. This and above also checks
// that sections names are properly shown in zlib-gnu style (without additional 'z' prefix).
CHECK: .debug_info contents
CHECK: 0x00000000: Compile Unit: length = 0x00000144 version = 0x0004 abbr_offset = 0x0000 addr_size = 0x08 (next unit at 0x00000148)

0 comments on commit 6bcbf4c

Please sign in to comment.