linux_stat 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a54eca551d77c1284989f5f8edeea8e363d32228e0ea5a2d28b2df9eefeedf53
-  data.tar.gz: 407820d169fe900f639cd43730bd03eb66c43a2ec0bcd5c3d1399af741418c4a
+  metadata.gz: 7f217c6dc1948f9b7c8aabc280be2944c4036369922bbf56558afb04246db731
+  data.tar.gz: f112e864606b82cce2172272791e2db4935b93fd594d61f8a847964e19b7155c
 SHA512:
-  metadata.gz: ff513a54d80eb9e9c101dd2fb92ff874c3e644da5752e8f7b2c9bdf535d56a1d942e64ed3b083eb051dfcb62be02cb521b51f0b1e08baef7f3ec0a261bacd1f1
-  data.tar.gz: ef5b77eb019ab19976a5799a276f22a6967603c6d03b0219a6314e74e00a275a288102f0ab6d753e38867b96d6621e8673a9b0fa733d772c2d97118749ada933
+  metadata.gz: efb59793c28352ef4761cdefb2d4d1739568e80671ba8046f5ed618e982a25f20d49235644e0cf3780d2370481a23b21b78a8dafbfa344c483b5cd31c5469c32
+  data.tar.gz: d668cd782b969916e3207bb17afca44cdcd0997f65c7cc2116cf9f45858761fd847582dfb7c83892b608fc2d3daa48517e7674f4b2b3365c7f64e78a8a6f99de

data/README.md

@@ -1,4 +1,7 @@
-# LinuxStat
+# LinuxStat [![Ruby Gem](https://badge.fury.io/rb/linux_stat.svg)](https://rubygems.org/gems/linux_stat) ![Workflow Status](https://github.com/souravgoswami/linux_stat/workflows/LinuxStat%20Test/badge.svg)
+
+---
+
 ![logo](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/images/logo.jpg)
 
 For reading the eyecandy HTML version, visit [linux_stat](https://souravgoswami.github.io/linux_stat/).
@@ -7,6 +10,10 @@ LinuxStat lets you read status of a Linux system. It can show you cpu stats and
 
 It only works for Linux, and detecting the OS is upto the user of this gem.
 
+Programming Languages Used:
+
+<img src="https://linuxstatloc.herokuapp.com/badge.svg" width="260px">
+
 ---
 
 ## Dependencies:
@@ -47,467 +54,821 @@ Or install it yourself as:
     $ gem install linux_stat
 
 ## Usage
+Following are the LinuxStat modules and module functions.
+It's generated by linuxstat.rb command, which is available after the installation.
+
+For ease of use, LinuxStat is also assigned to the LS constant.
+
 ### LinuxStat::BIOS
 ```
-LinuxStat::BIOS.date
+# File:		bios.rb | Line: 56
+# Definition:	def date
+LinuxStat::BIOS.date()
 => "04/10/2017"
 
-LinuxStat::BIOS.model
+# File:		bios.rb | Line: 10
+# Definition:	def model
+LinuxStat::BIOS.model()
 => "Inspiron 5567"
 
-LinuxStat::BIOS.vendor
+# File:		bios.rb | Line: 27
+# Definition:	def vendor
+LinuxStat::BIOS.vendor()
 => "Dell Inc."
 
-LinuxStat::BIOS.version
+# File:		bios.rb | Line: 42
+# Definition:	def version
+LinuxStat::BIOS.version()
 => "1.1.2"
 
 ```
 
 ### LinuxStat::Battery
 ```
-LinuxStat::Battery.charge
+# File:		battery.rb | Line: 100
+# Definition:	def charge
+LinuxStat::Battery.charge()
 => 100.0
 
-LinuxStat::Battery.charging?
+# File:		battery.rb | Line: 73
+# Definition:	def charging?
+LinuxStat::Battery.charging?()
 => true
 
-LinuxStat::Battery.discharging?
+# File:		battery.rb | Line: 82
+# Definition:	def discharging?
+LinuxStat::Battery.discharging?()
 => false
 
-LinuxStat::Battery.full?
+# File:		battery.rb | Line: 91
+# Definition:	def full?
+LinuxStat::Battery.full?()
 => true
 
-LinuxStat::Battery.manufacturer
+# File:		battery.rb | Line: 45
+# Definition:	def manufacturer
+LinuxStat::Battery.manufacturer()
 => "Samsung SDI"
 
-LinuxStat::Battery.model
+# File:		battery.rb | Line: 36
+# Definition:	def model
+LinuxStat::Battery.model()
 => "DELL CYMGM77"
 
-LinuxStat::Battery.present?
+# File:		battery.rb | Line: 8
+# Definition:	def present?
+LinuxStat::Battery.present?()
 => true
 
-LinuxStat::Battery.stat
+# File:		battery.rb | Line: 16
+# Definition:	def stat
+LinuxStat::Battery.stat()
 => {:model=>"DELL CYMGM77", :manufacturer=>"Samsung SDI", :technology=>"Li-ion", :status=>"Full", :charge=>100.0, :charging=>true, :discharging=>false, :full=>true}
 
-LinuxStat::Battery.status
+# File:		battery.rb | Line: 64
+# Definition:	def status
+LinuxStat::Battery.status()
 => "Full"
 
-LinuxStat::Battery.technology
+# File:		battery.rb | Line: 54
+# Definition:	def technology
+LinuxStat::Battery.technology()
 => "Li-ion"
 
+# File:		battery.rb | Line: 114
+# Definition:	def voltage_now
+LinuxStat::Battery.voltage_now()
+=> 12.477
+
 ```
 
 ### LinuxStat::CPU
 ```
-LinuxStat::CPU.count
+# File:		cpu.rb | Line: 243
+# Definition:	def available_governors
+LinuxStat::CPU.available_governors()
+=> {"cpu0"=>["performance", "powersave"], "cpu1"=>["performance", "powersave"], "cpu2"=>["performance", "powersave"], "cpu3"=>["performance", "powersave"]}
+
+# File:		cpu.rb | Line: 86
+# Definition:	def count
+LinuxStat::CPU.count()
 => 4
 
-LinuxStat::CPU.cur_freq
-=> [2000063, 2000108, 2000332, 2000028]
+# File:		cpu.rb | Line: 153
+# Definition:	def cur_freq
+LinuxStat::CPU.cur_freq()
+=> {"cpu0"=>1923309, "cpu1"=>2000053, "cpu2"=>2000046, "cpu3"=>2000086}
+
+# File:		cpu.rb | Line: 221
+# Definition:	def governor
+LinuxStat::CPU.governor()
+=> {"cpu0"=>"performance", "cpu1"=>"performance", "cpu2"=>"performance", "cpu3"=>"performance"}
+
+# File:		cpu.rb | Line: 197
+# Definition:	def max_freq
+LinuxStat::CPU.max_freq()
+=> {"cpu0"=>2000000, "cpu1"=>2000000, "cpu2"=>2000000, "cpu3"=>2000000}
+
+# File:		cpu.rb | Line: 175
+# Definition:	def min_freq
+LinuxStat::CPU.min_freq()
+=> {"cpu0"=>2000000, "cpu1"=>2000000, "cpu2"=>2000000, "cpu3"=>2000000}
+
+# File:		cpu.rb | Line: 140
+# Definition:	def model
+LinuxStat::CPU.model()
+=> "Intel(R) Core(TM) i3-6006U CPU @ 2.00GHz"
 
-LinuxStat::CPU.max_freq
-=> [2000000, 2000000, 2000000, 2000000]
+# File:		cpu.rb | Line: 119
+# Definition:	def offline
+LinuxStat::CPU.offline()
+=> []
 
-LinuxStat::CPU.model
-=> "Intel(R) Core(TM) i3-6006U CPU @ 2.00GHz"
+# File:		cpu.rb | Line: 97
+# Definition:	def online
+LinuxStat::CPU.online()
+=> [0, 1, 2, 3]
 
-LinuxStat::CPU.stat
-=> {0=>0.0, 1=>0.0, 2=>0.0, 3=>0.0, 4=>0.0}
+# File:		cpu.rb | Line: 23
+# Definition:	def stat(sleep = ticks_to_ms_t5)
+LinuxStat::CPU.stat(sleep)
+=> {0=>5.26, 1=>0.0, 2=>0.0, 3=>20.0, 4=>0.0}
 
-LinuxStat::CPU.total_usage
-=> 0.0
+# File:		cpu.rb | Line: 63
+# Definition:	def total_usage(sleep = ticks_to_ms_t5)
+LinuxStat::CPU.total_usage(sleep)
+=> 10.0
+
+# File:		cpu.rb | Line: 63
+# Definition:	def total_usage(sleep = ticks_to_ms_t5)
+LinuxStat::CPU.usage(sleep)
+=> 5.0
 
-LinuxStat::CPU.usage
-=> 20.0
+# File:		cpu.rb | Line: 23
+# Definition:	def stat(sleep = ticks_to_ms_t5)
+LinuxStat::CPU.usages(sleep)
+=> {0=>5.56, 1=>0.0, 2=>0.0, 3=>16.67, 4=>0.0}
 
-LinuxStat::CPU.usages
-=> {0=>20.0, 1=>0.0, 2=>0.0, 3=>50.0, 4=>100.0}
+```
+
+### LinuxStat::FS
+```
+LinuxStat::FS.stat(arg = "/")
+=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>12266136, :block_avail_unpriv=>12266136, :inodes=>58612160, :free_inodes=>56868673, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
 
 ```
 
 ### LinuxStat::Filesystem
 ```
-LinuxStat::Filesystem.available
-=> 33120964608
+# File:		filesystem.rb | Line: 92
+# Definition:	def available(fs = ?..freeze)
+LinuxStat::Filesystem.available(fs)
+=> 6442397696
 
-LinuxStat::Filesystem.free
-=> 33120964608
+# File:		filesystem.rb | Line: 58
+# Definition:	def free(fs = ?..freeze)
+LinuxStat::Filesystem.free(fs)
+=> 6442397696
 
-LinuxStat::Filesystem.stat
-=> {:total=>119981191168, :free=>33120964608, :used=>86860226560}
+# File:		filesystem.rb | Line: 19
+# Definition:	def stat(fs = ?..freeze)
+LinuxStat::Filesystem.stat(fs)
+=> {:total=>6442450944, :free=>6442397696, :used=>53248}
 
-LinuxStat::Filesystem.stat_raw
-=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>8086173, :block_avail_unpriv=>8086173, :inodes=>58612160, :free_inodes=>56567338, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
+# File:		filesystem.rb | Line: 108
+# Definition:	def stat_raw(fs = ?..freeze)
+LinuxStat::Filesystem.stat_raw(fs)
+=> {:block_size=>4096, :fragment_size=>4096, :blocks=>1572864, :block_free=>1572851, :block_avail_unpriv=>1572851, :inodes=>479529, :free_inodes=>479519, :filesystem_id=>0, :mount_flags=>4102, :max_filename_length=>255}
 
-LinuxStat::Filesystem.total
-=> 119981191168
+# File:		filesystem.rb | Line: 39
+# Definition:	def total(fs = ?..freeze)
+LinuxStat::Filesystem.total(fs)
+=> 6442450944
 
-LinuxStat::Filesystem.used
-=> 86860226560
+# File:		filesystem.rb | Line: 73
+# Definition:	def used(fs = ?..freeze)
+LinuxStat::Filesystem.used(fs)
+=> 53248
 
 ```
 
 ### LinuxStat::Kernel
 ```
-LinuxStat::Kernel.build_date
+# File:		kernel.rb | Line: 86
+# Definition:	def build_date
+LinuxStat::Kernel.build_date()
 => 2020-11-20 07:44:55 +0000
 
-LinuxStat::Kernel.build_date_string
+# File:		kernel.rb | Line: 140
+# Definition:	def build_date_string
+LinuxStat::Kernel.build_date_string()
 => "20 Nov 2020 07:44:55 +0000"
 
-LinuxStat::Kernel.build_user
+# File:		kernel.rb | Line: 21
+# Definition:	def build_user
+LinuxStat::Kernel.build_user()
 => "souravgoswami@archlinux"
 
-LinuxStat::Kernel.clk_tck
+# File:		kernel.rb | Line: 179
+# Definition:	def ticks
+LinuxStat::Kernel.clk_tck()
 => 100
 
-LinuxStat::Kernel.compiler
+# File:		kernel.rb | Line: 33
+# Definition:	def compiler
+LinuxStat::Kernel.compiler()
 => [:gcc, "10.2.0"]
 
-LinuxStat::Kernel.compiler_version
+# File:		kernel.rb | Line: 55
+# Definition:	def compiler_version
+LinuxStat::Kernel.compiler_version()
 => "10.2.0"
 
-LinuxStat::Kernel.release
+# File:		kernel.rb | Line: 10
+# Definition:	def version
+LinuxStat::Kernel.release()
 => "5.9.9-xanmod1-1"
 
-LinuxStat::Kernel.string
+# File:		kernel.rb | Line: 169
+# Definition:	def string
+LinuxStat::Kernel.string()
 => "Linux version 5.9.9-xanmod1-1 (souravgoswami@archlinux) (gcc (GCC) 10.2.0, GNU ld (GNU Binutils) 2.35.1) #1 SMP PREEMPT Fri, 20 Nov 2020 07:44:55 +0000"
 
-LinuxStat::Kernel.ticks
+# File:		kernel.rb | Line: 179
+# Definition:	def ticks
+LinuxStat::Kernel.ticks()
 => 100
 
-LinuxStat::Kernel.version
+# File:		kernel.rb | Line: 10
+# Definition:	def version
+LinuxStat::Kernel.version()
 => "5.9.9-xanmod1-1"
 
 ```
 
 ### LinuxStat::Memory
 ```
-LinuxStat::Memory.available
-=> 579264
-
-LinuxStat::Memory.percent_available
-=> 15.1
-
-LinuxStat::Memory.percent_used
-=> 84.9
-
-LinuxStat::Memory.stat
-=> {:total=>3836236, :used=>3256972, :available=>579264, :percent_used=>84.9, :percent_available=>15.1}
-
-LinuxStat::Memory.total
+# File:		memory.rb | Line: 50
+# Definition:	def available
+LinuxStat::Memory.available()
+=> 589228
+
+# File:		memory.rb | Line: 81
+# Definition:	def percent_available
+LinuxStat::Memory.percent_available()
+=> 15.36
+
+# File:		memory.rb | Line: 70
+# Definition:	def percent_used
+LinuxStat::Memory.percent_used()
+=> 84.64
+
+# File:		memory.rb | Line: 11
+# Definition:	def stat
+LinuxStat::Memory.stat()
+=> {:total=>3836236, :used=>3247008, :available=>589228, :percent_used=>84.64, :percent_available=>15.36}
+
+# File:		memory.rb | Line: 40
+# Definition:	def total
+LinuxStat::Memory.total()
 => 3836236
 
-LinuxStat::Memory.used
-=> 3256972
+# File:		memory.rb | Line: 60
+# Definition:	def used
+LinuxStat::Memory.used()
+=> 3247008
 
 ```
 
 ### LinuxStat::Mounts
 ```
-LinuxStat::Mounts.device_stat
-=> {:mountpoint=>"/", :total=>119981191168, :free=>33120964608, :available=>33120964608, :used=>86860226560, :percent_used=>72.39, :percent_free=>27.61, :percent_available=>27.61}
+# File:		mounts.rb | Line: 179
+# Definition:	def device_stat(dev = root)
+LinuxStat::Mounts.device_stat(dev)
+=> {:mountpoint=>"/", :total=>119981191168, :free=>50242093056, :available=>50242093056, :used=>69739098112, :percent_used=>58.13, :percent_free=>41.87, :percent_available=>41.87}
 
-LinuxStat::Mounts.devices_stat
+# File:		mounts.rb | Line: 137
+# Definition:	def devices_stat
+LinuxStat::Mounts.devices_stat()
 => {"proc"=>{:mountpoint=>"/proc", :total=>0, :free=>0, :available=>0, :used=>0, :percent_used=>NaN, :percent_free=>NaN, :percent_available=>NaN}, "sys"=>{:mountpoint=>"/sys", :total=>0, :free=>0, :available=>0, :used=>0, :percent_used=>NaN, :percent_fre...
 
-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=1892908k,nr_inodes=473227,mode=755 0 0", "run /run tmpfs rw,nosuid,nodev,relatime,mode=755 0 0", "...
+# File:		mounts.rb | Line: 11
+# Definition:	def list
+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=1892904k,nr_inodes=473226,mode=755 0 0", "run /run tmpfs rw,nosuid,nodev,relatime,mode=755 0 0", "...
 
-LinuxStat::Mounts.list_devices
-=> ["proc", "sys", "dev", "run", "/dev/sda2", "securityfs", "tmpfs", "devpts", "tmpfs", "cgroup2", "cgroup", "pstore", "none", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "systemd-1", "deb...
+# File:		mounts.rb | Line: 20
+# Definition:	def list_devices
+LinuxStat::Mounts.list_devices()
+=> ["proc", "sys", "dev", "run", "/dev/sda2", "securityfs", "tmpfs", "devpts", "tmpfs", "cgroup2", "cgroup", "pstore", "none", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "cgroup", "systemd-1", "mqu...
 
-LinuxStat::Mounts.list_devices_mount_point
-=> {"proc"=>"/proc", "sys"=>"/sys", "dev"=>"/dev", "run"=>"/run", "/dev/sda2"=>"/", "securityfs"=>"/sys/kernel/security", "tmpfs"=>"/run/user/1000", "devpts"=>"/dev/pts", "cgroup2"=>"/sys/fs/cgroup/unified", "cgroup"=>"/sys/fs/cgroup/perf_event", "pstore...
+# File:		mounts.rb | Line: 109
+# Definition:	def list_devices_mount_point
+LinuxStat::Mounts.list_devices_mount_point()
+=> {"proc"=>"/proc", "sys"=>"/sys", "dev"=>"/dev", "run"=>"/run", "/dev/sda2"=>"/", "securityfs"=>"/sys/kernel/security", "tmpfs"=>"/run/user/1000", "devpts"=>"/dev/pts", "cgroup2"=>"/sys/fs/cgroup/unified", "cgroup"=>"/sys/fs/cgroup/freezer", "pstore"=>...
 
-LinuxStat::Mounts.mount_point
+# File:		mounts.rb | Line: 80
+# Definition:	def mount_point(dev = root)
+LinuxStat::Mounts.mount_point(dev)
 => "/"
 
-LinuxStat::Mounts.root
+# File:		mounts.rb | Line: 29
+# Definition:	def root
+LinuxStat::Mounts.root()
 => "/dev/sda2"
 
-LinuxStat::Mounts.root_fs
+# File:		mounts.rb | Line: 38
+# Definition:	def root_fs
+LinuxStat::Mounts.root_fs()
 => "xfs"
 
-LinuxStat::Mounts.root_mount_options
+# File:		mounts.rb | Line: 47
+# Definition:	def root_mount_options
+LinuxStat::Mounts.root_mount_options()
 => "rw,noatime,attr2,inode64,logbufs=8,logbsize=32k,noquota"
 
-LinuxStat::Mounts.tmpfs
+# File:		mounts.rb | Line: 56
+# Definition:	def tmpfs
+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", "/cache"=>"tmpfs /cache tmpfs rw,nosuid,nodev,relatime,size=2097152k 0 0", "/ramdisk...
 
 ```
 
 ### LinuxStat::Net
 ```
-LinuxStat::Net.current_usage
-=> {:received=>2183400.0, :transmitted=>114860.0}
+# File:		net.rb | Line: 80
+# Definition:	def usage(interval = 0.1)
+LinuxStat::Net.current_usage(interval)
+=> {:received=>0.0, :transmitted=>0.0}
 
-LinuxStat::Net.ipv4_private
+# File:		net.rb | Line: 10
+# Definition:	def ipv4_private
+LinuxStat::Net.ipv4_private()
 => "192.168.0.102"
 
-LinuxStat::Net.total_bytes
-=> {:received=>294316415, :transmitted=>45313147}
+# File:		net.rb | Line: 23
+# Definition:	def total_bytes
+LinuxStat::Net.total_bytes()
+=> {:received=>154632306, :transmitted=>19636024}
+
+# File:		net.rb | Line: 41
+# Definition:	def total_bytes_received
+LinuxStat::Net.total_bytes_received()
+=> 154632306
 
-LinuxStat::Net.total_bytes_received
-=> 294317913
+# File:		net.rb | Line: 54
+# Definition:	def total_bytes_transmitted
+LinuxStat::Net.total_bytes_transmitted()
+=> 19636024
 
-LinuxStat::Net.total_bytes_transmitted
-=> 45313147
+# File:		net.rb | Line: 80
+# Definition:	def usage(interval = 0.1)
+LinuxStat::Net.usage(interval)
+=> {:received=>0.0, :transmitted=>0.0}
 
-LinuxStat::Net.usage
-=> {:received=>1643690.0, :transmitted=>146030.0}
+```
 
+### LinuxStat::Nproc
+```
 ```
 
 ### LinuxStat::OS
 ```
-LinuxStat::OS.bits
+# File:		os.rb | Line: 97
+# Definition:	def bits
+LinuxStat::OS.bits()
 => 64
 
-LinuxStat::OS.distribution
+# File:		os.rb | Line: 42
+# Definition:	def distribution
+LinuxStat::OS.distribution()
 => "Arch Linux"
 
-LinuxStat::OS.hostname
+# File:		os.rb | Line: 81
+# Definition:	def hostname
+LinuxStat::OS.hostname()
 => "archlinux"
 
-LinuxStat::OS.lsb_release
+# File:		os.rb | Line: 30
+# Definition:	def lsb_release
+LinuxStat::OS.lsb_release()
 => {:LSB_VERSION=>"1.4", :DISTRIB_ID=>"Arch", :DISTRIB_RELEASE=>"rolling", :DISTRIB_DESCRIPTION=>"Arch Linux"}
 
-LinuxStat::OS.machine
+# File:		os.rb | Line: 64
+# Definition:	def machine
+LinuxStat::OS.machine()
 => "x86_64"
 
-LinuxStat::OS.nodename
+# File:		os.rb | Line: 72
+# Definition:	def nodename
+LinuxStat::OS.nodename()
 => "archlinux"
 
-LinuxStat::OS.os_release
+# File:		os.rb | Line: 15
+# Definition:	def os_release
+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=>7, :minute=>44, :second=>29.92}
+# File:		os.rb | Line: 110
+# Definition:	def uptime
+LinuxStat::OS.uptime()
+=> {:hour=>5, :minute=>59, :second=>24.24}
 
 ```
 
-### LinuxStat::Process
+### LinuxStat::PrettifyBytes
 ```
-LinuxStat::Process.count
-=> 205
-
-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, 172, 174, 176, 178, 182, 183, 184, 185, 186, 188, 230, 271, 324, 328, 337, 14228, 14757, 14998, 14999, 15000, 15001, 15...
+# File:		prettify_bytes.rb | Line: 42
+# Definition:	def convert_binary(n)
+LinuxStat::PrettifyBytes.convert_binary(n = 303090340303942)
+=> "275.66 tebibytes"
 
-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,...
+# File:		prettify_bytes.rb | Line: 19
+# Definition:	def convert_decimal(n)
+LinuxStat::PrettifyBytes.convert_decimal(n = 805436909517676)
+=> "805.44 terabytes"
 
-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/...
+# File:		prettify_bytes.rb | Line: 90
+# Definition:	def convert_short_binary(n)
+LinuxStat::PrettifyBytes.convert_short_binary(n = 652441756135644)
+=> "593.39 TiB"
 
-LinuxStat::Process.running
-=> [21158]
+# File:		prettify_bytes.rb | Line: 65
+# Definition:	def convert_short_decimal(n)
+LinuxStat::PrettifyBytes.convert_short_decimal(n = 957289578618866)
+=> "957.29 TB"
 
-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, 189, 217, 231, 302, 307, 308, 309, 310, 320, 321, 322, 323, 325, 326, 350, 353, 356, 374, 394,...
+```
 
-LinuxStat::Process.types
+### LinuxStat::Process
+```
+# File:		process.rb | Line: 19
+# Definition:	def count
+LinuxStat::Process.count()
+=> 214
+
+# File:		process.rb | Line: 71
+# Definition:	def idle
+LinuxStat::Process.idle()
+=> [3, 4, 6, 9, 12, 23, 30, 37, 39, 49, 102, 103, 104, 106, 107, 108, 109, 110, 117, 118, 119, 121, 131, 134, 140, 152, 153, 182, 184, 186, 187, 190, 195, 196, 197, 198, 199, 200, 229, 245, 288, 368, 382, 2013, 6607, 6608, 6609, 6610, 6611, 6612, 11958,...
+
+# File:		process.rb | Line: 8
+# Definition:	def list
+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, 112, 114, 115, 117, 118, 119, 121, 131, 134,...
+
+# File:		process.rb | Line: 25
+# Definition:	def names
+LinuxStat::Process.names()
+=> {1=>"systemd", 2=>"kthreadd", 3=>"rcu_gp", 4=>"rcu_par_gp", 6=>"kworker/0:0H-kblockd", 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...
+
+# File:		process.rb | Line: 97
+# Definition:	def running
+LinuxStat::Process.running()
+=> [14954]
+
+# File:		process.rb | Line: 58
+# Definition:	def sleeping
+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, 112, 114, 115, 181, 183, 201, 232, 247, 308, 319, 321, 322, 323, 325, 326, 327, 328, 343, 346, 349, 403, 433, 435, 436,...
+
+# File:		process.rb | Line: 37
+# Definition:	def types
+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...
 
-LinuxStat::Process.zombie
+# File:		process.rb | Line: 84
+# Definition:	def zombie
+LinuxStat::Process.zombie()
 => []
 
 ```
 
 ### LinuxStat::ProcessInfo
 ```
-LinuxStat::ProcessInfo.cmdline
-=> "ruby exe/linuxstat.rb -md"
+# File:		process_info.rb | Line: 54
+# Definition:	def cmdline(pid = $$)
+LinuxStat::ProcessInfo.cmdline(pid)
+=> "ruby /usr/bin/linuxstat.rb -md"
 
-LinuxStat::ProcessInfo.command_name
+# File:		process_info.rb | Line: 78
+# Definition:	def command_name(pid = $$)
+LinuxStat::ProcessInfo.command_name(pid)
 => "ruby"
 
-LinuxStat::ProcessInfo.cpu_stat
+# File:		process_info.rb | Line: 640
+# Definition:	def nproc(pid = $$)
+LinuxStat::ProcessInfo.count_cpu(pid)
+=> 4
+
+# File:		process_info.rb | Line: 247
+# Definition:	def cpu_stat(pid: $$, sleep: ticks_to_ms_t5)
+LinuxStat::ProcessInfo.cpu_stat(pid:, sleep:)
 => {:cpu_usage=>0.0, :threads=>1, :last_executed_cpu=>1}
 
-LinuxStat::ProcessInfo.cpu_usage
+# File:		process_info.rb | Line: 307
+# Definition:	def cpu_usage(pid: $$, sleep: ticks_to_ms_t5)
+LinuxStat::ProcessInfo.cpu_usage(pid:, sleep:)
 => 0.0
 
-LinuxStat::ProcessInfo.gid
+# File:		process_info.rb | Line: 470
+# Definition:	def gid(pid = $$)
+LinuxStat::ProcessInfo.gid(pid)
 => {:real=>1000, :effective=>1000, :saved_set=>1000, :filesystem_uid=>1000}
 
-LinuxStat::ProcessInfo.last_executed_cpu
+# File:		process_info.rb | Line: 433
+# Definition:	def last_executed_cpu(pid = $$)
+LinuxStat::ProcessInfo.last_executed_cpu(pid)
 => 1
 
-LinuxStat::ProcessInfo.mem_stat
-=> {:memory=>10051.584, :virtual_memory=>81801.216, :resident_memory=>15986.688}
+# File:		process_info.rb | Line: 114
+# Definition:	def mem_stat(pid = $$)
+LinuxStat::ProcessInfo.mem_stat(pid)
+=> {:memory=>12472.32, :virtual_memory=>84164.60800000001, :resident_memory=>18575.36}
 
-LinuxStat::ProcessInfo.memory
-=> 10051.584
+# File:		process_info.rb | Line: 147
+# Definition:	def memory(pid = $$)
+LinuxStat::ProcessInfo.memory(pid)
+=> 12472.32
+
+# File:		process_info.rb | Line: 607
+# Definition:	def nice(pid = $$)
+LinuxStat::ProcessInfo.nice(pid)
+=> 0
 
-LinuxStat::ProcessInfo.owner
+# File:		process_info.rb | Line: 640
+# Definition:	def nproc(pid = $$)
+LinuxStat::ProcessInfo.nproc(pid)
+=> 4
+
+# File:		process_info.rb | Line: 491
+# Definition:	def owner(pid = $$)
+LinuxStat::ProcessInfo.owner(pid)
 => "sourav"
 
-LinuxStat::ProcessInfo.resident_memory
-=> 15986.688
+# File:		process_info.rb | Line: 197
+# Definition:	def resident_memory(pid = $$)
+LinuxStat::ProcessInfo.resident_memory(pid)
+=> 18575.36
+
+# File:		process_info.rb | Line: 563
+# Definition:	def running_time(pid = $$)
+LinuxStat::ProcessInfo.running_time(pid)
+=> 0.8
+
+# File:		process_info.rb | Line: 544
+# Definition:	def start_time(pid = $$)
+LinuxStat::ProcessInfo.start_time(pid)
+=> 2020-12-22 02:34:22 +0530
+
+# File:		process_info.rb | Line: 513
+# Definition:	def start_time_epoch(pid = $$)
+LinuxStat::ProcessInfo.start_time_epoch(pid)
+=> 1608584662
+
+# File:		process_info.rb | Line: 592
+# Definition:	def state(pid = $$)
+LinuxStat::ProcessInfo.state(pid)
+=> "R"
+
+# File:		process_info.rb | Line: 359
+# Definition:	def thread_usage(pid: $$, sleep: ticks_to_ms_t5)
+LinuxStat::ProcessInfo.thread_usage(pid:, sleep:)
+=> 0.0
 
-LinuxStat::ProcessInfo.threads
+# File:		process_info.rb | Line: 408
+# Definition:	def threads(pid = $$)
+LinuxStat::ProcessInfo.threads(pid)
 => 1
 
-LinuxStat::ProcessInfo.total_io
+# File:		process_info.rb | Line: 23
+# Definition:	def total_io(pid = $$)
+LinuxStat::ProcessInfo.total_io(pid)
 => {:read_bytes=>0, :write_bytes=>0}
 
-LinuxStat::ProcessInfo.uid
+# File:		process_info.rb | Line: 446
+# Definition:	def uid(pid = $$)
+LinuxStat::ProcessInfo.uid(pid)
 => {:real=>1000, :effective=>1000, :saved_set=>1000, :filesystem_uid=>1000}
 
-LinuxStat::ProcessInfo.virtual_memory
-=> 81801.216
+# File:		process_info.rb | Line: 172
+# Definition:	def virtual_memory(pid = $$)
+LinuxStat::ProcessInfo.virtual_memory(pid)
+=> 84164.608
 
 ```
 
 ### LinuxStat::Swap
 ```
-LinuxStat::Swap.any?
+# File:		swap.rb | Line: 22
+# Definition:	def any?
+LinuxStat::Swap.any?()
 => true
 
-LinuxStat::Swap.available
-=> 3383720
-
-LinuxStat::Swap.list
-=> {"/dev/zram0"=>[:partition, 4194300, 810580, -2]}
-
-LinuxStat::Swap.percent_available
-=> 80.67
-
-LinuxStat::Swap.percent_used
-=> 19.33
-
-LinuxStat::Swap.stat
-=> {:total=>4194300, :used=>810580, :available=>3383720, :percent_used=>19.33, :percent_available=>80.67}
-
-LinuxStat::Swap.total
+# File:		swap.rb | Line: 68
+# Definition:	def available
+LinuxStat::Swap.available()
+=> 2909408
+
+# File:		swap.rb | Line: 8
+# Definition:	def list
+LinuxStat::Swap.list()
+=> {"/dev/zram0"=>[:partition, 4194300, 1284892, -2]}
+
+# File:		swap.rb | Line: 103
+# Definition:	def percent_available
+LinuxStat::Swap.percent_available()
+=> 69.37
+
+# File:		swap.rb | Line: 89
+# Definition:	def percent_used
+LinuxStat::Swap.percent_used()
+=> 30.63
+
+# File:		swap.rb | Line: 32
+# Definition:	def stat
+LinuxStat::Swap.stat()
+=> {:total=>4194300, :used=>1284892, :available=>2909408, :percent_used=>30.63, :percent_available=>69.37}
+
+# File:		swap.rb | Line: 57
+# Definition:	def total
+LinuxStat::Swap.total()
 => 4194300
 
-LinuxStat::Swap.used
-=> 810580
+# File:		swap.rb | Line: 80
+# Definition:	def used
+LinuxStat::Swap.used()
+=> 1284892
 
 ```
 
 ### LinuxStat::Sysconf
 ```
-LinuxStat::Sysconf.child_max
+LinuxStat::Sysconf.child_max()
 => 2000000
 
-LinuxStat::Sysconf.get_euid
+LinuxStat::Sysconf.expr_nest_max()
+=> 32
+
+LinuxStat::Sysconf.get_euid()
 => 1000
 
-LinuxStat::Sysconf.get_gid
+LinuxStat::Sysconf.get_gid()
 => 1000
 
-LinuxStat::Sysconf.get_login
+LinuxStat::Sysconf.get_login()
 => "sourav"
 
-LinuxStat::Sysconf.get_uid
+LinuxStat::Sysconf.get_uid()
 => 1000
 
-LinuxStat::Sysconf.get_user
+LinuxStat::Sysconf.get_user()
 => "sourav"
 
-LinuxStat::Sysconf.hostname_max
+LinuxStat::Sysconf.hostname_max()
 => 64
 
-LinuxStat::Sysconf.login_name_max
+LinuxStat::Sysconf.line_max()
+=> 2048
+
+LinuxStat::Sysconf.login_name_max()
 => 256
 
-LinuxStat::Sysconf.open_max
+LinuxStat::Sysconf.open_max()
 => 1024
 
-LinuxStat::Sysconf.pagesize
+LinuxStat::Sysconf.pagesize()
 => 4096
 
-LinuxStat::Sysconf.posix_version
+LinuxStat::Sysconf.posix_version()
 => 200809
 
-LinuxStat::Sysconf.sc_clk_tck
+LinuxStat::Sysconf.processor_configured()
+=> 4
+
+LinuxStat::Sysconf.processor_online()
+=> 4
+
+LinuxStat::Sysconf.sc_clk_tck()
 => 100
 
-LinuxStat::Sysconf.stream_max
+LinuxStat::Sysconf.stream_max()
 => 16
 
-LinuxStat::Sysconf.tty_name_max
+LinuxStat::Sysconf.tty_name_max()
 => 32
 
 ```
 
 ### LinuxStat::Uname
 ```
-LinuxStat::Uname.machine
+LinuxStat::Uname.machine()
 => "x86_64"
 
-LinuxStat::Uname.nodename
+LinuxStat::Uname.nodename()
 => "archlinux"
 
-LinuxStat::Uname.release
+LinuxStat::Uname.release()
 => "5.9.9-xanmod1-1"
 
-LinuxStat::Uname.sysname
+LinuxStat::Uname.sysname()
 => "Linux"
 
-LinuxStat::Uname.version
+LinuxStat::Uname.version()
 => "#1 SMP PREEMPT Fri, 20 Nov 2020 07:44:55 +0000"
 
 ```
 
 ### LinuxStat::User
 ```
-LinuxStat::User.get_current_user
+# File:		user.rb | Line: 98
+# Definition:	def get_user
+LinuxStat::User.get_current_user()
 => "sourav"
 
-LinuxStat::User.get_euid
+# File:		user.rb | Line: 137
+# Definition:	def get_euid
+LinuxStat::User.get_euid()
 => 1000
 
-LinuxStat::User.get_gid
+# File:		user.rb | Line: 129
+# Definition:	def get_gid
+LinuxStat::User.get_gid()
 => 1000
 
-LinuxStat::User.get_login
+# File:		user.rb | Line: 152
+# Definition:	def get_login
+LinuxStat::User.get_login()
 => "sourav"
 
-LinuxStat::User.get_uid
+# File:		user.rb | Line: 121
+# Definition:	def get_uid
+LinuxStat::User.get_uid()
 => 1000
 
-LinuxStat::User.get_user
+# File:		user.rb | Line: 98
+# Definition:	def get_user
+LinuxStat::User.get_user()
 => "sourav"
 
-LinuxStat::User.gid_by_username
+# File:		user.rb | Line: 215
+# Definition:	def gid_by_username(username = get_user)
+LinuxStat::User.gid_by_username(username)
 => 1000
 
-LinuxStat::User.gids
+# File:		user.rb | Line: 56
+# Definition:	def gids
+LinuxStat::User.gids()
 => {:root=>0, :bin=>1, :daemon=>2, :mail=>12, :ftp=>11, :http=>33, :nobody=>65534, :dbus=>81, :"systemd-journal-remote"=>982, :"systemd-network"=>981, :"systemd-resolve"=>980, :"systemd-timesync"=>979, :"systemd-coredump"=>978, :uuidd=>68, :avahi=>977, :...
 
-LinuxStat::User.home_by_gid
+# File:		user.rb | Line: 314
+# Definition:	def home_by_gid(id = get_gid)
+LinuxStat::User.home_by_gid(id)
 => "/home/sourav"
 
-LinuxStat::User.home_by_username
+# File:		user.rb | Line: 266
+# Definition:	def home_by_username(user = get_user)
+LinuxStat::User.home_by_username(user)
 => "/home/sourav"
 
-LinuxStat::User.home_directories
+# File:		user.rb | Line: 72
+# Definition:	def home_directories
+LinuxStat::User.home_directories()
 => {:root=>"/root", :bin=>"/", :daemon=>"/", :mail=>"/var/spool/mail", :ftp=>"/srv/ftp", :http=>"/srv/http", :nobody=>"/", :dbus=>"/", :"systemd-journal-remote"=>"/", :"systemd-network"=>"/", :"systemd-resolve"=>"/", :"systemd-timesync"=>"/", :"systemd-c...
 
-LinuxStat::User.homes_by_uid
+# File:		user.rb | Line: 293
+# Definition:	def homes_by_uid(id = get_uid)
+LinuxStat::User.homes_by_uid(id)
 => ["/home/sourav"]
 
-LinuxStat::User.ids
+# File:		user.rb | Line: 23
+# Definition:	def ids
+LinuxStat::User.ids()
 => {:root=>{:uid=>0, :gid=>0}, :bin=>{:uid=>1, :gid=>1}, :daemon=>{:uid=>2, :gid=>2}, :mail=>{:uid=>8, :gid=>12}, :ftp=>{:uid=>14, :gid=>11}, :http=>{:uid=>33, :gid=>33}, :nobody=>{:uid=>65534, :gid=>65534}, :dbus=>{:uid=>81, :gid=>81}, :"systemd-journal...
 
-LinuxStat::User.list
+# File:		user.rb | Line: 11
+# Definition:	def list
+LinuxStat::User.list()
 => ["root", "bin", "daemon", "mail", "ftp", "http", "nobody", "dbus", "systemd-journal-remote", "systemd-network", "systemd-resolve", "systemd-timesync", "systemd-coredump", "uuidd", "avahi", "colord", "git", "lxdm", "polkitd", "rtkit", "usbmux", "sourav...
 
-LinuxStat::User.uid_by_username
+# File:		user.rb | Line: 244
+# Definition:	def uid_by_username(username = get_user)
+LinuxStat::User.uid_by_username(username)
 => 1000
 
-LinuxStat::User.uids
+# File:		user.rb | Line: 40
+# Definition:	def uids
+LinuxStat::User.uids()
 => {:root=>0, :bin=>1, :daemon=>2, :mail=>8, :ftp=>14, :http=>33, :nobody=>65534, :dbus=>81, :"systemd-journal-remote"=>982, :"systemd-network"=>981, :"systemd-resolve"=>980, :"systemd-timesync"=>979, :"systemd-coredump"=>978, :uuidd=>68, :avahi=>977, :c...
 
-LinuxStat::User.username_by_gid
+# File:		user.rb | Line: 187
+# Definition:	def username_by_gid(gid = get_gid)
+LinuxStat::User.username_by_gid(gid)
 => "sourav"
 
-LinuxStat::User.usernames_by_uid
+# File:		user.rb | Line: 169
+# Definition:	def usernames_by_uid(uid = get_uid)
+LinuxStat::User.usernames_by_uid(uid)
 => ["sourav"]
 
 ```
@@ -578,7 +939,115 @@ well as soon as the Linux kernel updates the data and ruby executes the loop.
 
 Just run the linuxstat.rb command to test what method takes what time measured in microseconds.
 
-## Note 2: Filesystem
+## Note 2: Count CPU
+
+There are confusingly 6 different methods to count the number of CPU. But they are here for a reason!
+
+Well this section actually demystifies the methods.
+
+1. The good old `LinuxStat::CPU.count()`:
+
+It gets the configured CPU for the system. It doesn't count for hotplugged CPU.
+If 3 out of 4 CPU are hotplugged out, it will still show 4. It calles `sysconf(_SC_NPROCESSORS_CONF)`
+
+2. The mysterious `LinuxStat::ProcessInfo.nproc(pid = $$)`:
+
+[ Also aliased to `LinuxStat::ProcessInfo.count_cpu()`  ]
+
+It returns the number of processors, like the other 3 methods.
+Without any arguments, it's like running `require 'etc' ; puts Etc.nprocessors`
+
+So there the caveat of checking what the number of processors are actually allocated to the pid.
+
+For example:
+
+```
+$ ruby -r linux_stat -e "puts LS::ProcessInfo.nproc"
+4
+
+$ taskset -c 0 ruby -r linux_stat -e "puts LS::ProcessInfo.nproc"
+1
+
+$ taskset -c 0-1 ruby -r linux_stat -e "puts LS::ProcessInfo.nproc"
+2
+
+$ taskset -c 0-1,3 ruby -r linux_stat -e "puts LS::ProcessInfo.nproc"
+3
+
+$ taskset -c 0-1,3 ruby -r linux_stat -e "puts LS::ProcessInfo.nproc "
+3
+```
+
+Or with argument:
+
+```
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::ProcessInfo.command_name 4775
+=> "electron"
+
+irb(main):003:0> LinuxStat::ProcessInfo.nproc 4775
+=> 4
+```
+
+3. The `LinuxStat::CPU.online()`:
+
+This returns the number of online CPU as an Array. It doesn't get affected by taskset or anything.
+
+For example:
+
+```
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::CPU.online
+=> [0, 1, 3]
+```
+
+By using `LinuxStat::CPU.online.count` you count the actual online CPU on your system.
+
+Any n number of CPU can get hotplugged in and out, and this will report that correctly.
+
+It just gets the info from /sys/devices/system/cpu/online, and parses the output.
+
+4. The `LinuxStat::CPU.offline()`:
+
+This returns the number of offline CPU as an Array. It doesn't get affected by taskset or anything.
+
+For example:
+
+```
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::CPU.offline
+=> [2]
+```
+
+Any n number of CPU can get hotplugged in and out, and this will report that correctly.
+
+It just gets the info from /sys/devices/system/cpu/offline, and parses the output.
+
+5. The `LinuxStat::Sysconf.processor_configured()`:
+
+Sounds repetitive! Actually yes, this is written in C, and it is called by `LinuxStat::CPU.count`.
+
+The difference is that `LinuxStat::CPU.count` caches the return value, and this method doesn't.
+
+6. The `LinuxStat::Sysconf.processor_online()`:
+
+This may again sound repititive to LinuxStat::CPU.online, but it's actually not!
+
+If you are using while loops, it might not report the correct number of CPU everytime.
+
+Worst, it can take a long time to update the total number of CPU.
+
+The benefit is, it's quite fast!
+
+It's mostly here just for the sake of completeness to sysconf.
+
+## Note 3: Filesystem
 
 Filesystem can take arguments. By default it's '/' or the root of the system...
 
@@ -613,7 +1082,7 @@ irb(main):005:0> LinuxStat::Filesystem.total(thumbdrive).fdiv(1024 ** 3).to_s <<
 => "29.305004119873047 GiB"
 ```
 
-## Note 3: ProcessInfo
+## Note 4: ProcessInfo
 
 All the methods LinuxStat::ProcessInfo can take an argument containing the Process ID of a process.
 By default it's $$ or the PID of the current process, ruby, itself.
@@ -665,7 +1134,7 @@ irb(main):002:0> LinuxStat::ProcessInfo.memory(LinuxStat::Process.names.find { |
 => "467.51 MiB"
 ```
 
-## Note 4: FS
+## Note 5: FS
 
 LinuxStat::FS module gives you the raw info in Hash collected from statvfs.
 
@@ -690,7 +1159,7 @@ irb(main):003:0> t = Time.now ; puts LinuxStat::FS.stat('/') ; Time.now - t
 
 To learn more about them, just run ri and the method name. To see all available methods.
 
-## Note 5: User
+## Note 6: User
 Most of the LinuxStat::User supports arguments.
 
 For example, to get a user's home by the username:
@@ -772,7 +1241,7 @@ irb(main):004:0> LinuxStat::User.get_login
 
 Right, the get_login() can return an empty string. But LinuxStat::User.get_user also aliased as LinuxStat::User.get_current_user shouldn't return an empty string under most circumstances.
 
-## Note 6: PrettifyBytes
+## Note 7: PrettifyBytes
 Often times we need to work with KB, MB GB, TB, or KiB, MiB, GiB, TiB, etc.
 And we need some work to convert bytes to those units.
 Because LinuxStat provides a lot of data in bytes, and kilobytes, it's quite tedious to convert them all the time.
@@ -912,6 +1381,16 @@ Issues regarding running LinuxStat on termux are also welcomed.
 
 ---
 
+## Cloning this Repo
+Users of this gem are requested to follow the above installation step to install this gem.
+
+This repo is only for development purpose. It has C extensions that could do worst to your stable app.
+Cloning, compiling code from this repo for a production app may seg fault and crash the whole app directly.
+
+Gems on Rubygems are released after various tests.
+
+So just install the gem, don't clone this repo just because the version is bumped here with new features, and the gem is not out on Rubygems.org.
+
 ## Development
 After checking out the repo, compile and install this gem onto your local machine with `bundle exec rake install`