elftools 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d224322bce7543153f1df63cc56b4c41c57825527f484fd6ff8893c85e939496
-  data.tar.gz: 6ff32495c229e034faabcd026eb47cf05fcdc7d737430075cdb0feb24548ef6b
+  metadata.gz: 37252d63c99fd7133d5abc0fc0e8c8685d3197840eaad1ddee1ba83b36e5dee7
+  data.tar.gz: 7c092256e8b730ba2e58d8dc6f5000024cf88ee8229f71727c5194a358d07bf8
 SHA512:
-  metadata.gz: 46d10fef9a58529af0a3838357f222f009a2b6e466a0a588933eccb182a8df4f785643d2f32909158e14bafb8dce026d3237afe2e5089ffe69a2f1a545a294e7
-  data.tar.gz: 6f4e7af4e07511edc99b0ef49cae2617edddb1a19097082674435a87dcbd471ebcff412525e8a862f1cec5206c1034911985863b7e66ba60cd47b650c099c559
+  metadata.gz: 03ca86ad044a3ed27c1b635f1ad4170a5906f8f3b41b5162934b16784475a3ce3b731b9734665b72803cb293f6eeb8e90cfc703a5b77adebc0b625842d7b3a95
+  data.tar.gz: 44a0470006720e81dfc7096b9cbb076120100db888603cd7107091372b3277d2a0f806089812505d86a0f58f44148e477906289cc49689d21d0ec57950ffee1e

data/lib/elftools/dynamic.rb

@@ -64,6 +64,18 @@ module ELFTools
       each_tags.find { |tag| tag.header.d_tag == type }
     end
 
+    # Get tags of specific type.
+    # @param [Integer, Symbol, String] type
+    #   Constant value, symbol, or string of type
+    #   is acceptable. See examples for more information.
+    # @return [Array<ELFTools::Dynamic::Tag>] The desired tags.
+    #
+    # @see #tag_by_type
+    def tags_by_type(type)
+      type = Util.to_constant(Constants::DT, type)
+      each_tags.select { |tag| tag.header.d_tag == type }
+    end
+
     # Get the +n+-th tag.
     #
     # Tags are lazy loaded.

data/lib/elftools/elf_file.rb

@@ -282,18 +282,15 @@ module ELFTools
     #
     # This method should work no matter ELF is a PIE or not.
     # This method refers from (actually equals to) binutils/readelf.c#offset_from_vma.
-    # @param [Integer] vma The address need query.
-    # @return [Integer] Offset related to file.
+    # @param [Integer] vma The virtual address to be queried.
+    # @return [Integer] Related file offset.
     # @example
     #   elf = ELFTools::ELFFile.new(File.open('/bin/cat'))
     #   elf.offset_from_vma(0x401337)
     #   #=> 4919 # 0x1337
     def offset_from_vma(vma, size = 0)
       segments_by_type(:load) do |seg|
-        if vma >= (seg.header.p_vaddr & -seg.header.p_align) &&
-           vma + size <= seg.header.p_vaddr + seg.header.p_filesz
-          return vma - seg.header.p_vaddr + seg.header.p_offset
-        end
+        return seg.vma_to_offset(vma) if seg.vma_in?(vma, size)
       end
     end
 

data/lib/elftools/segments/load_segment.rb

@@ -0,0 +1,89 @@
+require 'elftools/segments/segment'
+
+module ELFTools
+  module Segments
+    # For DT_LOAD segment.
+    # Able to query between file offset and virtual memory address.
+    class LoadSegment < Segment
+      # Returns the start of this segment.
+      # @return [Integer]
+      #   The file offset.
+      def file_head
+        header.p_offset.to_i
+      end
+
+      # Returns size in file.
+      # @return [Integer]
+      #   The size.
+      def size
+        header.p_filesz.to_i
+      end
+
+      # Returns the end of this segment.
+      # @return [Integer]
+      #   The file offset.
+      def file_tail
+        file_head + size
+      end
+
+      # Returns the start virtual address of this segment.
+      # @return [Integer]
+      #   The vma.
+      def mem_head
+        header.p_vaddr.to_i
+      end
+
+      # Returns size in memory.
+      # @return [Integer]
+      #   The size.
+      def mem_size
+        header.p_memsz.to_i
+      end
+
+      # Returns the end virtual address of this segment.
+      # @return [Integer]
+      #   The vma.
+      def mem_tail
+        mem_head + mem_size
+      end
+
+      # Query if the given file offset located in this segment.
+      # @param [Integer] offset
+      #   File offset.
+      # @param [Integer] size
+      #   Size.
+      # @return [Boolean]
+      def offset_in?(offset, size = 0)
+        file_head <= offset && offset + size < file_tail
+      end
+
+      # Convert file offset into virtual memory address.
+      # @param [Integer] offset
+      #   File offset.
+      # @return [Integer]
+      def offset_to_vma(offset)
+        # XXX: What if file_head is not aligned with p_vaddr (which is invalid according to ELF spec)?
+        offset - file_head + header.p_vaddr
+      end
+
+      # Query if the given virtual memory address located in this segment.
+      # @param [Integer] vma
+      #   Virtual memory address.
+      # @param [Integer] size
+      #   Size.
+      # @return [Boolean]
+      def vma_in?(vma, size = 0)
+        vma >= (header.p_vaddr & -header.p_align) &&
+          vma + size <= mem_tail
+      end
+
+      # Convert virtual memory address into file offset.
+      # @param [Integer] vma
+      #   Virtual memory address.
+      # @return [Integer]
+      def vma_to_offset(vma)
+        vma - header.p_vaddr + header.p_offset
+      end
+    end
+  end
+end

data/lib/elftools/segments/segments.rb

@@ -4,6 +4,7 @@ require 'elftools/segments/segment'
 
 require 'elftools/segments/dynamic_segment'
 require 'elftools/segments/interp_segment'
+require 'elftools/segments/load_segment'
 require 'elftools/segments/note_segment'
 
 module ELFTools
@@ -20,6 +21,7 @@ module ELFTools
         klass = case header.p_type
                 when Constants::PT_DYNAMIC then DynamicSegment
                 when Constants::PT_INTERP then InterpSegment
+                when Constants::PT_LOAD then LoadSegment
                 when Constants::PT_NOTE then NoteSegment
                 else Segment
                 end

data/lib/elftools/version.rb

@@ -1,4 +1,4 @@
 module ELFTools
   # Current gem version
-  VERSION = '1.0.2'.freeze
+  VERSION = '1.1.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elftools
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - david942j
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-25 00:00:00.000000000 Z
+date: 2019-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bindata
@@ -135,6 +135,7 @@ files:
 - lib/elftools/sections/sym_tab_section.rb
 - lib/elftools/segments/dynamic_segment.rb
 - lib/elftools/segments/interp_segment.rb
+- lib/elftools/segments/load_segment.rb
 - lib/elftools/segments/note_segment.rb
 - lib/elftools/segments/segment.rb
 - lib/elftools/segments/segments.rb