linux_stat 0.8.0 → 0.9.0

data/lib/linux_stat/filesystem.rb

@@ -2,7 +2,7 @@ module LinuxStat
 	module Filesystem
 		class << self
 			##
-			# = stat(fs = '/')
+			# = stat(fs = '.')
 			#
 			# Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive).
 			#
@@ -16,7 +16,7 @@ module LinuxStat
 			#    {:total=>119981191168, :free=>43155574784, :used=>76825616384, :available=>43155574784}
 			#
 			# If the stat can't be acquired, this method will return an empty Hash.
-			def stat(fs = ?/.freeze)
+			def stat(fs = ?..freeze)
 				s = stat_raw(fs)
 				return {} if s.empty?
 				s.default = 0
@@ -29,14 +29,14 @@ module LinuxStat
 			end
 
 			##
-			# = total(fs = '/')
+			# = total(fs = '.')
 			#
 			# Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive).
 			#
 			# It returns the total size of a given disk in bytes.
 			#
 			# If the stat can't be acquired, this method will return nil.
-			def total(fs = ?/.freeze)
+			def total(fs = ?..freeze)
 				s = stat_raw(fs)
 				return nil if s.empty?
 				s.default = 0
@@ -44,7 +44,7 @@ module LinuxStat
 			end
 
 			##
-			# = free(fs = '/')
+			# = free(fs = '.')
 			#
 			# Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive).
 			#
@@ -55,7 +55,7 @@ module LinuxStat
 			# Free returns the size of free blocks.
 			#
 			# If the stat can't be acquired, this method will return an empty Hash.
-			def free(fs = ?/.freeze)
+			def free(fs = ?..freeze)
 				s = stat_raw(fs)
 				return nil if s.empty?
 				s.default = 0
@@ -63,14 +63,14 @@ module LinuxStat
 			end
 
 			##
-			# = used(fs = '/')
+			# = used(fs = '.')
 			#
 			# Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive).
 			#
 			# It returns the used space of a given disk in bytes.
 			#
 			# If the stat can't be acquired, this method will return nil.
-			def used(fs = ?/.freeze)
+			def used(fs = ?..freeze)
 				s = stat_raw(fs)
 				return nil if s.empty?
 				s.default = 0
@@ -78,7 +78,7 @@ module LinuxStat
 			end
 
 			##
-			# = available(fs = '/')
+			# = available(fs = '.')
 			#
 			# Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive).
 			#
@@ -89,7 +89,7 @@ module LinuxStat
 			# Available returns the size of free blocks for unpriviledged users.
 			#
 			# If the stat can't be acquired, this method will return an empty Hash.
-			def available(fs = ?/.freeze)
+			def available(fs = ?..freeze)
 				s = stat_raw(fs)
 				return nil if s.empty?
 				s.default = 0
@@ -97,7 +97,7 @@ module LinuxStat
 			end
 
 			##
-			# = stat_raw(fs = '/')
+			# = stat_raw(fs = '.')
 			#
 			# Where fs is the directory of the file system (like / or /tmp/ or /run/media/thumbdrive).
 			#
@@ -105,7 +105,7 @@ module LinuxStat
 			#    {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>10535967, :block_avail_unpriv=>10535967, :inodes=>58612160, :free_inodes=>56718550, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
 			#
 			# If the stat can't be acquired, this method will return an empty Hash.
-			def stat_raw(fs = ?/.freeze)
+			def stat_raw(fs = ?..freeze)
 				LinuxStat::FS.stat(fs)
 			end
 		end

data/lib/linux_stat/kernel.rb

@@ -185,7 +185,7 @@ module LinuxStat
 
 			private
 			def splitted
-				@@string_splitted ||= string.split
+				@@string_splitted ||= string.split.freeze
 			end
 		end
 	end

data/lib/linux_stat/os.rb

@@ -121,7 +121,7 @@ module LinuxStat
 					hour: h,
 					minute: m,
 					second: s
-				}
+				}.freeze
 			end
 
 			private
@@ -143,7 +143,7 @@ module LinuxStat
 			end
 
 			def uptime_readable?
-				@@uptime_readable = File.readable?('/proc/uptime')
+				@@uptime_readable ||= File.readable?('/proc/uptime')
 			end
 		end
 	end

data/lib/linux_stat/process.rb

@@ -6,7 +6,7 @@ module LinuxStat
 			#
 			# The return type is an Array of Integers.
 			def list
-				Dir['/proc/*'].select! { |x|
+				Dir['/proc/*'].select { |x|
 					pid = File.split(x)[1]
 					pid.to_i.to_s == pid
 				}.map! { |x| File.split(x)[-1].to_i }

data/lib/linux_stat/process_info.rb

@@ -246,18 +246,20 @@ module LinuxStat
 			# The :last_executed_cpu also returns an Integer indicating the last executed cpu of the process.
 			def cpu_stat(pid: $$, sleep: ticks_to_ms_t5)
 				file = "/proc/#{pid}/stat"
-				return {} unless File.readable?(file)
-
 				ticks = get_ticks
 
+				return {} unless File.readable?(file)
 				utime, stime, starttime = IO.read(file)
 					.split.values_at(13, 14, 21).map(&:to_f)
+
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
 				total_time = utime + stime
 				idle1 = uptime - starttime - total_time
 
 				sleep(sleep)
+
+				return {} unless File.readable?(file)
 				stat = IO.read(file).split
 
 				utime2, stime2, starttime2 = stat.values_at(13, 14, 21).map(&:to_f)
@@ -267,10 +269,10 @@ module LinuxStat
 				idle2 = uptime - starttime2 - total_time2
 
 				totald = idle2.+(total_time2).-(idle1 + total_time)
-				cpu = totald.-(idle2 - idle1).fdiv(totald).*(100).round(2).abs./(LinuxStat::CPU.count)
+				cpu_u = totald.-(idle2 - idle1).fdiv(totald).abs.*(100)./(cpu_count)
 
 				{
-					cpu_usage: cpu,
+					cpu_usage: cpu_u > 100 ? 100.0 : cpu_u.round(2),
 					threads: stat[19].to_i,
 					last_executed_cpu: stat[38].to_i
 				}
@@ -293,6 +295,10 @@ module LinuxStat
 			#
 			#    => 10.0
 			#
+			# 10.0 means it's using 10% of the total processing power of the system.
+			#
+			# The value is divided with the configured number of CPU and not online CPU.
+			#
 			# A value of 100.0 indicates it is using 100% processing power available to the system.
 			#
 			# But if the info isn't available, it will return nil.
@@ -300,12 +306,12 @@ module LinuxStat
 			# This method is more efficient than running LinuxStat::ProcessInfo.cpu_stat()
 			def cpu_usage(pid: $$, sleep: ticks_to_ms_t5)
 				file = "/proc/#{pid}/stat"
-				return nil unless File.readable?(file)
-
 				ticks = get_ticks
 
+				return nil unless File.readable?(file)
 				utime, stime, starttime = IO.read(file)
 					.split.values_at(13, 14, 21).map(&:to_f)
+
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
 				total_time = utime + stime
@@ -313,15 +319,19 @@ module LinuxStat
 
 				sleep(sleep)
 
+				return nil unless File.readable?(file)
 				utime2, stime2, starttime2 = IO.read(file)
 					.split.values_at(13, 14, 21).map(&:to_f)
+
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
 				total_time2 = utime2 + stime2
 				idle2 = uptime - starttime2 - total_time2
 
 				totald = idle2.+(total_time2).-(idle1 + total_time)
-				totald.-(idle2 - idle1).fdiv(totald).*(100).round(2).abs./(LinuxStat::CPU.count)
+
+				u = totald.-(idle2 - idle1).fdiv(totald).abs.*(100)./(cpu_count)
+				u > 100 ? 100.0 : u.round(2)
 			end
 
 			##
@@ -348,12 +358,12 @@ module LinuxStat
 			# But if the info isn't available, it will return nil.
 			def thread_usage(pid: $$, sleep: ticks_to_ms_t5)
 				file = "/proc/#{pid}/stat"
-				return nil unless File.readable?(file)
-
 				ticks = get_ticks
 
+				return nil unless File.readable?(file)
 				utime, stime, starttime = IO.read(file)
 					.split.values_at(13, 14, 21).map(&:to_f)
+
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
 				total_time = utime + stime
@@ -361,15 +371,21 @@ module LinuxStat
 
 				sleep(sleep)
 
+				return nil unless File.readable?(file)
 				utime2, stime2, starttime2 = IO.read(file)
 					.split.values_at(13, 14, 21).map(&:to_f)
+
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
 				total_time2 = utime2 + stime2
 				idle2 = uptime - starttime2 - total_time2
 
 				totald = idle2.+(total_time2).-(idle1 + total_time)
-				totald.-(idle2 - idle1).fdiv(totald).*(100).round(2).abs
+
+				u = totald.-(idle2 - idle1).fdiv(totald).abs.*(100)
+
+				cpu_count_t100 = cpu_count * 100
+				u > cpu_count_t100 ? cpu_count_t100 : u.round(2)
 			end
 
 			##
@@ -539,7 +555,9 @@ module LinuxStat
 			# For example:
 			#    LinuxStat::ProcessInfo.running_time 14183
 			#
-			#    => 1947.619999999999
+			#    => 1947.61
+			#
+			# It always rounds the float number upto 2 decimal places
 			#
 			# If the info isn't available or the argument passed doesn't exist as a process ID, it will return nil.
 			def running_time(pid = $$)
@@ -549,7 +567,8 @@ module LinuxStat
 				@@u_readable ||= File.readable?(uptime)
 				return nil unless @@u_readable && File.readable?(stat_file)
 
-				IO.foreach(uptime, ' '.freeze).next.to_f - (IO.read(stat_file).split[21].to_i / get_ticks)
+				IO.foreach(uptime, ' '.freeze).next.to_f
+					.-(IO.read(stat_file).split[21].to_f / get_ticks).round(2)
 			end
 
 			##
@@ -592,6 +611,38 @@ module LinuxStat
 				IO.foreach(file, ' ').first(19)[-1].to_i
 			end
 
+			##
+			# = nproc(pid = $$)
+			# Returns the cpu allocated to the process.
+			#
+			# The output value is an Integer.
+			#
+			# For example:
+			#    $ taskset -c 0 irb
+			#
+			#    irb(main):001:0> require 'linux_stat'
+			#
+			#    => true
+			#
+			#    irb(main):002:0> LinuxStat::ProcessInfo.nproc
+			#
+			#    => 1
+			#
+			#    irb(main):003:0> LinuxStat::ProcessInfo.nproc 11562
+			#
+			#    => 3
+			#
+			#    irb(main):004:0> LinuxStat::ProcessInfo.nproc 12513
+			#
+			#    => 4
+			#
+			# If the info isn't available or the argument passed doesn't exist as a process ID, it will return nil.
+			def nproc(pid = $$)
+				LinuxStat::Nproc.count_cpu_for_pid(pid)
+			end
+
+			alias count_cpu nproc
+
 			private
 			def get_ticks
 				@@ticks ||= Sysconf.sc_clk_tck
@@ -607,6 +658,10 @@ module LinuxStat
 			def pagesize
 				@@pagesize ||= LinuxStat::Sysconf.pagesize
 			end
+
+			def cpu_count
+				@@nprocessors_conf ||= LinuxStat::CPU.count
+			end
 		end
 	end
 end

data/lib/linux_stat/swap.rb

@@ -117,7 +117,7 @@ module LinuxStat
 				val = IO.readlines('/proc/swaps').drop(1)
 				return [[], []] if val.empty?
 
-				val.map { |x|
+				val.map! { |x|
 					x.strip.split.values_at(2, 3).map!(&:to_i)
 				}.transpose
 			end

data/lib/linux_stat/version.rb

@@ -1,3 +1,3 @@
 module LinuxStat
-	VERSION ||= "0.8.0"
+	VERSION ||= "0.9.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: linux_stat
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Sourav Goswami
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-12-18 00:00:00.000000000 Z
+date: 2020-12-21 00:00:00.000000000 Z
 dependencies: []
 description: Linux only, efficient linux system utilization reporting and system monitoring
   gem
@@ -20,6 +20,7 @@ extensions:
 - ext/fs_stat/extconf.rb
 - ext/sysconf/extconf.rb
 - ext/utsname/extconf.rb
+- ext/nproc/extconf.rb
 extra_rdoc_files:
 - README.md
 files:
@@ -30,6 +31,8 @@ files:
 - exe/linuxstat.rb
 - ext/fs_stat/extconf.rb
 - ext/fs_stat/fs_stat.c
+- ext/nproc/extconf.rb
+- ext/nproc/nproc.c
 - ext/sysconf/extconf.rb
 - ext/sysconf/sysconf.c
 - ext/utsname/extconf.rb