Class: ReservedNames::Win32::File

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

def self.delete_volume_mount_point(mount_point)
  unless DeleteVolumeMountPointW(wstring(mount_point))
    Chef::ReservedNames::Win32::Error.raise!
  end
end

.file_access_check(path, desired_access) ⇒ `Object`

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

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 148

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 134

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

.get_volume_name_for_volume_mount_point(mount_point) ⇒ `Object`

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

def self.get_volume_name_for_volume_mount_point(mount_point)
  buffer = FFI::MemoryPointer.new(2, 128)
  unless GetVolumeNameForVolumeMountPointW(wstring(mount_point), buffer, buffer.size / buffer.type_size)
    Chef::ReservedNames::Win32::Error.raise!
  end
  buffer.read_wstring
end

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



161
162
163

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

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 42

def self.link(old_name, new_name)
  raise Errno::ENOENT, "(#{old_name}, #{new_name})" unless ::File.exist?(old_name) || ::File.symlink?(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 106

def self.readlink(link_name)
  raise Errno::ENOENT, link_name unless ::File.exists?(link_name) || ::File.symlink?(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

.realpath(file_name) ⇒ `Object`

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

def self.realpath(file_name)
  if symlink?(file_name)
    readlink(file_name)
  else
    file_name
  end
end

.set_volume_mount_point(mount_point, name) ⇒ `Object`

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

def self.set_volume_mount_point(mount_point, name)
  unless SetVolumeMountPointW(wstring(mount_point), wstring(name))
    Chef::ReservedNames::Win32::Error.raise!
  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 60

def self.symlink(old_name, new_name)
  # raise Errno::ENOENT, "(#{old_name}, #{new_name})" unless ::File.exist?(old_name) || ::File.symlink?(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
  flags |= SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE if Chef::ReservedNames::Win32::Version.new.win_10_creators_or_higher?
  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 78

def self.symlink?(file_name)
  is_symlink = false
  path = encode_path(file_name)
  if ::File.exists?(file_name) || ::File.symlink?(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 169

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

.version_info(file_name) ⇒ `Object`



165
166
167

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

def self.version_info(file_name)
  VersionInfo.new(file_name)
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

Methods included from Chef::Mixin::WideString

Class Method Details

.delete_volume_mount_point(mount_point) ⇒ Object

.file_access_check(path, desired_access) ⇒ Object

.get_long_path_name(path) ⇒ Object

.get_short_path_name(path) ⇒ Object

.get_volume_name_for_volume_mount_point(mount_point) ⇒ Object

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

.link(old_name, new_name) ⇒ Object

.readlink(link_name) ⇒ Object

.realpath(file_name) ⇒ Object

.set_volume_mount_point(mount_point, name) ⇒ Object

.symlink(old_name, new_name) ⇒ Object

.symlink?(file_name) ⇒ Boolean

.verify_links_supported! ⇒ Object

.version_info(file_name) ⇒ Object

.delete_volume_mount_point(mount_point) ⇒ `Object`