linux_stat 1.0.3 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01f83a838dcd8dcb7e9a0777a68fbad83284103ddc12e8c1ef9a1358df7c4965
-  data.tar.gz: ba699f7a8bcb56469f44ab36e3a48888421dd23295287b56896f4c931c99a6e5
+  metadata.gz: 86307b8ccfb101dbd829b5fdf36d6c9bf4eaffb555e1387311f34f10d5cb748e
+  data.tar.gz: 5576fa510cffef8567df558cd096afe91ccb5afa536532f5625f04be19279ae6
 SHA512:
-  metadata.gz: 7350b44b72c7385eb552d029668577c4cda06f1130104437e0baaf853cd119c8eb27aac99e7070a7191110faef4f3ba85773bcadf646485f94856b7ff859564e
-  data.tar.gz: 5ae2a2344cdff502a559e4feefd028feb0194fbfe63197f0969a78c87328077dc033acedf78f99844c338082937b3d72270f44666528fec45ee06ca129265431
+  metadata.gz: c6960ddec53d610b61e44de4c7432f4e05fb00c7588629924fd34d17d711357c00867bd80c48497082332507879c6b7ad5472f0b66f188fab14d34d0d491d579
+  data.tar.gz: 1f31b0c48520ec826bc9b74fb48e5d752fb61aedab841911c2de92e9027861226ebafb03e210fea67667b5d1ab8b68a271f7859fe2ae2acd25b5f50efc9e2c7d

data/README.md

@@ -153,7 +153,7 @@ LinuxStat::Battery.technology()
 # File:		battery.rb | Line: 160
 # Definition:	def voltage_now
 LinuxStat::Battery.voltage_now()
-=> 12.453
+=> 12.541
 
 ```
 
@@ -177,7 +177,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"=>2000006, "cpu1"=>2000050, "cpu2"=>2000024, "cpu3"=>2000195}
 
 # File:		cpu.rb | Line: 265
 # Definition:	def governor
@@ -212,29 +212,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=>9.52, 1=>0.0, 2=>0.0, 3=>0.0, 4=>0.0}
 
 # File:		cpu.rb | Line: 63
 # Definition:	def total_usage(sleep = ticks_to_ms_t5)
 LinuxStat::CPU.total_usage(sleep)
-=> 5.26
+=> 0.0
 
 # File:		cpu.rb | Line: 63
 # Definition:	def total_usage(sleep = ticks_to_ms_t5)
 LinuxStat::CPU.usage(sleep)
-=> 9.52
+=> 14.29
 
 # 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.0, 1=>0.0, 2=>20.0, 3=>20.0, 4=>16.67}
 
 ```
 
 ### 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=>10607830, :block_avail_unpriv=>10607830, :inodes=>58612160, :free_inodes=>56826206, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
 
 ```
 
@@ -243,22 +243,22 @@ LinuxStat::FS.stat(arg = "/")
 # File:		filesystem.rb | Line: 92
 # Definition:	def available(fs = ?..freeze)
 LinuxStat::Filesystem.available(fs)
-=> 47937835008
+=> 43449671680
 
 # File:		filesystem.rb | Line: 58
 # Definition:	def free(fs = ?..freeze)
 LinuxStat::Filesystem.free(fs)
-=> 47937835008
+=> 43449671680
 
 # File:		filesystem.rb | Line: 19
 # Definition:	def stat(fs = ?..freeze)
 LinuxStat::Filesystem.stat(fs)
-=> {:total=>119981191168, :free=>47937835008, :used=>72043356160}
+=> {:total=>119981191168, :free=>43449671680, :used=>76531519488}
 
 # 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=>10607830, :block_avail_unpriv=>10607830, :inodes=>58612160, :free_inodes=>56826206, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
 
 # File:		filesystem.rb | Line: 39
 # Definition:	def total(fs = ?..freeze)
@@ -268,7 +268,7 @@ LinuxStat::Filesystem.total(fs)
 # File:		filesystem.rb | Line: 73
 # Definition:	def used(fs = ?..freeze)
 LinuxStat::Filesystem.used(fs)
-=> 72043356160
+=> 76531519488
 
 ```
 
@@ -277,12 +277,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 +307,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 +322,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 +331,32 @@ LinuxStat::Kernel.version()
 # File:		memory.rb | Line: 50
 # Definition:	def available
 LinuxStat::Memory.available()
-=> 1597312
+=> 1000240
 
 # File:		memory.rb | Line: 81
 # Definition:	def percent_available
 LinuxStat::Memory.percent_available()
-=> 41.64
+=> 26.07
 
 # File:		memory.rb | Line: 70
 # Definition:	def percent_used
 LinuxStat::Memory.percent_used()
-=> 58.36
+=> 73.93
 
 # 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=>2835796, :available=>1000240, :percent_used=>73.93, :percent_available=>26.07}
 
 # 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
+=> 2835796
 
 ```
 
@@ -365,7 +365,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=>43449671680, :available=>43449671680, :used=>76531519488, :percent_used=>63.79, :percent_free=>36.21, :percent_available=>36.21}
 
 # File:		mounts.rb | Line: 137
 # Definition:	def devices_stat
@@ -375,17 +375,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=1909256k,nr_inodes=477314,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", "mqu...
 
 # 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/1000", "devpts"=>"/dev/pts", "cgroup2"=>"/sys/fs/cgroup/unified", "cgroup"=>"/sys/fs/cgroup/pids", "pstore"=>"/s...
 
 # File:		mounts.rb | Line: 80
 # Definition:	def mount_point(dev = root)
@@ -410,13 +410,13 @@ 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", "/tmp"=>"tmpfs /tmp tmpfs rw,nosuid,nodev,relatime,size=4194304k,ino...
 
 ```
 
 ### 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}
@@ -426,22 +426,22 @@ LinuxStat::Net.current_usage(interval)
 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=>4509667469, :transmitted=>172614974}
 
-# File:		net.rb | Line: 41
+# File:		net.rb | Line: 43
 # Definition:	def total_bytes_received
 LinuxStat::Net.total_bytes_received()
-=> 687677565
+=> 4509667469
 
-# File:		net.rb | Line: 54
+# File:		net.rb | Line: 56
 # Definition:	def total_bytes_transmitted
 LinuxStat::Net.total_bytes_transmitted()
-=> 149550163
+=> 172614974
 
-# 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}
@@ -450,45 +450,69 @@ LinuxStat::Net.usage(interval)
 
 ### LinuxStat::OS
 ```
-# File:		os.rb | Line: 97
+# File:		os.rb | Line: 99
 # Definition:	def bits
 LinuxStat::OS.bits()
 => 64
 
-# File:		os.rb | Line: 42
+# File:		os.rb | Line: 44
 # Definition:	def distribution
 LinuxStat::OS.distribution()
 => "Arch Linux"
 
-# File:		os.rb | Line: 81
+# File:		os.rb | Line: 83
 # 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: 66
 # Definition:	def machine
 LinuxStat::OS.machine()
 => "x86_64"
 
-# File:		os.rb | Line: 72
+# File:		os.rb | Line: 74
 # 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: 114
 # Definition:	def uptime
 LinuxStat::OS.uptime()
-=> {:hour=>6, :minute=>50, :second=>39.61}
+=> {:hour=>8, :minute=>50, :second=>58.38}
+
+```
+
+### 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...
 
 ```
 
@@ -496,23 +520,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 = 339049244499630)
+=> "308.36 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 = 963970414034560)
+=> "963.97 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 = 954637976904599)
+=> "868.24 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 = 464855754781732)
+=> "464.86 TB"
 
 ```
 
@@ -521,37 +545,37 @@ LinuxStat::PrettifyBytes.convert_short_decimal(n = 238518247519978)
 # File:		process.rb | Line: 19
 # Definition:	def count
 LinuxStat::Process.count()
-=> 195
+=> 203
 
 # 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, 152, 153, 172, 174, 176, 177, 181, 185, 186, 187, 188, 189, 190, 212, 233, 282, 339, 341, 351, 3101, 3102, 3103, 3104, 3105, 3106, 20589, 20...
 
 # 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, 111, 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]
+=> [28, 23778, 24066]
 
 # 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, 21, 24, 25, 26, 27, 28, 31, 32, 33, 34, 35, 38, 40, 41, 42, 43, 44, 46, 47, 48, 111, 113, 114, 171, 173, 191, 221, 239, 309, 311, 314, 315, 316, 338, 340, 366, 367, 368, 369, 383, 386, 389, 404, 407, 411,...
 
 # 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
@@ -580,7 +604,7 @@ LinuxStat::ProcessInfo.count_cpu(pid)
 # 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=>3}
+=> {:cpu_usage=>0.0, :threads=>1, :last_executed_cpu=>2}
 
 # File:		process_info.rb | Line: 307
 # Definition:	def cpu_usage(pid: $$, sleep: ticks_to_ms_t5)
@@ -595,17 +619,17 @@ LinuxStat::ProcessInfo.gid(pid)
 # File:		process_info.rb | Line: 433
 # Definition:	def last_executed_cpu(pid = $$)
 LinuxStat::ProcessInfo.last_executed_cpu(pid)
-=> 3
+=> 2
 
 # 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=>27025.408, :virtual_memory=>98074.624, :resident_memory=>33210.368}
 
 # File:		process_info.rb | Line: 147
 # Definition:	def memory(pid = $$)
 LinuxStat::ProcessInfo.memory(pid)
-=> 12627.968
+=> 27025.408
 
 # File:		process_info.rb | Line: 607
 # Definition:	def nice(pid = $$)
@@ -625,22 +649,22 @@ LinuxStat::ProcessInfo.owner(pid)
 # File:		process_info.rb | Line: 197
 # Definition:	def resident_memory(pid = $$)
 LinuxStat::ProcessInfo.resident_memory(pid)
-=> 18743.296
+=> 33210.368
 
 # File:		process_info.rb | Line: 563
 # Definition:	def running_time(pid = $$)
 LinuxStat::ProcessInfo.running_time(pid)
-=> 0.8
+=> 1.05
 
 # 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-27 04:20:42 +0530
 
 # File:		process_info.rb | Line: 513
 # Definition:	def start_time_epoch(pid = $$)
 LinuxStat::ProcessInfo.start_time_epoch(pid)
-=> 1608816951
+=> 1609023042
 
 # File:		process_info.rb | Line: 592
 # Definition:	def state(pid = $$)
@@ -670,7 +694,7 @@ LinuxStat::ProcessInfo.uid(pid)
 # File:		process_info.rb | Line: 172
 # Definition:	def virtual_memory(pid = $$)
 LinuxStat::ProcessInfo.virtual_memory(pid)
-=> 84221.952
+=> 98213.888
 
 ```
 
@@ -684,27 +708,27 @@ LinuxStat::Swap.any?()
 # File:		swap.rb | Line: 68
 # Definition:	def available
 LinuxStat::Swap.available()
-=> 4064380
+=> 3759868
 
 # File:		swap.rb | Line: 8
 # Definition:	def list
 LinuxStat::Swap.list()
-=> {"/dev/zram0"=>[:partition, 4194300, 129920, -2]}
+=> {"/dev/zram0"=>[:partition, 4194300, 434432, -2]}
 
 # File:		swap.rb | Line: 103
 # Definition:	def percent_available
 LinuxStat::Swap.percent_available()
-=> 96.9
+=> 89.64
 
 # File:		swap.rb | Line: 89
 # Definition:	def percent_used
 LinuxStat::Swap.percent_used()
-=> 3.1
+=> 10.36
 
 # 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=>434432, :available=>3759868, :percent_used=>10.36, :percent_available=>89.64}
 
 # File:		swap.rb | Line: 57
 # Definition:	def total
@@ -714,14 +738,14 @@ LinuxStat::Swap.total()
 # File:		swap.rb | Line: 80
 # Definition:	def used
 LinuxStat::Swap.used()
-=> 129920
+=> 434432
 
 ```
 
 ### LinuxStat::Sysconf
 ```
 LinuxStat::Sysconf.child_max()
-=> nil
+=> 2000000
 
 LinuxStat::Sysconf.expr_nest_max()
 => 32
@@ -757,7 +781,7 @@ LinuxStat::Sysconf.pagesize()
 => 4096
 
 LinuxStat::Sysconf.posix_version()
-=> 4201
+=> 200809
 
 LinuxStat::Sysconf.processor_configured()
 => 4
@@ -778,17 +802,17 @@ LinuxStat::Sysconf.tty_name_max()
 
 ### LinuxStat::USB
 ```
-# File:		usb.rb | Line: 74
+# File:		usb.rb | Line: 135
 # Definition:	def count
 LinuxStat::USB.count()
-=> 10
+=> 11
 
-# File:		usb.rb | Line: 74
+# File:		usb.rb | Line: 135
 # Definition:	def count
 LinuxStat::USB.count_devices()
-=> 10
+=> 11
 
-# 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...
@@ -804,13 +828,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"
 
 ```
 

data/lib/linux_stat.rb

@@ -25,6 +25,7 @@ require "linux_stat/battery"
 require "linux_stat/bios"
 require "linux_stat/memory"
 require "linux_stat/net"
+require "linux_stat/pci"
 require "linux_stat/process"
 require "linux_stat/swap"
 require "linux_stat/usb"

data/lib/linux_stat/pci.rb

@@ -0,0 +1,311 @@
+module LinuxStat
+	module PCI
+		class << self
+			##
+			# = devices_info(hwdata: true)
+			#
+			# [ Not to be confused with devices_stat ]
+			#
+			# Take a look at system_stat for more results.
+			#
+			# Returns details about the devices found in /proc/bus/pci/devices file.
+			#
+			# The details doesn't contain a lot of details, it's short and opens just one file once.
+			#
+			# The return value is an Array of multiple Hashes. If there's no info available,
+			# it will rather return an empty Array.
+			#
+			# On Android Termux for example, it can not list the directories because they are
+			# not readable the the regular user.
+			#
+			# It can have information like:
+			#
+			# id, vendor, device, irq, and kernel_driver
+			#
+			# An example of the returned sample from a test machine is:
+			#    LinuxStat::PCI.devices_info
+			#
+			#    => [{: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"}}]
+			#
+			# Right, it's an Array of Hashes.
+			#
+			# It also takes one option. The hwdata, which is true by default.
+			#
+			# Information about usb devices is found inside /usr/share/hwdata/pci.ids
+			#
+			# The data contains the vendor and the product, the subvendor and the subproduct.
+			#
+			# If the option is enabled, it will try read /usr/share/hwdata/pci.ids
+			#
+			# But the file will be read only once. The consecutive calls to this method
+			# won't open the hwdata all the times.
+			#
+			# But if there's no hwdata, the Hash returned by this method will not contain
+			# hwdata key.
+			#
+			# The data is only populated if it's available. For example, if there's no
+			# manufacturer available for the product, the returned Hash will not contain the
+			# information about the manufacturer.
+			#
+			# Also note that if there's no info available or no PCI enabled devices, it will return an empty
+			# Hash.
+			def devices_info(hwdata: true)
+				@@proc_pci_readable ||= File.readable?('/proc/bus/pci/devices')
+				return {} unless @@proc_pci_readable
+
+				IO.readlines('/proc/bus/pci/devices'.freeze).map! { |dev|
+					x = dev.split
+
+					vendor = x[1][0..3]
+					device = x[1][4..-1]
+					irq = x[2].to_i(16)
+					kernel_driver = x[-1]
+
+					query = if hwdata
+						query_hwdata(vendor, device)
+					else
+						{}
+					end
+
+					ret = {
+						id: "#{vendor}:#{device}",
+						vendor: vendor, device: device,
+						irq: irq,
+						kernel_driver: kernel_driver
+					}
+
+					ret.merge!(hwdata: query) unless query.empty?
+
+					ret
+				}
+			end
+
+			##
+			# = devices_stat(hwdata: true)
+			#
+			# Returns details about the devices found in /sys/bus/pci/devices/
+			#
+			# The return value is an Array of multiple Hashes. If there's no info available,
+			# it will rather return an empty Array.
+			#
+			# On Android Termux for example, it can not list the directories because they are
+			# not readable the the regular user.
+			#
+			# It can have information like:
+			#
+			# path, id, vendor, device, subvendor, sub_device,
+			# kernel_driver, revision, irq, enable, hwdata.
+			#
+			# An example of the returned sample from a test machine is:
+			#    LinuxStat::PCI.devices_stat
+			#
+			#    => [{: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 Corporation", :product=>"Xeon E3-1200 v5/E3-1500 v5/6th Gen Core Processor Host Bridge/DRAM Registers", :sub_system=>nil}}]
+			#
+			# Right, it's an Array of Hashes.
+			#
+			# It also takes one option. The hwdata, which is true by default.
+			#
+			# Information about usb devices is found inside /usr/share/hwdata/pci.ids
+			#
+			# The data contains the vendor and the product, the subvendor and the subproduct.
+			#
+			# If the option is enabled, it will try read /usr/share/hwdata/pci.ids
+			#
+			# But the file will be read only once. The consecutive calls to this method
+			# won't open the hwdata all the times.
+			#
+			# But if there's no hwdata, the Hash returned by this method will not contain
+			# hwdata key.
+			#
+			# The data is only populated if it's available. For example, if there's no
+			# manufacturer available for the product, the returned Hash will not contain the
+			# information about the manufacturer.
+			#
+			# If there's no /sys/bus/pci/devices/, it will call LinuxStat::PCI.devices_info
+			#
+			# Also note that if there's no info available or no PCI enabled devices, it will return an empty
+			# Hash.
+			def devices_stat(hwdata: true)
+				@@sys_pci_readable ||= File.readable?('/sys/bus/pci/devices/')
+				return devices_info(hwdata: hwdata) unless @@sys_pci_readable
+
+				Dir['/sys/bus/pci/devices/*/'.freeze].sort!.map! { |x|
+					_vendor_file = File.join(x, 'vendor'.freeze)
+					next unless File.readable?(_vendor_file)
+					vendor = IO.read(_vendor_file).to_i(16).to_s(16)
+					prepend_0(vendor)
+
+					_device_file = File.join(x, 'device'.freeze)
+					next unless File.readable?(_device_file)
+					device = IO.read(_device_file).to_i(16).to_s(16)
+					prepend_0(device)
+
+					_sub_vendor_file = File.join(x, 'subsystem_vendor'.freeze)
+					sub_vendor = File.readable?(_sub_vendor_file) ? IO.read(_sub_vendor_file).to_i(16).to_s(16) : nil
+					prepend_0(sub_vendor) if sub_vendor
+
+					_sub_device_file = File.join(x, 'subsystem_device'.freeze)
+					sub_device = File.readable?(_sub_device_file) ? IO.read(_sub_device_file).to_i(16).to_s(16) : nil
+					prepend_0(sub_device) if sub_device
+
+					_uevent = File.join(x, 'uevent'.freeze)
+					uevent = File.readable?(_uevent) ? IO.foreach(_uevent) : nil
+
+					kernel_driver = if uevent
+						uevent.find { |_x|
+							_x.split(?=.freeze)[0].to_s.tap(&:strip!) == 'DRIVER'.freeze
+						} &.split(?=) &.[](1) &.tap(&:strip!)
+					else
+						nil
+					end
+
+					_revision_file = File.join(x, 'revision'.freeze)
+					revision = File.readable?(_revision_file) ? IO.read(_revision_file).tap(&:strip!) : ''.freeze
+
+					_irq_file = File.join(x, 'irq'.freeze)
+					irq = File.readable?(_irq_file) ? IO.read(_irq_file).to_i : nil
+
+					_enable_file = File.join(x, 'enable'.freeze)
+					enable = File.readable?(_enable_file) ? IO.read(_enable_file).to_i  == 1 : nil
+
+					query = if hwdata && sub_vendor && sub_device
+						query_hwdata(vendor, device, sub_vendor, sub_device)
+					elsif hwdata && sub_vendor
+						query_hwdata(vendor, device, sub_vendor)
+					elsif hwdata
+						query_hwdata(vendor, device)
+					else
+						{}
+					end
+
+					ret = {
+						path: x, id: "#{vendor}:#{device}",
+						vendor: vendor, device: device
+					}
+
+					ret.merge!(sub_vendor: sub_vendor) if sub_vendor
+					ret.merge!(sub_device: sub_device) if sub_device
+
+					ret.merge!(kernel_driver: kernel_driver) if kernel_driver
+					ret.merge!(revision: revision) unless revision.empty?
+					ret.merge!(irq: irq) if irq
+					ret.merge!(enable: enable) unless enable.nil?
+					ret.merge!(hwdata: query) unless query.empty?
+
+					ret
+				}
+			end
+
+			##
+			# Reads /proc/bus/pci/devices, counts and returns the total number of lines.
+			#
+			# But if the information isn't available, it will look into the contents of
+			# /sys/bus/pci/devices, and counts the total number of
+			# devices connected to the PCI.
+			# It checks for devices with vendor and device id files.
+			# If there's no such file, it will not count them as a PCI connected device.
+			#
+			# The return type is an integer.
+			#
+			# But if the information isn't available, it will return nil.
+			def count
+				@@proc_pci_readable ||= File.readable?('/proc/bus/pci/devices')
+				@@sys_pci_readable ||= File.readable?('/sys/bus/pci/devices/')
+
+				if @@proc_pci_readable
+					IO.readlines('/proc/bus/pci/devices'.freeze).length
+
+				elsif @@sys_pci_readable
+					Dir['/sys/bus/pci/devices/*/'.freeze].count { |x|
+						id_vendor_file = File.join(x, 'vendor'.freeze)
+						id_product_file = File.join(x, 'device'.freeze)
+						File.readable?(id_vendor_file) && File.readable?(id_product_file)
+					}
+
+				else
+					nil
+				end
+			end
+
+			alias count_devices count
+
+			private
+			def hwdata
+				@@hwdata_file ||= "/usr/share/hwdata/pci.ids"
+
+				@@hwdata ||= if File.readable?(@@hwdata_file)
+					ret, vendor_id, device_id, device = {}, nil, nil, nil
+					i = -1
+
+					file_data = IO.readlines(@@hwdata_file, encoding: 'ASCII-8BIT')
+					file_data_size = file_data.size
+
+					while (i += 1) < file_data_size
+						x = file_data[i]
+
+						_lstripped = x.lstrip
+						next if _lstripped[0] == ?#.freeze || _lstripped.empty?
+
+						if x[0..1] == "\t\t".freeze
+							next unless device_id
+
+							x.strip!
+							sub_device_id = x[/\A.*?\s/].to_s.strip
+							sub_device = x[device_id.length..-1].to_s.strip
+
+							if ret[vendor_id] &.at(1) &.[](device_id) &.[](1)
+								sub_system_id = sub_device[/\A.*?\s/].to_s.strip
+								sub_system_device = sub_device[sub_system_id.length..-1].to_s.strip
+
+								ret[vendor_id][1][device_id][1].merge!(sub_device_id => {sub_system_id => sub_system_device})
+							end
+
+						elsif x[0] == ?\t.freeze
+							next unless vendor_id
+
+							x.strip!
+							device_id = x[/\A.*?\s/].to_s.strip
+							device = x[device_id.length..-1].to_s.strip
+							ret[vendor_id][1][device_id] = [device, {}]
+
+						else
+							x.strip!
+							vendor_id = x[/\A.*?\s/].to_s.strip
+							vendor = x[vendor_id.length..-1].to_s.strip
+							ret[vendor_id] = [vendor, {}]
+						end
+					end
+
+					ret.freeze
+				else
+					{}
+				end
+			end
+
+			def prepend_0(n)
+				n[0, 0] = ?0.*(4 - n.length).freeze if n.length < 4
+				n
+			end
+
+			def query_hwdata(vendor_id, product_id, sub_vendor_id = nil, sub_device_id = nil)
+				vendor = hwdata[vendor_id]
+
+				if vendor
+					ret = {
+						vendor: vendor[0],
+						product: vendor.dig(1, product_id, 0),
+					}
+
+					if sub_vendor_id && sub_device_id
+						sub_product = vendor.dig(1, product_id, 1, sub_vendor_id, sub_device_id)
+						ret.merge!(sub_system: sub_product) if sub_product
+					end
+
+					ret
+ 				else
+					{}
+				end
+			end
+		end
+	end
+end

data/lib/linux_stat/usb.rb

@@ -14,13 +14,13 @@ module LinuxStat
 			#
 			# It can have information like:
 			#
-			# id, vendor id, product id, manufacturer, serial, bus number, dev number,
+			# path, id, vendor id, product id, manufacturer, serial, bus number, dev number,
 			# b_max_power, b_max_packet_size, etc.
 			#
 			# An example of the returned sample from a test machine is:
 			#    LinuxStat::USB.devices_stat
 			#
-			#    [{: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_packet_size0=>8}
+			#    => [{: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_packet_size0=>8}
 			#
 			# Right, it's an array of Hashes.
 			#
@@ -114,6 +114,8 @@ module LinuxStat
 
 					ret.merge!(b_max_power: b_max_power) unless b_max_power.empty?
 					ret.merge!(b_max_packet_size0: b_max_packet_size0) if b_max_packet_size0
+
+					ret
 				}.tap(&:compact!)
 			end
 
@@ -163,19 +165,19 @@ module LinuxStat
 						if x[0] == ?\t.freeze
 							next unless vendor_id
 
-							data = x.tap(&:strip!)
-							device_id = data[/\A.*?\s/].to_s.strip
-							device = data[device_id.length..-1].to_s.strip
+							x.strip!
+							device_id = x[/\A.*?\s/].to_s.strip
+							device = x[device_id.length..-1].to_s.strip
 							ret[vendor_id][1][device_id] = device
 						else
-							data = x
-							vendor_id = data[/\A.*?\s/].to_s.strip
-							vendor = data[vendor_id.length..-1].to_s.strip
+							x.strip!
+							vendor_id = x[/\A.*?\s/].to_s.strip
+							vendor = x[vendor_id.length..-1].to_s.strip
 							ret[vendor_id] = [vendor, {}]
 						end
 					end
 
-					ret
+					ret.freeze
 				else
 					{}
 				end

data/lib/linux_stat/version.rb

@@ -1,3 +1,3 @@
 module LinuxStat
-	VERSION ||= "1.0.3"
+	VERSION ||= "1.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: linux_stat
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.1.0
 platform: ruby
 authors:
 - Sourav Goswami
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-12-25 00:00:00.000000000 Z
+date: 2020-12-26 00:00:00.000000000 Z
 dependencies: []
 description: Linux only, efficient linux system utilization reporting and system monitoring
   gem
@@ -47,6 +47,7 @@ files:
 - lib/linux_stat/mounts.rb
 - lib/linux_stat/net.rb
 - lib/linux_stat/os.rb
+- lib/linux_stat/pci.rb
 - lib/linux_stat/prettify_bytes.rb
 - lib/linux_stat/process.rb
 - lib/linux_stat/process_info.rb