Module: LinuxStat::Filesystem

Defined in:
lib/linux_stat/filesystem.rb

Class Method Summary collapse

Class Method Details

.available(fs = ?/.freeze) ⇒ Object

available(fs = ‘/’) Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive). It returns the total free space in a disk in bytes. It is to be noted that free is not same as available. Available returns the size of free blocks for unpriviledged users.

If the stat can’t be acquired, this method will return an empty Hash.



73
74
75
76
77
78
 
# File 'lib/linux_stat/filesystem.rb', line 73

def available(fs = ?/.freeze)
	s = stat_raw(fs)
	return nil if s.empty?
	s.default = 0
	s[:block_size] * s[:block_avail_unpriv]
end

.free(fs = ?/.freeze) ⇒ Object

free(fs = ‘/’) Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive). It returns the total free space in a disk in bytes. It is to be noted that free is not same as available. Free returns the size of free blocks.

If the stat can’t be acquired, this method will return an empty Hash.



47
48
49
50
51
52
 
# File 'lib/linux_stat/filesystem.rb', line 47

def free(fs = ?/.freeze)
	s = stat_raw(fs)
	return nil if s.empty?
	s.default = 0
	s[:block_size] * s[:block_free]
end

.stat(fs = ?/.freeze) ⇒ Object

stat(fs = ‘/’) Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive).

It returns a Hash with the following info:

  1. total size of the device (in bytes)

  2. free space (in kilobytes)

  3. used space (in kilobytes)

In a hash format:

{:total=>119981191168, :free=>43155574784, :used=>76825616384, :available=>43155574784}

If the stat can’t be acquired, this method will return an empty Hash.



16
17
18
19
20
21
22
23
24
25
26
 
# File 'lib/linux_stat/filesystem.rb', line 16

def stat(fs = ?/.freeze)
	s = stat_raw(fs)
	return {} if s.empty?
	s.default = 0

	{
		total: s[:block_size] * s[:blocks],
		free: s[:block_size] * s[:block_free],
		used: s[:blocks].-(s[:block_free]) * s[:block_size]
	}
end

.stat_raw(fs = ?/.freeze) ⇒ Object

stat_raw(fs = ‘/’) Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive).

It returns a Hash with the following data (for example):

{:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>10535967, :block_avail_unpriv=>10535967, :inodes=>58612160, :free_inodes=>56718550, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}

If the stat can’t be acquired, this method will return an empty Hash.



87
88
89
 
# File 'lib/linux_stat/filesystem.rb', line 87

def stat_raw(fs = ?/.freeze)
	LinuxStat::FS.stat(fs)
end

.total(fs = ?/.freeze) ⇒ Object

total(fs = ‘/’) Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive). It returns the total size of a given disk in bytes.

If the stat can’t be acquired, this method will return nil.



33
34
35
36
37
38
 
# File 'lib/linux_stat/filesystem.rb', line 33

def total(fs = ?/.freeze)
	s = stat_raw(fs)
	return nil if s.empty?
	s.default = 0
	s[:block_size] * s[:blocks]
end

.used(fs = ?/.freeze) ⇒ Object

used(fs = ‘/’) Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive). It returns the used space of a given disk in bytes.

If the stat can’t be acquired, this method will return nil.



59
60
61
62
63
64
 
# File 'lib/linux_stat/filesystem.rb', line 59

def used(fs = ?/.freeze)
	s = stat_raw(fs)
	return nil if s.empty?
	s.default = 0
	s[:blocks].-(s[:block_free]) * s[:block_size]
end