win32-file 0.6.7 → 0.6.8

data/CHANGES

@@ -1,3 +1,8 @@
+== 0.6.8 - 6-Apr-2012
+* Fixed some unused variable warnings for 1.9.3.
+* Minor cleanup of the Rakefile.
+* Fixed an issue with a blockdev test.
+
 == 0.6.7 - 23-Nov-2011
 * Fixed an encoding problem with File.set_permissions for Ruby 1.9.x.
 * Fixed a bug in File.basename where an error could be caused by trailing

data/README

@@ -1,87 +1,97 @@
 == Description
-Extra or redefined methods for the File class on MS Windows.
+  Additional methods for the File class on MS Windows. Plus, several existing
+  methods have been redefined to make them work properly on MS Windows.
 
 == Prerequisites
-* Ruby 1.8.0 or later
-* windows-pr 0.3.0 or later
-* win32-file-stat 1.2.0 or later
+  * windows-pr
+  * win32-file-stat
 
 == Installation
-=== Gem installation
-   gem install win32-file
-=== Local installation
-   rake install
+  gem install win32-file
 
 == Synopsis
-   require 'win32/file'
-
-   p File.hidden?(somefile)
-   p File.attributes(somefile)
-
-   File.open(somefile){ |fh|
-      fh.hidden = true
-   }
-
-== Class methods added - see documentation for details
-* File.attributes
-* File.archive?
-* File.compressed?
-* File.decrypt
-* File.encrypt
-* File.encrypted?
-* File.get_permissions
-* File.hidden?
-* File.indexed?
-* File.longpath
-* File.normal?
-* File.offline?
-* File.readonly?
-* File.remove_attributes
-* File.reparse_point?
-* File.securities
-* File.set_attributes
-* File.set_permissions
-* File.shortpath
-* File.sparse?
-* File.system?
-* File.temporary?
-
-== Instance methods added - see documentation for details
-* File#archive=
-* File#compressed=
-* File#hidden=
-* File#indexed=
-* File#normal=
-* File#offline=
-* File#readonly=
-* File#sparse=
-* File#system=
-* File#temporary=
-
-== Class methods redefined and the reason for redefining them
-* File.basename  # UNC path issues
-* File.blksize   # Wasn't implemented
-* File.blockdev? # Wasn't implemented
-* File.chardev?  # Wasn't implemented
-* File.dirname   # UNC path issues
-* File.size      # 2GB limitation
-* File.split     # UNC path issues
+  require 'win32/file'
+
+  p File.hidden?(somefile)
+  p File.attributes(somefile)
+
+  File.open(somefile){ |fh|
+    fh.hidden = true
+  }
+
+== Singleton Methods Added
+  * File.attributes
+  * File.archive?
+  * File.compressed?
+  * File.decrypt
+  * File.encrypt
+  * File.encrypted?
+  * File.get_permissions
+  * File.hidden?
+  * File.indexed?
+  * File.longpath
+  * File.normal?
+  * File.offline?
+  * File.readonly?
+  * File.remove_attributes
+  * File.reparse_point?
+  * File.securities
+  * File.set_attributes
+  * File.set_permissions
+  * File.shortpath
+  * File.sparse?
+  * File.system?
+  * File.temporary?
+
+== Instance Methods Added
+  * File#archive=
+  * File#compressed=
+  * File#hidden=
+  * File#indexed=
+  * File#normal=
+  * File#offline=
+  * File#readonly=
+  * File#sparse=
+  * File#system=
+  * File#temporary=
+
+== Singleton Methods Redefined
+  * File.basename   # UNC path issues
+  * File.blksize    # Not implemented in MRI
+  * File.blockdev?  # Not implemented in MRI
+  * File.chardev?   # Not implemented in MRI
+  * File.directory? # Wide character string handling
+  * File.dirname    # UNC path issues
+  * File.lstat      # Not implemented in MRI
+  * File.readlink   # Not implemented in MRI
+  * File.size       # 2GB limitation
+  * File.split      # UNC path issues
+  * File.stat       # Uses object returned by win32-file-stat
+  * File.symlink    # Not implemented in MRI
+  * File.symlink?   # Not implemented in MRI
 
 == Known issues or bugs
-None that I'm aware of. Please report any bugs you find on the project page
-at http://www.rubyforge.org/projects/win32utils.
+  None that I'm aware of.
+
+  Please report any issues you find on the github page at:
+
+  https://github.com/djberg96/win32-file/issues
+
+  Or the Win32Utils project page at:
+
+  http://www.rubyforge.org/projects/win32utils.
 
 == License
-Artistic 2.0
+  Artistic 2.0
 
 == Copyright
-(C) 2003-2009, Daniel J. Berger, All Rights Reserved
+  (C) 2003-2012, Daniel J. Berger, All Rights Reserved
 
 == Warranty
-This package is provided "as is" and without any express or
-implied warranties, including, without limitation, the implied
-warranties of merchantability and fitness for a particular purpose.
+  This package is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
 
 == Authors
-* Daniel J. Berger
-* Park Heesob
+  * Daniel J. Berger
+  * Park Heesob

data/Rakefile

@@ -1,8 +1,6 @@
 require 'rake'
 require 'rake/testtask'
 require 'rake/clean'
-require 'rbconfig'
-include Config
 
 CLEAN.include("**/*.txt", "**/*.gem", "**/*.rbc")
 

data/lib/win32/file.rb

@@ -1,1298 +1,1296 @@
-require 'windows/security'
-require 'windows/limits'
-require 'win32/file/stat'
-
-class File
-  include Windows::Error
-  include Windows::File
-  include Windows::Security
-  include Windows::Limits
-  include Windows::DeviceIO
-  include Windows::Handle
-
-  extend Windows::Error
-  extend Windows::File
-  extend Windows::Path
-  extend Windows::Security
-  extend Windows::MSVCRT::Buffer
-  extend Windows::Limits
-  extend Windows::Handle
-   
-  # The version of the win32-file library
-  WIN32_FILE_VERSION = '0.6.7'
-
-  # Abbreviated attribute constants for convenience
-
-  # The file or directory is an archive. Typically used to mark files for
-  # backup or removal.
-  ARCHIVE = FILE_ATTRIBUTE_ARCHIVE
-
-  # The file or directory is encrypted. For a file, this means that all
-  # data in the file is encrypted. For a directory, this means that
-  # encryption is # the default for newly created files and subdirectories.
-  COMPRESSED = FILE_ATTRIBUTE_COMPRESSED
-
-  # The file is hidden. Not included in an ordinary directory listing.
-  HIDDEN = FILE_ATTRIBUTE_HIDDEN
-
-  # A file that does not have any other attributes set.
-  NORMAL = FILE_ATTRIBUTE_NORMAL
-
-  # The data of a file is not immediately available. This attribute indicates
-  # that file data is physically moved to offline storage.
-  OFFLINE = FILE_ATTRIBUTE_OFFLINE
-
-  # The file is read only. Apps can read it, but not write to it or delete it.
-  READONLY = FILE_ATTRIBUTE_READONLY
-
-  # The file is part of or used exclusively by an operating system.
-  SYSTEM = FILE_ATTRIBUTE_SYSTEM
-
-  # The file is being used for temporary storage.
-  TEMPORARY = FILE_ATTRIBUTE_TEMPORARY
-
-  # The file or directory is to be indexed by the content indexing service.
-  # Note that we have inverted the traditional definition.
-  INDEXED = 0x0002000
-
-  # Synonym for File::INDEXED.
-  CONTENT_INDEXED = INDEXED
-
-  # Custom Security rights  
-
-  # Full security rights - read, write, append, execute, and delete.
-  FULL = STANDARD_RIGHTS_ALL | FILE_READ_DATA | FILE_WRITE_DATA |
-    FILE_APPEND_DATA | FILE_READ_EA | FILE_WRITE_EA | FILE_EXECUTE |
-    FILE_DELETE_CHILD | FILE_READ_ATTRIBUTES | FILE_WRITE_ATTRIBUTES
-
-  # Generic write, generic read, execute and delete privileges
-  CHANGE = FILE_GENERIC_WRITE | FILE_GENERIC_READ | FILE_EXECUTE | DELETE
-
-  # Read and execute privileges
-  READ = FILE_GENERIC_READ | FILE_EXECUTE
-
-  # Add privileges
-  ADD = 0x001201bf
-
-  # :stopdoc:
-
-  SECURITY_RIGHTS = {
-    'FULL'    => FULL,
-    'DELETE'  => DELETE, 
-    'READ'    => READ, 
-    'CHANGE'  => CHANGE,
-    'ADD'     => ADD
-  }
-
-  # :startdoc: 
-
-  ### Class Methods
-
-  class << self
-
-    # :stopdoc:
-
-    # Strictly for making this code -w clean. They are removed later.
-    alias basename_orig basename
-    alias blockdev_orig blockdev?
-    alias chardev_orig chardev?
-    alias directory_orig? directory?
-    alias dirname_orig dirname
-    alias join_orig join
-    alias lstat_orig lstat
-    alias readlink_orig readlink
-    alias size_orig size
-    alias split_orig split
-    alias stat_orig stat
-    alias symlink_orig symlink
-    alias symlink_orig? symlink?
-
-    # :startdoc:
-
-    ## Security
-      
-    # Sets the file permissions for the given file name.  The 'permissions'
-    # argument is a hash with an account name as the key, and the various
-    # permission constants as possible values. The possible constant values
-    # are:
-    #
-    # * FILE_READ_DATA
-    # * FILE_WRITE_DATA
-    # * FILE_APPEND_DATA
-    # * FILE_READ_EA
-    # * FILE_WRITE_EA
-    # * FILE_EXECUTE
-    # * FILE_DELETE_CHILD
-    # * FILE_READ_ATTRIBUTES
-    # * FILE_WRITE_ATTRIBUTES
-    # * STANDARD_RIGHTS_ALL
-    # * FULL
-    # * READ
-    # * ADD
-    # * CHANGE
-    # * DELETE
-    # * READ_CONTROL
-    # * WRITE_DAC
-    # * WRITE_OWNER
-    # * SYNCHRONIZE
-    # * STANDARD_RIGHTS_REQUIRED
-    # * STANDARD_RIGHTS_READ
-    # * STANDARD_RIGHTS_WRITE
-    # * STANDARD_RIGHTS_EXECUTE
-    # * STANDARD_RIGHTS_ALL
-    # * SPECIFIC_RIGHTS_ALL
-    # * ACCESS_SYSTEM_SECURITY
-    # * MAXIMUM_ALLOWED
-    # * GENERIC_READ
-    # * GENERIC_WRITE
-    # * GENERIC_EXECUTE
-    # * GENERIC_ALL
-    #
-    def set_permissions(file, perms)
-      raise TypeError unless file.is_a?(String)
-      raise TypeError unless perms.kind_of?(Hash)
-
-      file = multi_to_wide(file)
-
-      account_rights = 0
-      sec_desc = 0.chr * SECURITY_DESCRIPTOR_MIN_LENGTH
-
-      unless InitializeSecurityDescriptor(sec_desc, 1)
-        raise ArgumentError, get_last_error
-      end
-
-      cb_acl = 1024
-      cb_sid = 1024
-
-      acl_new = 0.chr * cb_acl
-
-      unless InitializeAcl(acl_new, cb_acl, ACL_REVISION2)
-        raise ArgumentError, get_last_error
-      end
-
-      sid      = 0.chr * cb_sid
-      snu_type = 0.chr * cb_sid
-
-      all_ace = 0.chr * ALLOW_ACE_LENGTH
-      all_ace_ptr = memset(all_ace, 0, 0) # address of all_ace
-
-
-      # all_ace_ptr->Header.AceType = ACCESS_ALLOWED_ACE_TYPE
-      all_ace[0] = 0.chr
-
-      perms.each{ |account, mask|
-        next if mask.nil?
-         
-        cch_domain = [80].pack('L')
-        cb_sid     = [1024].pack('L')
-        domain_buf = 0.chr * 80
-
-        server, account = account.split("\\")
-
-        if ['BUILTIN', 'NT AUTHORITY'].include?(server.upcase)
-          server = nil
-        end
-
-        val = LookupAccountName(
-           server,
-           account,
-           sid,
-           cb_sid,
-           domain_buf,
-           cch_domain,
-           snu_type
-        )
-
-        if val == 0
-          raise ArgumentError, get_last_error
-        end
-
-        size = [0,0,0,0,0].pack('CCSLL').length # sizeof(ACCESS_ALLOWED_ACE)
-            
-        val = CopySid(
-          ALLOW_ACE_LENGTH - size,
-          all_ace_ptr + 8,  # address of all_ace_ptr->SidStart
-          sid
-        )
-
-        if val == 0
-          raise ArgumentError, get_last_error
-        end
-
-        if (GENERIC_ALL & mask).nonzero?
-          account_rights = GENERIC_ALL & mask
-        elsif (GENERIC_RIGHTS_CHK & mask).nonzero?
-          account_rights = GENERIC_RIGHTS_MASK & mask
-        end
-
-        # all_ace_ptr->Header.AceFlags = INHERIT_ONLY_ACE|OBJECT_INHERIT_ACE
-        all_ace[1] = (INHERIT_ONLY_ACE | OBJECT_INHERIT_ACE).chr
-
-        # WHY DO I NEED THIS RUBY CORE TEAM? WHY?!?!?!?!?!?
-        all_ace.force_encoding('ASCII-8BIT') if RUBY_VERSION.to_f >= 1.9
-
-        2.times{
-          if account_rights != 0
-            all_ace[2,2] = [12 - 4 + GetLengthSid(sid)].pack('S')
-            all_ace[4,4] = [account_rights].pack('L')
-
-            val = AddAce(
-              acl_new,
-              ACL_REVISION2,
-              MAXDWORD,
-              all_ace_ptr,
-              all_ace[2,2].unpack('S').first
-            )
-
-            if val == 0
-              raise ArgumentError, get_last_error
-            end
-
-            # all_ace_ptr->Header.AceFlags = CONTAINER_INHERIT_ACE
-            all_ace[1] = CONTAINER_INHERIT_ACE.chr
-          else
-            # all_ace_ptr->Header.AceFlags = 0
-            all_ace[1] = 0.chr
-          end
-
-          account_rights = REST_RIGHTS_MASK & mask
-        }
-      }
-
-      unless SetSecurityDescriptorDacl(sec_desc, 1, acl_new, 0)
-        raise ArgumentError, get_last_error
-      end
-
-      unless SetFileSecurityW(file, DACL_SECURITY_INFORMATION, sec_desc)
-        raise ArgumentError, get_last_error
-      end
-
-      self
-    end
-      
-    # Returns an array of human-readable strings that correspond to the
-    # permission flags.
-    #
-    def securities(mask)
-      sec_array = []
-      if mask == 0
-        sec_array.push('NONE')
-      else
-        if (mask & FULL) ^ FULL == 0
-          sec_array.push('FULL')
-        else
-          SECURITY_RIGHTS.each{ |string, numeric|
-            if (numeric & mask) ^ numeric == 0
-              sec_array.push(string)
-            end
-          }
-        end
-      end
-      sec_array
-    end
-
-    # Returns a hash describing the current file permissions for the given
-    # file.  The account name is the key, and the value is an integer
-    # representing an or'd value that corresponds to the security
-    # permissions for that file.
-    #
-    # To get a human readable version of the permissions, pass the value to
-    # the +File.securities+ method.
-    #
-    def get_permissions(file, host=nil)
-      current_length = 0
-      length_needed  = [0].pack('L')
-      sec_buf = ''
-
-      loop do
-        bool = GetFileSecurityW(
-          multi_to_wide(file),
-          DACL_SECURITY_INFORMATION,
-          sec_buf,
-          sec_buf.length,
-          length_needed
-        )
-
-        if bool == 0 && GetLastError() != ERROR_INSUFFICIENT_BUFFER
-          raise ArgumentError, get_last_error
-        end
-            
-        break if sec_buf.length >= length_needed.unpack('L').first
-        sec_buf += ' ' * length_needed.unpack('L').first
-      end
-
-      control  = [0].pack('L')
-      revision = [0].pack('L')
-
-      unless GetSecurityDescriptorControl(sec_buf, control, revision)
-        raise ArgumentError, get_last_error
-      end
-
-      # No DACL exists
-      if (control.unpack('L').first & SE_DACL_PRESENT) == 0
-        raise ArgumentError, 'No DACL present: explicit deny all'
-      end
-
-      dacl_present   = [0].pack('L')
-      dacl_defaulted = [0].pack('L')
-      dacl_ptr       = [0].pack('L')
-
-      val = GetSecurityDescriptorDacl(
-        sec_buf,
-        dacl_present,
-        dacl_ptr,
-        dacl_defaulted
-      )
-
-      if val == 0
-        raise ArgumentError, get_last_error
-      end
-
-      acl_buf = 0.chr * 8 # byte, byte, word, word, word (struct ACL)
-      memcpy(acl_buf, dacl_ptr.unpack('L').first, acl_buf.size)
-
-      if acl_buf.unpack('CCSSS').first == 0
-        raise ArgumentError, 'DACL is NULL: implicit access grant'
-      end
-
-      ace_ptr   = [0].pack('L')
-      ace_count = acl_buf.unpack('CCSSS')[3]
-
-      perms_hash = {}
-
-      0.upto(ace_count - 1){ |i|
-        unless GetAce(dacl_ptr.unpack('L').first, i, ace_ptr)
-          next
-        end
-
-        ace_buf = 0.chr * 12 # ACE_HEADER, dword, dword (ACCESS_ALLOWED_ACE)
-        memcpy(ace_buf, ace_ptr.unpack('L').first, ace_buf.size)
-
-        if ace_buf.unpack('CCS').first == ACCESS_ALLOWED_ACE_TYPE
-          name        = 0.chr * MAXPATH
-          name_size   = [name.size].pack('L')
-          domain      = 0.chr * MAXPATH
-          domain_size = [domain.size].pack('L')
-          snu_ptr     = 0.chr * 4
-               
-          val = LookupAccountSid(
-            host,
-            ace_ptr.unpack('L').first + 8, # address of ace_ptr->SidStart
-            name,
-            name_size,
-            domain,
-            domain_size,
-            snu_ptr
-          )
-               
-          if val == 0
-            raise ArgumentError, get_last_error
-          end
-               
-          name   = name[0..name_size.unpack('L').first].split(0.chr)[0]
-          domain = domain[0..domain_size.unpack('L').first].split(0.chr)[0]
-          mask   = ace_buf.unpack('LLL')[1]
-               
-          unless domain.nil? || domain.empty?
-            name = domain + '\\' + name
-          end
-              
-          perms_hash[name] = mask
-        end
-      }
-      perms_hash
-    end
-      
-    ## Encryption
-      
-    # Encrypts a file or directory. All data streams in a file are encrypted.
-    # All new files created in an encrypted directory are encrypted.
-    #
-    # The caller must have the FILE_READ_DATA, FILE_WRITE_DATA,
-    # FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES, and SYNCHRONIZE access
-    # rights.
-    # 
-    # Requires exclusive access to the file being encrypted, and will fail if
-    # another process is using the file.  If the file is compressed,
-    # EncryptFile will decompress the file before encrypting it.
-    #
-    def encrypt(file)
-      unless EncryptFileW(multi_to_wide(file))
-        raise ArgumentError, get_last_error
-      end
-      self
-    end
-      
-    # Decrypts an encrypted file or directory.
-    #  
-    # The caller must have the FILE_READ_DATA, FILE_WRITE_DATA,
-    # FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES, and SYNCHRONIZE access
-    # rights.
-    # 
-    # Requires exclusive access to the file being decrypted, and will fail if
-    # another process is using the file. If the file is not encrypted an error
-    # is NOT raised.
-    # 
-    # Windows 2000 or later only.
-    #
-    def decrypt(file)
-      unless DecryptFileW(multi_to_wide(file), 0)
-        raise ArgumentError, get_last_error
-      end
-      self
-    end
-
-    ## Path methods
-    
-    # Returns the last component of the filename given in +filename+.  If
-    # +suffix+ is given and present at the end of +filename+, it is removed.
-    # Any extension can be removed by giving an extension of ".*".
-    #
-    # This was reimplemented because the current version does not handle UNC
-    # paths properly, i.e. it should not return anything less than the root.
-    # In all other respects it is identical to the current implementation.
-    #
-    # Unlike MRI, this version will convert all forward slashes to
-    # backslashes automatically.
-    #
-    # Examples:
-    #
-    #    File.basename("C:\\foo\\bar.txt")         -> "bar.txt"
-    #    File.basename("C:\\foo\\bar.txt", ".txt") -> "bar"
-    #    File.basename("\\\\foo\\bar")             -> "\\\\foo\\bar"
-    #
-    def basename(file, suffix = nil)
-      raise TypeError unless file.is_a?(String)
-      raise TypeError unless suffix.is_a?(String) if suffix
-
-      return file if file.empty? # Return an empty path as-is.
-      file = multi_to_wide(file)
-
-      # Required for Windows API functions to work properly.
-      file.tr!(File::SEPARATOR, File::ALT_SEPARATOR)
-
-      # Return a root path as-is.
-      return wide_to_multi(file) if PathIsRootW(file)
-             
-      PathStripPathW(file) # Gives us the basename
-       
-      if suffix
-        if suffix == '.*'
-          PathRemoveExtensionW(file)
-        else
-          if PathFindExtensionA(wide_to_multi(file)) == suffix
-             PathRemoveExtensionW(file)
-          end
-        end
-      end
-
-      file = wide_to_multi(file)
-      file.sub!(/\\+\z/, '') # Trim trailing slashes
-
-      file
-    end
-
-    # Returns true if +file+ is a directory, false otherwise.
-    #--
-    # This method was redefined to handle wide character strings.
-    #
-    def directory?(file)
-      file = multi_to_wide(file)
-      attributes = GetFileAttributesW(file)
-      (attributes != INVALID_FILE_ATTRIBUTES) && (attributes & FILE_ATTRIBUTE_DIRECTORY > 0)
-    end
-
-    # Returns all components of the filename given in +filename+ except the
-    # last one.
-    # 
-    # This was reimplemented because the current version does not handle UNC
-    # paths properly, i.e. it should not return anything less than the root.
-    # In all other respects it is identical to the current implementation.
-    #
-    # Also, this method will convert all forward slashes to backslashes.
-    #
-    # Examples:
-    #
-    #    File.dirname("C:\\foo\\bar\\baz.txt") -> "C:\\foo\\bar"
-    #    File.dirname("\\\\foo\\bar")          -> "\\\\foo\\bar"
-    #
-    def dirname(file)
-      raise TypeError unless file.is_a?(String)
-
-      # Short circuit for empty paths
-      return '.' if file.empty?
-
-      # Temporarily convert to wide-byte
-      file = multi_to_wide(file)
-
-      # Convert slashes to backslashes for the Windows API functions
-      file.tr!(File::SEPARATOR, File::ALT_SEPARATOR)
-         
-      # Return a root path as-is.
-      return wide_to_multi(file) if PathIsRootW(file)
-
-      # Remove trailing slashes if present
-      while result = PathRemoveBackslashW(file)
-        break unless result.empty?
-      end
-
-      # Remove trailing file name if present
-      PathRemoveFileSpecW(file)
-
-      # Return to multi-byte
-      file = wide_to_multi(file)
-       
-      # Empty paths, short relative paths
-      if file.nil? || (file && file.empty?)
-        return '.'
-      end
-         
-      file
-    end
-
-    # Join path string components together into a single string.
-    #
-    # This method was reimplemented so that it automatically converts
-    # forward slashes to backslashes. It is otherwise identical to
-    # the core File.join method.
-    #
-    # Examples:
-    #
-    #   File.join("C:", "foo", "bar") # => C:\foo\bar
-    #   File.join("foo", "bar")       # => foo\bar
-    #
-    def join(*args)
-      return join_orig(*args).tr("/", "\\")
-    end
-
-    # Returns +path+ in long format. For example, if 'SOMEFI~1.TXT'
-    # was the argument provided, and the short representation for
-    # 'somefile.txt', then this method would return 'somefile.txt'.
-    #
-    # Note that certain file system optimizations may prevent this method
-    # from working as expected.  In that case, you will get back the file
-    # name in 8.3 format.
-    #
-    def long_path(path)
-      buf = 0.chr * MAXPATH
-      if GetLongPathNameW(multi_to_wide(path), buf, buf.size) == 0
-        raise ArgumentError, get_last_error
-      end
-      wide_to_multi(buf)
-    end
-
-    # Returns the path of the of the symbolic link referred to by +file+.
-    #
-    # Requires Windows Vista or later. On older versions of Windows it
-    # will raise a NotImplementedError, as per MRI.
-    #
-    def readlink(file)
-      if defined? GetFinalPathNameByHandle
-        file = multi_to_wide(file)
-
-        begin
-          handle = CreateFileW(
-            file,
-            GENERIC_READ,
-            FILE_SHARE_READ,
-            nil,
-            OPEN_EXISTING,
-            FILE_ATTRIBUTE_NORMAL,
-            nil
-          )
-
-          if handle == INVALID_HANDLE_VALUE
-            raise ArgumentError, get_last_error
-          end
-
-          path = 0.chr * MAXPATH
-
-          GetFinalPathNameByHandleW(handle, path, path.size, 0)
-        ensure
-          CloseHandle(handle)
-        end
-
-        wide_to_multi(path).strip[4..-1] # get rid of prepending "\\?\"
-      else
-        msg = "readlink() function is unimplemented on this machine"
-        raise NotImplementedError, msg
-      end
-    end
-
-    # Returns +path+ in 8.3 format. For example, 'c:\documentation.doc'
-    # would be returned as 'c:\docume~1.doc'.
-    #
-    def short_path(path)
-      buf = 0.chr * MAXPATH
-      if GetShortPathNameW(multi_to_wide(path), buf, buf.size) == 0
-        raise ArgumentError, get_last_error
-      end
-      wide_to_multi(buf)
-    end
-
-    # Splits the given string into a directory and a file component and
-    # returns them in a two element array. This was reimplemented because
-    # the current version does not handle UNC paths properly.
-    # 
-    def split(file)
-      array = []
-         
-      if file.empty? || PathIsRootW(multi_to_wide(file))
-        array.push(file, '')
-      else
-        array.push(File.dirname(file), File.basename(file))
-      end
-      array
-    end
-
-    # Creates a symbolic link called +new_name+ for the file or directory
-    # +old_name+.
-    #
-    # This method requires Windows Vista or later to work. Otherwise, it
-    # returns nil as per MRI.
-    #
-    def symlink(old_name, new_name)
-      if defined? CreateSymbolicLink
-        old_name = multi_to_wide(old_name)
-        new_name = multi_to_wide(new_name)
-        flags    = File.directory?(wide_to_multi(old_name)) ? 1 : 0
-
-        unless CreateSymbolicLinkW(new_name, old_name, flags)
-          raise ArgumentError, get_last_error
-        end
-      else
-        nil
-      end
-    end
-
-    # Return true if the named file is a symbolic link, false otherwise.
-    #
-    # This method requires Windows Vista or later to work. Otherwise, it
-    # always returns false as per MRI.
-    #
-    def symlink?(file)
-      bool = false
-      file = multi_to_wide(file)
-      attr = GetFileAttributesW(file)
-
-      # Differentiate between a symlink and other kinds of reparse points
-      if attr & FILE_ATTRIBUTE_REPARSE_POINT > 0
-        begin
-          buffer = 0.chr * 278 # WIN32_FIND_DATA
-          handle = FindFirstFileW(file, buffer)
-
-          if handle == INVALID_HANDLE_VALUE
-            raise ArgumentError, get_last_error
-          end
-
-          if buffer[36,4].unpack('L')[0] == IO_REPARSE_TAG_SYMLINK
-            bool = true
-          end
-        ensure
-          CloseHandle(handle)
-        end
-      end
-
-      bool
-    end
-
-    ## Stat methods
-    
-    # Returns a File::Stat object, as defined in the win32-file-stat package.
-    # 
-    def stat(file)
-      File::Stat.new(file)
-    end
-      
-    # Identical to File.stat on Windows.
-    # 
-    def lstat(file)
-      File::Stat.new(file)
-    end
-      
-    # Returns the file system's block size.
-    #
-    def blksize(file)
-      File::Stat.new(file).blksize
-    end
-
-    # Returns whether or not +file+ is a block device. For MS Windows this
-    # means a removable drive, cdrom or ramdisk.
-    #
-    def blockdev?(file)
-      File::Stat.new(file).blockdev?
-    end
-
-    # Returns true if the file is a character device.  This replaces the
-    # current Ruby implementation which always returns false.
-    #
-    def chardev?(file)
-      File::Stat.new(file).chardev?
-    end
-
-    # Returns the size of the file in bytes.
-    #
-    # This was reimplemented because the current version does not handle file
-    # sizes greater than 2gb.
-    #
-    def size(file)
-      File::Stat.new(file).size
-    end
-
-    # We no longer need the aliases, so remove them
-    remove_method(:basename_orig, :blockdev_orig, :chardev_orig)
-    remove_method(:dirname_orig, :lstat_orig, :size_orig, :split_orig)
-    remove_method(:stat_orig, :symlink_orig, :symlink_orig?, :readlink_orig)
-    remove_method(:directory_orig?)
-  end # class << self
-
-  ## Attribute methods
-
-  # Returns true if the file or directory is an archive file. Applications
-  # use this attribute to mark files for backup or removal.
-  # 
-  def self.archive?(file)
-    File::Stat.new(file).archive?
-  end
-   
-  # Returns true if the file or directory is compressed. For a file, this
-  # means that all of the data in the file is compressed. For a directory,
-  # this means that compression is the default for newly created files and
-  # subdirectories.
-  #
-  def self.compressed?(file)
-    File::Stat.new(file).compressed?
-  end
-
-  # Returns true if the file or directory is encrypted. For a file, this
-  # means that all data in the file is encrypted. For a directory, this
-  # means that encryption is the default for newly created files and
-  # subdirectories.
-  #
-  def self.encrypted?(file)
-    File::Stat.new(file).encrypted?
-  end
-
-  # Returns true if the file or directory is hidden. It is not included
-  # in an ordinary directory listing.
-  # 
-  def self.hidden?(file)
-    File::Stat.new(file).hidden?
-  end
-   
-  # Returns true if the file or directory is indexed by the content indexing
-  # service.
-  #
-  def self.indexed?(file)
-    File::Stat.new(file).indexed?
-  end
-
-  # Returns true if the file or directory has no other attributes set.
-  #
-  def self.normal?(file)
-    File::Stat.new(file).normal?
-  end
-   
-  # Returns true if the data of the file is not immediately available. This
-  # attribute indicates that the file data has been physically moved to
-  # offline storage. This attribute is used by Remote Storage, the
-  # hierarchical storage management software. Applications should not
-  # arbitrarily change this attribute.
-  #
-  def self.offline?(file)
-    File::Stat.new(file).offline?
-  end
-
-  # Returns true if The file or directory is read-only. Applications can
-  # read the file but cannot write to it or delete it. In the case of a
-  # directory, applications cannot delete it.
-  #
-  def self.readonly?(file)
-    File::Stat.new(file).readonly?
-  end
-
-  # Returns true if the file or directory has an associated reparse point. A
-  # reparse point is a collection of user defined data associated with a file
-  # or directory.  For more on reparse points, search
-  # http://msdn.microsoft.com.
-  #
-  def self.reparse_point?(file)
-    File::Stat.new(file).reparse_point?
-  end
-
-  # Returns true if the file is a sparse file.  A sparse file is a file in
-  # which much of the data is zeros, typically image files.  See
-  # http://msdn.microsoft.com for more details.
-  #
-  def self.sparse?(file)
-    File::Stat.new(file).sparse?
-  end
-
-  # Returns true if the file or directory is part of the operating system
-  # or is used exclusively by the operating system.
-  #
-  def self.system?(file)
-    File::Stat.new(file).system?
-  end
-
-  # Returns true if the file is being used for temporary storage.
-  #
-  # File systems avoid writing data back to mass storage if sufficient cache
-  # memory is available, because often the application deletes the temporary
-  # file shortly after the handle is closed. In that case, the system can
-  # entirely avoid writing the data. Otherwise, the data will be written after
-  # the handle is closed.
-  #
-  def self.temporary?(file)
-    File::Stat.new(file).temporary?
-  end
-   
-  # Returns an array of strings indicating the attributes for that file.  The
-  # possible values are:
-  # 
-  # archive
-  # compressed
-  # directory
-  # encrypted
-  # hidden
-  # indexed
-  # normal
-  # offline
-  # readonly
-  # reparse_point
-  # sparse
-  # system
-  # temporary
-  #
-  def self.attributes(file)
-    attributes = GetFileAttributesW(multi_to_wide(file))
-      
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-
-    arr = []
-
-    arr << 'archive' if attributes & FILE_ATTRIBUTE_ARCHIVE > 0
-    arr << 'compressed' if attributes & FILE_ATTRIBUTE_COMPRESSED > 0
-    arr << 'directory' if attributes & FILE_ATTRIBUTE_DIRECTORY > 0
-    arr << 'encrypted' if attributes & FILE_ATTRIBUTE_ENCRYPTED > 0
-    arr << 'hidden' if attributes & FILE_ATTRIBUTE_HIDDEN > 0
-    arr << 'indexed' if attributes & FILE_ATTRIBUTE_NOT_CONTENT_INDEXED == 0
-    arr << 'normal' if attributes & FILE_ATTRIBUTE_NORMAL > 0
-    arr << 'offline' if attributes & FILE_ATTRIBUTE_OFFLINE > 0
-    arr << 'readonly' if attributes & FILE_ATTRIBUTE_READONLY > 0
-    arr << 'reparse_point' if attributes & FILE_ATTRIBUTE_REPARSE_POINT > 0
-    arr << 'sparse' if attributes & FILE_ATTRIBUTE_SPARSE_FILE > 0
-    arr << 'system' if attributes & FILE_ATTRIBUTE_SYSTEM > 0
-    arr << 'temporary' if attributes & FILE_ATTRIBUTE_TEMPORARY > 0
-      
-    arr
-  end
-  
-  # Sets the file attributes based on the given (numeric) +flags+.  This does
-  # not remove existing attributes, it merely adds to them.
-  #
-  def self.set_attributes(file, flags)
-    file = multi_to_wide(file)
-    attributes = GetFileAttributesW(file)
-      
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    attributes |= flags
-     
-    if SetFileAttributesW(file, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-      
-     self
-  end
-   
-  # Removes the file attributes based on the given (numeric) +flags+.
-  #
-  def self.remove_attributes(file, flags)
-    file = multi_to_wide(file)
-    attributes = GetFileAttributesW(file)
-       
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    attributes &= ~flags
-      
-    if SetFileAttributesW(file, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-      
-    self
-  end
-   
-  # Instance methods
-   
-  def stat
-    File::Stat.new(self.path)
-  end
-   
-  # Sets whether or not the file is an archive file.
-  #
-  def archive=(bool)
-    wide_path  = multi_to_wide(self.path)
-    attributes = GetFileAttributesW(wide_path)
-   
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    if bool
-      attributes |= FILE_ATTRIBUTE_ARCHIVE;
-    else
-      attributes &= ~FILE_ATTRIBUTE_ARCHIVE;
-    end
-      
-    if SetFileAttributesW(wide_path, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-
-    self
-  end
-   
-  # Sets whether or not the file is a compressed file.
-  #
-  def compressed=(bool)     
-    in_buf = bool ? COMPRESSION_FORMAT_DEFAULT : COMPRESSION_FORMAT_NONE
-    in_buf = [in_buf].pack('L')
-    bytes  = [0].pack('L')
-      
-    # We can't use get_osfhandle here because we need specific attributes
-    handle = CreateFileW(
-      multi_to_wide(self.path),
-      FILE_READ_DATA | FILE_WRITE_DATA,
-      FILE_SHARE_READ | FILE_SHARE_WRITE,
-      0,
-      OPEN_EXISTING,
-      0,
-      0
-    )
-      
-    if handle == INVALID_HANDLE_VALUE
-      raise ArgumentError, get_last_error
-    end
-
-    begin
-      bool = DeviceIoControl(
-        handle,
-        FSCTL_SET_COMPRESSION(),
-        in_buf,
-        in_buf.length,
-        0,
-        0,
-        bytes,
-        0
-      )
-      
-      unless bool
-        raise ArgumentError, get_last_error
-      end
-    ensure
-      CloseHandle(handle)
-    end
-      
-    self
-  end
-   
-  # Sets the hidden attribute to true or false.  Setting this attribute to
-  # true means that the file is not included in an ordinary directory listing.
-  #
-  def hidden=(bool)     
-    wide_path  = multi_to_wide(self.path)
-    attributes = GetFileAttributesW(wide_path)
-    
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    if bool
-      attributes |= FILE_ATTRIBUTE_HIDDEN;
-    else
-      attributes &= ~FILE_ATTRIBUTE_HIDDEN;
-    end
-      
-    if SetFileAttributesW(wide_path, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-
-    self
-  end
-   
-  # Sets the 'indexed' attribute to true or false.  Setting this to
-  # false means that the file will not be indexed by the content indexing
-  # service.
-  #
-  def indexed=(bool)
-    wide_path  = multi_to_wide(self.path)
-    attributes = GetFileAttributesW(wide_path)
-     
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    if bool
-      attributes &= ~FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
-    else
-      attributes |= FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
-    end
-      
-    if SetFileAttributes(wide_path, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-
-    self
-  end
-   
-   alias :content_indexed= :indexed=
-   
-  # Sets the normal attribute. Note that only 'true' is a valid argument,
-  # which has the effect of removing most other attributes.  Attempting to
-  # pass any value except true will raise an ArgumentError.
-  #
-  def normal=(bool)
-    unless bool
-      raise ArgumentError, "only 'true' may be passed as an argument"
-    end
-
-    if SetFileAttributesW(multi_to_wide(self.path),FILE_ATTRIBUTE_NORMAL) == 0
-      raise ArgumentError, get_last_error
-    end
-
-    self
-  end
-   
-  # Sets whether or not a file is online or not.  Setting this to false means
-	# that the data of the file is not immediately available. This attribute
-	# indicates that the file data has been physically moved to offline storage.
-	# This attribute is used by Remote Storage, the hierarchical storage
-	# management software.
-  # 
-	# Applications should not arbitrarily change this attribute.
-  #
-  def offline=(bool)
-    wide_path  = multi_to_wide(self.path)
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    if bool
-      attributes |= FILE_ATTRIBUTE_OFFLINE;
-    else
-      attributes &= ~FILE_ATTRIBUTE_OFFLINE;
-    end
-      
-    if SetFileAttributesW(wide_path, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-
-    self
-  end
-   
-  # Sets the readonly attribute.  If set to true the the file or directory is
-  # readonly. Applications can read the file but cannot write to it or delete
-  # it. In the case of a directory, applications cannot delete it.
-  # 
-  def readonly=(bool)
-    wide_path  = multi_to_wide(self.path)
-    attributes = GetFileAttributesW(wide_path)
-      
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    if bool
-      attributes |= FILE_ATTRIBUTE_READONLY;
-    else
-      attributes &= ~FILE_ATTRIBUTE_READONLY;
-    end
-      
-    if SetFileAttributesW(wide_path, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-
-    self
-  end
-   
-  # Sets the file to a sparse (usually image) file.  Note that you cannot
-  # remove the sparse property from a file.
-  #
-  def sparse=(bool)     
-    unless bool
-      warn 'cannot remove sparse property from a file - operation ignored'
-      return
-    end
-      
-    bytes = [0].pack('L')
-      
-    handle = CreateFileW(
-      multi_to_wide(self.path),
-      FILE_READ_DATA | FILE_WRITE_DATA,
-      FILE_SHARE_READ | FILE_SHARE_WRITE,
-      0,
-      OPEN_EXISTING,
-      FSCTL_SET_SPARSE(),
-      0
-    )
-      
-    if handle == INVALID_HANDLE_VALUE
-      raise ArgumentError, get_last_error
-    end
-      
-    begin
-      bool = DeviceIoControl(
-        handle,
-        FSCTL_SET_SPARSE(),
-        0,
-        0,
-        0,
-        0,
-        bytes,
-        0
-      )
-      
-      unless bool == 0
-        raise ArgumentError, get_last_error
-      end
-    ensure
-      CloseHandle(handle)
-    end
-      
-    self
-  end
-   
-  # Set whether or not the file is a system file.  A system file is a file
-	# that is part of the operating system or is used exclusively by it.
-  #
-  def system=(bool)
-    wide_path  = multi_to_wide(self.path)
-    attributes = GetFileAttributesW(wide_path)
-      
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    if bool
-      attributes |= FILE_ATTRIBUTE_SYSTEM;
-    else
-      attributes &= ~FILE_ATTRIBUTE_SYSTEM;
-    end
-      
-    if SetFileAttributesW(wide_path, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-
-    self
-  end
-   
-  # Sets whether or not the file is being used for temporary storage.
-  # 
-  # File systems avoid writing data back to mass storage if sufficient cache
-  # memory is available, because often the application deletes the temporary
-  # file shortly after the handle is closed. In that case, the system can
-  # entirely avoid writing the data. Otherwise, the data will be written
-  # after the handle is closed.
-  # 
-  def temporary=(bool)
-    wide_path  = multi_to_wide(self.path)
-    attributes = GetFileAttributesW(wide_path)
-
-    if attributes == INVALID_FILE_ATTRIBUTES
-      raise ArgumentError, get_last_error
-    end
-      
-    if bool
-      attributes |= FILE_ATTRIBUTE_TEMPORARY;
-    else
-      attributes &= ~FILE_ATTRIBUTE_TEMPORARY;
-    end
-      
-    if SetFileAttributesW(wide_path, attributes) == 0
-      raise ArgumentError, get_last_error
-    end
-
-    self
-  end
-   
-  # Singleton aliases, mostly for backwards compatibility
-  class << self
-    alias :read_only? :readonly?
-    alias :content_indexed? :indexed?
-    alias :set_attr :set_attributes
-    alias :unset_attr :remove_attributes
-  end
-
-  private
-
-  # Get the owner of a given file by name.
-  #
-  def get_owner(file)
-    handle = CreateFile(
-      file,
-      GENERIC_READ,
-      FILE_SHARE_READ,
-      0,
-      OPEN_EXISTING,
-      0,
-      0
-    )
-
-    if handle == INVALID_HANDLE_VALUE
-      raise ArgumentError, get_last_error
-    end
-
-    sid     = 0.chr * 28
-    sid_ptr = [0].pack('L')
-
-    begin
-      rv = GetSecurityInfo(
-        handle,
-        SE_FILE_OBJECT,
-        OWNER_SECURITY_INFORMATION,
-        sid_ptr,
-        nil,
-        nil,
-        nil,
-        nil
-      )
-
-      if rv != 0
-        raise get_last_error
-      end
-
-      name_buf = 0.chr * 80
-      name_cch = [name_buf.size].pack('L')
-
-      domain_buf = 0.chr * 80
-      domain_cch = [domain_buf.size].pack('L')
-      sid_name   = 0.chr * 4
-
-      bool = LookupAccountSid(
-        nil,
-        sid_ptr.unpack('L').first,
-        name_buf,
-        name_cch,
-        domain_buf,
-        domain_cch,
-        sid_name
-      )
-
-      unless bool
-        raise get_last_error
-      end
-    ensure
-      CloseHandle(handle)
-    end
-      
-    name_buf.strip
-  end
-end
+require 'windows/security'
+require 'windows/limits'
+require 'win32/file/stat'
+
+class File
+  include Windows::Error
+  include Windows::File
+  include Windows::Security
+  include Windows::Limits
+  include Windows::DeviceIO
+  include Windows::Handle
+
+  extend Windows::Error
+  extend Windows::File
+  extend Windows::Path
+  extend Windows::Security
+  extend Windows::MSVCRT::Buffer
+  extend Windows::Limits
+  extend Windows::Handle
+
+  # The version of the win32-file library
+  WIN32_FILE_VERSION = '0.6.8'
+
+  # Abbreviated attribute constants for convenience
+
+  # The file or directory is an archive. Typically used to mark files for
+  # backup or removal.
+  ARCHIVE = FILE_ATTRIBUTE_ARCHIVE
+
+  # The file or directory is encrypted. For a file, this means that all
+  # data in the file is encrypted. For a directory, this means that
+  # encryption is # the default for newly created files and subdirectories.
+  COMPRESSED = FILE_ATTRIBUTE_COMPRESSED
+
+  # The file is hidden. Not included in an ordinary directory listing.
+  HIDDEN = FILE_ATTRIBUTE_HIDDEN
+
+  # A file that does not have any other attributes set.
+  NORMAL = FILE_ATTRIBUTE_NORMAL
+
+  # The data of a file is not immediately available. This attribute indicates
+  # that file data is physically moved to offline storage.
+  OFFLINE = FILE_ATTRIBUTE_OFFLINE
+
+  # The file is read only. Apps can read it, but not write to it or delete it.
+  READONLY = FILE_ATTRIBUTE_READONLY
+
+  # The file is part of or used exclusively by an operating system.
+  SYSTEM = FILE_ATTRIBUTE_SYSTEM
+
+  # The file is being used for temporary storage.
+  TEMPORARY = FILE_ATTRIBUTE_TEMPORARY
+
+  # The file or directory is to be indexed by the content indexing service.
+  # Note that we have inverted the traditional definition.
+  INDEXED = 0x0002000
+
+  # Synonym for File::INDEXED.
+  CONTENT_INDEXED = INDEXED
+
+  # Custom Security rights
+
+  # Full security rights - read, write, append, execute, and delete.
+  FULL = STANDARD_RIGHTS_ALL | FILE_READ_DATA | FILE_WRITE_DATA |
+    FILE_APPEND_DATA | FILE_READ_EA | FILE_WRITE_EA | FILE_EXECUTE |
+    FILE_DELETE_CHILD | FILE_READ_ATTRIBUTES | FILE_WRITE_ATTRIBUTES
+
+  # Generic write, generic read, execute and delete privileges
+  CHANGE = FILE_GENERIC_WRITE | FILE_GENERIC_READ | FILE_EXECUTE | DELETE
+
+  # Read and execute privileges
+  READ = FILE_GENERIC_READ | FILE_EXECUTE
+
+  # Add privileges
+  ADD = 0x001201bf
+
+  # :stopdoc:
+
+  SECURITY_RIGHTS = {
+    'FULL'    => FULL,
+    'DELETE'  => DELETE,
+    'READ'    => READ,
+    'CHANGE'  => CHANGE,
+    'ADD'     => ADD
+  }
+
+  # :startdoc:
+
+  ### Class Methods
+
+  class << self
+
+    # :stopdoc:
+
+    # Strictly for making this code -w clean. They are removed later.
+    alias basename_orig basename
+    alias blockdev_orig blockdev?
+    alias chardev_orig chardev?
+    alias directory_orig? directory?
+    alias dirname_orig dirname
+    alias join_orig join
+    alias lstat_orig lstat
+    alias readlink_orig readlink
+    alias size_orig size
+    alias split_orig split
+    alias stat_orig stat
+    alias symlink_orig symlink
+    alias symlink_orig? symlink?
+
+    # :startdoc:
+
+    ## Security
+
+    # Sets the file permissions for the given file name.  The 'permissions'
+    # argument is a hash with an account name as the key, and the various
+    # permission constants as possible values. The possible constant values
+    # are:
+    #
+    # * FILE_READ_DATA
+    # * FILE_WRITE_DATA
+    # * FILE_APPEND_DATA
+    # * FILE_READ_EA
+    # * FILE_WRITE_EA
+    # * FILE_EXECUTE
+    # * FILE_DELETE_CHILD
+    # * FILE_READ_ATTRIBUTES
+    # * FILE_WRITE_ATTRIBUTES
+    # * STANDARD_RIGHTS_ALL
+    # * FULL
+    # * READ
+    # * ADD
+    # * CHANGE
+    # * DELETE
+    # * READ_CONTROL
+    # * WRITE_DAC
+    # * WRITE_OWNER
+    # * SYNCHRONIZE
+    # * STANDARD_RIGHTS_REQUIRED
+    # * STANDARD_RIGHTS_READ
+    # * STANDARD_RIGHTS_WRITE
+    # * STANDARD_RIGHTS_EXECUTE
+    # * STANDARD_RIGHTS_ALL
+    # * SPECIFIC_RIGHTS_ALL
+    # * ACCESS_SYSTEM_SECURITY
+    # * MAXIMUM_ALLOWED
+    # * GENERIC_READ
+    # * GENERIC_WRITE
+    # * GENERIC_EXECUTE
+    # * GENERIC_ALL
+    #
+    def set_permissions(file, perms)
+      raise TypeError unless file.is_a?(String)
+      raise TypeError unless perms.kind_of?(Hash)
+
+      file = multi_to_wide(file)
+
+      account_rights = 0
+      sec_desc = 0.chr * SECURITY_DESCRIPTOR_MIN_LENGTH
+
+      unless InitializeSecurityDescriptor(sec_desc, 1)
+        raise ArgumentError, get_last_error
+      end
+
+      cb_acl = 1024
+      cb_sid = 1024
+
+      acl_new = 0.chr * cb_acl
+
+      unless InitializeAcl(acl_new, cb_acl, ACL_REVISION2)
+        raise ArgumentError, get_last_error
+      end
+
+      sid      = 0.chr * cb_sid
+      snu_type = 0.chr * cb_sid
+
+      all_ace = 0.chr * ALLOW_ACE_LENGTH
+      all_ace_ptr = memset(all_ace, 0, 0) # address of all_ace
+
+
+      # all_ace_ptr->Header.AceType = ACCESS_ALLOWED_ACE_TYPE
+      all_ace[0] = 0.chr
+
+      perms.each{ |account, mask|
+        next if mask.nil?
+
+        cch_domain = [80].pack('L')
+        cb_sid     = [1024].pack('L')
+        domain_buf = 0.chr * 80
+
+        server, account = account.split("\\")
+
+        if ['BUILTIN', 'NT AUTHORITY'].include?(server.upcase)
+          server = nil
+        end
+
+        val = LookupAccountName(
+           server,
+           account,
+           sid,
+           cb_sid,
+           domain_buf,
+           cch_domain,
+           snu_type
+        )
+
+        if val == 0
+          raise ArgumentError, get_last_error
+        end
+
+        size = [0,0,0,0,0].pack('CCSLL').length # sizeof(ACCESS_ALLOWED_ACE)
+
+        val = CopySid(
+          ALLOW_ACE_LENGTH - size,
+          all_ace_ptr + 8,  # address of all_ace_ptr->SidStart
+          sid
+        )
+
+        if val == 0
+          raise ArgumentError, get_last_error
+        end
+
+        if (GENERIC_ALL & mask).nonzero?
+          account_rights = GENERIC_ALL & mask
+        elsif (GENERIC_RIGHTS_CHK & mask).nonzero?
+          account_rights = GENERIC_RIGHTS_MASK & mask
+        end
+
+        # all_ace_ptr->Header.AceFlags = INHERIT_ONLY_ACE|OBJECT_INHERIT_ACE
+        all_ace[1] = (INHERIT_ONLY_ACE | OBJECT_INHERIT_ACE).chr
+
+        # WHY DO I NEED THIS RUBY CORE TEAM? WHY?!?!?!?!?!?
+        all_ace.force_encoding('ASCII-8BIT') if RUBY_VERSION.to_f >= 1.9
+
+        2.times{
+          if account_rights != 0
+            all_ace[2,2] = [12 - 4 + GetLengthSid(sid)].pack('S')
+            all_ace[4,4] = [account_rights].pack('L')
+
+            val = AddAce(
+              acl_new,
+              ACL_REVISION2,
+              MAXDWORD,
+              all_ace_ptr,
+              all_ace[2,2].unpack('S').first
+            )
+
+            if val == 0
+              raise ArgumentError, get_last_error
+            end
+
+            # all_ace_ptr->Header.AceFlags = CONTAINER_INHERIT_ACE
+            all_ace[1] = CONTAINER_INHERIT_ACE.chr
+          else
+            # all_ace_ptr->Header.AceFlags = 0
+            all_ace[1] = 0.chr
+          end
+
+          account_rights = REST_RIGHTS_MASK & mask
+        }
+      }
+
+      unless SetSecurityDescriptorDacl(sec_desc, 1, acl_new, 0)
+        raise ArgumentError, get_last_error
+      end
+
+      unless SetFileSecurityW(file, DACL_SECURITY_INFORMATION, sec_desc)
+        raise ArgumentError, get_last_error
+      end
+
+      self
+    end
+
+    # Returns an array of human-readable strings that correspond to the
+    # permission flags.
+    #
+    def securities(mask)
+      sec_array = []
+      if mask == 0
+        sec_array.push('NONE')
+      else
+        if (mask & FULL) ^ FULL == 0
+          sec_array.push('FULL')
+        else
+          SECURITY_RIGHTS.each{ |string, numeric|
+            if (numeric & mask) ^ numeric == 0
+              sec_array.push(string)
+            end
+          }
+        end
+      end
+      sec_array
+    end
+
+    # Returns a hash describing the current file permissions for the given
+    # file.  The account name is the key, and the value is an integer
+    # representing an or'd value that corresponds to the security
+    # permissions for that file.
+    #
+    # To get a human readable version of the permissions, pass the value to
+    # the +File.securities+ method.
+    #
+    def get_permissions(file, host=nil)
+      length_needed  = [0].pack('L')
+      sec_buf = ''
+
+      loop do
+        bool = GetFileSecurityW(
+          multi_to_wide(file),
+          DACL_SECURITY_INFORMATION,
+          sec_buf,
+          sec_buf.length,
+          length_needed
+        )
+
+        if bool == 0 && GetLastError() != ERROR_INSUFFICIENT_BUFFER
+          raise ArgumentError, get_last_error
+        end
+
+        break if sec_buf.length >= length_needed.unpack('L').first
+        sec_buf += ' ' * length_needed.unpack('L').first
+      end
+
+      control  = [0].pack('L')
+      revision = [0].pack('L')
+
+      unless GetSecurityDescriptorControl(sec_buf, control, revision)
+        raise ArgumentError, get_last_error
+      end
+
+      # No DACL exists
+      if (control.unpack('L').first & SE_DACL_PRESENT) == 0
+        raise ArgumentError, 'No DACL present: explicit deny all'
+      end
+
+      dacl_present   = [0].pack('L')
+      dacl_defaulted = [0].pack('L')
+      dacl_ptr       = [0].pack('L')
+
+      val = GetSecurityDescriptorDacl(
+        sec_buf,
+        dacl_present,
+        dacl_ptr,
+        dacl_defaulted
+      )
+
+      if val == 0
+        raise ArgumentError, get_last_error
+      end
+
+      acl_buf = 0.chr * 8 # byte, byte, word, word, word (struct ACL)
+      memcpy(acl_buf, dacl_ptr.unpack('L').first, acl_buf.size)
+
+      if acl_buf.unpack('CCSSS').first == 0
+        raise ArgumentError, 'DACL is NULL: implicit access grant'
+      end
+
+      ace_ptr   = [0].pack('L')
+      ace_count = acl_buf.unpack('CCSSS')[3]
+
+      perms_hash = {}
+
+      0.upto(ace_count - 1){ |i|
+        unless GetAce(dacl_ptr.unpack('L').first, i, ace_ptr)
+          next
+        end
+
+        ace_buf = 0.chr * 12 # ACE_HEADER, dword, dword (ACCESS_ALLOWED_ACE)
+        memcpy(ace_buf, ace_ptr.unpack('L').first, ace_buf.size)
+
+        if ace_buf.unpack('CCS').first == ACCESS_ALLOWED_ACE_TYPE
+          name        = 0.chr * MAXPATH
+          name_size   = [name.size].pack('L')
+          domain      = 0.chr * MAXPATH
+          domain_size = [domain.size].pack('L')
+          snu_ptr     = 0.chr * 4
+
+          val = LookupAccountSid(
+            host,
+            ace_ptr.unpack('L').first + 8, # address of ace_ptr->SidStart
+            name,
+            name_size,
+            domain,
+            domain_size,
+            snu_ptr
+          )
+
+          if val == 0
+            raise ArgumentError, get_last_error
+          end
+
+          name   = name[0..name_size.unpack('L').first].split(0.chr)[0]
+          domain = domain[0..domain_size.unpack('L').first].split(0.chr)[0]
+          mask   = ace_buf.unpack('LLL')[1]
+
+          unless domain.nil? || domain.empty?
+            name = domain + '\\' + name
+          end
+
+          perms_hash[name] = mask
+        end
+      }
+      perms_hash
+    end
+
+    ## Encryption
+
+    # Encrypts a file or directory. All data streams in a file are encrypted.
+    # All new files created in an encrypted directory are encrypted.
+    #
+    # The caller must have the FILE_READ_DATA, FILE_WRITE_DATA,
+    # FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES, and SYNCHRONIZE access
+    # rights.
+    #
+    # Requires exclusive access to the file being encrypted, and will fail if
+    # another process is using the file.  If the file is compressed,
+    # EncryptFile will decompress the file before encrypting it.
+    #
+    def encrypt(file)
+      unless EncryptFileW(multi_to_wide(file))
+        raise ArgumentError, get_last_error
+      end
+      self
+    end
+
+    # Decrypts an encrypted file or directory.
+    #
+    # The caller must have the FILE_READ_DATA, FILE_WRITE_DATA,
+    # FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES, and SYNCHRONIZE access
+    # rights.
+    #
+    # Requires exclusive access to the file being decrypted, and will fail if
+    # another process is using the file. If the file is not encrypted an error
+    # is NOT raised.
+    #
+    # Windows 2000 or later only.
+    #
+    def decrypt(file)
+      unless DecryptFileW(multi_to_wide(file), 0)
+        raise ArgumentError, get_last_error
+      end
+      self
+    end
+
+    ## Path methods
+
+    # Returns the last component of the filename given in +filename+.  If
+    # +suffix+ is given and present at the end of +filename+, it is removed.
+    # Any extension can be removed by giving an extension of ".*".
+    #
+    # This was reimplemented because the current version does not handle UNC
+    # paths properly, i.e. it should not return anything less than the root.
+    # In all other respects it is identical to the current implementation.
+    #
+    # Unlike MRI, this version will convert all forward slashes to
+    # backslashes automatically.
+    #
+    # Examples:
+    #
+    #    File.basename("C:\\foo\\bar.txt")         -> "bar.txt"
+    #    File.basename("C:\\foo\\bar.txt", ".txt") -> "bar"
+    #    File.basename("\\\\foo\\bar")             -> "\\\\foo\\bar"
+    #
+    def basename(file, suffix = nil)
+      raise TypeError unless file.is_a?(String)
+      raise TypeError unless suffix.is_a?(String) if suffix
+
+      return file if file.empty? # Return an empty path as-is.
+      file = multi_to_wide(file)
+
+      # Required for Windows API functions to work properly.
+      file.tr!(File::SEPARATOR, File::ALT_SEPARATOR)
+
+      # Return a root path as-is.
+      return wide_to_multi(file) if PathIsRootW(file)
+
+      PathStripPathW(file) # Gives us the basename
+
+      if suffix
+        if suffix == '.*'
+          PathRemoveExtensionW(file)
+        else
+          if PathFindExtensionA(wide_to_multi(file)) == suffix
+             PathRemoveExtensionW(file)
+          end
+        end
+      end
+
+      file = wide_to_multi(file)
+      file.sub!(/\\+\z/, '') # Trim trailing slashes
+
+      file
+    end
+
+    # Returns true if +file+ is a directory, false otherwise.
+    #--
+    # This method was redefined to handle wide character strings.
+    #
+    def directory?(file)
+      file = multi_to_wide(file)
+      attributes = GetFileAttributesW(file)
+      (attributes != INVALID_FILE_ATTRIBUTES) && (attributes & FILE_ATTRIBUTE_DIRECTORY > 0)
+    end
+
+    # Returns all components of the filename given in +filename+ except the
+    # last one.
+    #
+    # This was reimplemented because the current version does not handle UNC
+    # paths properly, i.e. it should not return anything less than the root.
+    # In all other respects it is identical to the current implementation.
+    #
+    # Also, this method will convert all forward slashes to backslashes.
+    #
+    # Examples:
+    #
+    #    File.dirname("C:\\foo\\bar\\baz.txt") -> "C:\\foo\\bar"
+    #    File.dirname("\\\\foo\\bar")          -> "\\\\foo\\bar"
+    #
+    def dirname(file)
+      raise TypeError unless file.is_a?(String)
+
+      # Short circuit for empty paths
+      return '.' if file.empty?
+
+      # Temporarily convert to wide-byte
+      file = multi_to_wide(file)
+
+      # Convert slashes to backslashes for the Windows API functions
+      file.tr!(File::SEPARATOR, File::ALT_SEPARATOR)
+
+      # Return a root path as-is.
+      return wide_to_multi(file) if PathIsRootW(file)
+
+      # Remove trailing slashes if present
+      while result = PathRemoveBackslashW(file)
+        break unless result.empty?
+      end
+
+      # Remove trailing file name if present
+      PathRemoveFileSpecW(file)
+
+      # Return to multi-byte
+      file = wide_to_multi(file)
+
+      # Empty paths, short relative paths
+      if file.nil? || (file && file.empty?)
+        return '.'
+      end
+
+      file
+    end
+
+    # Join path string components together into a single string.
+    #
+    # This method was reimplemented so that it automatically converts
+    # forward slashes to backslashes. It is otherwise identical to
+    # the core File.join method.
+    #
+    # Examples:
+    #
+    #   File.join("C:", "foo", "bar") # => C:\foo\bar
+    #   File.join("foo", "bar")       # => foo\bar
+    #
+    def join(*args)
+      return join_orig(*args).tr("/", "\\")
+    end
+
+    # Returns +path+ in long format. For example, if 'SOMEFI~1.TXT'
+    # was the argument provided, and the short representation for
+    # 'somefile.txt', then this method would return 'somefile.txt'.
+    #
+    # Note that certain file system optimizations may prevent this method
+    # from working as expected.  In that case, you will get back the file
+    # name in 8.3 format.
+    #
+    def long_path(path)
+      buf = 0.chr * MAXPATH
+      if GetLongPathNameW(multi_to_wide(path), buf, buf.size) == 0
+        raise ArgumentError, get_last_error
+      end
+      wide_to_multi(buf)
+    end
+
+    # Returns the path of the of the symbolic link referred to by +file+.
+    #
+    # Requires Windows Vista or later. On older versions of Windows it
+    # will raise a NotImplementedError, as per MRI.
+    #
+    def readlink(file)
+      if defined? GetFinalPathNameByHandle
+        file = multi_to_wide(file)
+
+        begin
+          handle = CreateFileW(
+            file,
+            GENERIC_READ,
+            FILE_SHARE_READ,
+            nil,
+            OPEN_EXISTING,
+            FILE_ATTRIBUTE_NORMAL,
+            nil
+          )
+
+          if handle == INVALID_HANDLE_VALUE
+            raise ArgumentError, get_last_error
+          end
+
+          path = 0.chr * MAXPATH
+
+          GetFinalPathNameByHandleW(handle, path, path.size, 0)
+        ensure
+          CloseHandle(handle)
+        end
+
+        wide_to_multi(path).strip[4..-1] # get rid of prepending "\\?\"
+      else
+        msg = "readlink() function is unimplemented on this machine"
+        raise NotImplementedError, msg
+      end
+    end
+
+    # Returns +path+ in 8.3 format. For example, 'c:\documentation.doc'
+    # would be returned as 'c:\docume~1.doc'.
+    #
+    def short_path(path)
+      buf = 0.chr * MAXPATH
+      if GetShortPathNameW(multi_to_wide(path), buf, buf.size) == 0
+        raise ArgumentError, get_last_error
+      end
+      wide_to_multi(buf)
+    end
+
+    # Splits the given string into a directory and a file component and
+    # returns them in a two element array. This was reimplemented because
+    # the current version does not handle UNC paths properly.
+    #
+    def split(file)
+      array = []
+
+      if file.empty? || PathIsRootW(multi_to_wide(file))
+        array.push(file, '')
+      else
+        array.push(File.dirname(file), File.basename(file))
+      end
+      array
+    end
+
+    # Creates a symbolic link called +new_name+ for the file or directory
+    # +old_name+.
+    #
+    # This method requires Windows Vista or later to work. Otherwise, it
+    # returns nil as per MRI.
+    #
+    def symlink(old_name, new_name)
+      if defined? CreateSymbolicLink
+        old_name = multi_to_wide(old_name)
+        new_name = multi_to_wide(new_name)
+        flags    = File.directory?(wide_to_multi(old_name)) ? 1 : 0
+
+        unless CreateSymbolicLinkW(new_name, old_name, flags)
+          raise ArgumentError, get_last_error
+        end
+      else
+        nil
+      end
+    end
+
+    # Return true if the named file is a symbolic link, false otherwise.
+    #
+    # This method requires Windows Vista or later to work. Otherwise, it
+    # always returns false as per MRI.
+    #
+    def symlink?(file)
+      bool = false
+      file = multi_to_wide(file)
+      attr = GetFileAttributesW(file)
+
+      # Differentiate between a symlink and other kinds of reparse points
+      if attr & FILE_ATTRIBUTE_REPARSE_POINT > 0
+        begin
+          buffer = 0.chr * 278 # WIN32_FIND_DATA
+          handle = FindFirstFileW(file, buffer)
+
+          if handle == INVALID_HANDLE_VALUE
+            raise ArgumentError, get_last_error
+          end
+
+          if buffer[36,4].unpack('L')[0] == IO_REPARSE_TAG_SYMLINK
+            bool = true
+          end
+        ensure
+          CloseHandle(handle)
+        end
+      end
+
+      bool
+    end
+
+    ## Stat methods
+
+    # Returns a File::Stat object, as defined in the win32-file-stat package.
+    #
+    def stat(file)
+      File::Stat.new(file)
+    end
+
+    # Identical to File.stat on Windows.
+    #
+    def lstat(file)
+      File::Stat.new(file)
+    end
+
+    # Returns the file system's block size.
+    #
+    def blksize(file)
+      File::Stat.new(file).blksize
+    end
+
+    # Returns whether or not +file+ is a block device. For MS Windows this
+    # means a removable drive, cdrom or ramdisk.
+    #
+    def blockdev?(file)
+      File::Stat.new(file).blockdev?
+    end
+
+    # Returns true if the file is a character device.  This replaces the
+    # current Ruby implementation which always returns false.
+    #
+    def chardev?(file)
+      File::Stat.new(file).chardev?
+    end
+
+    # Returns the size of the file in bytes.
+    #
+    # This was reimplemented because the current version does not handle file
+    # sizes greater than 2gb.
+    #
+    def size(file)
+      File::Stat.new(file).size
+    end
+
+    # We no longer need the aliases, so remove them
+    remove_method(:basename_orig, :blockdev_orig, :chardev_orig)
+    remove_method(:dirname_orig, :lstat_orig, :size_orig, :split_orig)
+    remove_method(:stat_orig, :symlink_orig, :symlink_orig?, :readlink_orig)
+    remove_method(:directory_orig?)
+  end # class << self
+
+  ## Attribute methods
+
+  # Returns true if the file or directory is an archive file. Applications
+  # use this attribute to mark files for backup or removal.
+  #
+  def self.archive?(file)
+    File::Stat.new(file).archive?
+  end
+
+  # Returns true if the file or directory is compressed. For a file, this
+  # means that all of the data in the file is compressed. For a directory,
+  # this means that compression is the default for newly created files and
+  # subdirectories.
+  #
+  def self.compressed?(file)
+    File::Stat.new(file).compressed?
+  end
+
+  # Returns true if the file or directory is encrypted. For a file, this
+  # means that all data in the file is encrypted. For a directory, this
+  # means that encryption is the default for newly created files and
+  # subdirectories.
+  #
+  def self.encrypted?(file)
+    File::Stat.new(file).encrypted?
+  end
+
+  # Returns true if the file or directory is hidden. It is not included
+  # in an ordinary directory listing.
+  #
+  def self.hidden?(file)
+    File::Stat.new(file).hidden?
+  end
+
+  # Returns true if the file or directory is indexed by the content indexing
+  # service.
+  #
+  def self.indexed?(file)
+    File::Stat.new(file).indexed?
+  end
+
+  # Returns true if the file or directory has no other attributes set.
+  #
+  def self.normal?(file)
+    File::Stat.new(file).normal?
+  end
+
+  # Returns true if the data of the file is not immediately available. This
+  # attribute indicates that the file data has been physically moved to
+  # offline storage. This attribute is used by Remote Storage, the
+  # hierarchical storage management software. Applications should not
+  # arbitrarily change this attribute.
+  #
+  def self.offline?(file)
+    File::Stat.new(file).offline?
+  end
+
+  # Returns true if The file or directory is read-only. Applications can
+  # read the file but cannot write to it or delete it. In the case of a
+  # directory, applications cannot delete it.
+  #
+  def self.readonly?(file)
+    File::Stat.new(file).readonly?
+  end
+
+  # Returns true if the file or directory has an associated reparse point. A
+  # reparse point is a collection of user defined data associated with a file
+  # or directory.  For more on reparse points, search
+  # http://msdn.microsoft.com.
+  #
+  def self.reparse_point?(file)
+    File::Stat.new(file).reparse_point?
+  end
+
+  # Returns true if the file is a sparse file.  A sparse file is a file in
+  # which much of the data is zeros, typically image files.  See
+  # http://msdn.microsoft.com for more details.
+  #
+  def self.sparse?(file)
+    File::Stat.new(file).sparse?
+  end
+
+  # Returns true if the file or directory is part of the operating system
+  # or is used exclusively by the operating system.
+  #
+  def self.system?(file)
+    File::Stat.new(file).system?
+  end
+
+  # Returns true if the file is being used for temporary storage.
+  #
+  # File systems avoid writing data back to mass storage if sufficient cache
+  # memory is available, because often the application deletes the temporary
+  # file shortly after the handle is closed. In that case, the system can
+  # entirely avoid writing the data. Otherwise, the data will be written after
+  # the handle is closed.
+  #
+  def self.temporary?(file)
+    File::Stat.new(file).temporary?
+  end
+
+  # Returns an array of strings indicating the attributes for that file.  The
+  # possible values are:
+  #
+  # archive
+  # compressed
+  # directory
+  # encrypted
+  # hidden
+  # indexed
+  # normal
+  # offline
+  # readonly
+  # reparse_point
+  # sparse
+  # system
+  # temporary
+  #
+  def self.attributes(file)
+    attributes = GetFileAttributesW(multi_to_wide(file))
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    arr = []
+
+    arr << 'archive' if attributes & FILE_ATTRIBUTE_ARCHIVE > 0
+    arr << 'compressed' if attributes & FILE_ATTRIBUTE_COMPRESSED > 0
+    arr << 'directory' if attributes & FILE_ATTRIBUTE_DIRECTORY > 0
+    arr << 'encrypted' if attributes & FILE_ATTRIBUTE_ENCRYPTED > 0
+    arr << 'hidden' if attributes & FILE_ATTRIBUTE_HIDDEN > 0
+    arr << 'indexed' if attributes & FILE_ATTRIBUTE_NOT_CONTENT_INDEXED == 0
+    arr << 'normal' if attributes & FILE_ATTRIBUTE_NORMAL > 0
+    arr << 'offline' if attributes & FILE_ATTRIBUTE_OFFLINE > 0
+    arr << 'readonly' if attributes & FILE_ATTRIBUTE_READONLY > 0
+    arr << 'reparse_point' if attributes & FILE_ATTRIBUTE_REPARSE_POINT > 0
+    arr << 'sparse' if attributes & FILE_ATTRIBUTE_SPARSE_FILE > 0
+    arr << 'system' if attributes & FILE_ATTRIBUTE_SYSTEM > 0
+    arr << 'temporary' if attributes & FILE_ATTRIBUTE_TEMPORARY > 0
+
+    arr
+  end
+
+  # Sets the file attributes based on the given (numeric) +flags+.  This does
+  # not remove existing attributes, it merely adds to them.
+  #
+  def self.set_attributes(file, flags)
+    file = multi_to_wide(file)
+    attributes = GetFileAttributesW(file)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    attributes |= flags
+
+    if SetFileAttributesW(file, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+     self
+  end
+
+  # Removes the file attributes based on the given (numeric) +flags+.
+  #
+  def self.remove_attributes(file, flags)
+    file = multi_to_wide(file)
+    attributes = GetFileAttributesW(file)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    attributes &= ~flags
+
+    if SetFileAttributesW(file, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+  # Instance methods
+
+  def stat
+    File::Stat.new(self.path)
+  end
+
+  # Sets whether or not the file is an archive file.
+  #
+  def archive=(bool)
+    wide_path  = multi_to_wide(self.path)
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_ARCHIVE;
+    else
+      attributes &= ~FILE_ATTRIBUTE_ARCHIVE;
+    end
+
+    if SetFileAttributesW(wide_path, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+  # Sets whether or not the file is a compressed file.
+  #
+  def compressed=(bool)
+    in_buf = bool ? COMPRESSION_FORMAT_DEFAULT : COMPRESSION_FORMAT_NONE
+    in_buf = [in_buf].pack('L')
+    bytes  = [0].pack('L')
+
+    # We can't use get_osfhandle here because we need specific attributes
+    handle = CreateFileW(
+      multi_to_wide(self.path),
+      FILE_READ_DATA | FILE_WRITE_DATA,
+      FILE_SHARE_READ | FILE_SHARE_WRITE,
+      0,
+      OPEN_EXISTING,
+      0,
+      0
+    )
+
+    if handle == INVALID_HANDLE_VALUE
+      raise ArgumentError, get_last_error
+    end
+
+    begin
+      bool = DeviceIoControl(
+        handle,
+        FSCTL_SET_COMPRESSION(),
+        in_buf,
+        in_buf.length,
+        0,
+        0,
+        bytes,
+        0
+      )
+
+      unless bool
+        raise ArgumentError, get_last_error
+      end
+    ensure
+      CloseHandle(handle)
+    end
+
+    self
+  end
+
+  # Sets the hidden attribute to true or false.  Setting this attribute to
+  # true means that the file is not included in an ordinary directory listing.
+  #
+  def hidden=(bool)
+    wide_path  = multi_to_wide(self.path)
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_HIDDEN;
+    else
+      attributes &= ~FILE_ATTRIBUTE_HIDDEN;
+    end
+
+    if SetFileAttributesW(wide_path, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+  # Sets the 'indexed' attribute to true or false.  Setting this to
+  # false means that the file will not be indexed by the content indexing
+  # service.
+  #
+  def indexed=(bool)
+    wide_path  = multi_to_wide(self.path)
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    if bool
+      attributes &= ~FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
+    else
+      attributes |= FILE_ATTRIBUTE_NOT_CONTENT_INDEXED;
+    end
+
+    if SetFileAttributes(wide_path, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+   alias :content_indexed= :indexed=
+
+  # Sets the normal attribute. Note that only 'true' is a valid argument,
+  # which has the effect of removing most other attributes.  Attempting to
+  # pass any value except true will raise an ArgumentError.
+  #
+  def normal=(bool)
+    unless bool
+      raise ArgumentError, "only 'true' may be passed as an argument"
+    end
+
+    if SetFileAttributesW(multi_to_wide(self.path),FILE_ATTRIBUTE_NORMAL) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+  # Sets whether or not a file is online or not.  Setting this to false means
+	# that the data of the file is not immediately available. This attribute
+	# indicates that the file data has been physically moved to offline storage.
+	# This attribute is used by Remote Storage, the hierarchical storage
+	# management software.
+  #
+	# Applications should not arbitrarily change this attribute.
+  #
+  def offline=(bool)
+    wide_path  = multi_to_wide(self.path)
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_OFFLINE;
+    else
+      attributes &= ~FILE_ATTRIBUTE_OFFLINE;
+    end
+
+    if SetFileAttributesW(wide_path, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+  # Sets the readonly attribute.  If set to true the the file or directory is
+  # readonly. Applications can read the file but cannot write to it or delete
+  # it. In the case of a directory, applications cannot delete it.
+  #
+  def readonly=(bool)
+    wide_path  = multi_to_wide(self.path)
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_READONLY;
+    else
+      attributes &= ~FILE_ATTRIBUTE_READONLY;
+    end
+
+    if SetFileAttributesW(wide_path, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+  # Sets the file to a sparse (usually image) file.  Note that you cannot
+  # remove the sparse property from a file.
+  #
+  def sparse=(bool)
+    unless bool
+      warn 'cannot remove sparse property from a file - operation ignored'
+      return
+    end
+
+    bytes = [0].pack('L')
+
+    handle = CreateFileW(
+      multi_to_wide(self.path),
+      FILE_READ_DATA | FILE_WRITE_DATA,
+      FILE_SHARE_READ | FILE_SHARE_WRITE,
+      0,
+      OPEN_EXISTING,
+      FSCTL_SET_SPARSE(),
+      0
+    )
+
+    if handle == INVALID_HANDLE_VALUE
+      raise ArgumentError, get_last_error
+    end
+
+    begin
+      bool = DeviceIoControl(
+        handle,
+        FSCTL_SET_SPARSE(),
+        0,
+        0,
+        0,
+        0,
+        bytes,
+        0
+      )
+
+      unless bool == 0
+        raise ArgumentError, get_last_error
+      end
+    ensure
+      CloseHandle(handle)
+    end
+
+    self
+  end
+
+  # Set whether or not the file is a system file.  A system file is a file
+	# that is part of the operating system or is used exclusively by it.
+  #
+  def system=(bool)
+    wide_path  = multi_to_wide(self.path)
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_SYSTEM;
+    else
+      attributes &= ~FILE_ATTRIBUTE_SYSTEM;
+    end
+
+    if SetFileAttributesW(wide_path, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+  # Sets whether or not the file is being used for temporary storage.
+  #
+  # File systems avoid writing data back to mass storage if sufficient cache
+  # memory is available, because often the application deletes the temporary
+  # file shortly after the handle is closed. In that case, the system can
+  # entirely avoid writing the data. Otherwise, the data will be written
+  # after the handle is closed.
+  #
+  def temporary=(bool)
+    wide_path  = multi_to_wide(self.path)
+    attributes = GetFileAttributesW(wide_path)
+
+    if attributes == INVALID_FILE_ATTRIBUTES
+      raise ArgumentError, get_last_error
+    end
+
+    if bool
+      attributes |= FILE_ATTRIBUTE_TEMPORARY;
+    else
+      attributes &= ~FILE_ATTRIBUTE_TEMPORARY;
+    end
+
+    if SetFileAttributesW(wide_path, attributes) == 0
+      raise ArgumentError, get_last_error
+    end
+
+    self
+  end
+
+  # Singleton aliases, mostly for backwards compatibility
+  class << self
+    alias :read_only? :readonly?
+    alias :content_indexed? :indexed?
+    alias :set_attr :set_attributes
+    alias :unset_attr :remove_attributes
+  end
+
+  private
+
+  # Get the owner of a given file by name.
+  #
+  def get_owner(file)
+    handle = CreateFile(
+      file,
+      GENERIC_READ,
+      FILE_SHARE_READ,
+      0,
+      OPEN_EXISTING,
+      0,
+      0
+    )
+
+    if handle == INVALID_HANDLE_VALUE
+      raise ArgumentError, get_last_error
+    end
+
+    sid_ptr = [0].pack('L')
+
+    begin
+      rv = GetSecurityInfo(
+        handle,
+        SE_FILE_OBJECT,
+        OWNER_SECURITY_INFORMATION,
+        sid_ptr,
+        nil,
+        nil,
+        nil,
+        nil
+      )
+
+      if rv != 0
+        raise get_last_error
+      end
+
+      name_buf = 0.chr * 80
+      name_cch = [name_buf.size].pack('L')
+
+      domain_buf = 0.chr * 80
+      domain_cch = [domain_buf.size].pack('L')
+      sid_name   = 0.chr * 4
+
+      bool = LookupAccountSid(
+        nil,
+        sid_ptr.unpack('L').first,
+        name_buf,
+        name_cch,
+        domain_buf,
+        domain_cch,
+        sid_name
+      )
+
+      unless bool
+        raise get_last_error
+      end
+    ensure
+      CloseHandle(handle)
+    end
+
+    name_buf.strip
+  end
+end