Module: ELFShim Private
- Included in:
- Pathname
- Defined in:
- os/linux/elf.rb,
os/linux/elf.rbi
This module is part of a private API. This module may only be used in the Homebrew/brew repository. Third parties should avoid using this module if possible, as it may be removed or changed without warning.
Instance Method Summary collapse
- #arch ⇒ Object private
- #binary_executable? ⇒ Boolean private
- #dylib? ⇒ Boolean private
- #dylib_id ⇒ Object private
- #dynamic_elf? ⇒ Boolean private
- #dynamically_linked_libraries ⇒ Object private
- #elf? ⇒ Boolean private
- #elf_type ⇒ Object private
- #interpreter ⇒ Object private
- #patch!(interpreter: nil, rpath: nil) ⇒ Object private
- #patchelf_patcher ⇒ Object private
- #read_uint16(offset) ⇒ Object private
- #read_uint8(offset) ⇒ Object private
-
#rpath ⇒ Object
private
The runtime search path, such as: "/lib:/usr/lib:/usr/local/lib".
- #rpath_using_patchelf_rb ⇒ Object private
-
#rpaths ⇒ Object
private
An array of runtime search path entries, such as: ["/lib", "/usr/lib", "/usr/local/lib"].
- #save_using_patchelf_rb(new_interpreter, new_rpath) ⇒ Object private
Instance Method Details
#arch ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
58 59 60 61 62 63 64 65 66 67 68 69 |
# File 'os/linux/elf.rb', line 58 def arch return :dunno unless elf? @arch ||= case read_uint16(ARCHITECTURE_OFFSET) when ARCHITECTURE_I386 then :i386 when ARCHITECTURE_X86_64 then :x86_64 when ARCHITECTURE_POWERPC then :powerpc when ARCHITECTURE_ARM then :arm when ARCHITECTURE_AARCH64 then :arm64 else :dunno end end |
#binary_executable? ⇒ Boolean
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
85 86 87 |
# File 'os/linux/elf.rb', line 85 def binary_executable? elf_type == :executable end |
#dylib? ⇒ Boolean
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
81 82 83 |
# File 'os/linux/elf.rb', line 81 def dylib? elf_type == :dylib end |
#dylib_id ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
217 218 219 |
# File 'os/linux/elf.rb', line 217 def dylib_id .dylib_id end |
#dynamic_elf? ⇒ Boolean
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
115 116 117 118 119 |
# File 'os/linux/elf.rb', line 115 def dynamic_elf? return @dynamic_elf if defined? @dynamic_elf @dynamic_elf = patchelf_patcher.elf.segment_by_type(:DYNAMIC).present? end |
#dynamically_linked_libraries ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
221 222 223 |
# File 'os/linux/elf.rb', line 221 def dynamically_linked_libraries(*) .dylibs end |
#elf? ⇒ Boolean
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
49 50 51 52 53 54 55 56 |
# File 'os/linux/elf.rb', line 49 def elf? return @elf if defined? @elf return @elf = false if read(MAGIC_NUMBER_ASCII.size, MAGIC_NUMBER_OFFSET) != MAGIC_NUMBER_ASCII # Check that this ELF file is for Linux or System V. # OS_ABI is often set to 0 (System V), regardless of the target platform. @elf = [OS_ABI_LINUX, OS_ABI_SYSTEM_V].include? read_uint8(OS_ABI_OFFSET) end |
#elf_type ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
71 72 73 74 75 76 77 78 79 |
# File 'os/linux/elf.rb', line 71 def elf_type return :dunno unless elf? @elf_type ||= case read_uint16(TYPE_OFFSET) when TYPE_EXECUTABLE then :executable when TYPE_SHARED then :dylib else :dunno end end |
#interpreter ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
103 104 105 106 107 |
# File 'os/linux/elf.rb', line 103 def interpreter return @interpreter if defined? @interpreter @interpreter = patchelf_patcher.interpreter end |
#patch!(interpreter: nil, rpath: nil) ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
109 110 111 112 113 |
# File 'os/linux/elf.rb', line 109 def patch!(interpreter: nil, rpath: nil) return if interpreter.blank? && rpath.blank? save_using_patchelf_rb interpreter, rpath end |
#patchelf_patcher ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
207 208 209 210 |
# File 'os/linux/elf.rb', line 207 def patchelf_patcher require "patchelf" @patchelf_patcher ||= ::PatchELF::Patcher.new to_s, on_error: :silent end |
#read_uint16(offset) ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
45 46 47 |
# File 'os/linux/elf.rb', line 45 def read_uint16(offset) read(2, offset).unpack1("v") end |
#read_uint8(offset) ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
41 42 43 |
# File 'os/linux/elf.rb', line 41 def read_uint8(offset) read(1, offset).unpack1("C") end |
#rpath ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
The runtime search path, such as: "/lib:/usr/lib:/usr/local/lib"
91 92 93 94 95 |
# File 'os/linux/elf.rb', line 91 def rpath return @rpath if defined? @rpath @rpath = rpath_using_patchelf_rb end |
#rpath_using_patchelf_rb ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
203 204 205 |
# File 'os/linux/elf.rb', line 203 def rpath_using_patchelf_rb patchelf_patcher.runpath || patchelf_patcher.rpath end |
#rpaths ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
An array of runtime search path entries, such as: ["/lib", "/usr/lib", "/usr/local/lib"]
99 100 101 |
# File 'os/linux/elf.rb', line 99 def rpaths Array(rpath&.split(":")) end |
#save_using_patchelf_rb(new_interpreter, new_rpath) ⇒ Object
This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.
196 197 198 199 200 201 |
# File 'os/linux/elf.rb', line 196 def save_using_patchelf_rb(new_interpreter, new_rpath) patcher = patchelf_patcher patcher.interpreter = new_interpreter if new_interpreter.present? patcher.rpath = new_rpath if new_rpath.present? patcher.save(patchelf_compatible: true) end |