Module: Msf::Util::EXE::Linux::X86::ClassMethods

Included in:
Msf::Util::EXE::Linux::X86
Defined in:
lib/msf/util/exe/linux/x86.rb

Instance Method Summary collapse

Instance Method Details

#to_linux_x86_custom_elf(framework, code, opts = {}) ⇒ String

Create a 32-bit Linux ELF containing the payload provided in code with custom template to_linux_x86_custom_elf

Parameters:

  • framework (Msf::Framework)
  • code (String)
  • opts (Hash) (defaults to: {})
  • [String] (Hash) —

    a customizable set of options

Returns:

  • (String) —

    Returns an elf



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
 
# File 'lib/msf/util/exe/linux/x86.rb', line 36

def to_linux_x86_custom_elf(framework, code, opts = {})
  # Use set_template_default to normalize the :template key. It will just end up doing
  # opts[:template] = File.join(opts[:template_path], opts[:template])
  # for us, check if the file exists.
  set_template_default(opts, 'template_x86_linux.bin')

  # If this isn't our normal template, we have to do some fancy
  # header patching to mark the .text section rwx before putting our
  # payload into the entry point.

  # read in the template and parse it
  e = Metasm::ELF.decode_file(opts[:template])

  # This will become a modified copy of the template's original phdr
  new_phdr = Metasm::EncodedData.new
  e.segments.each { |s|
    # Be lazy and mark any executable segment as writable.  Doing
    # it this way means we don't have to care about which one
    # contains .text
    s.flags += [ "W" ] if s.flags.include? "X"
    new_phdr << s.encode(e)
  }

  # Copy the original file
  elf = get_file_contents(opts[:template], "rb")

  # Replace the header with our rwx modified version
  elf[e.header.phoff, new_phdr.data.length] = new_phdr.data

  # Replace code at the entrypoint with our payload
  entry_off = e.addr_to_off(e.label_addr('entrypoint'))
  elf[entry_off, code.length] = code
end

#to_linux_x86_elf(framework, code, opts = {}) ⇒ String

Create a 32-bit Linux ELF containing the payload provided in code to_linux_x86_elf

Parameters:

  • framework (Msf::Framework) —

    The framework of you want to use

  • code (String)
  • opts (Hash) (defaults to: {})
  • [String] (Hash) —

    a customizable set of options

Returns:

  • (String) —

    Returns an elf



21
22
23
24
25
26
 
# File 'lib/msf/util/exe/linux/x86.rb', line 21

def to_linux_x86_elf(framework, code, opts = {})
  default = true unless opts[:template]

  return to_exe_elf(framework, opts, "template_x86_linux.bin", code) if default
  return to_linux_x86_custom_elf(framework, code, opts)
end

#to_linux_x86_elf_dll(framework, code, opts = {}) ⇒ String

Create a 32-bit Linux ELF_DYN containing the payload provided in code to_linux_x86_elf_dll

Parameters:

  • framework (Msf::Framework)
  • code (String)
  • opts (Hash) (defaults to: {})
  • [String] (Hash) —

    a customizable set of options

Returns:

  • (String) —

    Returns an elf



79
80
81
 
# File 'lib/msf/util/exe/linux/x86.rb', line 79

def to_linux_x86_elf_dll(framework, code, opts = {})
  to_exe_elf(framework, opts, "template_x86_linux_dll.bin", code)
end