linux_stat 1.0.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5db083b3617b6bd52399fefd54f9ffa6719ba324ab6eaa9b51227a8ef13ad362
-  data.tar.gz: f15d91899cddb4063c301657468f0eba934d2d811eb4f4b185d0046476af9c8a
+  metadata.gz: c84445d23c56692a85aa620d8529099e4466721d004218ae33c8ae28abdb0980
+  data.tar.gz: e69b74b0b906a8ed3c479c73056ffbf1a2c904deab896ea0fa99fccdc992af9d
 SHA512:
-  metadata.gz: adabc35b035a90560b430376287a4dd2cdd4d143c68af3cc312fbf7cae102a300c362c62ed81e82b1a739c5a63372015036a5760d5ac967ce689ebc09d37b81f
-  data.tar.gz: 6a37fcea1b5550d3a20e13d4f392aa4a1c0003b687a56d28467df03204e9e4c4c848bf4214f3491f4674d3fdccfbd610331547dbbb4680acd2b7ec75bc8dbf3a
+  metadata.gz: 1b54691d6ed08d6de27e8040149c61174755dc28be706289228800f399d3b71b73ddbdc13e68bd87be1f78370964e7fecb6c0ad2d764f7d9660fbcebc0318b0b
+  data.tar.gz: 91a45ff49fd6f633acc768fc23d03b6f10b0b47bb56db40a05568ad3ca43b29204fed27a233fc6da45bd3017ad4dc316a66488c71a3aaad78c7fc1a620f6c257

data/README.md

@@ -10,7 +10,7 @@ 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:
+Languages Used:
 
 <img src="https://linuxstatloc.herokuapp.com/badge.svg" width="260px">
 
@@ -37,6 +37,32 @@ On Debian based systems:
 
 ---
 
+## Optional Dependencies
+
+You need hwdata to decode vendor and product ids if you use LinuxStat::USB and/or LinuxStat::PCI
+
+You can install hwdata simply.
+
++ Arch:
+
+```
+sudo pacman -S hwids
+```
+
++ Debian based systems:
+
+```
+sudo apt install hwdata
+```
+
+But without hwdata, it won't show such information.
+
+You can also point to a downloaded copy of hwdata (pci.ids / usb.ids) file.
+
+Follow [Note 7](https://github.com/Souravgoswami/linux_stat#note-7-hwdata) below for more information on that.
+
+---
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -153,7 +179,7 @@ LinuxStat::Battery.technology()
 # File:		battery.rb | Line: 160
 # Definition:	def voltage_now
 LinuxStat::Battery.voltage_now()
-=> 12.453
+=> 12.625
 
 ```
 
@@ -177,7 +203,7 @@ LinuxStat::CPU.count_online()
 # File:		cpu.rb | Line: 197
 # Definition:	def cur_freq
 LinuxStat::CPU.cur_freq()
-=> {"cpu0"=>1971347, "cpu1"=>2000253, "cpu2"=>1916631, "cpu3"=>2000064}
+=> {"cpu0"=>1999999, "cpu1"=>2000045, "cpu2"=>2000144, "cpu3"=>2000034}
 
 # File:		cpu.rb | Line: 265
 # Definition:	def governor
@@ -212,29 +238,29 @@ LinuxStat::CPU.online()
 # File:		cpu.rb | Line: 23
 # Definition:	def stat(sleep = ticks_to_ms_t5)
 LinuxStat::CPU.stat(sleep)
-=> {0=>5.0, 1=>16.67, 2=>0.0, 3=>0.0, 4=>16.67}
+=> {0=>10.0, 1=>0.0, 2=>0.0, 3=>16.67, 4=>0.0}
 
 # File:		cpu.rb | Line: 63
 # Definition:	def total_usage(sleep = ticks_to_ms_t5)
 LinuxStat::CPU.total_usage(sleep)
-=> 5.26
+=> 19.05
 
 # File:		cpu.rb | Line: 63
 # Definition:	def total_usage(sleep = ticks_to_ms_t5)
 LinuxStat::CPU.usage(sleep)
-=> 9.52
+=> 5.26
 
 # File:		cpu.rb | Line: 23
 # Definition:	def stat(sleep = ticks_to_ms_t5)
 LinuxStat::CPU.usages(sleep)
-=> {0=>5.26, 1=>16.67, 2=>0.0, 3=>0.0, 4=>0.0}
+=> {0=>5.26, 1=>0.0, 2=>0.0, 3=>33.33, 4=>20.0}
 
 ```
 
 ### LinuxStat::FS
 ```
 LinuxStat::FS.stat(arg = "/")
-=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>11703573, :block_avail_unpriv=>11703573, :inodes=>58612160, :free_inodes=>56863418, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
+=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>10846968, :block_avail_unpriv=>10846968, :inodes=>58612160, :free_inodes=>56825184, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
 
 ```
 
@@ -243,22 +269,22 @@ LinuxStat::FS.stat(arg = "/")
 # File:		filesystem.rb | Line: 92
 # Definition:	def available(fs = ?..freeze)
 LinuxStat::Filesystem.available(fs)
-=> 47937835008
+=> 44429180928
 
 # File:		filesystem.rb | Line: 58
 # Definition:	def free(fs = ?..freeze)
 LinuxStat::Filesystem.free(fs)
-=> 47937835008
+=> 44429180928
 
 # File:		filesystem.rb | Line: 19
 # Definition:	def stat(fs = ?..freeze)
 LinuxStat::Filesystem.stat(fs)
-=> {:total=>119981191168, :free=>47937835008, :used=>72043356160}
+=> {:total=>119981191168, :free=>44429180928, :used=>75552010240}
 
 # File:		filesystem.rb | Line: 108
 # Definition:	def stat_raw(fs = ?..freeze)
 LinuxStat::Filesystem.stat_raw(fs)
-=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>11703573, :block_avail_unpriv=>11703573, :inodes=>58612160, :free_inodes=>56863418, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
+=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>10846968, :block_avail_unpriv=>10846968, :inodes=>58612160, :free_inodes=>56825184, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
 
 # File:		filesystem.rb | Line: 39
 # Definition:	def total(fs = ?..freeze)
@@ -268,7 +294,7 @@ LinuxStat::Filesystem.total(fs)
 # File:		filesystem.rb | Line: 73
 # Definition:	def used(fs = ?..freeze)
 LinuxStat::Filesystem.used(fs)
-=> 72043356160
+=> 75552010240
 
 ```
 
@@ -277,12 +303,12 @@ LinuxStat::Filesystem.used(fs)
 # File:		kernel.rb | Line: 86
 # Definition:	def build_date
 LinuxStat::Kernel.build_date()
-=> 2020-11-20 07:44:55 +0000
+=> 2020-12-24 18:28:16 +0000
 
 # File:		kernel.rb | Line: 140
 # Definition:	def build_date_string
 LinuxStat::Kernel.build_date_string()
-=> "20 Nov 2020 07:44:55 +0000"
+=> "24 Dec 2020 18:28:16 +0000"
 
 # File:		kernel.rb | Line: 21
 # Definition:	def build_user
@@ -307,12 +333,12 @@ LinuxStat::Kernel.compiler_version()
 # File:		kernel.rb | Line: 10
 # Definition:	def version
 LinuxStat::Kernel.release()
-=> "5.9.9-xanmod1-1"
+=> "5.10.2-xanmod1-cacule-1-cacule"
 
 # 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"
+=> "Linux version 5.10.2-xanmod1-cacule-1-cacule (souravgoswami@archlinux) (gcc (GCC) 10.2.0, GNU ld (GNU Binutils) 2.35.1) #1 SMP PREEMPT Thu, 24 Dec 2020 18:28:16 +0000"
 
 # File:		kernel.rb | Line: 179
 # Definition:	def ticks
@@ -322,7 +348,7 @@ LinuxStat::Kernel.ticks()
 # File:		kernel.rb | Line: 10
 # Definition:	def version
 LinuxStat::Kernel.version()
-=> "5.9.9-xanmod1-1"
+=> "5.10.2-xanmod1-cacule-1-cacule"
 
 ```
 
@@ -331,32 +357,32 @@ LinuxStat::Kernel.version()
 # File:		memory.rb | Line: 50
 # Definition:	def available
 LinuxStat::Memory.available()
-=> 1597312
+=> 375384
 
 # File:		memory.rb | Line: 81
 # Definition:	def percent_available
 LinuxStat::Memory.percent_available()
-=> 41.64
+=> 9.79
 
 # File:		memory.rb | Line: 70
 # Definition:	def percent_used
 LinuxStat::Memory.percent_used()
-=> 58.36
+=> 90.21
 
 # File:		memory.rb | Line: 11
 # Definition:	def stat
 LinuxStat::Memory.stat()
-=> {:total=>3836236, :used=>2238924, :available=>1597312, :percent_used=>58.36, :percent_available=>41.64}
+=> {:total=>3836036, :used=>3460652, :available=>375384, :percent_used=>90.21, :percent_available=>9.79}
 
 # File:		memory.rb | Line: 40
 # Definition:	def total
 LinuxStat::Memory.total()
-=> 3836236
+=> 3836036
 
 # File:		memory.rb | Line: 60
 # Definition:	def used
 LinuxStat::Memory.used()
-=> 2238924
+=> 3460652
 
 ```
 
@@ -365,7 +391,7 @@ LinuxStat::Memory.used()
 # File:		mounts.rb | Line: 179
 # Definition:	def device_stat(dev = root)
 LinuxStat::Mounts.device_stat(dev)
-=> {:mountpoint=>"/", :total=>119981191168, :free=>47937835008, :available=>47937835008, :used=>72043356160, :percent_used=>60.05, :percent_free=>39.95, :percent_available=>39.95}
+=> {:mountpoint=>"/", :total=>119981191168, :free=>44429180928, :available=>44429180928, :used=>75552010240, :percent_used=>62.97, :percent_free=>37.03, :percent_available=>37.03}
 
 # File:		mounts.rb | Line: 137
 # Definition:	def devices_stat
@@ -375,17 +401,17 @@ LinuxStat::Mounts.devices_stat()
 # 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", "...
+=> ["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=1909248k,nr_inodes=477312,mode=755,inode64 0 0", "run /run tmpfs rw,nosuid,nodev,relatime,mode=755...
 
 # 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", "tra...
+=> ["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", "hug...
 
 # 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/memory", "pstore"=>"...
+=> {"proc"=>"/proc", "sys"=>"/sys", "dev"=>"/dev", "run"=>"/run", "/dev/sda2"=>"/", "securityfs"=>"/sys/kernel/security", "tmpfs"=>"/run/user/0", "devpts"=>"/dev/pts", "cgroup2"=>"/sys/fs/cgroup/unified", "cgroup"=>"/sys/fs/cgroup/cpuset", "pstore"=>"/sy...
 
 # File:		mounts.rb | Line: 80
 # Definition:	def mount_point(dev = root)
@@ -410,85 +436,134 @@ LinuxStat::Mounts.root_mount_options()
 # 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...
+=> {"/dev/shm"=>"tmpfs /dev/shm tmpfs rw,nosuid,nodev,inode64 0 0", "/sys/fs/cgroup"=>"tmpfs /sys/fs/cgroup tmpfs ro,nosuid,nodev,noexec,size=4096k,nr_inodes=1024,mode=755,inode64 0 0", "/ramdisk"=>"tmpfs /ramdisk tmpfs rw,nosuid,nodev,relatime,size=6291...
 
 ```
 
 ### LinuxStat::Net
 ```
-# File:		net.rb | Line: 80
+# File:		net.rb | Line: 84
 # Definition:	def usage(interval = 0.1)
 LinuxStat::Net.current_usage(interval)
-=> {:received=>0.0, :transmitted=>0.0}
+=> {:received=>279000.0, :transmitted=>5640.0}
 
 # File:		net.rb | Line: 10
 # Definition:	def ipv4_private
 LinuxStat::Net.ipv4_private()
 => "192.168.0.102"
 
-# File:		net.rb | Line: 23
+# File:		net.rb | Line: 25
 # Definition:	def total_bytes
 LinuxStat::Net.total_bytes()
-=> {:received=>687677565, :transmitted=>149550163}
+=> {:received=>2093813713, :transmitted=>138899807}
 
-# File:		net.rb | Line: 41
+# File:		net.rb | Line: 43
 # Definition:	def total_bytes_received
 LinuxStat::Net.total_bytes_received()
-=> 687677565
+=> 2093813713
 
-# File:		net.rb | Line: 54
+# File:		net.rb | Line: 56
 # Definition:	def total_bytes_transmitted
 LinuxStat::Net.total_bytes_transmitted()
-=> 149550163
+=> 138899807
 
-# File:		net.rb | Line: 80
+# File:		net.rb | Line: 84
 # Definition:	def usage(interval = 0.1)
 LinuxStat::Net.usage(interval)
-=> {:received=>0.0, :transmitted=>0.0}
+=> {:received=>419320.0, :transmitted=>10340.0}
 
 ```
 
 ### LinuxStat::OS
 ```
-# File:		os.rb | Line: 97
+# File:		os.rb | Line: 127
 # Definition:	def bits
 LinuxStat::OS.bits()
 => 64
 
-# File:		os.rb | Line: 42
+# File:		os.rb | Line: 82
+# Definition:	def version
+LinuxStat::OS.distrib_version()
+=> "rolling"
+
+# File:		os.rb | Line: 44
 # Definition:	def distribution
 LinuxStat::OS.distribution()
 => "Arch Linux"
 
-# File:		os.rb | Line: 81
+# File:		os.rb | Line: 115
 # Definition:	def hostname
 LinuxStat::OS.hostname()
 => "archlinux"
 
-# File:		os.rb | Line: 30
+# File:		os.rb | Line: 33
 # Definition:	def lsb_release
 LinuxStat::OS.lsb_release()
 => {:LSB_VERSION=>"1.4", :DISTRIB_ID=>"Arch", :DISTRIB_RELEASE=>"rolling", :DISTRIB_DESCRIPTION=>"Arch Linux"}
 
-# File:		os.rb | Line: 64
+# File:		os.rb | Line: 98
 # Definition:	def machine
 LinuxStat::OS.machine()
 => "x86_64"
 
-# File:		os.rb | Line: 72
+# File:		os.rb | Line: 106
 # Definition:	def nodename
 LinuxStat::OS.nodename()
 => "archlinux"
 
-# File:		os.rb | Line: 15
+# File:		os.rb | Line: 17
 # 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/"...
 
-# File:		os.rb | Line: 110
+# File:		os.rb | Line: 142
 # Definition:	def uptime
 LinuxStat::OS.uptime()
-=> {:hour=>6, :minute=>50, :second=>39.61}
+=> {:hour=>14, :minute=>24, :second=>12.06}
+
+# File:		os.rb | Line: 82
+# Definition:	def version
+LinuxStat::OS.version()
+=> "rolling"
+
+```
+
+### LinuxStat::PCI
+```
+# File:		pci.rb | Line: 211
+# Definition:	def count
+LinuxStat::PCI.count()
+=> 13
+
+# File:		pci.rb | Line: 211
+# Definition:	def count
+LinuxStat::PCI.count_devices()
+=> 13
+
+# File:		pci.rb | Line: 52
+# Definition:	def devices_info(hwdata: true)
+LinuxStat::PCI.devices_info(hwdata:)
+=> [{:id=>"8086:1904", :vendor=>"8086", :device=>"1904", :irq=>0, :kernel_driver=>"skl_uncore", :hwdata=>{:vendor=>"Intel Corporation", :product=>"Xeon E3-1200 v5/E3-1500 v5/6th Gen Core Processor Host Bridge/DRAM Registers"}}, {:id=>"8086:1916", :vendor...
+
+# File:		pci.rb | Line: 128
+# Definition:	def devices_stat(hwdata: true)
+LinuxStat::PCI.devices_stat(hwdata:)
+=> [{:path=>"/sys/bus/pci/devices/0000:00:00.0/", :id=>"8086:1904", :vendor=>"8086", :device=>"1904", :sub_vendor=>"1028", :sub_device=>"077d", :kernel_driver=>"skl_uncore", :revision=>"0x08", :irq=>0, :enable=>false, :hwdata=>{:vendor=>"Intel Corporatio...
+
+# File:		pci.rb | Line: 259
+# Definition:	def hwdata_file
+LinuxStat::PCI.hwdata_file()
+=> "/usr/share/hwdata/pci.ids"
+
+# File:		pci.rb | Line: 248
+# Definition:	def hwdata_file_set?
+LinuxStat::PCI.hwdata_file_set?()
+=> true
+
+# File:		pci.rb | Line: 275
+# Definition:	def initialize_hwdata
+LinuxStat::PCI.initialize_hwdata()
+=> false
 
 ```
 
@@ -496,23 +571,23 @@ LinuxStat::OS.uptime()
 ```
 # File:		prettify_bytes.rb | Line: 42
 # Definition:	def convert_binary(n)
-LinuxStat::PrettifyBytes.convert_binary(n = 200152828322898)
-=> "182.04 tebibytes"
+LinuxStat::PrettifyBytes.convert_binary(n = 320846048510750)
+=> "291.81 tebibytes"
 
 # File:		prettify_bytes.rb | Line: 19
 # Definition:	def convert_decimal(n)
-LinuxStat::PrettifyBytes.convert_decimal(n = 434440373786022)
-=> "434.44 terabytes"
+LinuxStat::PrettifyBytes.convert_decimal(n = 996984130887475)
+=> "996.98 terabytes"
 
 # File:		prettify_bytes.rb | Line: 90
 # Definition:	def convert_short_binary(n)
-LinuxStat::PrettifyBytes.convert_short_binary(n = 88309228425306)
-=> "80.32 TiB"
+LinuxStat::PrettifyBytes.convert_short_binary(n = 396350966829319)
+=> "360.48 TiB"
 
 # File:		prettify_bytes.rb | Line: 65
 # Definition:	def convert_short_decimal(n)
-LinuxStat::PrettifyBytes.convert_short_decimal(n = 238518247519978)
-=> "238.52 TB"
+LinuxStat::PrettifyBytes.convert_short_decimal(n = 558910893490277)
+=> "558.91 TB"
 
 ```
 
@@ -521,37 +596,37 @@ LinuxStat::PrettifyBytes.convert_short_decimal(n = 238518247519978)
 # File:		process.rb | Line: 19
 # Definition:	def count
 LinuxStat::Process.count()
-=> 195
+=> 210
 
 # 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, 173, 175, 177, 180, 182, 186, 187, 188, 189, 190, 191, 193, 237, 273, 325, 329, 335, 9051, 9055, 9056, 9057, 9058, 9059, 9060, 13...
+=> [3, 4, 7, 9, 12, 23, 30, 37, 39, 45, 99, 100, 101, 104, 105, 106, 107, 108, 116, 117, 119, 122, 131, 134, 140, 164, 166, 169, 170, 173, 175, 180, 181, 182, 183, 184, 185, 186, 188, 231, 275, 315, 323, 333, 3142, 3143, 3144, 3145, 3146, 3147, 20004, 29...
 
 # 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,...
+=> [1, 2, 3, 4, 7, 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, 43, 44, 45, 46, 47, 48, 99, 100, 101, 104, 105, 106, 107, 108, 109, 113, 114, 116, 117, 119, 122, 131, 134, 140,...
 
 # 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...
+=> {1=>"systemd", 2=>"kthreadd", 3=>"rcu_gp", 4=>"rcu_par_gp", 7=>"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()
-=> [15978]
+=> [34967]
 
 # 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, 172, 174, 192, 222, 238, 310, 311, 312, 313, 315, 324, 327, 332, 333, 334, 336, 347, 349, 351, 384, 412,...
+=> [1, 2, 10, 11, 13, 14, 15, 16, 17, 18, 19, 20, 24, 25, 26, 27, 28, 31, 32, 33, 34, 35, 38, 40, 41, 42, 43, 44, 46, 47, 48, 109, 113, 114, 163, 165, 189, 218, 232, 271, 302, 314, 316, 319, 321, 322, 324, 325, 326, 327, 345, 348, 351, 376, 403, 405, 406...
 
 # 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...
+=> {1=>:sleeping, 2=>:sleeping, 3=>:idle, 4=>:idle, 7=>: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...
 
 # File:		process.rb | Line: 84
 # Definition:	def zombie
@@ -565,7 +640,7 @@ LinuxStat::Process.zombie()
 # File:		process_info.rb | Line: 54
 # Definition:	def cmdline(pid = $$)
 LinuxStat::ProcessInfo.cmdline(pid)
-=> "/usr/bin/ruby /home/sourav/.gem/ruby/2.7.0/bin/linuxstat.rb -md"
+=> "/usr/bin/ruby /home/sourav/.gem/ruby/2.7.0/bin/linuxstat.rb --markdown"
 
 # File:		process_info.rb | Line: 78
 # Definition:	def command_name(pid = $$)
@@ -600,12 +675,12 @@ LinuxStat::ProcessInfo.last_executed_cpu(pid)
 # File:		process_info.rb | Line: 114
 # Definition:	def mem_stat(pid = $$)
 LinuxStat::ProcessInfo.mem_stat(pid)
-=> {:memory=>12627.968, :virtual_memory=>84221.952, :resident_memory=>18743.296}
+=> {:memory=>26836.992, :virtual_memory=>97992.704, :resident_memory=>32841.728}
 
 # File:		process_info.rb | Line: 147
 # Definition:	def memory(pid = $$)
 LinuxStat::ProcessInfo.memory(pid)
-=> 12627.968
+=> 26836.992
 
 # File:		process_info.rb | Line: 607
 # Definition:	def nice(pid = $$)
@@ -625,22 +700,22 @@ LinuxStat::ProcessInfo.owner(pid)
 # File:		process_info.rb | Line: 197
 # Definition:	def resident_memory(pid = $$)
 LinuxStat::ProcessInfo.resident_memory(pid)
-=> 18743.296
+=> 32841.728
 
 # File:		process_info.rb | Line: 563
 # Definition:	def running_time(pid = $$)
 LinuxStat::ProcessInfo.running_time(pid)
-=> 0.8
+=> 1.04
 
 # File:		process_info.rb | Line: 544
 # Definition:	def start_time(pid = $$)
 LinuxStat::ProcessInfo.start_time(pid)
-=> 2020-12-24 19:05:51 +0530
+=> 2020-12-29 01:58:56 +0530
 
 # File:		process_info.rb | Line: 513
 # Definition:	def start_time_epoch(pid = $$)
 LinuxStat::ProcessInfo.start_time_epoch(pid)
-=> 1608816951
+=> 1609187336
 
 # File:		process_info.rb | Line: 592
 # Definition:	def state(pid = $$)
@@ -660,7 +735,7 @@ LinuxStat::ProcessInfo.threads(pid)
 # File:		process_info.rb | Line: 23
 # Definition:	def total_io(pid = $$)
 LinuxStat::ProcessInfo.total_io(pid)
-=> {:read_bytes=>0, :write_bytes=>0}
+=> {:read_bytes=>1249280, :write_bytes=>0}
 
 # File:		process_info.rb | Line: 446
 # Definition:	def uid(pid = $$)
@@ -670,7 +745,7 @@ LinuxStat::ProcessInfo.uid(pid)
 # File:		process_info.rb | Line: 172
 # Definition:	def virtual_memory(pid = $$)
 LinuxStat::ProcessInfo.virtual_memory(pid)
-=> 84221.952
+=> 97992.704
 
 ```
 
@@ -684,27 +759,27 @@ LinuxStat::Swap.any?()
 # File:		swap.rb | Line: 68
 # Definition:	def available
 LinuxStat::Swap.available()
-=> 4064380
+=> 2293908
 
 # File:		swap.rb | Line: 8
 # Definition:	def list
 LinuxStat::Swap.list()
-=> {"/dev/zram0"=>[:partition, 4194300, 129920, -2]}
+=> {"/dev/zram0"=>[:partition, 4194300, 1900392, -2]}
 
 # File:		swap.rb | Line: 103
 # Definition:	def percent_available
 LinuxStat::Swap.percent_available()
-=> 96.9
+=> 54.69
 
 # File:		swap.rb | Line: 89
 # Definition:	def percent_used
 LinuxStat::Swap.percent_used()
-=> 3.1
+=> 45.31
 
 # File:		swap.rb | Line: 32
 # Definition:	def stat
 LinuxStat::Swap.stat()
-=> {:total=>4194300, :used=>129920, :available=>4064380, :percent_used=>3.1, :percent_available=>96.9}
+=> {:total=>4194300, :used=>1900392, :available=>2293908, :percent_used=>45.31, :percent_available=>54.69}
 
 # File:		swap.rb | Line: 57
 # Definition:	def total
@@ -714,14 +789,14 @@ LinuxStat::Swap.total()
 # File:		swap.rb | Line: 80
 # Definition:	def used
 LinuxStat::Swap.used()
-=> 129920
+=> 1900392
 
 ```
 
 ### LinuxStat::Sysconf
 ```
 LinuxStat::Sysconf.child_max()
-=> nil
+=> 14915
 
 LinuxStat::Sysconf.expr_nest_max()
 => 32
@@ -741,6 +816,9 @@ LinuxStat::Sysconf.get_uid()
 LinuxStat::Sysconf.get_user()
 => "sourav"
 
+LinuxStat::Sysconf.hostname()
+=> "archlinux"
+
 LinuxStat::Sysconf.hostname_max()
 => 64
 
@@ -757,7 +835,7 @@ LinuxStat::Sysconf.pagesize()
 => 4096
 
 LinuxStat::Sysconf.posix_version()
-=> 4201
+=> 200809
 
 LinuxStat::Sysconf.processor_configured()
 => 4
@@ -778,20 +856,35 @@ LinuxStat::Sysconf.tty_name_max()
 
 ### LinuxStat::USB
 ```
-# File:		usb.rb | Line: 74
+# File:		usb.rb | Line: 135
 # Definition:	def count
 LinuxStat::USB.count()
 => 10
 
-# File:		usb.rb | Line: 74
+# File:		usb.rb | Line: 135
 # Definition:	def count
 LinuxStat::USB.count_devices()
 => 10
 
-# File:		usb.rb | Line: 4
+# File:		usb.rb | Line: 47
 # Definition:	def devices_stat(hwdata: true)
 LinuxStat::USB.devices_stat(hwdata:)
-=> [{:path=>"/sys/bus/usb/devices/1-1.2/", :id=>"04d9:1203", :vendor_id=>"04d9", :product_id=>"1203", :bus_num=>1, :dev_num=>4, :hwdata=>{:vendor=>"Holtek Semiconductor, Inc.", :product=>"Keyboard"}, :authorized=>true, :b_max_power=>"100mA", :b_max_packe...
+=> [{:path=>"/sys/bus/usb/devices/1-1.2/", :id=>"04d9:1203", :vendor_id=>"04d9", :product_id=>"1203", :bus_num=>1, :dev_num=>7, :hwdata=>{:vendor=>"Holtek Semiconductor, Inc.", :product=>"Keyboard"}, :authorized=>true, :b_max_power=>"100mA", :b_max_packe...
+
+# File:		usb.rb | Line: 175
+# Definition:	def hwdata_file
+LinuxStat::USB.hwdata_file()
+=> "/usr/share/hwdata/usb.ids"
+
+# File:		usb.rb | Line: 164
+# Definition:	def hwdata_file_set?
+LinuxStat::USB.hwdata_file_set?()
+=> true
+
+# File:		usb.rb | Line: 191
+# Definition:	def initialize_hwdata
+LinuxStat::USB.initialize_hwdata()
+=> false
 
 ```
 
@@ -804,13 +897,13 @@ LinuxStat::Uname.nodename()
 => "archlinux"
 
 LinuxStat::Uname.release()
-=> "5.9.9-xanmod1-1"
+=> "5.10.2-xanmod1-cacule-1-cacule"
 
 LinuxStat::Uname.sysname()
 => "Linux"
 
 LinuxStat::Uname.version()
-=> "#1 SMP PREEMPT Fri, 20 Nov 2020 07:44:55 +0000"
+=> "#1 SMP PREEMPT Thu, 24 Dec 2020 18:28:16 +0000"
 
 ```
 
@@ -983,11 +1076,11 @@ 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)`
+If 3 out of 4 CPU are hotplugged out, it will still show 4. It calls `sysconf(_SC_NPROCESSORS_CONF)`
 
 2. The mysterious `LinuxStat::ProcessInfo.nproc(pid = $$)`:
 
-[ Also aliased to `LinuxStat::ProcessInfo.count_cpu()`  ]
+[ 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`
@@ -1051,7 +1144,7 @@ and parse the output to get an array.
 It's a more robust method that counts the online CPU. It shouldn't fail in most if not all cases!
 But if it fails for some really spooky reasons, it will return nil.
 
-4. The `LinuxStat::CPU.offline()`:
+5. The `LinuxStat::CPU.offline()`:
 
 This returns the number of offline CPU as an Array. It doesn't get affected by taskset or anything.
 
@@ -1069,13 +1162,13 @@ Any n number of CPU can get hotplugged in and out, and this will report that cor
 
 It just gets the info from /sys/devices/system/cpu/offline, and parses the output.
 
-5. The `LinuxStat::Sysconf.processor_configured()`:
+6. 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()`:
+7. The `LinuxStat::Sysconf.processor_online()`:
 
 This may again sound repititive to LinuxStat::CPU.online, but it's actually not!
 
@@ -1281,7 +1374,72 @@ 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 7: PrettifyBytes
+## Note 7: Hwdata
+The PCI and USB modules actually rely on hwdata found in /usr/share/hwdata/.
+The LS::USB.devices_stat and LS::PCI.devices_stat returns the information in a Hash:
+
+```
+$ ruby -r linux_stat -e "puts LS::USB.devices_stat.to_s[0..200]"
+[{:path=>"/sys/bus/usb/devices/1-1.2/", :id=>"04d9:1203", :vendor_id=>"04d9", :product_id=>"1203", :bus_num=>1, :dev_num=>7, :hwdata=>{:vendor=>"Holtek Semiconductor, Inc.", :product=>"Keyboard"}, :aut
+```
+
+But if the files are not available, it won't return hwdata related information.
+
+So it's suggested to install hwdata. But you might face issues with heroku and
+other online PaaS where you can't install it. So Version 1.1.1+ comes with a module function called `hwdata_file = file`.
+
++ You can use any usb.ids or pci.ids files:
+
+```
+LS::PCI.hwdata_file = File.join(__dir__, 'hwdata', 'pci.ids')
+LS::USB.hwdata_file = File.join(__dir__, 'hwdata', 'usb.ids')
+```
+
+Assuming that you have `pci.ids` and `usb.ids` under ./hwdata directory.
+
+On rails, you can put this (replace `__dir__` with `Rails.root`) inside environment.rb.
+
+But do note that the file can be set only once. It's suggested to do that in the beginning of your app.
+
++ There's one method to check if the hwdata file was already set:
+
+```
+irb(main):001:0' require 'linux_stat'
+=> true
+
+irb(main):002:0> LS::USB.hwdata_file_set?
+=> false
+
+irb(main):003:0> LS::USB.devices_stat ; ''
+=> ""
+
+irb(main):004:0> LS::USB.hwdata_file_set?
+=> true
+```
+
+It works on USB and PCI modules.
+
+Once the file is set, calling `LS::PCI.hwdata_file = file` is futile.
+
++ Initializing hwdata can take 0.1 to 0.2 seconds at the first, so there's a method to initialize_hwdata at first:
+
+```
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LS::PCI.initialize_hwdata
+=> true
+
+irb(main):003:0> LS::PCI.initialize_hwdata
+=> false
+```
+
+It will return true if it worked, else it will return false. It's intended to be done once.
+
+If you don't initialize and call methods that utilizes hwdata, they will call it and the first
+call may take 0.1 to 0.2 seconds, the consecutive calls will then take under a millisecond.
+
+## Note 8: 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.