Index: llvm/docs/CommandGuide/llvm-dwarfdump.rst =================================================================== --- llvm/docs/CommandGuide/llvm-dwarfdump.rst +++ llvm/docs/CommandGuide/llvm-dwarfdump.rst @@ -105,6 +105,10 @@ When displaying debug info entries, only show children to a maximum depth of . +.. option:: --show-section-sizes + + Show the sizes of all debug sections. + .. option:: --statistics Collect debug info quality metrics and print the results Index: llvm/test/tools/llvm-dwarfdump/X86/archive_section_sizes.test =================================================================== --- /dev/null +++ llvm/test/tools/llvm-dwarfdump/X86/archive_section_sizes.test @@ -0,0 +1,47 @@ +RUN: llvm-dwarfdump --show-section-sizes %S/../../dsymutil/Inputs/libfat-test.a \ +RUN: | FileCheck %s --match-full-lines --strict-whitespace + + CHECK:file: {{.*}}libfat-test.a(x86_64)(fat-test.o) +CHECK-NEXT:---------------------------------------------------- +CHECK-NEXT: SECTION SIZE +CHECK-NEXT:---------------- ----------------------- +CHECK-NEXT: __debug_abbrev 44 (2.81%) +CHECK-NEXT: __debug_info 60 (3.83%) +CHECK-NEXT: __debug_line 43 (2.74%) +CHECK-NEXT: __debug_loc 0 (0.00%) +CHECK-NEXT: __debug_ranges 0 (0.00%) +CHECK-NEXT: __debug_str 69 (4.40%) +CHECK-EMPTY: +CHECK-NEXT: Total Size: 216 (13.78%) +CHECK-NEXT: Total File Size: 1568 +CHECK-NEXT:---------------------------------------------------- + + CHECK:file: {{.*}}libfat-test.a(i386)(fat-test.o) +CHECK-NEXT:---------------------------------------------------- +CHECK-NEXT: SECTION SIZE +CHECK-NEXT:---------------- ----------------------- +CHECK-NEXT: __debug_abbrev 44 (3.14%) +CHECK-NEXT: __debug_info 56 (4.00%) +CHECK-NEXT: __debug_line 43 (3.07%) +CHECK-NEXT: __debug_loc 0 (0.00%) +CHECK-NEXT: __debug_ranges 0 (0.00%) +CHECK-NEXT: __debug_str 67 (4.79%) +CHECK-EMPTY: +CHECK-NEXT: Total Size: 210 (15.00%) +CHECK-NEXT: Total File Size: 1400 +CHECK-NEXT:---------------------------------------------------- + + CHECK:file: {{.*}}libfat-test.a(x86_64h)(fat-test.o) +CHECK-NEXT:---------------------------------------------------- +CHECK-NEXT: SECTION SIZE +CHECK-NEXT:---------------- ----------------------- +CHECK-NEXT: __debug_abbrev 44 (2.81%) +CHECK-NEXT: __debug_info 60 (3.83%) +CHECK-NEXT: __debug_line 43 (2.74%) +CHECK-NEXT: __debug_loc 0 (0.00%) +CHECK-NEXT: __debug_ranges 0 (0.00%) +CHECK-NEXT: __debug_str 70 (4.46%) +CHECK-EMPTY: +CHECK-NEXT: Total Size: 217 (13.84%) +CHECK-NEXT: Total File Size: 1568 +CHECK-NEXT:---------------------------------------------------- Index: llvm/test/tools/llvm-dwarfdump/X86/section_sizes.test =================================================================== --- /dev/null +++ llvm/test/tools/llvm-dwarfdump/X86/section_sizes.test @@ -0,0 +1,48 @@ +## Check how llvm-dwarfdump calculates section sizes with --show-section-sizes. + +# RUN: yaml2obj --docnum=1 %s -o %t +# RUN: llvm-dwarfdump --show-section-sizes %t | FileCheck %s --match-full-lines --strict-whitespace + +# CHECK:file: {{.*}} +# CHECK-NEXT:---------------------------------------------------- +# CHECK-NEXT: SECTION SIZE +# CHECK-NEXT:----------------- ----------------------- +# CHECK-NEXT: .debug_foo 100 (10.25%) +# CHECK-NEXT: .debug_info 17 (1.74%) +# CHECK-NEXT: .debug_info.dwo 9 (0.92%) +# CHECK-NEXT: .debug_line 19 (1.95%) +# CHECK-NEXT: .debug_loc 1 (0.10%) +# CHECK-NEXT: .debug_type 26 (2.66%) +# CHECK-EMPTY: +# CHECK-NEXT: Total Size: 172 (17.62%) +# CHECK-NEXT: Total File Size: 976 +# CHECK-NEXT:---------------------------------------------------- + +--- !ELF +FileHeader: + Class: ELFCLASS64 + Data: ELFDATA2LSB + Type: ET_REL + Machine: EM_X86_64 +Sections: + - Name: .debug_info + Type: SHT_PROGBITS + Size: 17 + - Name: .debug_line + Type: SHT_PROGBITS + Size: 19 + - Name: .debug_loc + Type: SHT_PROGBITS + Size: 1 + - Name: .debug_type + Type: SHT_PROGBITS + Size: 13 + - Name: .debug_type [1] + Type: SHT_PROGBITS + Size: 13 + - Name: .debug_foo + Type: SHT_PROGBITS + Size: 100 + - Name: .debug_info.dwo + Type: SHT_PROGBITS + Size: 9 Index: llvm/tools/llvm-dwarfdump/CMakeLists.txt =================================================================== --- llvm/tools/llvm-dwarfdump/CMakeLists.txt +++ llvm/tools/llvm-dwarfdump/CMakeLists.txt @@ -9,6 +9,7 @@ add_llvm_tool(llvm-dwarfdump Statistics.cpp + SectionSizes.cpp llvm-dwarfdump.cpp ) Index: llvm/tools/llvm-dwarfdump/SectionSizes.cpp =================================================================== --- /dev/null +++ llvm/tools/llvm-dwarfdump/SectionSizes.cpp @@ -0,0 +1,121 @@ +//===-- SectionSizes.cpp - Debug section sizes ----------------------------===// +// +// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. +// See https://llvm.org/LICENSE.txt for license information. +// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception +// +//===----------------------------------------------------------------------===// + +#include "llvm/DebugInfo/DIContext.h" +#include "llvm/DebugInfo/DWARF/DWARFContext.h" +#include "llvm/Object/ObjectFile.h" +#include "llvm/Support/WithColor.h" + +#include + +#define DEBUG_TYPE "dwarfdump" +using namespace llvm; +using namespace object; + +using SectionSizeMap = std::map; + +/// Holds cumulative section sizes for an object file. +struct SectionSizes { + /// Map of .debug section names and their sizes across all such-named + /// sections. + SectionSizeMap DebugSectionSizes; + /// Total number of bytes of all sections. + uint64_t TotalObjectSize = 0; + /// Total number of bytes of all debug sections. + uint64_t TotalDebugSectionsSize = 0; +}; + +static size_t getMaxSectionNameWidth(const SectionSizes &Sizes) { + // The minimum column length should be the size of "SECTION" plus 2. + size_t MaxWidth = 9; + for (const auto &DebugSec : Sizes.DebugSectionSizes) { + StringRef SectionName = DebugSec.first; + MaxWidth = std::max(MaxWidth, SectionName.size()); + } + return MaxWidth; +} + +static void prettyPrintSectionSizes(const ObjectFile &Obj, + const SectionSizes &Sizes, + raw_ostream &OS) { + size_t MaxSectionWidth = getMaxSectionNameWidth(Sizes); + + OS << "----------------------------------------------------" + << "\n"; + OS << " SECTION"; + for (unsigned i = 0; i < MaxSectionWidth + 2; i++) + OS << " "; + + OS << "SIZE\n"; + + for (unsigned i = 0; i < MaxSectionWidth + 2; i++) + OS << "-"; + OS << " -----------------------\n"; + + for (const auto &DebugSec : Sizes.DebugSectionSizes) { + OS << " " << left_justify(DebugSec.first, MaxSectionWidth) << " " + << format_decimal(DebugSec.second, 12) << " (" + << format("%0.2f", DebugSec.second / (double)Sizes.TotalObjectSize * 100) + << "%)\n"; + } + OS << "\n"; + OS << " Total Size: " << Sizes.TotalDebugSectionsSize << " (" + << format("%0.2f", Sizes.TotalDebugSectionsSize / + (double)Sizes.TotalObjectSize * 100) + << "%)\n"; + OS << " Total File Size: " << Sizes.TotalObjectSize << "\n"; + OS << "----------------------------------------------------" + << "\n"; +} + +static bool isDebugSection(StringRef SectionName) { + return SectionName.startswith(".debug") || + SectionName.startswith("__debug") || + SectionName.startswith(".zdebug") || + SectionName.startswith("__zdebug") || SectionName == ".gdb_index" || + SectionName == "__gdb_index"; +} + +static void calculateSizes(const ObjectFile &Obj, SectionSizes &Sizes, + const Twine &Filename) { + // Get total size. + Sizes.TotalObjectSize = Obj.getData().size(); + + for (const SectionRef &Section : Obj.sections()) { + StringRef SectionName; + if (Expected NameOrErr = Section.getName()) + SectionName = *NameOrErr; + else + WithColor::defaultWarningHandler( + createFileError(Filename, NameOrErr.takeError())); + + LLVM_DEBUG(dbgs() << SectionName.str() << ": " << Section.getSize() + << "\n"); + + if (!isDebugSection(SectionName)) + continue; + + Sizes.TotalDebugSectionsSize += Section.getSize(); + Sizes.DebugSectionSizes[SectionName] += Section.getSize(); + } +} + +bool collectObjectSectionSizes(ObjectFile &Obj, DWARFContext & /*DICtx*/, + const Twine &Filename, raw_ostream &OS) { + SectionSizes Sizes; + + // Get the section sizes. + calculateSizes(Obj, Sizes, Filename); + + OS << "----------------------------------------------------\n"; + OS << "file: " << Filename.str() << "\n"; + + prettyPrintSectionSizes(Obj, Sizes, OS); + + return true; +} Index: llvm/tools/llvm-dwarfdump/llvm-dwarfdump.cpp =================================================================== --- llvm/tools/llvm-dwarfdump/llvm-dwarfdump.cpp +++ llvm/tools/llvm-dwarfdump/llvm-dwarfdump.cpp @@ -208,6 +208,10 @@ Statistics("statistics", cl::desc("Emit JSON-formatted debug info quality metrics."), cat(DwarfDumpCategory)); +static cl::opt + ShowSectionSizes("show-section-sizes", + cl::desc("Show the sizes of all debug sections."), + cat(DwarfDumpCategory)); static opt Verify("verify", desc("Verify the DWARF debug info."), cat(DwarfDumpCategory)); static opt Quiet("quiet", desc("Use with -verify to not emit to STDOUT."), @@ -413,6 +417,9 @@ bool collectStatsForObjectFile(ObjectFile &Obj, DWARFContext &DICtx, const Twine &Filename, raw_ostream &OS); +bool collectObjectSectionSizes(ObjectFile &Obj, DWARFContext & /*DICtx*/, + const Twine &Filename, raw_ostream &OS); + static bool dumpObjectFile(ObjectFile &Obj, DWARFContext &DICtx, const Twine &Filename, raw_ostream &OS) { logAllUnhandledErrors(DICtx.loadRegisterInfo(Obj), errs(), @@ -638,6 +645,9 @@ } else if (Statistics) for (auto Object : Objects) handleFile(Object, collectStatsForObjectFile, OutputFile.os()); + else if (ShowSectionSizes) + for (auto Object : Objects) + handleFile(Object, collectObjectSectionSizes, OutputFile.os()); else for (auto Object : Objects) handleFile(Object, dumpObjectFile, OutputFile.os());