elftools 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 19ea6d2a816767e47ee17390784085a33e1fe331
-  data.tar.gz: f4af2d0e5552c02ee43d4de74afecd077926532d
+SHA256:
+  metadata.gz: d224322bce7543153f1df63cc56b4c41c57825527f484fd6ff8893c85e939496
+  data.tar.gz: 6ff32495c229e034faabcd026eb47cf05fcdc7d737430075cdb0feb24548ef6b
 SHA512:
-  metadata.gz: a368bc9ee554c9ca775d8e2d51b121965d242f64d2b2a838d249a3914d0d91ece6a3469c36519fa9fdd5d1347f2ff291917adf43e39f488509f29faac5348eda
-  data.tar.gz: 8d777854fc6d4f931452aa0e738202496dd9dd7ce01b22e25da1cf40e1e4839f944cdd95de99e5a88cea85fab2eb611859379b5dc78180a4d0ff42ea835c1f13
+  metadata.gz: 46d10fef9a58529af0a3838357f222f009a2b6e466a0a588933eccb182a8df4f785643d2f32909158e14bafb8dce026d3237afe2e5089ffe69a2f1a545a294e7
+  data.tar.gz: 6f4e7af4e07511edc99b0ef49cae2617edddb1a19097082674435a87dcbd471ebcff412525e8a862f1cec5206c1034911985863b7e66ba60cd47b650c099c559

data/lib/elftools/constants.rb

@@ -6,49 +6,42 @@ module ELFTools
     # ELF magic header
     ELFMAG = "\x7FELF".freeze
 
-    # Section header types, records in +sh_type+.
-    module SHT
-      SHT_NULL     = 0 # null section
-      SHT_PROGBITS = 1 # information defined by program itself
-      SHT_SYMTAB   = 2 # symbol table section
-      SHT_STRTAB   = 3 # string table section
-      SHT_RELA     = 4 # relocation with addends
-      SHT_HASH     = 5 # symbol hash table
-      SHT_DYNAMIC  = 6 # information of dynamic linking
-      SHT_NOTE     = 7 # note section
-      SHT_NOBITS   = 8 # section occupies no space
-      SHT_REL      = 9 # relocation
-      SHT_SHLIB    = 10 # reserved
-      SHT_DYNSYM   = 11 # symbols for dynamic
-      # Values between {SHT_LOPROC} and {SHT_HIPROC} are reserved for processor-specific semantics.
-      SHT_LOPROC   = 0x70000000
-      SHT_HIPROC   = 0x7fffffff # see {SHT_LOPROC}
-      # Values between {SHT_LOUSER} and {SHT_HIUSER} are reserved for application programs.
-      SHT_LOUSER   = 0x80000000
-      SHT_HIUSER   = 0xffffffff # see {SHT_LOUSER}
-    end
-    include SHT
+    # Values of `d_un.d_val' in the DT_FLAGS and DT_FLAGS_1 entry.
+    module DF
+      DF_ORIGIN       = 0x00000001 # Object may use DF_ORIGIN
+      DF_SYMBOLIC     = 0x00000002 # Symbol resolutions starts here
+      DF_TEXTREL      = 0x00000004 # Object contains text relocations
+      DF_BIND_NOW     = 0x00000008 # No lazy binding for this object
+      DF_STATIC_TLS   = 0x00000010 # Module uses the static TLS model
 
-    # Program header types, records in +p_type+.
-    module PT
-      PT_NULL         = 0          # null segment
-      PT_LOAD         = 1          # segment to be load
-      PT_DYNAMIC      = 2          # dynamic tags
-      PT_INTERP       = 3          # interpreter, same as .interp section
-      PT_NOTE         = 4          # same as .note* section
-      PT_SHLIB        = 5          # reserved
-      PT_PHDR         = 6          # where program header starts
-      PT_TLS          = 7          # thread local storage segment
-      PT_LOOS         = 0x60000000 # OS-specific
-      PT_HIOS         = 0x6fffffff # OS-specific
-      # Values between {PT_LOPROC} and {PT_HIPROC} are reserved for processor-specific semantics.
-      PT_LOPROC       = 0x70000000
-      PT_HIPROC       = 0x7fffffff # see {PT_LOPROC}
-      PT_GNU_EH_FRAME = 0x6474e550 # for exception handler
-      PT_GNU_STACK    = 0x6474e551 # permission of stack
-      PT_GNU_RELRO    = 0x6474e552 # read only after relocation
+      DF_1_NOW        = 0x00000001 # Set RTLD_NOW for this object.
+      DF_1_GLOBAL     = 0x00000002 # Set RTLD_GLOBAL for this object.
+      DF_1_GROUP      = 0x00000004 # Set RTLD_GROUP for this object.
+      DF_1_NODELETE   = 0x00000008 # Set RTLD_NODELETE for this object.
+      DF_1_LOADFLTR   = 0x00000010 # Trigger filtee loading at runtime.
+      DF_1_INITFIRST  = 0x00000020 # Set RTLD_INITFIRST for this object
+      DF_1_NOOPEN     = 0x00000040 # Set RTLD_NOOPEN for this object.
+      DF_1_ORIGIN     = 0x00000080 # $ORIGIN must be handled.
+      DF_1_DIRECT     = 0x00000100 # Direct binding enabled.
+      DF_1_TRANS      = 0x00000200 # :nodoc:
+      DF_1_INTERPOSE  = 0x00000400 # Object is used to interpose.
+      DF_1_NODEFLIB   = 0x00000800 # Ignore default lib search path.
+      DF_1_NODUMP     = 0x00001000 # Object can't be dldump'ed.
+      DF_1_CONFALT    = 0x00002000 # Configuration alternative created.
+      DF_1_ENDFILTEE  = 0x00004000 # Filtee terminates filters search.
+      DF_1_DISPRELDNE = 0x00008000 # Disp reloc applied at build time.
+      DF_1_DISPRELPND = 0x00010000 # Disp reloc applied at run-time.
+      DF_1_NODIRECT   = 0x00020000 # Object has no-direct binding.
+      DF_1_IGNMULDEF  = 0x00040000 # :nodoc:
+      DF_1_NOKSYMS    = 0x00080000 # :nodoc:
+      DF_1_NOHDR      = 0x00100000 # :nodoc:
+      DF_1_EDITED     = 0x00200000 # Object is modified after built.
+      DF_1_NORELOC    = 0x00400000 # :nodoc:
+      DF_1_SYMINTPOSE = 0x00800000 # Object has individual interposers.
+      DF_1_GLOBAUDIT  = 0x01000000 # Global auditing required.
+      DF_1_SINGLETON  = 0x02000000 # Singleton symbols are used.
     end
-    include PT
+    include DF
 
     # Dynamic table types, records in +d_tag+.
     module DT
@@ -107,43 +100,6 @@ module ELFTools
     end
     include DT
 
-    # Values of `d_un.d_val' in the DT_FLAGS and DT_FLAGS_1 entry.
-    module DF
-      DF_ORIGIN       = 0x00000001 # Object may use DF_ORIGIN
-      DF_SYMBOLIC     = 0x00000002 # Symbol resolutions starts here
-      DF_TEXTREL      = 0x00000004 # Object contains text relocations
-      DF_BIND_NOW     = 0x00000008 # No lazy binding for this object
-      DF_STATIC_TLS   = 0x00000010 # Module uses the static TLS model
-
-      DF_1_NOW        = 0x00000001 # Set RTLD_NOW for this object.
-      DF_1_GLOBAL     = 0x00000002 # Set RTLD_GLOBAL for this object.
-      DF_1_GROUP      = 0x00000004 # Set RTLD_GROUP for this object.
-      DF_1_NODELETE   = 0x00000008 # Set RTLD_NODELETE for this object.
-      DF_1_LOADFLTR   = 0x00000010 # Trigger filtee loading at runtime.
-      DF_1_INITFIRST  = 0x00000020 # Set RTLD_INITFIRST for this object
-      DF_1_NOOPEN     = 0x00000040 # Set RTLD_NOOPEN for this object.
-      DF_1_ORIGIN     = 0x00000080 # $ORIGIN must be handled.
-      DF_1_DIRECT     = 0x00000100 # Direct binding enabled.
-      DF_1_TRANS      = 0x00000200 # :nodoc:
-      DF_1_INTERPOSE  = 0x00000400 # Object is used to interpose.
-      DF_1_NODEFLIB   = 0x00000800 # Ignore default lib search path.
-      DF_1_NODUMP     = 0x00001000 # Object can't be dldump'ed.
-      DF_1_CONFALT    = 0x00002000 # Configuration alternative created.
-      DF_1_ENDFILTEE  = 0x00004000 # Filtee terminates filters search.
-      DF_1_DISPRELDNE = 0x00008000 # Disp reloc applied at build time.
-      DF_1_DISPRELPND = 0x00010000 # Disp reloc applied at run-time.
-      DF_1_NODIRECT   = 0x00020000 # Object has no-direct binding.
-      DF_1_IGNMULDEF  = 0x00040000 # :nodoc:
-      DF_1_NOKSYMS    = 0x00080000 # :nodoc:
-      DF_1_NOHDR      = 0x00100000 # :nodoc:
-      DF_1_EDITED     = 0x00200000 # Object is modified after built.
-      DF_1_NORELOC    = 0x00400000 # :nodoc:
-      DF_1_SYMINTPOSE = 0x00800000 # Object has individual interposers.
-      DF_1_GLOBAUDIT  = 0x01000000 # Global auditing required.
-      DF_1_SINGLETON  = 0x02000000 # Singleton symbols are used.
-    end
-    include DF
-
     # These constants define the various ELF target machines.
     module EM
       EM_NONE           = 0      # none
@@ -253,5 +209,93 @@ module ELFTools
       end
     end
     include ET
+
+    # Program header types, records in +p_type+.
+    module PT
+      PT_NULL         = 0          # null segment
+      PT_LOAD         = 1          # segment to be load
+      PT_DYNAMIC      = 2          # dynamic tags
+      PT_INTERP       = 3          # interpreter, same as .interp section
+      PT_NOTE         = 4          # same as .note* section
+      PT_SHLIB        = 5          # reserved
+      PT_PHDR         = 6          # where program header starts
+      PT_TLS          = 7          # thread local storage segment
+      PT_LOOS         = 0x60000000 # OS-specific
+      PT_HIOS         = 0x6fffffff # OS-specific
+      # Values between {PT_LOPROC} and {PT_HIPROC} are reserved for processor-specific semantics.
+      PT_LOPROC       = 0x70000000
+      PT_HIPROC       = 0x7fffffff # see {PT_LOPROC}
+      PT_GNU_EH_FRAME = 0x6474e550 # for exception handler
+      PT_GNU_STACK    = 0x6474e551 # permission of stack
+      PT_GNU_RELRO    = 0x6474e552 # read only after relocation
+    end
+    include PT
+
+    # Section header types, records in +sh_type+.
+    module SHT
+      SHT_NULL     = 0 # null section
+      SHT_PROGBITS = 1 # information defined by program itself
+      SHT_SYMTAB   = 2 # symbol table section
+      SHT_STRTAB   = 3 # string table section
+      SHT_RELA     = 4 # relocation with addends
+      SHT_HASH     = 5 # symbol hash table
+      SHT_DYNAMIC  = 6 # information of dynamic linking
+      SHT_NOTE     = 7 # note section
+      SHT_NOBITS   = 8 # section occupies no space
+      SHT_REL      = 9 # relocation
+      SHT_SHLIB    = 10 # reserved
+      SHT_DYNSYM   = 11 # symbols for dynamic
+      # Values between {SHT_LOPROC} and {SHT_HIPROC} are reserved for processor-specific semantics.
+      SHT_LOPROC   = 0x70000000
+      SHT_HIPROC   = 0x7fffffff # see {SHT_LOPROC}
+      # Values between {SHT_LOUSER} and {SHT_HIUSER} are reserved for application programs.
+      SHT_LOUSER   = 0x80000000
+      SHT_HIUSER   = 0xffffffff # see {SHT_LOUSER}
+    end
+    include SHT
+
+    # Symbol binding from Sym st_info field.
+    module STB
+      STB_LOCAL      = 0 # Local symbol
+      STB_GLOBAL     = 1 # Global symbol
+      STB_WEAK       = 2 # Weak symbol
+      STB_NUM        = 3 # Number of defined types.
+      STB_LOOS       = 10 # Start of OS-specific
+      STB_GNU_UNIQUE = 10 # Unique symbol.
+      STB_HIOS       = 12 # End of OS-specific
+      STB_LOPROC     = 13 # Start of processor-specific
+      STB_HIPROC     = 15 # End of processor-specific
+    end
+    include STB
+
+    # Symbol types from Sym st_info field.
+    module STT
+      STT_NOTYPE         = 0 # Symbol type is unspecified
+      STT_OBJECT         = 1 # Symbol is a data object
+      STT_FUNC           = 2 # Symbol is a code object
+      STT_SECTION        = 3 # Symbol associated with a section
+      STT_FILE           = 4 # Symbol's name is file name
+      STT_COMMON         = 5 # Symbol is a common data object
+      STT_TLS            = 6 # Symbol is thread-local data object
+      STT_NUM            = 7 # Number of defined types.
+
+      # GNU extension: symbol value points to a function which is called
+      # at runtime to determine the final value of the symbol.
+      STT_GNU_IFUNC      = 10
+
+      STT_LOOS           = 10 # Start of OS-specific
+      STT_HIOS           = 12 # End of OS-specific
+      STT_LOPROC         = 13 # Start of processor-specific
+      STT_HIPROC         = 15 # End of processor-specific
+
+      # The section type that must be used for register symbols on
+      # Sparc. These symbols initialize a global register.
+      STT_SPARC_REGISTER = 13
+
+      # ARM: a THUMB function. This is not defined in ARM ELF Specification but
+      # used by the GNU tool-chain.
+      STT_ARM_TFUNC      = 13
+    end
+    include STT
   end
 end

data/lib/elftools/dynamic.rb

@@ -18,6 +18,7 @@ module ELFTools
     #   Otherwise, return array of tags.
     def each_tags(&block)
       return enum_for(:each_tags) unless block_given?
+
       arr = []
       0.step do |i|
         tag = tag_at(i).tap(&block)
@@ -31,7 +32,7 @@ module ELFTools
     # @return [Array<ELFTools::Dynamic::Tag>]
     #   Array of tags.
     def tags
-      each_tags.to_a
+      @tags ||= each_tags.to_a
     end
 
     # Get a tag of specific type.
@@ -77,8 +78,10 @@ module ELFTools
     # @return [ELFTools::Dynamic::Tag] The desired tag.
     def tag_at(n)
       return if n < 0
+
       @tag_at_map ||= {}
       return @tag_at_map[n] if @tag_at_map[n]
+
       dyn = Structs::ELF_Dyn.new(endian: endian)
       dyn.elf_class = header.elf_class
       stream.pos = tag_start + n * dyn.num_bytes
@@ -153,6 +156,7 @@ module ELFTools
       # @return [String, nil] The name.
       def name
         return nil unless name?
+
         Util.cstring(stream, @str_offset.call + header.d_val.to_i)
       end
     end

data/lib/elftools/elf_file.rb

@@ -32,6 +32,7 @@ module ELFTools
     # @return [ELFTools::Structs::ELF_Ehdr] The header.
     def header
       return @header if defined?(@header)
+
       stream.pos = 0
       @header = Structs::ELF_Ehdr.new(endian: endian, offset: stream.pos)
       @header.elf_class = elf_class
@@ -49,8 +50,10 @@ module ELFTools
     def build_id
       section = section_by_name('.note.gnu.build-id')
       return nil if section.nil?
+
       note = section.notes.first
       return nil if note.nil?
+
       note.desc.unpack('H*').first
     end
 
@@ -116,6 +119,7 @@ module ELFTools
     #   otherwise, the whole sections will be returned.
     def each_sections(&block)
       return enum_for(:each_sections) unless block_given?
+
       Array.new(num_sections) do |i|
         section_at(i).tap(&block)
       end
@@ -188,6 +192,7 @@ module ELFTools
     #   Whole segments will be returned.
     def each_segments(&block)
       return enum_for(:each_segments) unless block_given?
+
       Array.new(num_segments) do |i|
         segment_at(i).tap(&block)
       end
@@ -324,6 +329,7 @@ module ELFTools
       explore = lambda do |obj|
         return obj if obj.is_a?(::ELFTools::Structs::ELFStruct)
         return obj.map(&explore) if obj.is_a?(Array)
+
         obj.instance_variables.map do |s|
           explore.call(obj.instance_variable_get(s))
         end
@@ -335,12 +341,14 @@ module ELFTools
       stream.pos = 0
       magic = stream.read(4)
       raise ELFError, "Invalid magic number #{magic.inspect}" unless magic == Constants::ELFMAG
+
       ei_class = stream.read(1).ord
       @elf_class = {
         1 => 32,
         2 => 64
       }[ei_class]
       raise ELFError, format('Invalid EI_CLASS "\x%02x"', ei_class) if elf_class.nil?
+
       ei_data = stream.read(1).ord
       @endian = {
         1 => :little,

data/lib/elftools/lazy_array.rb

@@ -38,6 +38,7 @@ module ELFTools
     def [](i)
       # XXX: support negative index?
       return nil if i < 0 || i >= @internal.size
+
       @internal[i] ||= @block.call(i)
     end
   end

data/lib/elftools/note.rb

@@ -41,6 +41,7 @@ module ELFTools
     #   Otherwise, return the array of notes.
     def each_notes
       return enum_for(:each_notes) unless block_given?
+
       @notes_offset_map ||= {}
       cur = note_start
       notes = []
@@ -101,6 +102,7 @@ module ELFTools
       # @return [String] The name.
       def name
         return @name if @name
+
         stream.pos = @offset + SIZE_OF_NHDR
         @name = stream.read(header.n_namesz)[0..-2]
       end
@@ -108,7 +110,8 @@ module ELFTools
       # Description of this note.
       # @return [String] The description.
       def desc
-        return @desc if @desc
+        return @desc if instance_variable_defined?(:@desc)
+
         stream.pos = @offset + SIZE_OF_NHDR + Util.align(header.n_namesz, 2)
         @desc = stream.read(header.n_descsz)
       end

data/lib/elftools/sections/relocation_section.rb

@@ -42,6 +42,7 @@ module ELFTools
       #   Otherwise, the whole relocations will be returned.
       def each_relocations(&block)
         return enum_for(:each_relocations) unless block_given?
+
         Array.new(num_relocations) do |i|
           relocation_at(i).tap(&block)
         end

data/lib/elftools/sections/sym_tab_section.rb

@@ -56,6 +56,7 @@ module ELFTools
       #   Otherwise return array of symbols.
       def each_symbols(&block)
         return enum_for(:each_symbols) unless block_given?
+
         Array.new(num_symbols) do |i|
           symbol_at(i).tap(&block)
         end

data/lib/elftools/structs.rb

@@ -54,6 +54,7 @@ module ELFTools
         # @return [String]
         def pack(val, bytes)
           raise ArgumentError, "Not supported assign type #{val.class}" unless val.is_a?(Integer)
+
           number = val & ((1 << (8 * bytes)) - 1)
           out = []
           bytes.times do

data/lib/elftools/util.rb

@@ -17,6 +17,7 @@ module ELFTools
       def align(num, bit)
         n = 2**bit
         return num if (num % n).zero?
+
         (num + n) & ~(n - 1)
       end
 
@@ -36,6 +37,7 @@ module ELFTools
         # if val is an integer, check if exists in mod
         if val.is_a?(Integer)
           return val if mod.constants.any? { |c| mod.const_get(c) == val }
+
           raise ArgumentError, "No constants in #{module_name} is #{val}"
         end
         val = val.to_s.upcase
@@ -43,6 +45,7 @@ module ELFTools
         val = prefix + '_' + val unless val.start_with?(prefix)
         val = val.to_sym
         raise ArgumentError, "No constants in #{module_name} named \"#{val}\"" unless mod.const_defined?(val)
+
         mod.const_get(val)
       end
 
@@ -61,6 +64,7 @@ module ELFTools
           c = stream.read(1)
           return nil if c.nil? # reach EOF
           break if c == "\x00"
+
           ret += c
         end
         ret

data/lib/elftools/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elftools
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - david942j
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-10-03 00:00:00.000000000 Z
+date: 2018-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bindata
@@ -24,20 +24,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2'
-- !ruby/object:Gem::Dependency
-  name: codeclimate-test-reporter
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -72,42 +58,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '3.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '3.7'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.47'
+        version: '0.59'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.47'
+        version: '0.59'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.13.0
+        version: 0.16.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.13.0
+        version: 0.16.1
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -175,7 +161,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: ELFTools - Pure ruby library for parsing and patching ELF files