Class: ReservedNames::Win32::File

Inherits:

Object

Object
ReservedNames::Win32::File

show all

Extended by:: Chef::ReservedNames::Win32::API::File

Includes:: Chef::ReservedNames::Win32::API::File

Defined in:: lib/chef/win32/file.rb

Constant Summary

Constants included from Chef::ReservedNames::Win32::API::File

Constants included from Chef::ReservedNames::Win32::API::System

Constants included from Chef::ReservedNames::Win32::API::Security

Class Method Summary collapse

.file_access_check(path, desired_access) ⇒ Object
.get_long_path_name(path) ⇒ Object

Gets the long form of a path (ADMINI~1 -> Administrator).
.get_short_path_name(path) ⇒ Object

Gets the short form of a path (Administrator -> ADMINI~1).
.info(file_name) ⇒ Object (also: stat)
.link(old_name, new_name) ⇒ Object

Creates a symbolic link called new_name for the file or directory old_name.
.readlink(link_name) ⇒ Object

Returns the path of the of the symbolic link referred to by file.
.symlink(old_name, new_name) ⇒ Object

Creates a symbolic link called new_name for the file or directory old_name.
.symlink?(file_name) ⇒ Boolean

Return true if the named file is a symbolic link, false otherwise.
.verify_links_supported! ⇒ Object

Methods included from Chef::ReservedNames::Win32::API::File

CTL_CODE, canonical_encode_path, encode_path, file_handle, file_search_handle, path_prepender, retrieve_file_info, symlink_file_handle

Class Method Details

.file_access_check(path, desired_access) ⇒ `Object`

# File 'lib/chef/win32/file.rb', line 158

def self.file_access_check(path, desired_access)
  security_descriptor = Chef::ReservedNames::Win32::Security.get_file_security(path)
  token_rights = Chef::ReservedNames::Win32::Security::TOKEN_IMPERSONATE | 
                 Chef::ReservedNames::Win32::Security::TOKEN_QUERY |
                 Chef::ReservedNames::Win32::Security::TOKEN_DUPLICATE | 
                 Chef::ReservedNames::Win32::Security::STANDARD_RIGHTS_READ
  token = Chef::ReservedNames::Win32::Security.open_process_token(
    Chef::ReservedNames::Win32::Process.get_current_process,
    token_rights)
  duplicate_token = token.duplicate_token(:SecurityImpersonation)

  mapping = Chef::ReservedNames::Win32::Security::GENERIC_MAPPING.new
  mapping[:GenericRead] = Chef::ReservedNames::Win32::Security::FILE_GENERIC_READ
  mapping[:GenericWrite] = Chef::ReservedNames::Win32::Security::FILE_GENERIC_WRITE
  mapping[:GenericExecute] = Chef::ReservedNames::Win32::Security::FILE_GENERIC_EXECUTE
  mapping[:GenericAll] = Chef::ReservedNames::Win32::Security::FILE_ALL_ACCESS

  Chef::ReservedNames::Win32::Security.access_check(security_descriptor, duplicate_token, 
                                                    desired_access, mapping)
end

.get_long_path_name(path) ⇒ `Object`

Gets the long form of a path (ADMINI~1 -> Administrator)

# File 'lib/chef/win32/file.rb', line 131

def self.get_long_path_name(path)
  path = path.to_wstring
  size = GetLongPathNameW(path, nil, 0)
  if size == 0
    Chef::ReservedNames::Win32::Error.raise!
  end
  result = FFI::MemoryPointer.new :char, (size+1)*2
  if GetLongPathNameW(path, result, size+1) == 0
    Chef::ReservedNames::Win32::Error.raise!
  end
  result.read_wstring(size)
end

.get_short_path_name(path) ⇒ `Object`

Gets the short form of a path (Administrator -> ADMINI~1)

# File 'lib/chef/win32/file.rb', line 117

def self.get_short_path_name(path)
  path = path.to_wstring
  size = GetShortPathNameW(path, nil, 0)
  if size == 0
    Chef::ReservedNames::Win32::Error.raise!
  end
  result = FFI::MemoryPointer.new :char, (size+1)*2
  if GetShortPathNameW(path, result, size+1) == 0
    Chef::ReservedNames::Win32::Error.raise!
  end
  result.read_wstring(size)
end

.info(file_name) ⇒ `Object` Also known as: stat



144
145
146

# File 'lib/chef/win32/file.rb', line 144

def self.info(file_name)
  Info.new(file_name)
end

.link(old_name, new_name) ⇒ `Object`

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.

Raises:

(Errno::ENOENT)

# File 'lib/chef/win32/file.rb', line 36

def self.link(old_name, new_name)
  raise Errno::ENOENT, "(#{old_name}, #{new_name})" unless ::File.exist?(old_name)
  # TODO do a check for CreateHardLinkW and
  # raise NotImplemented exception on older Windows
  old_name = encode_path(old_name)
  new_name = encode_path(new_name)
  unless CreateHardLinkW(new_name, old_name, nil)
    Chef::ReservedNames::Win32::Error.raise!
  end
end

.readlink(link_name) ⇒ `Object`

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.

Raises:

(Errno::ENOENT)

# File 'lib/chef/win32/file.rb', line 90

def self.readlink(link_name)
  raise Errno::ENOENT, link_name unless ::File.exists?(link_name)
  symlink_file_handle(link_name) do |handle|
    # Go to DeviceIoControl to get the symlink information
    # http://msdn.microsoft.com/en-us/library/windows/desktop/aa364571(v=vs.85).aspx
    reparse_buffer = FFI::MemoryPointer.new(MAXIMUM_REPARSE_DATA_BUFFER_SIZE)
    parsed_size = FFI::Buffer.new(:long).write_long(0)
    if DeviceIoControl(handle, FSCTL_GET_REPARSE_POINT, nil, 0, reparse_buffer, MAXIMUM_REPARSE_DATA_BUFFER_SIZE, parsed_size, nil) == 0
      Chef::ReservedNames::Win32::Error.raise!
    end

    # Ensure it's a symbolic link
    reparse_buffer = REPARSE_DATA_BUFFER.new(reparse_buffer)
    if reparse_buffer[:ReparseTag] != IO_REPARSE_TAG_SYMLINK
      raise Errno::EACCES, "#{link_name} is not a symlink"
    end

    # Return the link destination (strip off \??\ at the beginning, which is a local filesystem thing)
    link_dest = reparse_buffer.reparse_buffer.substitute_name
    if link_dest =~ /^\\\?\?\\/
      link_dest = link_dest[4..-1]
    end
    link_dest
  end
end

.symlink(old_name, new_name) ⇒ `Object`

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.

# File 'lib/chef/win32/file.rb', line 53

def self.symlink(old_name, new_name)
  # raise Errno::ENOENT, "(#{old_name}, #{new_name})" unless ::File.exist?(old_name)
  # TODO do a check for CreateSymbolicLinkW and
  # raise NotImplemented exception on older Windows
  flags = ::File.directory?(old_name) ? SYMBOLIC_LINK_FLAG_DIRECTORY : 0
  old_name = encode_path(old_name)
  new_name = encode_path(new_name)
  unless CreateSymbolicLinkW(new_name, old_name, flags)
    Chef::ReservedNames::Win32::Error.raise!
  end
end

.symlink?(file_name) ⇒ `Boolean`

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.

Returns:

(Boolean)

# File 'lib/chef/win32/file.rb', line 70

def self.symlink?(file_name)
  is_symlink = false
  path = encode_path(file_name)
  if ::File.exists?(file_name)
    if ((GetFileAttributesW(path) & FILE_ATTRIBUTE_REPARSE_POINT) > 0)
      file_search_handle(file_name) do |handle, find_data|
        if find_data[:dw_reserved_0] == IO_REPARSE_TAG_SYMLINK
          is_symlink = true
        end
      end
    end
  end
  is_symlink
end

.verify_links_supported! ⇒ `Object`

# File 'lib/chef/win32/file.rb', line 148

def self.verify_links_supported!
  begin
    CreateSymbolicLinkW(nil)
  rescue Chef::Exceptions::Win32APIFunctionNotImplemented => e
    raise e
  rescue Exception
    # things are ok.
  end
end

Class: ReservedNames::Win32::File

Constant Summary

Constants included from Chef::ReservedNames::Win32::API::File

Constants included from Chef::ReservedNames::Win32::API::System

Constants included from Chef::ReservedNames::Win32::API::Security

Class Method Summary collapse

Methods included from Chef::ReservedNames::Win32::API::File

Class Method Details

.file_access_check(path, desired_access) ⇒ Object

.get_long_path_name(path) ⇒ Object

.get_short_path_name(path) ⇒ Object

.info(file_name) ⇒ Object Also known as: stat

.link(old_name, new_name) ⇒ Object

.readlink(link_name) ⇒ Object

.symlink(old_name, new_name) ⇒ Object

.symlink?(file_name) ⇒ Boolean

.verify_links_supported! ⇒ Object