Class: Chef::ReservedNames::Win32::File::Info

Inherits:

Object

Object
Chef::ReservedNames::Win32::File::Info

show all

Includes:: API, API::File

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

Overview

Objects of class Chef::ReservedNames::Win32::File::Stat encapsulate common status information for Chef::ReservedNames::Win32::File objects. The information is recorded at the moment the Chef::ReservedNames::Win32::File::Stat object is created; changes made to the file after that point will not be reflected.

Constant Summary

Constants included from API::File

Constants included from API::System

Constants included from API::Security

Instance Method Summary collapse

#creation_time ⇒ Object (also: #ctime)
#index ⇒ Object
#initialize(file_name) ⇒ Info constructor

msdn.microsoft.com/en-us/library/windows/desktop/aa363788(v=vs.85).aspx.
#ino ⇒ Object

we’re faking it here, but this is in the spirit of ino in *nix.
#last_access_time ⇒ Object (also: #atime)
#last_write_time ⇒ Object (also: #mtime)
#links ⇒ Object
#parse_time(file_time_struct) ⇒ Object

given a Chef::ReservedNames::Win32::API::File::FILETIME structure convert into a Ruby Time object.
#size ⇒ Object
#volume_serial_number ⇒ Object

Methods included from API::File

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

Constructor Details

#initialize(file_name) ⇒ `Info`

msdn.microsoft.com/en-us/library/windows/desktop/aa363788(v=vs.85).aspx

Raises:

(Errno::ENOENT)

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

def initialize(file_name)
  raise Errno::ENOENT, file_name unless ::File.exist?(file_name)

  @file_info = retrieve_file_info(file_name)
end

Instance Method Details

#creation_time ⇒ `Object` Also known as: ctime



53
54
55

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

def creation_time
  parse_time(@file_info[:ft_creation_time])
end

#index ⇒ `Object`



45
46
47

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

def index
  make_uint64(@file_info[:n_file_index_low], @file_info[:n_file_index_high])
end

#ino ⇒ `Object`

we’re faking it here, but this is in the spirit of ino in *nix

from MSDN:

“The identifier (low and high parts) and the volume serial number uniquely identify a file on a single computer. To determine whether two open handles represent the same file, combine the identifier and the volume serial number for each file and compare them.”“



84
85
86

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

def ino
  volume_serial_number + index
end

#last_access_time ⇒ `Object` Also known as: atime



49
50
51

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

def last_access_time
  parse_time(@file_info[:ft_last_access_time])
end

#last_write_time ⇒ `Object` Also known as: mtime



57
58
59

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

def last_write_time
  parse_time(@file_info[:ft_last_write_time])
end

#links ⇒ `Object`



61
62
63

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

def links
  @file_info[:n_number_of_links]
end

#parse_time(file_time_struct) ⇒ `Object`

given a Chef::ReservedNames::Win32::API::File::FILETIME structure convert into a Ruby Time object.

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

def parse_time(file_time_struct)
  wtime_to_time(make_uint64(file_time_struct[:dw_low_date_time],
    file_time_struct[:dw_high_date_time]))
end

#size ⇒ `Object`



65
66
67

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

def size
  make_uint64(@file_info[:n_file_size_low], @file_info[:n_file_size_high])
end

#volume_serial_number ⇒ `Object`



41
42
43

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

def volume_serial_number
  @file_info[:dw_volume_serial_number]
end

Class: Chef::ReservedNames::Win32::File::Info

Overview

Constant Summary

Constants included from API::File

Constants included from API::System

Constants included from API::Security

Instance Method Summary collapse

Methods included from API::File

Constructor Details

#initialize(file_name) ⇒ Info

Instance Method Details

#creation_time ⇒ Object Also known as: ctime

#index ⇒ Object

#ino ⇒ Object

#last_access_time ⇒ Object Also known as: atime

#last_write_time ⇒ Object Also known as: mtime

#links ⇒ Object

#parse_time(file_time_struct) ⇒ Object

#size ⇒ Object

#volume_serial_number ⇒ Object