ruby-macho 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 16240f8ca67e156531a460441d739de7d63fbe9e
-  data.tar.gz: 9a4baa19c7d468ea968a1d0eac8f12941053fcf4
+  metadata.gz: 939f8d565fc3d98bd633414e797b2f8cd70c0df6
+  data.tar.gz: 3ab244e120eba39d1f84a8b495de6c221f4fc8f0
 SHA512:
-  metadata.gz: cbf7d99140e66376e18dfae8efc2e0b1d9d921e4f5ba3813a6cf09f478ec5a6de2a777b6b4b582afcf8427a005d3807c6b72f13862b4d7c0d30c476a8711d547
-  data.tar.gz: f2a8064e9246c8b1d5f671edc830a902023f754458a2cc6a4abed62dde247e698d1b955eff5c9e91f8951e66fe6d095fd6677f8a9a7e45f0c34acb435f2b2ed5
+  metadata.gz: bb2d31798f5d4b6fefd00a2c3e5c562595331015f9a44b9d3b5bcce84b43db3c473236222412bc1b26e358161df2451e15c8ea292c1c0fc433292afc9871772c
+  data.tar.gz: 39bd050a693d85cd48e7ce3594d5cfd199732e171df7026474af03723bdd3c1a58108df08c078333fc0304ed84691c14a76bb15b6a168f8411f993e4e7b0b5d2

data/lib/macho.rb

@@ -12,5 +12,5 @@ require "#{File.dirname(__FILE__)}/macho/tools"
 # The primary namespace for ruby-macho.
 module MachO
 	# release version
-	VERSION = "0.1.8".freeze
+	VERSION = "0.1.9".freeze
 end

data/lib/macho/headers.rb

@@ -111,6 +111,7 @@ module MachO
 	MH_KEXT_BUNDLE = 0xb
 
 	# association of filetypes to string representations
+	# @api private
 	MH_FILETYPES = {
 		MH_OBJECT => "MH_OBJECT",
 		MH_EXECUTE => "MH_EXECUTE",
@@ -125,112 +126,35 @@ module MachO
 		MH_KEXT_BUNDLE => "MH_KEXT_BUNDLE"
 	}
 
-	# the object file has no undefined references (flag)
-	MH_NOUNDEFS = 0x1
-
-	# the object file is the output of an incremental link against a base file (flag)
-	MH_INCRLINK = 0x2
-
-	# the object file is input for the dynamic linker and can't be staticly link edited again (flag)
-	MH_DYLDLINK = 0x4
-
-	# the object file's undefined references are bound by the dynamic linker when loaded (flag)
-	MH_BINDATLOAD = 0x8
-
-	# the file has its dynamic undefined references prebound (flag)
-	MH_PREBOUND = 0x10
-
-	# the file has its read-only and read-write segments split (flag)
-	MH_SPLIT_SEGS = 0x20
-
-	# the shared library init routine is to be run lazily via catching memory faults to its writeable segments (obsolete) (flag)
-	MH_LAZY_INIT = 0x40
-
-	# the image is using two-level name space bindings (flag)
-	MH_TWOLEVEL = 0x80
-
-	# the executable is forcing all images to use flat name space bindings (flag)
-	MH_FORCE_FLAT = 0x100
-
-	# this umbrella guarantees no multiple defintions of symbols in its sub-images so the two-level namespace hints can always be used (flag)
-	MH_NOMULTIDEFS = 0x200
-
-	# do not have dyld notify the prebinding agent about this executable (flag)
-	MH_NOPREFIXBINDING = 0x400
-
-	# the binary is not prebound but can have its prebinding redone. only used when MH_PREBOUND is not set (flag)
-	MH_PREBINDABLE = 0x800
-
-	# indicates that this binary binds to all two-level namespace modules of its dependent libraries. only used when MH_PREBINDABLE and MH_TWOLEVEL are both set (flag)
-	MH_ALLMODSBOUND = 0x1000
-
-	# safe to divide up the sections into sub-sections via symbols for dead code stripping (flag)
-	MH_SUBSECTIONS_VIA_SYMBOLS = 0x2000
-
-	# the binary has been canonicalized via the unprebind operation (flag)
-	MH_CANONICAL = 0x4000
-
-	# the final linked image contains external weak symbols (flag)
-	MH_WEAK_DEFINES = 0x8000
-
-	# the final linked image uses weak symbols (flag)
-	MH_BINDS_TO_WEAK = 0x10000
-
-	# When this bit is set, all stacks in the task will be given stack execution privilege.  Only used in MH_EXECUTE filetypes (flag)
-	MH_ALLOW_STACK_EXECUTION = 0x20000
-
-	# When this bit is set, the binary declares it is safe for use in processes with uid zero (flag)
-	MH_ROOT_SAFE = 0x40000
-
-	# When this bit is set, the binary declares it is safe for use in processes when issetugid() is true (flag)
-	MH_SETUID_SAFE = 0x80000
-
-	# When this bit is set on a dylib, the static linker does not need to examine dependent dylibs to see if any are re-exported (flag)
-	MH_NO_REEXPORTED_DYLIBS = 0x100000
-
-	# When this bit is set, the OS will load the main executable at a random address.  Only used in MH_EXECUTE filetypes (flag)
-	MH_PIE = 0x200000
-
-	# Only for use on dylibs.  When linking against a dylib that has this bit set, the static linker will automatically not create a LC_LOAD_DYLIB load command to the dylib if no symbols are being referenced from the dylib (flag)
-	MH_DEAD_STRIPPABLE_DYLIB = 0x400000
-
-	# Contains a section of type S_THREAD_LOCAL_VARIABLES (flag)
-	MH_HAS_TLV_DESCRIPTORS = 0x800000
-
-	# When this bit is set, the OS will run the main executable with a non-executable heap even on platforms (e.g. i386) that don't require it. Only used in MH_EXECUTE filetypes (flag)
-	MH_NO_HEAP_EXECUTION = 0x1000000
-
-	# The code was linked for use in an application extension (flag)
-	MH_APP_EXTENSION_SAFE = 0x02000000
-
-	# association of mach header flags to string representations
+	# association of mach header flag symbols to values
+	# @api private
 	MH_FLAGS = {
-		MH_NOUNDEFS => "MH_NOUNDEFS",
-		MH_INCRLINK => "MH_INCRLINK",
-		MH_DYLDLINK => "MH_DYLDLINK",
-		MH_BINDATLOAD => "MH_BINDATLOAD",
-		MH_PREBOUND => "MH_PREBOUND",
-		MH_SPLIT_SEGS => "MH_SPLIT_SEGS",
-		MH_LAZY_INIT => "MH_LAZY_INIT",
-		MH_TWOLEVEL => "MH_TWOLEVEL",
-		MH_FORCE_FLAT => "MH_FORCE_FLAT",
-		MH_NOMULTIDEFS => "MH_NOMULTIDEFS",
-		MH_NOPREFIXBINDING => "MH_NOPREFIXBINDING",
-		MH_PREBINDABLE => "MH_PREBINDABLE",
-		MH_ALLMODSBOUND => "MH_ALLMODSBOUND",
-		MH_SUBSECTIONS_VIA_SYMBOLS => "MH_SUBSECTIONS_VIA_SYMBOLS",
-		MH_CANONICAL => "MH_CANONICAL",
-		MH_WEAK_DEFINES => "MH_WEAK_DEFINES",
-		MH_BINDS_TO_WEAK => "MH_BINDS_TO_WEAK",
-		MH_ALLOW_STACK_EXECUTION => "MH_ALLOW_STACK_EXECUTION",
-		MH_ROOT_SAFE => "MH_ROOT_SAFE",
-		MH_SETUID_SAFE => "MH_SETUID_SAFE",
-		MH_NO_REEXPORTED_DYLIBS => "MH_NO_REEXPORTED_DYLIBS",
-		MH_PIE => "MH_PIE",
-		MH_DEAD_STRIPPABLE_DYLIB => "MH_DEAD_STRIPPABLE_DYLIB",
-		MH_HAS_TLV_DESCRIPTORS => "MH_HAS_TLV_DESCRIPTORS",
-		MH_NO_HEAP_EXECUTION => "MH_NO_HEAP_EXECUTION",
-		MH_APP_EXTENSION_SAFE => "MH_APP_EXTENSION_SAFE"
+		:MH_NOUNDEFS => 0x1,
+		:MH_INCRLINK => 0x2,
+		:MH_DYLDLINK => 0x4,
+		:MH_BINDATLOAD => 0x8,
+		:MH_PREBOUND => 0x10,
+		:MH_SPLIT_SEGS => 0x20,
+		:MH_LAZY_INIT => 0x40,
+		:MH_TWOLEVEL => 0x80,
+		:MH_FORCE_FLAT => 0x100,
+		:MH_NOMULTIDEFS => 0x200,
+		:MH_NOPREFIXBINDING => 0x400,
+		:MH_PREBINDABLE => 0x800,
+		:MH_ALLMODSBOUND => 0x1000,
+		:MH_SUBSECTIONS_VIA_SYMBOLS => 0x2000,
+		:MH_CANONICAL => 0x4000,
+		:MH_WEAK_DEFINES => 0x8000,
+		:MH_BINDS_TO_WEAK => 0x10000,
+		:MH_ALLOW_STACK_EXECUTION => 0x20000,
+		:MH_ROOT_SAFE => 0x40000,
+		:MH_SETUID_SAFE => 0x80000,
+		:MH_NO_REEXPORTED_DYLIBS => 0x100000,
+		:MH_PIE => 0x200000,
+		:MH_DEAD_STRIPPABLE_DYLIB => 0x400000,
+		:MH_HAS_TLV_DESCRIPTORS => 0x800000,
+		:MH_NO_HEAP_EXECUTION => 0x1000000,
+		:MH_APP_EXTENSION_SAFE => 0x02000000
 	}
 
 	# Fat binary header structure
@@ -323,10 +247,12 @@ module MachO
 		end
 
 		# @example
-		#  puts "this mach-o has position-independent execution" if header.flag?(MH_PIE)
-		# @param flag [Fixnum] a mach header flag constant
+		#  puts "this mach-o has position-independent execution" if header.flag?(:MH_PIE)
+		# @param flag [Symbol] a mach header flag symbol
 		# @return [Boolean] true if `flag` is present in the header's flag section
 		def flag?(flag)
+			flag = MH_FLAGS[flag]
+			return false if flag.nil?
 			flags & flag == flag
 		end
 	end

data/lib/macho/load_commands.rb

@@ -3,7 +3,7 @@ module MachO
 	# LC_REQ_DYLD to be recognized by the dynamic linder (dyld)
 	LC_REQ_DYLD = 0x80000000
 
-	# association of load commands to string representations
+	# association of load commands to symbol representations
 	# @api private
 	LOAD_COMMANDS = {
 		0x1 => :LC_SEGMENT,
@@ -55,7 +55,8 @@ module MachO
 		0x2e => :LC_LINKER_OPTIMIZATION_HINT
 	}
 
-	# association of load commands to string representations of class names
+	# association of load command symbols to string representations of classes
+	# @api private
 	LC_STRUCTURES = {
 		:LC_SEGMENT => "SegmentCommand",
 		:LC_SYMTAB => "SymtabCommand",
@@ -106,41 +107,27 @@ module MachO
 		:LC_LINKER_OPTIMIZATION_HINT => "LinkeditDataCommand"
 	}
 
-	# pagezero segment name
-	SEG_PAGEZERO = "__PAGEZERO"
-
-	# text segment name
-	SEG_TEXT = "__TEXT"
-
-	# data segment name
-	SEG_DATA = "__DATA"
-
-	# objective-c runtime segment
-	SEG_OBJC = "__OBJC"
-
-	# icon segment
-	SEG_ICON = "__ICON"
-
-	# link editor structures segment
-	SEG_LINKEDIT = "__LINKEDIT"
-
-	# unix stack segment
-	SEG_UNIXSTACK = "__UNIXSTACK"
-
-	# segment for self-modifying code with RWX permissions
-	SEG_IMPORT = "__IMPORT"
-
-	# the file contents for this segment is for the high part of the VM space, the low part is zero filled (for stacks in core files)
-	SG_HIGHVM = 0x1
-
-	# this segment is the VM that is allocated by a fixed VM library, for overlap checking in the link editor
-	SG_FVMLIB = 0x2
-
-	# this segment has nothing that was relocated in it and nothing relocated to it, that is it maybe safely replaced without relocation
-	SG_NORELOC = 0x4
+	# association of segment name symbols to names
+	# @api private
+	SEGMENT_NAMES = {
+		:SEG_PAGEZERO => "__PAGEZERO",
+		:SEG_TEXT => "__TEXT",
+		:SEG_DATA => "__DATA",
+		:SEG_OBJC => "__OBJC",
+		:SEG_ICON => "__ICON",
+		:SEG_LINKEDIT => "__LINKEDIT",
+		:SEG_UNIXSTACK => "__UNIXSTACK",
+		:SEG_IMPORT => "__IMPORT"
+	}
 
-	# this segment is protected.  if the segment starts at file offset 0, the first page of the segment is not protected.  all other pages of the segment are protected.
-	SG_PROTECTED_VERSION_1 = 0x8
+	# association of segment flag symbols to values
+	# @api private
+	SEGMENT_FLAGS = {
+		:SG_HIGHVM => 0x1,
+		:SG_FVMLIB => 0x2,
+		:SG_NORELOC => 0x4,
+		:SG_PROTECTED_VERSION_1 => 0x8
+	}
 
 	# Mach-O load command structure
 	# This is the most generic load command - only cmd ID and size are
@@ -293,6 +280,16 @@ module MachO
 			@nsects = nsects
 			@flags = flags
 		end
+
+		# @example
+		#  puts "this segment relocated in/to it" if sect.flag?(:SG_NORELOC)
+		# @param flag [Symbol] a segment flag symbol
+		# @return [Boolean] true if `flag` is present in the segment's flag field
+		def flag?(flag)
+			flag = SEGMENT_FLAGS[flag]
+			return false if flag.nil?
+			flags & flag == flag
+		end
 	end
 
 	# A load command indicating that part of this file is to be mapped into
@@ -342,6 +339,16 @@ module MachO
 			@nsects = nsects
 			@flags = flags
 		end
+
+		# @example
+		#  puts "this segment relocated in/to it" if sect.flag?(:SG_NORELOC)
+		# @param flag [Symbol] a segment flag symbol
+		# @return [Boolean] true if `flag` is present in the segment's flag field
+		def flag?(flag)
+			flag = SEGMENT_FLAGS[flag]
+			return false if flag.nil?
+			flags & flag == flag
+		end
 	end
 
 	# A load command representing some aspect of shared libraries, depending

data/lib/macho/macho_file.rb

@@ -442,8 +442,8 @@ module MachO
 			# calculate the low file offset (offset to first section data)
 			segments.each do |seg|
 				sections(seg).each do |sect|
-					if sect.size != 0 && !sect.flag?(S_ZEROFILL) &&
-							!sect.flag?(S_THREAD_LOCAL_ZEROFILL) &&
+					if sect.size != 0 && !sect.flag?(:S_ZEROFILL) &&
+							!sect.flag?(:S_THREAD_LOCAL_ZEROFILL) &&
 							sect.offset < low_fileoff
 
 						low_fileoff = sect.offset

data/lib/macho/sections.rb

@@ -11,116 +11,59 @@ module MachO
 	# system settable attributes mask
 	SECTION_ATTRIBUTES_SYS = 0x00ffff00
 
-	# a regular section
-	S_REGULAR = 0x0
-
-	# a zero fill on demand section
-	S_ZEROFILL = 0x1
-
-	# a section with only literal C strings
-	S_CSTRING_LITERALS = 0x2
-
-	# a section with only 4 byte literals
-	S_4BYTE_LITERALS = 0x3
-
-	# a section with only 8 byte literals
-	S_8BYTE_LITERALS = 0x4
-
-	# a section with only pointers to literals
-	S_LITERAL_POINTERS = 0x5
-
-	# a section with only non-lazy symbol pointers
-	S_NON_LAZY_SYMBOL_POINTERS = 0x6
-
-	# a section with only lazy symbol pointers
-	S_LAZY_SYMBOL_POINTERS = 0x7
-
-	# a section with only symbol stubs (byte size of stub in reserved2 field)
-	S_SYMBOL_STUBS = 0x8
-
-	# a section with only function pointers for initialization
-	S_MOD_INIT_FUNC_POINTERS = 0x9
-
-	# a section with only function pointers for termination
-	S_MOD_TERM_FUNC_POINTERS = 0xa
-
-	# a section with only symbols that are to be coalesced
-	S_COALESCED = 0xb
-
-	# a zero fill on demand section that can be larger than 4GB
-	S_GB_ZEROFILE = 0xc
-
-	# a section with only pairs of function pointers for interposing
-	S_INTERPOSING = 0xd
-
-	# a section with only 16 byte literals
-	S_16BYTE_LITERALS = 0xe
-
-	# a section containing DTrace Object Format
-	S_DTRACE_DOF = 0xf
-
-	# a section with only lazy symbol pointers to lazy loaded dylibs
-	S_LAZY_DYLIB_SYMBOL_POINTERS = 0x10
-
-	# a template of initial values for thread local variables
-	S_THREAD_LOCAL_REGULAR = 0x11
-
-	# a template of initial values for thread local variables
-	S_THREAD_LOCAL_ZEROFILL = 0x12
-
-	# thread local variable descriptors
-	S_THREAD_LOCAL_VARIABLES = 0x13
-
-	# pointers to thread local variable descriptors
-	S_THREAD_LOCAL_VARIABLE_POINTERS = 0x14
-
-	# functions to call to initialize thread local variable values
-	S_THREAD_LOCAL_INIT_FUNCTION_POINTERS = 0x15
-
-	# a section with only true machine instructions
-	S_ATTR_PURE_INSTRUCTIONS = 0x80000000
-
-	# a section with coalesced symbols that are not to be in a ranlib table of contents
-	S_ATTR_NO_TOC = 0x40000000
-
-	# static symbols in this section can be stripped in files with the MH_DYLDLINK flag
-	S_ATTR_STRIP_STATIC_SYMS = 0x20000000
-
-	# no dead stripping
-	S_ATTR_NO_DEAD_STRIP = 0x10000000
-
-	# blocks are live if they reference live blocks
-	S_ATTR_LIVE_SUPPORT = 0x08000000
-
-	# used with i386 code stubs written on by dyld
-	S_ATTR_SELF_MODIFYING_CODE = 0x04000000
-
-	# a debug section
-	S_ATTR_DEBUG = 0x02000000
-
-	# a section containing some machine instructions
-	S_ATTR_SOME_INSTRUCTIONS = 0x00000400
-
-	# a section containing external relocation entries
-	S_ATTR_EXT_RELOC = 0x00000200
-
-	# a section containing local relocation entries
-	S_ATTR_LOC_RELOC = 0x00000100
-
-	# currently known section names
-	# we don't use these anywhere right now, but they're good to have
-	SECT_TEXT = "__text"
-	SECT_FVMLIB_INIT0 = "__fvmlib_init0"
-	SECT_FVMLIB_INIT1 = "__fvmlib_init1"
-	SECT_DATA = "__data"
-	SECT_BSS = "__bss"
-	SECT_COMMON = "__common"
-	SECT_OBJC_SYMBOLS = "__symbol_table"
-	SECT_OBJC_MODULES = "__module_info"
-	SECT_OBJC_STRINGS = "__selector_strs"
-	SECT_OBJC_REFS = "__selector_refs"
-	SECT_ICON_HEADER = "__header"
-	SECT_ICON_TIFF = "__tiff"
+	# association of section flag symbols to values
+	# @api private
+	SECTION_FLAGS = {
+		:S_REGULAR => 0x0,
+		:S_ZEROFILL => 0x1,
+		:S_CSTRING_LITERALS => 0x2,
+		:S_4BYTE_LITERALS => 0x3,
+		:S_8BYTE_LITERALS => 0x4,
+		:S_LITERAL_POINTERS => 0x5,
+		:S_NON_LAZY_SYMBOL_POINTERS => 0x6,
+		:S_LAZY_SYMBOL_POINTERS => 0x7,
+		:S_SYMBOL_STUBS => 0x8,
+		:S_MOD_INIT_FUNC_POINTERS => 0x9,
+		:S_MOD_TERM_FUNC_POINTERS => 0xa,
+		:S_COALESCED => 0xb,
+		:S_GB_ZEROFILE => 0xc,
+		:S_INTERPOSING => 0xd,
+		:S_16BYTE_LITERALS => 0xe,
+		:S_DTRACE_DOF => 0xf,
+		:S_LAZY_DYLIB_SYMBOL_POINTERS => 0x10,
+		:S_THREAD_LOCAL_REGULAR => 0x11,
+		:S_THREAD_LOCAL_ZEROFILL => 0x12,
+		:S_THREAD_LOCAL_VARIABLES => 0x13,
+		:S_THREAD_LOCAL_VARIABLE_POINTERS => 0x14,
+		:S_THREAD_LOCAL_INIT_FUNCTION_POINTERS => 0x15,
+		:S_ATTR_PURE_INSTRUCTIONS => 0x80000000,
+		:S_ATTR_NO_TOC => 0x40000000,
+		:S_ATTR_STRIP_STATIC_SYMS => 0x20000000,
+		:S_ATTR_NO_DEAD_STRIP => 0x10000000,
+		:S_ATTR_LIVE_SUPPORT => 0x08000000,
+		:S_ATTR_SELF_MODIFYING_CODE => 0x04000000,
+		:S_ATTR_DEBUG => 0x02000000,
+		:S_ATTR_SOME_INSTRUCTIONS => 0x00000400,
+		:S_ATTR_EXT_RELOC => 0x00000200,
+		:S_ATTR_LOC_RELOC => 0x00000100
+	}
+
+	# association of section name symbols to names
+	# @api private
+	SECTION_NAMES = {
+		:SECT_TEXT => "__text",
+		:SECT_FVMLIB_INIT0 => "__fvmlib_init0",
+		:SECT_FVMLIB_INIT1 => "__fvmlib_init1",
+		:SECT_DATA => "__data",
+		:SECT_BSS => "__bss",
+		:SECT_COMMON => "__common",
+		:SECT_OBJC_SYMBOLS => "__symbol_table",
+		:SECT_OBJC_MODULES => "__module_info",
+		:SECT_OBJC_STRINGS => "__selector_strs",
+		:SECT_OBJC_REFS => "__selector_refs",
+		:SECT_ICON_HEADER => "__header",
+		:SECT_ICON_TIFF => "__tiff"
+	}
 
 	# Represents a section of a segment for 32-bit architectures.
 	class Section < MachOStructure
@@ -187,10 +130,12 @@ module MachO
 		end
 
 		# @example
-		#  puts "this section is regular" if sect.flag?(S_REGULAR)
-		# @param flag [Fixnum] a section flag constant
-		# @return [Boolean] true if `flag` is present in the sections's flag field
+		#  puts "this section is regular" if sect.flag?(:S_REGULAR)
+		# @param flag [Symbol] a section flag symbol
+		# @return [Boolean] true if `flag` is present in the section's flag field
 		def flag?(flag)
+			flag = SECTION_FLAGS[flag]
+			return false if flag.nil?
 			flags & flag == flag
 		end
 	end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-macho
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - William Woodruff
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-04 00:00:00.000000000 Z
+date: 2015-11-07 00:00:00.000000000 Z
 dependencies: []
 description: A library for viewing and manipulating Mach-O files in Ruby.
 email: william@tuffbizz.com