Class: MachO::LoadCommands::SegmentCommand

Inherits:
LoadCommand show all
Defined in:
lib/macho/load_commands.rb

Overview

A load command indicating that part of this file is to be mapped into the task's address space. Corresponds to LC_SEGMENT.

Direct Known Subclasses

SegmentCommand64

Instance Method Summary collapse

Methods inherited from LoadCommand

#cmd, #cmdsize, create, new_from_bin, #offset, #serializable?, #serialize, #to_s, #type, #view

Methods inherited from MachOStructure

bytesize, format, #initialize, new_from_bin

Constructor Details

This class inherits a constructor from MachO::MachOStructure

Instance Method Details

#fileoff ⇒ Integer

Returns the file offset of the segment.

Returns:

  • (Integer) —

    the file offset of the segment



410
 
# File 'lib/macho/load_commands.rb', line 410

field :fileoff, :uint32

#filesize ⇒ Integer

Returns the amount to map from the file.

Returns:

  • (Integer) —

    the amount to map from the file



413
 
# File 'lib/macho/load_commands.rb', line 413

field :filesize, :uint32

#flag?(flag) ⇒ Boolean

Returns true if flag is present in the segment's flag field.

Examples:

puts "this segment relocated in/to it" if sect.flag?(:SG_NORELOC)

Parameters:

  • flag (Symbol) —

    a segment flag symbol

Returns:

  • (Boolean) —

    true if flag is present in the segment's flag field



451
452
453
454
455
456
457
 
# File 'lib/macho/load_commands.rb', line 451

def flag?(flag)
  flag = SEGMENT_FLAGS[flag]

  return false if flag.nil?

  flags & flag == flag
end

#flags ⇒ Integer

Returns any flags associated with the segment.

Returns:

  • (Integer) —

    any flags associated with the segment



425
 
# File 'lib/macho/load_commands.rb', line 425

field :flags, :uint32

#guess_align ⇒ Integer

Note:

See guess_align in cctools/misc/lipo.c

Guesses the alignment of the segment.

Returns:

  • (Integer) —

    the guessed alignment, as a power of 2



462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
 
# File 'lib/macho/load_commands.rb', line 462

def guess_align
  return Sections::MAX_SECT_ALIGN if vmaddr.zero?

  align = 0
  segalign = 1

  while (segalign & vmaddr).zero?
    segalign <<= 1
    align += 1
  end

  return 2 if align < 2
  return Sections::MAX_SECT_ALIGN if align > Sections::MAX_SECT_ALIGN

  align
end

#initprot ⇒ Integer

Returns the initial VM protection.

Returns:

  • (Integer) —

    the initial VM protection



419
 
# File 'lib/macho/load_commands.rb', line 419

field :initprot, :int32

#maxprot ⇒ Integer

Returns the maximum VM protection.

Returns:

  • (Integer) —

    the maximum VM protection



416
 
# File 'lib/macho/load_commands.rb', line 416

field :maxprot, :int32

#nsects ⇒ Integer

Returns the number of sections in the segment.

Returns:

  • (Integer) —

    the number of sections in the segment



422
 
# File 'lib/macho/load_commands.rb', line 422

field :nsects, :uint32

#sections ⇒ Array<MachO::Sections::Section>, Array<MachO::Sections::Section64>

All sections referenced within this segment.

Returns:



430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
 
# File 'lib/macho/load_commands.rb', line 430

def sections
  klass = case self
  when SegmentCommand64
    MachO::Sections::Section64
  when SegmentCommand
    MachO::Sections::Section
  end

  offset = view.offset + self.class.bytesize
  length = nsects * klass.bytesize

  bins = view.raw_data[offset, length]
  bins.unpack("a#{klass.bytesize}" * nsects).map do |bin|
    klass.new_from_bin(view.endianness, bin)
  end
end

#segname ⇒ String

Returns the name of the segment.

Returns:

  • (String) —

    the name of the segment



401
 
# File 'lib/macho/load_commands.rb', line 401

field :segname, :string, :padding => :null, :size => 16, :to_s => true

#to_h ⇒ Hash

Returns a hash representation of this MachO::LoadCommands::SegmentCommand.

Returns:



480
481
482
483
484
485
486
487
488
489
490
491
492
493
 
# File 'lib/macho/load_commands.rb', line 480

def to_h
  {
    "segname" => segname,
    "vmaddr" => vmaddr,
    "vmsize" => vmsize,
    "fileoff" => fileoff,
    "filesize" => filesize,
    "maxprot" => maxprot,
    "initprot" => initprot,
    "nsects" => nsects,
    "flags" => flags,
    "sections" => sections.map(&:to_h),
  }.merge super
end

#vmaddr ⇒ Integer

Returns the memory address of the segment.

Returns:

  • (Integer) —

    the memory address of the segment



404
 
# File 'lib/macho/load_commands.rb', line 404

field :vmaddr, :uint32

#vmsize ⇒ Integer

Returns the memory size of the segment.

Returns:

  • (Integer) —

    the memory size of the segment



407
 
# File 'lib/macho/load_commands.rb', line 407

field :vmsize, :uint32