linux_stat 0.2.0 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd93c4105b08257a85c176b7898d5ae282b1d74bb33d99d2b11536fae6402eda
-  data.tar.gz: a4a3a2032a1573c7f60ca09567fc9cb03ebea90cdc330f4652d7c7711d26adf6
+  metadata.gz: a392f3c04781b05bb96636a882b6e69143bef15befb094f980c7b542923e0649
+  data.tar.gz: 4ef67fa10ab4210090790b368852cac7deee99965560b201f136f0cd093e9a87
 SHA512:
-  metadata.gz: 24d055e84863433fa67cf3c5a59ddea66ad03346aaf469eb033dfa3dae362ee62117f4b07bcb251f26e73517a13dfde460132f3773e214ab34812c7838e7ccf9
-  data.tar.gz: 0ac774300aab62af85094f9be2162449cbfa5be8bfba0f04fcf1801e11b9bbb730db8e51a765bbd53d9d0b887b769037ddc19fa5012018e1b5d8dfc3137adddb
+  metadata.gz: 816e423f9a22797022d87a347dbcde20277d0b1d6fa8cc90001367cbdf2012e625400c2a659bbbd308fcf58363c19f2af88ec39d5bcc1fa04ccd4f61d77371b7
+  data.tar.gz: dfae97ea5bd4ef7c0daa4c784d7d951b915121753d8b61363624aaaa12e9559968e623638004accb8438a77b820913e726856e166bd437f1073047b936a83ba1

data/README.md

@@ -1,10 +1,31 @@
 # LinuxStat
-![logo](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/logo/logo.jpg)
+![logo](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/images/logo.jpg)
 
-LinuxStat lets you read statistics of a Linux system. It can show you cpu stats and usages, memory stats and usages, swap stats and usages, battery usage, bios info,  kernel details, local ip, os details and parse os-release + lsb-release, etc.
+For reading the HTML version, visit [linux_stat](https://souravgoswami.github.io/linux_stat/).
+
+LinuxStat lets you read status of a Linux system. It can show you cpu stats and usages, memory stats and usages, swap stats and usages, battery usage, bios info,  kernel details, local ip, os details and parse os-release + lsb-release, etc.
 
 It only works for Linux, and detecting the OS is upto the user of this gem.
 
+## Dependencies:
++ You need to have the C compile to be able to compile the C extension.
+On Arch Linux:
+```
+# pacman -S gcc
+```
+
+On Debian based systems:
+```
+# apt install gcc
+```
+
++ You might also require ruby-dev in Debian based systems which provides support for ruby.h header file:
+```
+# apt install ruby-dev
+```
+
++ Once your are done, and you can compile the C file, you can follow the installation!
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -78,7 +99,7 @@ LinuxStat::CPU.count
 => 4
 
 LinuxStat::CPU.cur_freq
-=> [2000001, 1999996, 1999998, 1999997]
+=> [1998722, 1998401, 1974377, 1875264]
 
 LinuxStat::CPU.max_freq
 => [2000000, 2000000, 2000000, 2000000]
@@ -87,16 +108,38 @@ LinuxStat::CPU.model
 => "Intel(R) Core(TM) i3-6006U CPU @ 2.00GHz"
 
 LinuxStat::CPU.stat
-=> {0=>30.0, 1=>50.0, 2=>28.57, 3=>16.67, 4=>28.57}
+=> {0=>6.45, 1=>0.0, 2=>0.0, 3=>12.5, 4=>0.0}
 
 LinuxStat::CPU.total_usage
-=> 26.67
+=> 3.45
 
 LinuxStat::CPU.usage
-=> 25.0
+=> 6.45
 
 LinuxStat::CPU.usages
-=> {0=>33.33, 1=>50.0, 2=>28.57, 3=>28.57, 4=>16.67}
+=> {0=>9.68, 1=>11.11, 2=>12.5, 3=>14.29, 4=>12.5}
+
+```
+
+### LinuxStat::Filesystem
+```
+LinuxStat::Filesystem.available
+=> 43155402752
+
+LinuxStat::Filesystem.free
+=> 43155402752
+
+LinuxStat::Filesystem.stat
+=> {:total=>119981191168, :free=>43155402752, :used=>76825788416}
+
+LinuxStat::Filesystem.stat_raw
+=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>10535987, :block_avail_unpriv=>10535987, :inodes=>58612160, :free_inodes=>56718515, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
+
+LinuxStat::Filesystem.total
+=> 119981191168
+
+LinuxStat::Filesystem.used
+=> 76825788416
 
 ```
 
@@ -128,22 +171,41 @@ LinuxStat::Kernel.version
 ### LinuxStat::Memory
 ```
 LinuxStat::Memory.available
-=> 405020
+=> 403724
 
 LinuxStat::Memory.percent_available
-=> 10.56
+=> 10.52
 
 LinuxStat::Memory.percent_used
-=> 89.44
+=> 89.48
 
 LinuxStat::Memory.stat
-=> {:total=>3836264, :used=>3431244, :available=>405020, :percent_used=>89.44, :percent_available=>10.56}
+=> {:total=>3836264, :used=>3432540, :available=>403724, :percent_used=>89.48, :percent_available=>10.52}
 
 LinuxStat::Memory.total
 => 3836264
 
 LinuxStat::Memory.used
-=> 3431244
+=> 3432540
+
+```
+
+### LinuxStat::Mounts
+```
+LinuxStat::Mounts.list
+=> ["proc /proc proc rw,nosuid,nodev,noexec,relatime 0 0", "sys /sys sysfs rw,nosuid,nodev,noexec,relatime 0 0", "dev /dev devtmpfs rw,nosuid,relatime,size=1891796k,nr_inodes=472949,mode=755 0 0", "run /run tmpfs rw,nosuid,nodev,relatime,mode=755 0 0", "...
+
+LinuxStat::Mounts.root
+=> "/dev/sda2"
+
+LinuxStat::Mounts.root_fs
+=> "xfs"
+
+LinuxStat::Mounts.root_mount_options
+=> "rw,noatime,attr2,inode64,logbufs=8,logbsize=32k,noquota"
+
+LinuxStat::Mounts.tmpfs
+=> {"/dev/shm"=>"tmpfs /dev/shm tmpfs rw,nosuid,nodev 0 0", "/sys/fs/cgroup"=>"tmpfs /sys/fs/cgroup tmpfs ro,nosuid,nodev,noexec,size=4096k,nr_inodes=1024,mode=755 0 0", "/ramdisk"=>"tmpfs /ramdisk tmpfs rw,nosuid,nodev,relatime,size=6291456k 0 0", "/tmp...
 
 ```
 
@@ -172,29 +234,29 @@ LinuxStat::OS.os_release
 => {:NAME=>"Arch Linux", :PRETTY_NAME=>"Arch Linux", :ID=>"arch", :BUILD_ID=>"rolling", :ANSI_COLOR=>"38;2;23;147;209", :HOME_URL=>"https://www.archlinux.org/", :DOCUMENTATION_URL=>"https://wiki.archlinux.org/", :SUPPORT_URL=>"https://bbs.archlinux.org/"...
 
 LinuxStat::OS.uptime
-=> {:hour=>40, :minute=>46, :second=>19.75}
+=> {:hour=>10, :minute=>54, :second=>22.45}
 
 ```
 
 ### LinuxStat::Process
 ```
 LinuxStat::Process.count
-=> 223
+=> 210
 
 LinuxStat::Process.idle
-=> [3, 4, 6, 9, 12, 23, 30, 37, 39, 49, 102, 103, 104, 106, 107, 108, 109, 110, 117, 118, 120, 122, 131, 134, 140, 152, 153, 166, 168, 170, 171, 174, 180, 181, 182, 183, 184, 185, 187, 224, 272, 320, 327, 328, 2238, 2239, 2240, 2241, 2242, 2243, 89437, 9...
+=> [3, 4, 6, 9, 12, 23, 30, 37, 39, 49, 102, 103, 104, 106, 107, 108, 109, 110, 117, 118, 119, 122, 131, 134, 140, 152, 153, 179, 181, 183, 184, 191, 192, 193, 194, 195, 196, 198, 236, 286, 314, 324, 346, 385, 3540, 3541, 3542, 3543, 3544, 3545, 30463, 3...
 
 LinuxStat::Process.list
-=> [1, 2, 3, 4, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 30, 31, 32, 33, 34, 35, 37, 38, 39, 40, 41, 42, 46, 47, 48, 49, 50, 51, 52, 102, 103, 104, 106, 107, 108, 109, 110, 111, 114, 115, 117, 118, 120, 122, 131, 134,...
+=> [1, 2, 3, 4, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 30, 31, 32, 33, 34, 35, 37, 38, 39, 40, 41, 42, 46, 47, 48, 49, 50, 51, 52, 102, 103, 104, 106, 107, 108, 109, 110, 112, 114, 115, 117, 118, 119, 122, 131, 134,...
 
 LinuxStat::Process.names
-=> {1=>"systemd", 2=>"kthreadd", 3=>"rcu_gp", 4=>"rcu_par_gp", 6=>"kworker/0:0H", 9=>"mm_percpu_wq", 10=>"ksoftirqd/0", 11=>"rcuc/0", 12=>"rcu_preempt", 13=>"rcub/0", 14=>"migration/0", 15=>"idle_inject/0", 16=>"cpuhp/0", 17=>"cpuhp/1", 18=>"idle_inject/...
+=> {1=>"systemd", 2=>"kthreadd", 3=>"rcu_gp", 4=>"rcu_par_gp", 6=>"kworker/0:0H-events_highpri", 9=>"mm_percpu_wq", 10=>"ksoftirqd/0", 11=>"rcuc/0", 12=>"rcu_preempt", 13=>"rcub/0", 14=>"migration/0", 15=>"idle_inject/0", 16=>"cpuhp/0", 17=>"cpuhp/1", 18...
 
 LinuxStat::Process.running
-=> [525, 91940, 91971, 91993, 92020, 95119]
+=> [33736]
 
 LinuxStat::Process.sleeping
-=> [1, 2, 10, 11, 13, 14, 15, 16, 17, 18, 19, 20, 21, 24, 25, 26, 27, 28, 31, 32, 33, 34, 35, 38, 40, 41, 42, 46, 47, 48, 50, 51, 52, 111, 114, 115, 165, 167, 186, 214, 227, 302, 313, 319, 321, 333, 334, 335, 352, 353, 354, 355, 362, 366, 367, 369, 382,...
+=> [1, 2, 10, 11, 13, 14, 15, 16, 17, 18, 19, 20, 21, 24, 25, 26, 27, 28, 31, 32, 33, 34, 35, 38, 40, 41, 42, 46, 47, 48, 50, 51, 52, 112, 114, 115, 178, 180, 197, 225, 239, 309, 317, 329, 332, 333, 334, 338, 367, 368, 369, 370, 378, 381, 383, 384, 402,...
 
 LinuxStat::Process.types
 => {1=>:sleeping, 2=>:sleeping, 3=>:idle, 4=>:idle, 6=>:idle, 9=>:idle, 10=>:sleeping, 11=>:sleeping, 12=>:idle, 13=>:sleeping, 14=>:sleeping, 15=>:sleeping, 16=>:sleeping, 17=>:sleeping, 18=>:sleeping, 19=>:sleeping, 20=>:sleeping, 21=>:sleeping, 23=>:i...
@@ -210,39 +272,64 @@ LinuxStat::Swap.any?
 => true
 
 LinuxStat::Swap.available
-=> 2292252
+=> 1913936
 
 LinuxStat::Swap.list
-=> {"/dev/zram0"=>[:partition, 4194300, 1902048, -2]}
+=> {"/dev/zram0"=>[:partition, 4194300, 2280364, -2]}
 
 LinuxStat::Swap.percent_available
-=> 54.65
+=> 45.63
 
 LinuxStat::Swap.percent_used
-=> 45.35
+=> 54.37
 
 LinuxStat::Swap.stat
-=> {:total=>4194300, :used=>1902048, :available=>2292252, :percent_used=>45.35, :percent_available=>54.65}
+=> {:total=>4194300, :used=>2280364, :available=>1913936, :percent_used=>54.37, :percent_available=>45.63}
 
 LinuxStat::Swap.total
 => 4194300
 
 LinuxStat::Swap.used
-=> 1902048
+=> 2280364
 
 ```
 
-### Return Types:
-In general, if a method returns either a Float or a Integer or a Time, it will return float. But if the status isn't available, it will return nil.
-If the method returns a Hash / Array, it will return return Hash. If the status isn't available, it will return an empty Hash / Array.
-If the method returns a String, it will return return Hash. If the status isn't available, it will return an empty *frozen* String.
+## Return Types
++ In general, if a method returns either a Float or a Integer or a Time, it will return a Float or Integer or Time in all cases. But if the status isn't available, it will return nil.
+
++ If the method returns a Hash / Array, it will return return Hash / Array in all cases. If the status isn't available, it will return an empty Hash / Array.
+
++ If the method returns a String, it will return return String in all cases. If the status isn't available, it will return an empty *frozen* String.
 
-It doesn't have implementation of any Error that gets raised in runtime for the ease of use.
-If you need to check some stat that returns an integer or float, and you get nil, you know it's not available, so you can work accordingly.
-But if you need the integer or float value in 0 to whatever format, you can use the .to_i or .to_f method on the object, nil will get converted to number then.
++ It doesn't have implementation of any Error that gets raised in runtime for the ease of use.
+
++ If you need to check some stat that returns an integer or float, and you get nil, you know it's not available, so you can work accordingly. But if you need the integer or float value in 0 to whatever format, you can use the .to_i or .to_f method on the object, nil will get converted to number then.
 
 If some error is *raised* it should be reported as a bug.
 
+## Ruby on Rails
+
+1. Just add `gem linux_stat`:
+
+```
+$ bundle add linux_stat
+```
+
+You can use LinuxStat directly in rails.
+
+![RailsApp](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/images/rails.gif)
+
+
+## Android
+
+LinuxStat does support Android OS. But it's not rigorously tested on all device like android apps.
+
+But in Termux you can just run LinuxStat without facing issues.
+
+![termux](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/images/termux.webp)
+
+Issues regarding running LinuxStat on termux are also welcomed.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -254,34 +341,26 @@ Like other gems, this doesn't have a test like RSpec. We suggest using the bin/l
 If you need to test a specific module, say the CPU, just run it like this:
 
 ```
-ruby bin/linuxstat.rb CPU
+$ ruby bin/linuxstat.rb CPU
 ```
 
 Or:
 ```
-ruby bin/linuxstat.rb cpu
+$ ruby bin/linuxstat.rb cpu
 ```
 
 That is, the argument passed is not case-sensitive.
-But if the method passed isn't available and outright wrong, it will run all the module methods. For example, you can't do:
+But if the argument passed isn't available and outright wrong, it will run all the module methods. For example, you can't do:
 
 ```
-ruby bin/linuxstat.rb upc
+$ ruby bin/linuxstat.rb upc
 ```
-
-You can run `rake` to test all the modules.
-You can also use `rake cpu` to test the CPU module or `rake memory` to test the memory module. But this is case-sensitive.
-
 This is not a valid module and can't be run.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/linux_stat. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[Souravgoswami]/linux_stat/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/Souravgoswami/linux_stat.
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the LinuxStat project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/linux_stat/blob/master/CODE_OF_CONDUCT.md).

data/bin/linuxstat.rb

@@ -41,7 +41,8 @@ execute.sort.each do |c|
 	meths.each do |meth|
 		time = Time.now
 		v = e.send(meth)
-		time = Time.now.-(time).*(1_000_000).round(3)
+		time2 = Time.now
+		time = time2.-(time).*(1_000_000).round(3)
 
 		v = v.inspect
 		dis = v.length > 253 ? v[0..250].strip + '...'.freeze : v

data/ext/fs_stat/extconf.rb

@@ -0,0 +1,7 @@
+require 'mkmf'
+
+unless (have_header('sys/statvfs.h') && have_header('ruby.h'))
+	abort('Missing header')
+end
+
+create_makefile 'linux_stat/fs_stat'

data/ext/fs_stat/fs_stat.c

@@ -0,0 +1,30 @@
+#include <sys/statvfs.h>
+#include "ruby.h"
+#pragma GCC optimize ("O3")
+#pragma clang optimize on
+
+static VALUE statfs(VALUE obj, VALUE dir) {
+	struct statvfs buf ;
+	char *d = StringValuePtr(dir) ;
+	VALUE hash = rb_hash_new() ;
+
+	if(statvfs(d, &buf) < 0) return hash ;
+
+	rb_hash_aset(hash, ID2SYM(rb_intern("block_size")), INT2FIX(buf.f_bsize)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("fragment_size")), INT2FIX(buf.f_frsize)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("blocks")), INT2FIX(buf.f_blocks)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("block_free")), INT2FIX(buf.f_bfree)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("block_avail_unpriv")), INT2FIX(buf.f_bavail)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("inodes")), INT2FIX(buf.f_files)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("free_inodes")), INT2FIX(buf.f_ffree)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("filesystem_id")), INT2FIX(buf.f_fsid)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("mount_flags")), INT2FIX(buf.f_flag)) ;
+	rb_hash_aset(hash, ID2SYM(rb_intern("max_filename_length")), INT2FIX(buf.f_namemax)) ;
+
+	return hash ;
+}
+
+void Init_fs_stat() {
+	VALUE fs = rb_define_module("FS") ;
+	rb_define_module_function(fs, "stat", statfs, 1) ;
+}

data/ext/utsname/extconf.rb

@@ -0,0 +1,7 @@
+require 'mkmf'
+
+unless (have_header('sys/utsname.h') && have_header('ruby.h'))
+	abort('Missing header')
+end
+
+create_makefile 'linux_stat/utsname'

data/ext/utsname/utsname.c

@@ -0,0 +1,29 @@
+#include <sys/utsname.h>
+#include "ruby.h"
+#pragma GCC optimize ("O3")
+#pragma clang optimize on
+
+static struct utsname buf ;
+static short status ;
+
+void init_buf() {
+	status = uname(&buf) ;
+}
+
+static VALUE getMachine(VALUE obj) {
+	VALUE machine = status < 0 ? rb_str_new_cstr("") : rb_str_new_cstr(buf.machine) ;
+	return machine ;
+}
+
+static VALUE getNodename(VALUE obj) {
+	VALUE nodename = status < 0 ? rb_str_new_cstr("") : rb_str_new_cstr(buf.nodename) ;
+	return nodename ;
+}
+
+void Init_utsname() {
+	init_buf() ;
+
+	VALUE _uname = rb_define_module("Uname") ;
+	rb_define_module_function(_uname, "machine", getMachine, 0) ;
+	rb_define_module_function(_uname, "nodename", getNodename, 0) ;
+}

data/lib/linux_stat.rb

@@ -1,14 +1,17 @@
 require "linux_stat/version"
-
-module LinuxStat
-end
-
 require "linux_stat/battery"
 require "linux_stat/bios"
 require "linux_stat/cpu"
 require "linux_stat/kernel"
 require "linux_stat/memory"
 require "linux_stat/net"
+
+require 'linux_stat/utsname'
 require "linux_stat/os"
+
 require "linux_stat/process"
 require "linux_stat/swap"
+require "linux_stat/mounts"
+
+require "linux_stat/fs_stat"
+require "linux_stat/filesystem"

data/lib/linux_stat/cpu.rb

@@ -1,7 +1,9 @@
 module LinuxStat
 	module CPU
 		class << self
-			# Returns the cpu usage of all threads.
+			# stat(sleep = 0.075)
+			# Where sleep is the delay to gather the data.
+			# This method returns the cpu usage of all threads.
 			#
 			# The first one is aggregated CPU usage reported by the Linux kernel.
 			# And the consecutive ones are the real core usages.
@@ -30,7 +32,10 @@ module LinuxStat
 				end
 			end
 
-			# Returns the total cpu usage.
+			# total_usage(sleep = 0.075)
+			# Where sleep is the delay to gather the data.
+			# This method returns the cpu usage of all threads.
+			#
 			# It's like running LinuxStat::CPU.stat[0] but it's much more efficient and calculates just the aggregated usage which is available at the top of the /proc/stat file.
 			#
 			# If the information is not available, it will return nil.
@@ -67,14 +72,26 @@ module LinuxStat
 			# If the information isn't available, it will return an empty array.
 			def cur_freq
 				@@cpu_freqs ||= Dir["/sys/devices/system/cpu/cpu[0-9]*/cpufreq/scaling_cur_freq"]
-				@@cpu_freqs.map { |x| IO.read(x).to_i }
+				@@cur_freqs_readable ||= @@cpu_freqs.all?(&File.method(:readable?))
+
+				if @@cur_freqs_readable
+					@@cpu_freqs.map { |x| IO.read(x).to_i }
+				else
+					[]
+				end
 			end
 
 			# Returns an array with max core frequencies corresponding to the usages.
 			# If the information isn't available, it will return an empty array.
 			def max_freq
 				@@max_freqs ||= Dir["/sys/devices/system/cpu/cpu[0-9]*/cpufreq/scaling_max_freq"]
-				@@max_freqs.map { |x| IO.read(x).to_i }
+				@@max_freqs_readable ||= @@max_freqs.all?(&File.method(:readable?))
+
+				if @@max_freqs_readable
+					@@max_freqs.map { |x| IO.read(x).to_i }
+				else
+					[]
+				end
 			end
 
 			alias usages stat

data/lib/linux_stat/filesystem.rb

@@ -0,0 +1,94 @@
+module LinuxStat
+	module Filesystem
+		prepend FS
+
+		class << self
+			# 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.
+			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
+
+			# 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.
+			def total(fs = ?/.freeze)
+				s = stat_raw(fs)
+				return nil if s.empty?
+				s.default = 0
+				s[:block_size] * s[:blocks]
+			end
+
+			# 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.
+			def free(fs = ?/.freeze)
+				s = stat_raw(fs)
+				return nil if s.empty?
+				s.default = 0
+				s[:block_size] * s[:block_free]
+			end
+
+			# 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.
+			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
+
+			# 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.
+			def available(fs = ?/.freeze)
+				s = stat_raw(fs)
+				return nil if s.empty?
+				s.default = 0
+				s[:block_size] * s[:block_avail_unpriv]
+			end
+
+			# 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.
+			def stat_raw(fs = '/'.freeze)
+				FS.stat(fs)
+			end
+		end
+	end
+end

data/lib/linux_stat/kernel.rb

@@ -73,15 +73,15 @@ module LinuxStat
 						joined = x.each(&:strip!).join(?\s.freeze)
 
 						# Match 21 Oct 2020 01:11:20 +0000
-						if joined[/^\d{2}\s\w{3}\s\d{4}\s\d{2}:\d{2}:\d{2}\s\+\d*$/]
+						if joined[/^\d{1,2}\s\w{3}\s\d{4}\s\d{1,2}:\d{1,2}:\d{1,2}\s\+\d*$/]
 							Time.strptime(joined, '%d %b %Y %H:%M:%S %Z') rescue nil
 
 						# Match Aug 25 17:23:54 UTC 2020
-						elsif joined[/^\w{3}\s\d{2}\s\d{2}:\d{2}:\d{2}\s\w+\s\d*$/]
+						elsif joined[/^\w{3}\s\d{1,2}\s\d{1,2}:\d{1,2}:\d{2}\s\w+\s\d*$/]
 							Time.strptime(joined, '%b %d %H:%M:%S %z %Y') rescue nil
 
 						# Match 2017-09-19
-						elsif joined[/\d{4}-\d{2}-\d{2}/]
+						elsif joined[/\d{4}-\d{1,2}-\d{1,2}/]
 							Time.strptime(joined[/\d{4}-\d{2}-\d{2}/] + " +00:00", '%Y-%m-%d %z') rescue nil
 
 						else
@@ -118,13 +118,13 @@ module LinuxStat
 						joined = x.each(&:strip!).join(?\s.freeze)
 
 						# Match 21 Oct 2020 01:11:20 +0000
-						if (joined[/^\d{2}\s\w{3}\s\d{4}\s\d{2}:\d{2}:\d{2}\s\+\d*$/] && (Time.strptime(joined, '%d %b %Y %H:%M:%S %Z') rescue nil)) ||
+						if (joined[/^\d{1,2}\s\w{3}\s\d{4}\s\d{1,2}:\d{1,2}:\d{1,2}\s\+\d*$/] && (Time.strptime(joined, '%d %b %Y %H:%M:%S %Z') rescue nil)) ||
 
 						# Match Aug 25 17:23:54 UTC 2020
-						(joined[/^\w{3}\s\d{2}\s\d{2}:\d{2}:\d{2}\s\w+\s\d*$/] && (Time.strptime(joined, '%b %d %H:%M:%S %z %Y') rescue nil)) ||
+						(joined[/^\w{3}\s\d{1,2}\s\d{1,2}:\d{1,2}:\d{1,2}\s\w+\s\d*$/] && (Time.strptime(joined, '%b %d %H:%M:%S %z %Y') rescue nil)) ||
 
 						# Match 2017-09-19
-						(joined[/\d{4}-\d{2}-\d{2}/] && (Time.strptime(joined[/\d{4}-\d{2}-\d{2}/] + " +00:00", '%Y-%m-%d %z') rescue nil))
+						(joined[/\d{4}-\d{1,2}-\d{1,2}/] && (Time.strptime(joined[/\d{4}-\d{2}-\d{2}/] + " +00:00", '%Y-%m-%d %z') rescue nil))
 							joined
 						else
 							nil
@@ -133,6 +133,8 @@ module LinuxStat
 				end
 			end
 
+			alias release version
+
 			# Reads maximum 1024 bytes from /proc/version and returns the string.
 			# The output is also cached ; as changing the value in runtime is unexpected.
 			def string

data/lib/linux_stat/mounts.rb

@@ -0,0 +1,64 @@
+module LinuxStat
+	module Mounts
+		class << self
+			# Reads /proc/mounts and returns list of devices.
+			#
+			# It returns an Array.
+			# If the info isn't available or /proc/mounts is not readable, it will return an empty Array.
+			def list
+				mounts
+			end
+
+			# Reads /proc/mounts and returns partition name of the device mounted at /.
+			#
+			# It returns a String.
+			# But if the info isn't available or /proc/mounts is not readable, it will return an empty frozen String.
+			def root
+				find_root[0].to_s
+			end
+
+			# Reads /proc/mounts and returns the file system of the device mounted at /.
+			#
+			# It returns a String.
+			# But if the info isn't available or /proc/mounts is not readable, it will return an empty frozen String.
+			def root_fs
+				find_root[2].to_s
+			end
+
+			# Reads /proc/mounts and returns the options used for mounting /.
+			#
+			# It returns a String.
+			# But if the info isn't available or /proc/mounts is not readable, it will return an empty frozen string.
+			def root_mount_options
+				find_root[3].to_s
+			end
+
+			# Reads /proc/mounts and finds all tmpfs.
+			#
+			# It returns a Hash
+			# But if the info isn't available or /proc/mounts is not readable, it will return an empty Hash.
+			def tmpfs
+				ret = {}
+				mounts.each { |x|
+					ret.merge!({x.split[1] => x}) if x.start_with?('tmpfs '.freeze)
+				}
+				ret
+			end
+
+			private
+			def mount_readable?
+				@@mount_readable ||= File.readable?('/proc/mounts')
+			end
+
+			def mounts
+				return [] unless mount_readable?
+				IO.readlines('/proc/mounts').each(&:strip!)
+			end
+
+			def find_root
+				return [] unless mount_readable?
+				@@root ||= IO.foreach('/proc/mounts').find { |x| x.split[1] == '/'.freeze }.split
+			end
+		end
+	end
+end

data/lib/linux_stat/os.rb

@@ -1,5 +1,7 @@
 module LinuxStat
 	module OS
+		prepend Uname
+
 		class << self
 			# Reads /etc/os-release and returns a Hash. For example:
 			# {:NAME=>"Arch Linux", :PRETTY_NAME=>"Arch Linux", :ID=>"arch", :BUILD_ID=>"rolling", :ANSI_COLOR=>"38;2;23;147;209", :HOME_URL=>"https://www.archlinux.org/", :DOCUMENTATION_URL=>"https://wiki.archlinux.org/", :SUPPORT_URL=>"https://bbs.archlinux.org/", :BUG_REPORT_URL=>"https://bugs.archlinux.org/", :LOGO=>"archlinux"}
@@ -51,6 +53,18 @@ module LinuxStat
 				end
 			end
 
+			# Uses utsname.h to determine the machine
+			# It returns a String but if the info isn't available, it will return an empty String
+			def machine
+				@@machine ||= Uname.machine
+			end
+
+			# Uses utsname.h to determine the system nodename
+			# It returns String but if the info isn't available, it will return an empty String
+			def nodename
+				@@nodename ||= Uname.nodename
+			end
+
 			# Reads /etc/hostname and returns the hostname.
 			# The return type is String.
 			# If the info info isn't available, it will return 'localhost'.
@@ -62,10 +76,13 @@ module LinuxStat
 				end
 			end
 
-			# Reads ruby configuration and tries to guess if the system is 32 bit or 64 bit.
-			# The return type is Integer.
+			# Reads ruby configuration and tries to guess if the system is 64 bit.
+			# If it fails then it runs utsname.h to guess the machine.
+			# It the machine is 64 bits, it will return 64, else it returns 32.
+			#
+			# The return type is strictly Integer and doesn't fail.
 			def bits
-				@@bits ||= if RbConfig::CONFIG['host_cpu'].end_with?('64') || RUBY_PLATFORM[/x86_64/]
+				@@bits ||= if RbConfig::CONFIG['host_cpu'].end_with?('64') || RUBY_PLATFORM.end_with?('64') || machine.end_with?('64')
 					64
 				else
 					32

data/lib/linux_stat/version.rb

@@ -1,3 +1,3 @@
 module LinuxStat
-	VERSION = "0.2.0"
+	VERSION = "0.3.3"
 end

metadata

@@ -1,34 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: linux_stat
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.3
 platform: ruby
 authors:
 - Sourav Goswami
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-11-25 00:00:00.000000000 Z
+date: 2020-12-03 00:00:00.000000000 Z
 dependencies: []
 description: Efficient linux system reporting gem. Linux Only | Efficient | Reliable
 email:
 - souravgoswami@protonmail.com
 executables: []
-extensions: []
+extensions:
+- ext/utsname/extconf.rb
+- ext/fs_stat/extconf.rb
 extra_rdoc_files:
 - README.md
 files:
-- Gemfile
 - README.md
 - bin/console
 - bin/linuxstat.rb
 - bin/setup
+- ext/fs_stat/extconf.rb
+- ext/fs_stat/fs_stat.c
+- ext/utsname/extconf.rb
+- ext/utsname/utsname.c
 - lib/linux_stat.rb
 - lib/linux_stat/battery.rb
 - lib/linux_stat/bios.rb
 - lib/linux_stat/cpu.rb
+- lib/linux_stat/filesystem.rb
 - lib/linux_stat/kernel.rb
 - lib/linux_stat/memory.rb
+- lib/linux_stat/mounts.rb
 - lib/linux_stat/net.rb
 - lib/linux_stat/os.rb
 - lib/linux_stat/process.rb
@@ -56,7 +63,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key:
 specification_version: 4
 summary: Efficient linux system reporting gem

data/Gemfile

@@ -1,5 +0,0 @@
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in linux_stat.gemspec
-gemspec
-gem "rake", ">= 12.0"