dstruct 0.0.1

data/lib/rex/post/meterpreter/extensions/sniffer/tlv.rb

@@ -0,0 +1,27 @@
+# -*- coding: binary -*-
+module Rex
+module Post
+module Meterpreter
+module Extensions
+module Sniffer
+
+TLV_TYPE_EXTENSION_SNIFFER		= 0
+TLV_TYPE_SNIFFER_INTERFACES		= TLV_META_TYPE_GROUP | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 1)
+TLV_TYPE_SNIFFER_INTERFACE_ID		= TLV_META_TYPE_UINT  | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 2)
+TLV_TYPE_SNIFFER_INTERFACE_HANDLE	= TLV_META_TYPE_UINT  | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 3)
+TLV_TYPE_SNIFFER_PACKET_COUNT		= TLV_META_TYPE_UINT  | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 4)
+TLV_TYPE_SNIFFER_BYTE_COUNT		= TLV_META_TYPE_UINT  | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 5)
+
+TLV_TYPE_SNIFFER_EXCLUDE_PORTS		= TLV_META_TYPE_GROUP | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 6)
+TLV_TYPE_SNIFFER_INCLUDE_PORTS		= TLV_META_TYPE_GROUP | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 7)
+
+TLV_TYPE_SNIFFER_PACKETS		= TLV_META_TYPE_GROUP  | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 8)
+TLV_TYPE_SNIFFER_PACKET			= TLV_META_TYPE_RAW    | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 9)
+
+TLV_TYPE_SNIFFER_ADDITIONAL_FILTER	= TLV_META_TYPE_STRING | (TLV_TYPE_EXTENSION_SNIFFER + TLV_EXTENSIONS + 10)
+
+end
+end
+end
+end
+end

data/lib/rex/post/meterpreter/extensions/stdapi/constants.rb

@@ -0,0 +1,396 @@
+# -*- coding: binary -*-
+
+###
+#
+# Windows Specific Constants
+# --------------------------
+#
+# These are put into the global namespace for now
+# so that they can be referenced globally.
+#
+###
+
+##
+#
+# Net
+#
+##
+AF_INET = 2
+AF_INET6 = 23
+
+##
+#
+# Permissions
+#
+##
+DELETE                   = 0x00010000
+READ_CONTROL             = 0x00020000
+WRITE_DAC                = 0x00040000
+WRITE_OWNER              = 0x00080000
+SYNCHRONIZE              = 0x00100000
+STANDARD_RIGHTS_REQUIRED = 0x000f0000
+STANDARD_RIGHTS_READ     = READ_CONTROL
+STANDARD_RIGHTS_WRITE    = READ_CONTROL
+STANDARD_RIGHTS_EXECUTE  = READ_CONTROL
+STANDARD_RIGHTS_ALL      = 0x001f0000
+SPECIFIC_RIGHTS_ALL      = 0x0000ffff
+MAXIMUM_ALLOWED          = 0x02000000
+GENERIC_READ             = 0x80000000
+GENERIC_WRITE            = 0x40000000
+GENERIC_EXECUTE          = 0x20000000
+GENERIC_ALL              = 0x10000000
+
+##
+#
+# Page Protections
+#
+##
+PAGE_NOACCESS            = 0x00000001
+PAGE_READONLY            = 0x00000002
+PAGE_READWRITE           = 0x00000004
+PAGE_WRITECOPY           = 0x00000008
+PAGE_EXECUTE             = 0x00000010
+PAGE_EXECUTE_READ        = 0x00000020
+PAGE_EXECUTE_READWRITE   = 0x00000040
+PAGE_EXECUTE_WRITECOPY   = 0x00000080
+PAGE_GUARD               = 0x00000100
+PAGE_NOCACHE             = 0x00000200
+PAGE_WRITECOMBINE        = 0x00000400
+MEM_COMMIT               = 0x00001000
+MEM_RESERVE              = 0x00002000
+MEM_DECOMMIT             = 0x00004000
+MEM_RELEASE              = 0x00008000
+MEM_FREE                 = 0x00010000
+MEM_PRIVATE              = 0x00020000
+MEM_MAPPED               = 0x00040000
+MEM_RESET                = 0x00080000
+MEM_TOP_DOWN             = 0x00100000
+MEM_WRITE_WATCH          = 0x00200000
+MEM_PHYSICAL             = 0x00400000
+MEM_LARGE_PAGES          = 0x20000000
+MEM_4MB_PAGES            = 0x80000000
+SEC_FILE                 = 0x00800000
+SEC_IMAGE                = 0x01000000
+SEC_RESERVE              = 0x04000000
+SEC_COMMIT               = 0x08000000
+SEC_NOCACHE              = 0x10000000
+MEM_IMAGE                = SEC_IMAGE
+
+##
+#
+# Registry Permissions
+#
+##
+KEY_QUERY_VALUE          = 0x00000001
+KEY_SET_VALUE            = 0x00000002
+KEY_CREATE_SUB_KEY       = 0x00000004
+KEY_ENUMERATE_SUB_KEYS   = 0x00000008
+KEY_NOTIFY               = 0x00000010
+KEY_CREATE_LINK          = 0x00000020
+KEY_WOW64_64KEY          = 0x00000100
+KEY_WOW64_32KEY          = 0x00000200
+KEY_READ                 = (STANDARD_RIGHTS_READ | KEY_QUERY_VALUE |
+              KEY_ENUMERATE_SUB_KEYS | KEY_NOTIFY) & ~SYNCHRONIZE
+KEY_WRITE                = (STANDARD_RIGHTS_WRITE | KEY_SET_VALUE |
+              KEY_CREATE_SUB_KEY) & ~SYNCHRONIZE
+KEY_EXECUTE              = KEY_READ
+KEY_ALL_ACCESS           = (STANDARD_RIGHTS_ALL | KEY_QUERY_VALUE |
+              KEY_SET_VALUE | KEY_CREATE_SUB_KEY |
+              KEY_ENUMERATE_SUB_KEYS | KEY_NOTIFY |
+              KEY_CREATE_LINK) & ~SYNCHRONIZE
+
+##
+#
+# Registry
+#
+##
+HKEY_CLASSES_ROOT        = 0x80000000
+HKEY_CURRENT_USER        = 0x80000001
+HKEY_LOCAL_MACHINE       = 0x80000002
+HKEY_USERS               = 0x80000003
+HKEY_PERFORMANCE_DATA    = 0x80000004
+HKEY_CURRENT_CONFIG      = 0x80000005
+HKEY_DYN_DATA            = 0x80000006
+
+REG_NONE                 = 0
+REG_SZ                   = 1
+REG_EXPAND_SZ            = 2
+REG_BINARY               = 3
+REG_DWORD                = 4
+REG_DWORD_LITTLE_ENDIAN  = 4
+REG_DWORD_BIG_ENDIAN     = 5
+REG_LINK                 = 6
+REG_MULTI_SZ             = 7
+
+##
+#
+# Process Permissions
+#
+##
+PROCESS_TERMINATE        = 0x00000001
+PROCESS_CREATE_THREAD    = 0x00000002
+PROCESS_SET_SESSIONID    = 0x00000004
+PROCESS_VM_OPERATION     = 0x00000008
+PROCESS_VM_READ          = 0x00000010
+PROCESS_VM_WRITE         = 0x00000020
+PROCESS_DUP_HANDLE       = 0x00000040
+PROCESS_CREATE_PROCESS   = 0x00000080
+PROCESS_SET_QUOTA        = 0x00000100
+PROCESS_SET_INFORMATION  = 0x00000200
+PROCESS_QUERY_INFORMATION= 0x00000400
+PROCESS_SUSPEND_RESUME   = 0x00000800
+PROCESS_ALL_ACCESS       = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0xFFF
+
+##
+#
+# Thread Permissions
+#
+##
+THREAD_TERMINATE            = 0x00000001
+THREAD_SUSPEND_RESUME       = 0x00000002
+THREAD_GET_CONTEXT          = 0x00000008
+THREAD_SET_CONTEXT          = 0x00000010
+THREAD_SET_INFORMATION      = 0x00000020
+THREAD_QUERY_INFORMATION    = 0x00000040
+THREAD_SET_THREAD_TOKEN     = 0x00000080
+THREAD_IMPERSONATE          = 0x00000100
+THREAD_DIRECT_IMPERSONATION = 0x00000200
+THREAD_ALL_ACCESS           = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0x3FF
+
+##
+#
+# Creation flags
+#
+##
+
+CREATE_SUSPENDED            = 0x00000004
+
+##
+#
+# Event Log
+#
+##
+EVENTLOG_SEQUENTIAL_READ    = 0x00000001
+EVENTLOG_SEEK_READ          = 0x00000002
+EVENTLOG_FORWARDS_READ      = 0x00000004
+EVENTLOG_BACKWARDS_READ     = 0x00000008
+
+##
+#
+# Event Log
+#
+##
+EWX_LOGOFF                  = 0
+EWX_SHUTDOWN                = 0x00000001
+EWX_REBOOT                  = 0x00000002
+EWX_FORCE                   = 0x00000004
+EWX_POWEROFF                = 0x00000008
+EWX_FORCEIFHUNG             = 0x00000010
+
+##
+#
+# Shutdown Reason Codes
+#
+##
+SHTDN_REASON_MINOR_DC_PROMOTION             = 0x00000021
+SHTDN_REASON_MAJOR_APPLICATION              = 0x00040000
+SHTDN_REASON_MAJOR_HARDWARE                 = 0x00010000
+SHTDN_REASON_FLAG_COMMENT_REQUIRED          = 0x01000000
+SHTDN_REASON_FLAG_DIRTY_UI                  = 0x08000000
+SHTDN_REASON_MINOR_UNSTABLE                 = 0x00000006
+SHTDN_REASON_MINOR_SECURITYFIX_UNINSTALL    = 0x00000018
+SHTDN_REASON_MINOR_ENVIRONMENT              = 0x00000000
+SHTDN_REASON_MAJOR_LEGACY_API               = 0x00070000
+SHTDN_REASON_MINOR_DC_DEMOTION              = 0x00000022
+SHTDN_REASON_MINOR_SECURITYFIX              = 0x00000012
+SHTDN_REASON_FLAG_CLEAN_UI                  = 0x04000000
+SHTDN_REASON_MINOR_HOTFIX                   = 0x00000011
+SHTDN_REASON_MINOR_CORDUNPLUGGED            = 0x00000000
+SHTDN_REASON_MINOR_HOTFIX_UNINSTALL         = 0x00000017
+SHTDN_REASON_FLAG_USER_DEFINED              = 0x40000000
+SHTDN_REASON_MINOR_SYSTEMRESTORE            = 0x00000001
+SHTDN_REASON_MINOR_OTHERDRIVER              = 0x00000000
+SHTDN_REASON_MINOR_WMI                      = 0x00000015
+SHTDN_REASON_MINOR_INSTALLATION             = 0x00000002
+SHTDN_REASON_MINOR_BLUESCREEN               = 0x0000000F
+SHTDN_REASON_MAJOR_SOFTWARE                 = 0x00030000
+SHTDN_REASON_MINOR_NETWORKCARD              = 0x00000009
+SHTDN_REASON_MINOR_SERVICEPACK_UNINSTALL    = 0x00000016
+SHTDN_REASON_MINOR_SERVICEPACK              = 0x00000010
+SHTDN_REASON_MINOR_UPGRADE                  = 0x00000003
+SHTDN_REASON_FLAG_PLANNED                   = 0x80000000
+SHTDN_REASON_MINOR_MMC                      = 0x00000019
+SHTDN_REASON_MINOR_POWER_SUPPLY             = 0x00000000
+SHTDN_REASON_MINOR_MAINTENANCE              = 0x00000001
+SHTDN_REASON_VALID_BIT_MASK                 = 0x00000000
+SHTDN_REASON_MAJOR_NONE                     = 0x00000000
+SHTDN_REASON_MAJOR_POWER                    = 0x00060000
+SHTDN_REASON_FLAG_DIRTY_PROBLEM_ID_REQUIRED = 0x02000000
+SHTDN_REASON_MINOR_OTHER                    = 0x00000000
+SHTDN_REASON_MINOR_PROCESSOR                = 0x00000008
+SHTDN_REASON_MAJOR_OTHER                    = 0x00000000
+SHTDN_REASON_MINOR_DISK                     = 0x00000007
+SHTDN_REASON_MINOR_NETWORK_CONNECTIVITY     = 0x00000014
+SHTDN_REASON_MAJOR_OPERATINGSYSTEM          = 0x00020000
+SHTDN_REASON_MINOR_HUNG                     = 0x00000005
+SHTDN_REASON_MINOR_TERMSRV                  = 0x00000020
+SHTDN_REASON_MINOR_NONE                     = 0x00000000
+SHTDN_REASON_MINOR_RECONFIG                 = 0x00000004
+SHTDN_REASON_MAJOR_SYSTEM                   = 0x00050000
+SHTDN_REASON_MINOR_HARDWARE_DRIVER          = 0x00000000
+SHTDN_REASON_MINOR_SECURITY                 = 0x00000013
+SHTDN_REASON_DEFAULT                        = SHTDN_REASON_MAJOR_OTHER | SHTDN_REASON_MINOR_OTHER
+
+##
+#
+# Keyboard Mappings
+#
+##
+
+VirtualKeyCodes = {
+  1 => %W{ LClick },
+  2 => %W{ RClick },
+  3 => %W{ Cancel },
+  4 => %W{ MClick },
+  8 => %W{ Back  },
+  9 => %W{ Tab  },
+  10 => %W{ Newline },
+  12 => %W{ Clear },
+  13 => %W{ Return },
+
+  16 => %W{ Shift },
+  17 => %W{ Ctrl },
+  18 => %W{ Alt },
+  19 => %W{ Pause },
+  20 => %W{ CapsLock },
+
+  27 => %W{ Esc },
+
+  32 => %W{ Space },
+  33 => %W{ Prior },
+  34 => %W{ Next },
+  35 => %W{ End },
+  36 => %W{ Home },
+  37 => %W{ Left },
+  38 => %W{ Up },
+  39 => %W{ Right },
+  40 => %W{ Down  },
+  41 => %W{ Select },
+  42 => %W{ Print },
+  43 => %W{ Execute },
+  44 => %W{ Snapshot },
+  45 => %W{ Insert },
+  46 => %W{ Delete },
+  47 => %W{ Help },
+  48 => %W{ 0  )},
+  49 => %W{ 1  !},
+  50 => %W{ 2  @},
+  51 => %W{ 3  #},
+  52 => %W{ 4  $},
+  53 => %W{ 5  %},
+  54 => %W{ 6  ^},
+  55 => %W{ 7  &},
+  56 => %W{ 8  *},
+  57 => %W{ 9  (},
+  65 => %W{ a  A},
+  66 => %W{ b  B},
+  67 => %W{ c  C},
+  68 => %W{ d  D},
+  69 => %W{ e  E},
+  70 => %W{ f  F},
+  71 => %W{ g  G},
+  72 => %W{ h  H},
+  73 => %W{ i  I},
+  74 => %W{ j  J},
+  75 => %W{ k  K},
+  76 => %W{ l  L},
+  77 => %W{ m  M},
+  78 => %W{ n  N},
+  79 => %W{ o  O},
+  80 => %W{ p  P},
+  81 => %W{ q  Q},
+  82 => %W{ r  R},
+  83 => %W{ s  S},
+  84 => %W{ t  T},
+  85 => %W{ u  U},
+  86 => %W{ v  V},
+  87 => %W{ w  W},
+  88 => %W{ x  X},
+  89 => %W{ y  Y},
+  90 => %W{ z  Z},
+  91 => %W{ LWin },
+  92 => %W{ RWin },
+  93 => %W{ Apps },
+
+  95 => %W{ Sleep },
+  96 => %W{ N0 },
+  97 => %W{ N1 },
+  98 => %W{ N2 },
+  99 => %W{ N3 },
+  100 => %W{ N4 },
+  101 => %W{ N5 },
+  102 => %W{ N6 },
+  103 => %W{ N7 },
+  104 => %W{ N8 },
+  105 => %W{ N9 },
+  106 => %W{ Multiply },
+  107 => %W{ Add },
+  108 => %W{ Separator },
+  109 => %W{ Subtract },
+  110 => %W{ Decimal },
+  111 => %W{ Divide },
+  112 => %W{ F1 },
+  113 => %W{ F2 },
+  114 => %W{ F3 },
+  115 => %W{ F4 },
+  116 => %W{ F5 },
+  117 => %W{ F6 },
+  118 => %W{ F7 },
+  119 => %W{ F8 },
+  120 => %W{ F9 },
+  121 => %W{ F10 },
+  122 => %W{ F11 },
+  123 => %W{ F12 },
+  124 => %W{ F13 },
+  125 => %W{ F14 },
+  126 => %W{ F15 },
+  127 => %W{ F16 },
+  128 => %W{ F17 },
+  129 => %W{ F18 },
+  130 => %W{ F19 },
+  131 => %W{ F20 },
+  132 => %W{ F21 },
+  133 => %W{ F22 },
+  134 => %W{ F23 },
+  135 => %W{ F24 },
+  144 => %W{ NumLock },
+  145 => %W{ Scroll },
+  160 => %W{ LShift },
+  161 => %W{ RShift },
+  162 => %W{ LCtrl },
+  163 => %W{ RCtrl },
+  164 => %W{ LMenu },
+  165 => %W{ RMenu },
+  166 => %W{ Back },
+  167 => %W{ Forward },
+  168 => %W{ Refresh },
+  169 => %W{ Stop },
+  170 => %W{ Search },
+  171 => %W{ Favorites },
+  172 => %W{ Home },
+  176 => %W{ Forward },
+  177 => %W{ Reverse },
+  178 => %W{ Stop },
+  179 => %W{ Play },
+  186 => %W{ ;  :},
+  187 => %W{ =  +},
+  188 => %W{ ,  <},
+  189 => %W{ -  _},
+  190 => %W{ .  >},
+  191 => %W{ /  ?},
+  192 => %W{ '  ~},
+  219 => %W| [  {|,
+  220 => %W{ \  |},
+  221 => %W| ]  }|,
+  222 => %W{ '  Quotes},
+}

data/lib/rex/post/meterpreter/extensions/stdapi/fs/dir.rb

@@ -0,0 +1,284 @@
+# -*- coding: binary -*-
+
+require 'rex/post/dir'
+require 'rex/post/meterpreter/extensions/stdapi/stdapi'
+
+module Rex
+module Post
+module Meterpreter
+module Extensions
+module Stdapi
+module Fs
+
+###
+#
+# This class implements directory operations against the remote endpoint.  It
+# implements the Rex::Post::Dir interface.
+#
+###
+class Dir < Rex::Post::Dir
+
+  class << self
+    attr_accessor :client
+  end
+
+  ##
+  #
+  # Constructor
+  #
+  ##
+
+  #
+  # Initializes the directory instance.
+  #
+  def initialize(path)
+    self.path   = path
+    self.client = self.class.client
+  end
+
+  ##
+  #
+  # Enumeration
+  #
+  ##
+
+  #
+  # Enumerates all of the contents of the directory.
+  #
+  def each(&block)
+    client.fs.dir.foreach(self.path, &block)
+  end
+
+  #
+  # Enumerates all of the files/folders in a given directory.
+  #
+  def Dir.entries(name = getwd)
+    request = Packet.create_request('stdapi_fs_ls')
+    files   = []
+
+    request.add_tlv(TLV_TYPE_DIRECTORY_PATH, client.unicode_filter_decode(name))
+
+    response = client.send_request(request)
+
+    response.each(TLV_TYPE_FILE_NAME) { |file_name|
+      files << client.unicode_filter_encode( file_name.value )
+    }
+
+    return files
+  end
+
+  #
+  # Enumerates files with a bit more information than the default entries.
+  #
+  def Dir.entries_with_info(name = getwd)
+    request = Packet.create_request('stdapi_fs_ls')
+    files   = []
+
+    request.add_tlv(TLV_TYPE_DIRECTORY_PATH, client.unicode_filter_decode(name))
+
+    response = client.send_request(request)
+
+    fname = response.get_tlvs(TLV_TYPE_FILE_NAME)
+    fpath = response.get_tlvs(TLV_TYPE_FILE_PATH)
+    sbuf  = response.get_tlvs(TLV_TYPE_STAT_BUF)
+
+    if (!fname or !sbuf)
+      return []
+    end
+
+    fname.each_with_index { |file_name, idx|
+      st = nil
+
+      if (sbuf[idx])
+        st = ::Rex::Post::FileStat.new
+        st.update(sbuf[idx].value)
+      end
+
+      files <<
+        {
+          'FileName' => client.unicode_filter_encode( file_name.value ),
+          'FilePath' => client.unicode_filter_encode( fpath[idx].value ),
+          'StatBuf'  => st,
+        }
+    }
+
+    return files
+  end
+
+  ##
+  #
+  # General directory operations
+  #
+  ##
+
+  #
+  # Changes the working directory of the remote process.
+  #
+  def Dir.chdir(path)
+    request = Packet.create_request('stdapi_fs_chdir')
+
+    request.add_tlv(TLV_TYPE_DIRECTORY_PATH, client.unicode_filter_decode( path ))
+
+    response = client.send_request(request)
+
+    return 0
+  end
+
+  #
+  # Creates a directory.
+  #
+  def Dir.mkdir(path)
+    request = Packet.create_request('stdapi_fs_mkdir')
+
+    request.add_tlv(TLV_TYPE_DIRECTORY_PATH, client.unicode_filter_decode( path ))
+
+    response = client.send_request(request)
+
+    return 0
+  end
+
+  #
+  # Returns the current working directory of the remote process.
+  #
+  def Dir.pwd
+    request = Packet.create_request('stdapi_fs_getwd')
+
+    response = client.send_request(request)
+
+    return client.unicode_filter_encode( response.get_tlv(TLV_TYPE_DIRECTORY_PATH).value )
+  end
+
+  #
+  # Synonym for pwd.
+  #
+  def Dir.getwd
+    pwd
+  end
+
+  #
+  # Removes the supplied directory if it's empty.
+  #
+  def Dir.delete(path)
+    request = Packet.create_request('stdapi_fs_delete_dir')
+
+    request.add_tlv(TLV_TYPE_DIRECTORY_PATH, client.unicode_filter_decode( path ))
+
+    response = client.send_request(request)
+
+    return 0
+  end
+
+  #
+  # Synonyms for delete.
+  #
+  def Dir.rmdir(path)
+    delete(path)
+  end
+
+  #
+  # Synonyms for delete.
+  #
+  def Dir.unlink(path)
+    delete(path)
+  end
+
+  ##
+  #
+  # Directory mirroring
+  #
+  ##
+
+  #
+  # Downloads the contents of a remote directory a
+  # local directory, optionally in a recursive fashion.
+  #
+  def Dir.download(dst, src, recursive = false, force = true, &stat)
+
+    self.entries(src).each { |src_sub|
+      dst_item = dst + ::File::SEPARATOR + client.unicode_filter_encode( src_sub )
+      src_item = src + client.fs.file.separator + client.unicode_filter_encode( src_sub )
+
+      if (src_sub == '.' or src_sub == '..')
+        next
+      end
+
+      src_stat = client.fs.filestat.new(src_item)
+
+      if (src_stat.file?)
+        stat.call('downloading', src_item, dst_item) if (stat)
+        begin
+          client.fs.file.download(dst_item, src_item)
+          stat.call('downloaded', src_item, dst_item) if (stat)
+        rescue ::Rex::Post::Meterpreter::RequestError => e
+          if force
+            stat.call('failed', src_item, dst_item) if (stat)
+          else
+            raise e
+          end
+        end
+
+      elsif (src_stat.directory?)
+        if (recursive == false)
+          next
+        end
+
+        begin
+          ::Dir.mkdir(dst_item)
+        rescue
+        end
+
+        stat.call('mirroring', src_item, dst_item) if (stat)
+        download(dst_item, src_item, recursive, force, &stat)
+        stat.call('mirrored', src_item, dst_item) if (stat)
+      end
+    }
+  end
+
+  #
+  # Uploads the contents of a local directory to a remote
+  # directory, optionally in a recursive fashion.
+  #
+  def Dir.upload(dst, src, recursive = false, &stat)
+    ::Dir.entries(src).each { |src_sub|
+      dst_item = dst + client.fs.file.separator + client.unicode_filter_encode( src_sub )
+      src_item = src + ::File::SEPARATOR + client.unicode_filter_encode( src_sub )
+
+      if (src_sub == '.' or src_sub == '..')
+        next
+      end
+
+      src_stat = ::File.stat(src_item)
+
+      if (src_stat.file?)
+        stat.call('uploading', src_item, dst_item) if (stat)
+        client.fs.file.upload(dst_item, src_item)
+        stat.call('uploaded', src_item, dst_item) if (stat)
+      elsif (src_stat.directory?)
+        if (recursive == false)
+          next
+        end
+
+        begin
+          self.mkdir(dst_item)
+        rescue
+        end
+
+        stat.call('mirroring', src_item, dst_item) if (stat)
+        upload(dst_item, src_item, recursive, &stat)
+        stat.call('mirrored', src_item, dst_item) if (stat)
+      end
+    }
+  end
+
+  #
+  # The path of the directory that was opened.
+  #
+  attr_reader   :path
+protected
+  attr_accessor :client # :nodoc:
+  attr_writer   :path # :nodoc:
+
+end
+
+end; end; end; end; end; end
+