/lib/rex/post/meterpreter/extensions/stdapi/net/interface.rb

# -*- coding: binary -*-

require 'ipaddr'

module Rex
module Post
module Meterpreter
module Extensions
module Stdapi
module Net

###
#
# This class represents a logical physical interface
# on the remote machine.
#
###
class Interface

  ##
  #
  # Constructor
  #
  ##

  #
  # Returns a logical interface and initializes it to the supplied
  # parameters.
  #
  def initialize(opts={})
    self.index    = opts[:index] || -1
    self.mac_addr = opts[:mac_addr]
    self.mac_name = opts[:mac_name]
    self.mtu      = opts[:mtu]
    self.flags    = opts[:flags]
    self.addrs    = opts[:addrs]
    self.netmasks = opts[:netmasks]
    self.scopes   = opts[:scopes]
  end

  #
  # Returns a pretty string representation of the interface's properties.
  #
  def pretty
    macocts = []
    mac_addr.each_byte { |o| macocts << o }
    macocts += [0] * (6 - macocts.size) if macocts.size < 6

    info = [
      ["Name"         , mac_name  ],
      ["Hardware MAC" , sprintf("%02x:%02x:%02x:%02x:%02x:%02x",
        macocts[0], macocts[1], macocts[2],
        macocts[3], macocts[4], macocts[5])],
      ["MTU"          , mtu       ],
      ["Flags"        , flags     ],
    ]

    # If all went as planned, addrs and netmasks will have the same number
    # of elements and be properly ordered such that they match up
    # correctly.
    addr_masks = addrs.zip(netmasks)

    addr_masks.select { |a| Rex::Socket.is_ipv4?(a[0]) }.each { |a|
      info << [ "IPv4 Address", a[0] ]
      info << [ "IPv4 Netmask", a[1] ]
    }
    addr_masks.select { |a| Rex::Socket.is_ipv6?(a[0]) }.each { |a|
      info << [ "IPv6 Address", a[0] ]
      info << [ "IPv6 Netmask", a[1] ]
    }

    pad = info.map{|i| i[0] }.max_by{|k|k.length}.length

    ret = sprintf(
        "Interface %2d\n" +
        "============\n",
        index
      )

    info.map {|k,v|
      next if v.nil?
      ret << k.ljust(pad) + " : #{v}\n"
    }

    ret
  end

  #
  # The first address associated with this Interface
  #
  def ip
    addrs.first
  end

  #
  # The index of the interface.
  #
  attr_accessor :index
  #
  # An Array of IP addresses bound to the Interface.
  #
  attr_accessor :addrs
  #
  # The physical (MAC) address of the NIC.
  #
  attr_accessor :mac_addr
  #
  # The name of the interface.
  #
  attr_accessor :mac_name
  #
  # The MTU associated with the interface.
  #
  attr_accessor :mtu
  #
  # The flags associated with the interface.
  #
  attr_accessor :flags
  #
  # An Array of netmasks. This will have the same number of elements as #addrs
  #
  attr_accessor :netmasks
  #
  # An Array of IPv6 address scopes. This will have the same number of elements as #addrs
  #
  attr_accessor :scopes
end

end; end; end; end; end; end