dwarves 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2366429fa46c2b680724383a3feacd28b1c242f39784ea1fd2e8c19ccddec915
+  data.tar.gz: e323ad5108096a98bb7ea077a06b01adc1dad48f1633572e5332e72a29f1563b
+SHA512:
+  metadata.gz: 86f2e24147ebc367a44ce84713fa60c11f42ac8212f6f446efbe0b98b63a1a0e43d456745b5228bc75525c51b47b9648c3235ebd4dbd37b7aa94e19b6b82c0b9
+  data.tar.gz: fc49913262a9fc29b4521ee494c04fc9930d12e5b3707499d39140153476345359fbd247e7809e5af6778d071cb88e50f9264a9bc0af74ac3d608d41e8abd660

data/.github/workflows/build.yml

@@ -0,0 +1,40 @@
+name: build
+
+on: [push]
+
+jobs:
+  ruby:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby: [ '2.4.x', '2.5.x', '2.6.x']
+
+    steps:
+    - uses: actions/checkout@v1
+      with:
+        submodules: true
+
+    - name: set up ruby
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+
+    - name: setup bundler
+      run: |
+        gem install bundler
+
+    - name: install
+      run: |
+        ./bin/setup
+
+    - name: test
+      run: |
+        bundle exec rake test
+
+    - name: lint
+      run: |
+        bundle exec rake lint
+
+    - name: doc
+      run: |
+        bundle exec rake doc

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+
+# Cached config
+.rubocop-https-*
+
+tmp/**/*
+
+gems.locked

data/.rubocop.yml

@@ -0,0 +1,15 @@
+# rubocop styles
+
+inherit_from:
+  - https://raw.githubusercontent.com/jethrodaniel/dotfiles/master/home/.config/rubocop/config.yml
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/dwarves/parser/**/*_spec.rb'
+
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/dwarves/parser/*.rb'
+
+Style/ClassAndModuleChildren:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.6.3

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+
+dist: bionic
+
+script: |
+  bundle exec rake spec doc
+
+notifications:
+  email: false

data/.yardopts

@@ -0,0 +1,11 @@
+--markup-provider=redcarpet
+--markup=markdown
+
+lib/**/*.rb
+
+-
+
+LICENSE.txt
+README.md
+doc/**/*.md
+

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Mark Delk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,73 @@
+# dwarves
+
+![](https://github.com/jethrodaniel/dwarves/workflows/build/badge.svg)
+![](https://img.shields.io/github/license/jethrodaniel/dwarves.svg)
+[![Gem Version](https://badge.fury.io/rb/dwarves.svg)](https://badge.fury.io/rb/dwarves)
+
+DWARF parser (only the `.debug_info` section for now) using [parslet][1] and unix utilities.
+
+Source code is avaiable under MIT license at https://github.com/jethrodaniel/dwarves.
+
+---
+
+## What it do
+
+```
+λ readelf --debug-dump=info spec/fixtures/c/build/example.so | dwarves | head -n 15
+
+{
+  :compilation_unit_offset => "0x0"@66,
+                   :length => "0x112"@89,
+             :architecture => "32-bit"@96,
+                  :version => "4"@122,
+            :abbrev_offset => "0x0"@142,
+             :pointer_size => "8"@164,
+                     :dies => [
+    {
+         :nesting_level => "0"@168,
+               :address => "b"@171,
+      :dw_tag_base_type => "1"@190,
+                  :type => "DW_TAG_compile_unit"@193,
+            :attributes => [
+...
+```
+
+## Installation
+
+```
+gem install dwarves
+```
+
+## Development
+
+```
+λ ls bin/
+console  objdump  readelf  setup
+λ rake -T
+rake build            # Build dwarves-0.1.0.gem into the pkg directory
+rake clean            # Remove any temporary products
+rake clobber          # Remove any generated files
+rake doc              # Generates documentation
+rake install          # Build and install dwarves-0.1.0.gem into system gems
+rake install:local    # Build and install dwarves-0.1.0.gem into system gems without network access
+rake lint             # Runs the linter
+rake release[remote]  # Create tag v0.1.0 and build and push dwarves-0.1.0.gem to TODO: Set to 'https://rubygems.org'
+rake test             # Run tests
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/jethrodaniel/dwarves.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Resources
+
+- http://www.dwarfstd.org/doc/Debugging%20using%20DWARF-2012.pdf
+- http://dwarfstd.org/
+- http://dwarfstd.org/doc/DWARF4.pdf
+- http://dwarfstd.org/doc/DWARF5.pdf
+
+[1]: https://github.com/kschiess/parslet

data/bin/console

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "dwarves"
+
+require "pry"
+
+Pry.start

data/bin/objdump

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+set -x
+
+objdump --dwarf=info "$1"

data/bin/readelf

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+set -x
+
+readelf --debug-dump=info "$1"

data/bin/setup

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+set -x
+
+cd spec/fixtures/c && make
+
+bundle install --path .bundle

data/dwarves.gemspec

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative "lib/dwarves/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "dwarves"
+  spec.version       = Dwarves::VERSION
+  spec.authors       = ["Mark Delk"]
+  spec.email         = ["jethrodaniel@gmail.com"]
+
+  spec.summary       = <<~MSG
+    DWARF parser (only the `.debug_info` section for now).
+  MSG
+  spec.homepage      = "https://github.com/jethrodaniel/dwarves"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new ">= 2.3.0"
+
+  spec.metadata = {
+    "allowed_push_host" => "https://rubygems.org",
+    "homepage_uri"      => spec.homepage,
+    "source_code_uri"   => spec.homepage
+  }
+
+  # Specify which files should be added to the gem when it is released.  The
+  # `git ls-files -z` loads the files in the RubyGem that have been added into
+  # git.
+  spec.files = Dir.chdir(File.expand_path __dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match %r{^(test|spec|features)/}
+    end
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename f }
+  spec.require_paths = ["lib"]
+
+  {
+    "awesome_print" => "~> 1.8",
+    "parslet"       => "~> 1.8"
+  }.each do |gem, version|
+    spec.add_dependency gem, version
+  end
+
+  {
+    "bundler"            => "~> 2.0",
+    "minitest-reporters" => "~> 1.3",
+    "pry"                => "~> 0.12.2",
+    "pry-byebug"         => "~> 3.7",
+    "pry-doc"            => "~> 1.0",
+    "rake"               => "~> 12.3",
+    "rubocop"            => "~> 0.72.0",
+    "redcarpet"          => "~> 3.4"
+  }.each do |gem, version|
+    spec.add_development_dependency gem, version
+  end
+end

data/exe/dwarves

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+
+require "awesome_print"
+
+require_relative "../lib/dwarves"
+
+options = {
+  json: false,
+  transform: false
+}
+
+OptionParser.new do |opts|
+  opts.banner = <<~MSG
+    Usage: dwarves [options]... [file]...
+  MSG
+
+  opts.on "-h", "--help", "print this help" do
+    puts opts
+    exit
+  end
+
+  opts.on "-v", "--version", "show the version" do
+    puts Dwarves::VERSION
+    exit
+  end
+
+  opts.on "-j", "--json", "output results in JSON" do
+    options[:transform] = true
+    options[:json] = true
+  end
+
+  opts.on "-t", "--transform", "transform the parser output" do
+    options[:transform] = true
+  end
+end.parse!
+
+begin
+  tree = Dwarves::Parser[4].new.parse ARGF.read
+
+  tree = Dwarves::Parser[4].new.apply tree if options[:transform]
+
+  ap tree, indent: 2, index: false
+rescue Parslet::ParseFailed => e
+  puts e.parse_failure_cause.ascii_tree
+end

data/gems.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec

data/lib/dwarves.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "dwarves/version"
+require "dwarves/parser"
+
+# dwarves is a DWARF parser (at least for the `.debug_info` section).
+#
+# @todo add example
+#
+module Dwarves
+  class Error < StandardError; end
+end

data/lib/dwarves/parser.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "dwarves/parser/basic_rules"
+require "dwarves/parser/4"
+
+module Dwarves
+  # Base parser, delegates the actual parsing to versioned classes.
+  module Parser
+    # A parser error
+    class Error < StandardError; end
+
+    # Get a versioned parser.
+    #
+    # @example
+    #   v4 = Dwarves::Parser[4].new
+    #
+    # @param version [Integer] which version of DWARF to use
+    # @return [Subclass of Dwarves::Parser] the versioned subclass
+    #
+    def self.[] version
+      raise Error, "Unsupported DWARF version!" unless version == 4
+
+      V4
+    end
+  end
+end

data/lib/dwarves/parser/4.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "parslet"
+require "dwarves/parser/4/parser"
+require "dwarves/parser/4/transformer"
+
+module Dwarves
+  module Parser
+    # Parser to handle DWARF 4 format outputed by the following
+    #
+    # - `readelf --debug-dump=info`
+    # - `objdump --dwarf=info`
+    #
+    class V4
+      # @return [Hash] the parsed DWARF output
+      def parse input
+        V4Parser.new.parse input
+      end
+
+      def apply input
+        V4Transformer.new.apply input
+      end
+    end
+  end
+end

data/lib/dwarves/parser/4/parser.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+require "parslet"
+
+module Dwarves
+  module Parser
+    class V4Parser < Parslet::Parser
+      include Parser::BasicRules
+
+      # @!method root
+      root :input
+
+      # @!method input
+      #
+      # The entire input
+      rule :input do
+        prelude >> die.repeat.as(:dies) >> ending
+      end
+
+      # @!method prelude_header
+      #
+      # The very beginning of input.
+      #
+      # @example
+      #   contents of the .debug_info section:
+      #
+      # @example
+      #   tmp/everything.so:     file format elf64-x86-64
+      #
+      #   contents of the .debug_info section:
+      #
+      rule :prelude_header do
+        readelf =
+          str("Contents of the .debug_info section:") >>
+          newline >>
+          _
+
+        objdump =
+          filename >> _ >> str("file format") >> _ >> format >>
+          newline >>
+          _ >> str("Contents of the .debug_info section:") >>
+          newline >>
+          _
+
+        readelf | objdump
+      end
+
+      # @!method prelude
+      #
+      # @example
+      #
+      #   contents of the .debug_info section:
+      #
+      #     Compilation Unit @ offset 0x0:
+      #      Length:        0xf8 (32-bit)
+      #      Version:       4
+      #      Abbrev Offset: 0x0
+      #      Pointer Size:  8
+      #
+      # @todo convert numeric string results to numeric values
+      #
+      rule :prelude do
+        prelude_header >>
+          str("Compilation Unit @ offset ") >>
+          hexadecimal.as(:compilation_unit_offset) >> colon >>
+          newline >>
+          _ >> str("Length:") >> _ >> hexadecimal.as(:length) >> _ >>
+          str("(") >> arch.as(:architecture) >> str(")") >>
+          newline >>
+          _ >> str("Version:") >> _ >> integer.as(:version) >>
+          newline >>
+          _ >> str("Abbrev Offset:") >> _ >> hexadecimal.as(:abbrev_offset) >>
+          newline >>
+          _ >> str("Pointer Size:") >> _ >> integer.as(:pointer_size) >>
+          newline
+      end
+
+      # @!method arch
+      #
+      # @example
+      #   32-bit
+      #
+      # @example
+      #   64-bit
+      #
+      rule(:arch) { digit.repeat >> str("-bit") }
+
+      # @!method format
+      #
+      # @example
+      #   elf64-x86-64
+      #
+      rule(:format) { filename }
+
+      # @!method die_header
+      #
+      #  @example
+      #    <0><b>: Abbrev Number: 1 (DW_TAG_compile_unit)
+      #
+      #  @example
+      #    <3><b8>: Abbrev Number: 0
+      #
+      rule :die_header do
+        _ >>
+          str("<") >>
+          integer.as(:nesting_level) >>
+          str(">") >>
+          str("<") >>
+          word.as(:address) >>
+          str(">") >>
+          str(": Abbrev Number: ") >>
+          integer.as(:dw_tag_base_type) >>
+          (
+            _ >>
+            str("(") >>
+            words.as(:type) >>
+            str(")")
+          ).maybe >>
+          newline
+      end
+
+      # @!method die_body
+      #
+      # @example
+      #   <1><2d>: Abbrev Number: 2 (DW_TAG_base_type)
+      #      <2e>   DW_AT_byte_size   : 4
+      #      <2f>   DW_AT_encoding    : 5  (signed)
+      #      <30>   DW_AT_name        : int
+      #
+      rule(:die_body) { attribute.repeat.as :attributes }
+
+      # @!method attribute
+      #
+      # @example
+      #   <30>   DW_AT_name        : int
+      #
+      rule :attribute do
+        _ >>
+          str("<") >>
+          word.as(:order) >>
+          str(">") >>
+          _ >>
+          word.as(:name) >>
+          _ >>
+          colon >>
+          _ >>
+          (newline.absent? >> any).repeat.as(:description) >>
+          newline
+      end
+
+      # @!method die
+      rule(:die) { die_header >> die_body.maybe }
+
+      # @!method ending
+      rule(:ending) { any.repeat }
+    end
+  end
+end

data/lib/dwarves/parser/4/transformer.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "parslet"
+
+module Dwarves
+  module Parser
+    # Transformer to turn the parser output into meaningful classes
+    #
+    class V4Transformer < Parslet::Transform
+    end
+  end
+end

data/lib/dwarves/parser/basic_rules.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require "parslet"
+
+module Dwarves
+  module Parser
+    # Shared rules common to many parsers.
+    #
+    # These can be directly included in your parser class, like so
+    #
+    # @example
+    #   class SomeParser < Parslet::Parser
+    #     include Dwarves::Parser::BasicRules
+    #
+    #     # ...
+    #   end
+    #
+    module BasicRules
+      include Parslet
+
+      # @!method colon
+      rule(:colon) { str ":" }
+
+      # @!method space
+      rule(:space) { match('\s').repeat 1 }
+
+      # @!method space?
+      rule(:space?) { space.maybe }
+
+      # @!method newline
+      rule(:newline) { match('\n').repeat 1 }
+
+      # @!method newlines
+      rule(:newlines) { newline.repeat }
+
+      # @!method separator
+      rule(:separator) { space? | space }
+
+      alias _ separator
+
+      # @!method digit
+      rule(:digit) { match("[0-9]").repeat 1 }
+
+      # @!method integer
+      rule(:integer) { digit.repeat }
+
+      # @!method word
+      rule(:word) { match('[a-zA-Z\._0-9]').repeat 1 }
+
+      # @!method words
+      rule(:words) { word >> (separator >> word).repeat }
+
+      # @!method lparen
+      rule(:lparen) { str "(" }
+
+      # @!method rparen
+      rule(:rparen) { str ")" }
+
+      # @!method semicolon
+      rule(:semicolon) { str ";" }
+
+      # @!method hexadecimal
+      rule :hexadecimal do
+        str("0x") >> (match("[a-f]") | match("[0-9]")).repeat
+      end
+
+      # @!method filename
+      rule :filename do
+        match('[^\s]').repeat
+      end
+    end
+  end
+end

data/lib/dwarves/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Dwarves
+  VERSION = "0.1.0"
+end

data/rakefile.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rake/clean"
+require "yard"
+
+CLEAN << FileList.new("doc/*") do |list|
+  list.exclude /.*\.md/
+  list.include "tmp/*"
+end
+
+Rake::TestTask.new :test do |t|
+  t.libs << "lib"
+  t.libs << "spec"
+  t.test_files = FileList["spec/**/*_spec.rb"]
+  # Supress `circular require` error messages from minitest
+  t.warning = false
+end
+
+task spec: :test
+task default: :spec
+
+desc "Runs the linter"
+task :lint do
+  sh "bundle exec rubocop"
+end
+
+desc "Generates documentation"
+task :doc do
+  sh "bundle exec yard"
+end

metadata

@@ -0,0 +1,210 @@
+--- !ruby/object:Gem::Specification
+name: dwarves
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mark Delk
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-11-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: parslet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.2
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: pry-doc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.72.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.72.0
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+description: 
+email:
+- jethrodaniel@gmail.com
+executables:
+- dwarves
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/build.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".travis.yml"
+- ".yardopts"
+- LICENSE.txt
+- README.md
+- bin/console
+- bin/objdump
+- bin/readelf
+- bin/setup
+- dwarves.gemspec
+- exe/dwarves
+- gems.rb
+- lib/dwarves.rb
+- lib/dwarves/parser.rb
+- lib/dwarves/parser/4.rb
+- lib/dwarves/parser/4/parser.rb
+- lib/dwarves/parser/4/transformer.rb
+- lib/dwarves/parser/basic_rules.rb
+- lib/dwarves/version.rb
+- rakefile.rb
+homepage: https://github.com/jethrodaniel/dwarves
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/jethrodaniel/dwarves
+  source_code_uri: https://github.com/jethrodaniel/dwarves
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: DWARF parser (only the `.debug_info` section for now).
+test_files: []