linux_stat 1.2.2 → 1.5.1

data/lib/linux_stat/mounts.rb

@@ -1,4 +1,6 @@
 module LinuxStat
+	# Shows various Mounted device related information of the current system.
+
 	module Mounts
 		class << self
 			##
@@ -209,17 +211,17 @@ module LinuxStat
 
 			private
 			def mount_readable?
-				@@mount_readable ||= File.readable?('/proc/mounts')
+				@@mount_readable ||= File.readable?('/proc/mounts'.freeze)
 			end
 
 			def mounts
 				return [] unless mount_readable?
-				IO.readlines('/proc/mounts').each(&:strip!)
+				IO.readlines('/proc/mounts'.freeze).each(&:strip!)
 			end
 
 			def find_root
 				return [] unless mount_readable?
-				@@root ||= IO.foreach('/proc/mounts').find { |x| x.split[1] == '/'.freeze }.split
+				@@root ||= IO.foreach('/proc/mounts'.freeze).find { |x| x.split[1] == '/'.freeze }.split
 			end
 
 			def fs_info(dev)

data/lib/linux_stat/net.rb

@@ -1,4 +1,6 @@
 module LinuxStat
+	# Shows various Net related information of the current system.
+
 	module Net
 		class << self
 			DEV = '/proc/net/dev'.freeze
@@ -86,13 +88,13 @@ module LinuxStat
 
 				data = IO.readlines(DEV).drop(2)
 				indices = find_index_of_bytes
-				data.reject! { |x| x.strip.start_with?('lo:') }
+				data.reject! { |x| x.strip.start_with?('lo:'.freeze) }
 				r, t = data.map { |x| x.split.values_at(*indices).map(&:to_i) }.transpose.map(&:sum)
 
 				sleep(interval)
 
 				data2 = IO.readlines(DEV).drop(2)
-				data2.reject! { |x| x.strip.start_with?('lo:') }
+				data2.reject! { |x| x.strip.start_with?('lo:'.freeze) }
 				r2, t2 = data2.map { |x| x.split.values_at(*indices).map(&:to_i) }.transpose.map(&:sum)
 
 				# Measure the difference
@@ -118,8 +120,8 @@ module LinuxStat
 
 					r.each_with_index { |x, i|
 						downcased = x.downcase
-						h.merge!(:r => i) if downcased.start_with?('receive')
-						h.merge!(:t => i) if downcased.start_with?('transmit')
+						h.merge!(:r => i) if downcased.start_with?('receive'.freeze)
+						h.merge!(:t => i) if downcased.start_with?('transmit'.freeze)
 					}
 
 					data_0 = data.next.gsub(?|.freeze, ' %'.freeze)

data/lib/linux_stat/os.rb

@@ -1,4 +1,6 @@
 module LinuxStat
+	# Shows various OS related information of the current system.
+
 	module OS
 		class << self
 			##
@@ -52,7 +54,7 @@ module LinuxStat
 					elsif v.key?(:DISTRIB_ID)
 						v[:DISTRIB_ID]
 					elsif File.readable?('/etc/issue'.freeze)
-						IO.read('/etc/issue'.freeze, encoding: 'ASCII-8bit').strip
+						IO.read('/etc/issue'.freeze, encoding: 'ASCII-8bit'.freeze).strip
 					else
 						'Unknown'.freeze
 					end
@@ -156,6 +158,40 @@ module LinuxStat
 				}.freeze
 			end
 
+			##
+			# Returns uptime of the system reported by LinuxStat::Sysinfo.uptime()
+			#    LinuxStat::OS.uptime_i
+			#
+			#    28956
+			#
+			# If the stat isn't available, nil is returned.
+			def uptime_i
+				LinuxStat::Sysinfo.uptime
+			end
+
+			##
+			# The first three fields in this file are load average
+              		# figures giving the number of jobs in the run queue (state R)
+			# or waiting for disk I/O (state D) averaged over 1, 5,
+			# and 15 minutes.  They are the same as the load average
+			# numbers given by uptime(1) and other programs.
+			# https://man7.org/linux/man-pages/man5/procfs.5.html
+			#
+			# The return type is an Hash containing the values
+			# that maps to 1, 5, and 15.
+			# This method calls LinuxStat::Sysinfo.loads() directly.
+			#
+			# However, if the info isn't available, it will return nil as values.
+			def loadavg
+				loads = LinuxStat::Sysinfo.loads
+
+				{
+					1 => loads[0],
+					5 => loads[1],
+					15 => loads[2]
+				}
+			end
+
 			alias distrib_version version
 
 			private

data/lib/linux_stat/pci.rb

@@ -1,4 +1,6 @@
 module LinuxStat
+	# Shows various PCI device related information of the current system.
+
 	module PCI
 		class << self
 			##

data/lib/linux_stat/prettify_bytes.rb

@@ -1,4 +1,11 @@
 module LinuxStat
+	# Helps you convert bytes to a unit like:
+	#
+	# 1. kilobyte, megabyte, gigabyte, terabyte, petabyte, exabyte, zettabyte, yottabyte
+	# 2. kibibyte, mebibyte, gibibyte, tebibyte, pebibyte, exbibyte, zebibyte, yobibyte
+	# 3. kB, MB, GB, TB, PB, EB, ZB, YB
+	# 4. kiB, MiB, GiB, TiB, PiB, EiB, ZiB, YiB
+
 	module PrettifyBytes
 		class << self
 			##
@@ -16,13 +23,13 @@ module LinuxStat
 			# LinuxStat::PrettifyBytes.convert_decimal(1024 ** 3)
 			#
 			# => "1.07 gigabytes"
-			def convert_decimal(n)
+			def convert_decimal(n, precision: 2)
 				@@d_units ||= %W(#{''} kilo mega giga tera peta exa zetta)
 					.map.with_index { |x, i| [x, 1000.**(i + 1)] }
 				unit = @@d_units.find { |x| n < x[1] } || ['yotta'.freeze, 10 ** 27]
 
 				converted = n.fdiv(unit[1] / 1000).round(2)
-				"#{pad_left(converted)} #{unit[0]}byte#{?s.freeze if converted != 1}"
+				"#{pad_left(converted, precision)} #{unit[0]}byte#{?s.freeze if converted != 1}"
 			end
 
 			# Converts a number to binary byte units and outputs with the IEC prefix
@@ -39,13 +46,13 @@ module LinuxStat
 			# LinuxStat::PrettifyBytes.convert_binary(1024 ** 3)
 			#
 			# => "1.0 gibibyte"
-			def convert_binary(n)
+			def convert_binary(n, precision: 2)
 				@@b_units ||= %W(#{''} kibi mebi gibi tebi pebi exbi zebi)
 					.map.with_index { |x, i| [x, 1024.**(i + 1)] }
 				unit = @@b_units.find { |x| n < x[1] } || ['yobi'.freeze, 10 ** 27]
 
 				converted = n.fdiv(unit[1] / 1024).round(2)
-				"#{pad_left(converted)} #{unit[0]}byte#{?s.freeze if converted != 1}"
+				"#{pad_left(converted, precision)} #{unit[0]}byte#{?s.freeze if converted != 1}"
 			end
 
 			# Converts a number to decimal byte units
@@ -62,13 +69,13 @@ module LinuxStat
 			# LinuxStat::PrettifyBytes.convert_short_decimal(1024 ** 3)
 			#
 			# => "1.07 GB"
-			def convert_short_decimal(n)
+			def convert_short_decimal(n, precision: 2)
 				@@sd_units ||= %W(#{''} k M G T P E Z)
 					.map.with_index { |x, i| [x, 1000.**(i + 1)] }
 				unit = @@sd_units.find { |x| n < x[1] } || [?Y.freeze, 10 ** 27]
 
 				converted = n.fdiv(unit[1] / 1000).round(2)
-				"#{pad_left(converted)} #{unit[0]}B"
+				"#{pad_left(converted, precision)} #{unit[0]}B"
 			end
 
 			##
@@ -87,15 +94,15 @@ module LinuxStat
 			# LinuxStat::PrettifyBytes.convert_short_binary(1024 ** 3)
 			#
 			# => "1.0 GiB"
-			def convert_short_binary(n)
-				return "#{n} B" if n < 1024
+			def convert_short_binary(n, precision: 2)
+				return "#{pad_left(n, precision)} B" if n < 1024
 
 				@@sb_units ||= %W(#{''} K M G T P E Z)
 					.map.with_index { |x, i| [x, 1024.**(i + 1)] }
 				unit = @@sb_units.find { |x| n < x[1] } || [?Y.freeze, 1024 ** 9]
 
 				converted = n.fdiv(unit[1] / 1024).round(2)
-				"#{pad_left(converted)} #{unit[0]}iB"
+				"#{pad_left(converted, precision)} #{unit[0]}iB"
 			end
 
 			private

data/lib/linux_stat/process.rb

@@ -1,4 +1,7 @@
 module LinuxStat
+	# Shows various information about a process that is either
+	# running, sleeping, idle or a zombie.
+
 	module Process
 		class << self
 			##
@@ -6,10 +9,17 @@ module LinuxStat
 			#
 			# The return type is an Array of Integers.
 			def list
-				Dir['/proc/*'].select { |x|
-					pid = File.split(x)[1]
-					pid.to_i.to_s == pid
-				}.map! { |x| File.split(x)[-1].to_i }
+				d = Dir['/proc/*'.freeze]
+				ret, i = [], -1
+				count = d.length
+
+				while(i += 1) < count
+					pid = File.split(d[i])[1]
+					pid_i = pid.to_i
+					ret << pid_i if pid_i.to_s == pid
+				end
+
+				ret
 			end
 
 			##
@@ -17,39 +27,82 @@ module LinuxStat
 			#
 			# The return type is Integer.
 			def count
-				list.count
+				list.length
 			end
 
 			##
-			# Returns all the id of processes mapped with their names as a Hash.
+			# Returns all the id of processes mapped with their executable names (comm) as a Hash.
+			# The names can be truncated to TASK_COMM_LEN or (16 - 1 = 15) places.
 			def names
-				list.reduce({}) { |h, x|
+				h, i = {}, -1
+
+				l = list
+				count = l.length
+
+				while(i += 1) < count
+					x = l[i]
+
 					begin
-						h.merge!( x => IO.foreach(File.join('/proc', x.to_s, 'status')).first.split[1] )
-					rescue Exception
-						h
+						h.merge!( x => IO.read("/proc/#{x}/comm").strip)
+					rescue StandardError
 					end
-				}
+				end
+				h
+			end
+
+			##
+			# Returns all the id of processes mapped with their cmdline info as a Hash.
+			# The cmdlines aren't usually truncated like names, but they can contain
+			# arguments with the command.
+			def cmdlines
+				h, i = {}, -1
+
+				l = list
+				count = l.length
+
+				while(i += 1) < count
+					x = l[i]
+
+					begin
+						cmdlines = IO.read("/proc/#{x}/cmdline").strip
+						cmdlines.gsub!(?\u0000.freeze, ?\s.freeze)
+						h.merge!( x => cmdlines)
+					rescue StandardError
+					end
+				end
+				h
 			end
 
 			##
 			# Returns all the id of processes mapped with their status as a Hash.
 			def types
-				list.reduce({}) { |h, x|
+				h, i = {}, -1
+
+				l = list
+				count = l.length
+
+				while(i += 1) < count
+					x = l[i]
+
 					begin
 						h.merge!(x =>
-							case IO.read(File.join('/proc', x.to_s, 'stat')).split[2]
+							case IO.read("/proc/#{x}/stat").split(/(\(.*\))/)[-1][/\s.+?/].strip
 								when ?S.freeze then :sleeping
 								when ?I.freeze then :idle
 								when ?Z.freeze then :zombie
 								when ?R.freeze then :running
+								when ?T.freeze then :stopped
+								when ?X.freeze then :dead
+								when ?D.freeze then :sleeping
+								when ?t.freeze then :stopped
 								else :unknown
 							end
 						)
-					rescue Exception
-						h
+					rescue StandardError
 					end
-				}
+				end
+
+				h
 			end
 
 			##
@@ -58,9 +111,9 @@ module LinuxStat
 			def sleeping
 				list.select { |x|
 					begin
-						IO.read(File.join('/proc', x.to_s, 'stat')).split[2] == ?S
-					rescue Exception
-						nil
+						IO.read("/proc/#{x}/stat").split(/(\(.*\))/)[-1][/\s.+?/].strip == ?S.freeze
+					rescue StandardError
+						false
 					end
 				}
 			end
@@ -71,9 +124,9 @@ module LinuxStat
 			def idle
 				list.select { |x|
 					begin
-						IO.read(File.join('/proc', x.to_s, 'stat')).split[2] == ?I
-					rescue Exception
-						nil
+						IO.read("/proc/#{x}/stat").split(/(\(.*\))/)[-1][/\s.+?/].strip == ?I.freeze
+					rescue StandardError
+						false
 					end
 				}
 			end
@@ -84,9 +137,9 @@ module LinuxStat
 			def zombie
 				list.select { |x|
 					begin
-						IO.read(File.join('/proc', x.to_s, 'stat')).split[2] == ?Z
-					rescue Exception
-						nil
+						IO.read("/proc/#{x}/stat").split(/(\(.*\))/)[-1][/\s.+?/].strip == ?Z.freeze
+					rescue StandardError
+						false
 					end
 				}
 			end
@@ -97,9 +150,23 @@ module LinuxStat
 			def running
 				list.select { |x|
 					begin
-						IO.read(File.join('/proc', x.to_s, 'stat')).split[2] == ?R
-					rescue Exception
-						nil
+						IO.read("/proc/#{x}/stat").split(/(\(.*\))/)[-1][/\s.+?/].strip == ?R.freeze
+					rescue StandardError
+						false
+					end
+				}
+			end
+
+			##
+			# Returns all the id of processes that are stopped.
+			# The return type is an Array of Integers.
+			def stopped
+				list.select { |x|
+					begin
+						v = IO.read("/proc/#{x}/stat").split(/(\(.*\))/)[-1][/\s.+?/].strip
+						v == ?T.freeze || v == ?t.freeze
+					rescue StandardError
+						false
 					end
 				}
 			end

data/lib/linux_stat/process_info.rb

@@ -1,4 +1,11 @@
 module LinuxStat
+	# Shows various information about a process that is either
+	# running, sleeping, idle or a zombie.
+	# Most methods can take a PID, but some uses polling to calculate
+	# something, they can accept options instead of arguments.
+	# Consult the documentation on the specific methods
+	# for more details on that.
+
 	module ProcessInfo
 		class << self
 			##
@@ -62,6 +69,8 @@ module LinuxStat
 
 			##
 			# = command_name(pid = $$)
+			# Not to be confused with process_name
+			# It just splits the cmdline to show the command name
 			#
 			# Where pid is the process ID.
 			#
@@ -77,12 +86,40 @@ module LinuxStat
 			# If the info isn't available it will return an empty frozen String.
 			def command_name(pid = $$)
 				# Do note that the /proc/ppid/comm may not contain the full name
-				file = "/proc/#{pid}/cmdline".freeze
-				return ''.freeze unless File.readable?(file)
+				# It's limited by TASK_COMM_LEN (16) characters
+				c = cmdline(pid).split[0]
+				return ''.freeze unless c
+				File.split(c)[-1]
+			end
 
-				_cmdline = IO.read(file)
-				_cmdline.gsub!(?\u0000, ?\s)
-				File.split(_cmdline.tap(&:strip!).split[0])[-1]
+			##
+			# = process_name(pid = $$)
+			# It shows the filename of the command
+			# Sometimes the filename is stripped
+			#
+			# Where pid is the process ID.
+			#
+			# By default it is the id of the current process ($$)
+			#
+			# It retuns the total command name of the process.
+			#
+			# The output is String. For example:
+			#    LinuxStat::ProcessInfo.process_name
+			#
+			#    "ruby"
+			#
+			# If the info isn't available it will return an empty frozen String.
+			def process_name(pid = $$)
+				file = "/proc/#{pid}/stat".freeze
+				return command_name unless File.readable?(file)
+
+				name = IO.read(file).split(/(\(.*\))/) &.[](1) &.[](1..-2)
+
+				if name && name.length > 0 && name.length < 15
+					name
+				else
+					command_name
+				end
 			end
 
 			##
@@ -249,8 +286,11 @@ module LinuxStat
 				ticks = get_ticks
 
 				return {} unless File.readable?(file)
-				utime, stime, starttime = IO.read(file)
-					.split.values_at(13, 14, 21).map(&:to_f)
+
+				stat = IO.read(file).split(/(\(.*\))/)[-1] &.split
+				return {} unless stat
+
+				utime, stime, starttime = *stat.values_at(11, 12, 19).map(&:to_f)
 
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
@@ -260,9 +300,12 @@ module LinuxStat
 				sleep(sleep)
 
 				return {} unless File.readable?(file)
-				stat = IO.read(file).split
 
-				utime2, stime2, starttime2 = stat.values_at(13, 14, 21).map(&:to_f)
+				stat = IO.read(file).split(/(\(.*\))/)[-1] &.split
+				return {} unless stat
+
+				utime2, stime2, starttime2 = *stat.values_at(11, 12, 19).map(&:to_f)
+
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
 				total_time2 = utime2 + stime2
@@ -273,8 +316,8 @@ module LinuxStat
 
 				{
 					cpu_usage: cpu_u > 100 ? 100.0 : cpu_u.round(2),
-					threads: stat[19].to_i,
-					last_executed_cpu: stat[38].to_i
+					threads: stat[17].to_i,
+					last_executed_cpu: stat[36].to_i
 				}
 			end
 
@@ -309,8 +352,11 @@ module LinuxStat
 				ticks = get_ticks
 
 				return nil unless File.readable?(file)
-				utime, stime, starttime = IO.read(file)
-					.split.values_at(13, 14, 21).map(&:to_f)
+
+				stat = IO.read(file).split(/(\(.*\))/)[-1] &.split
+				return nil unless stat
+
+				utime, stime, starttime = *stat.values_at(11, 12, 19).map(&:to_f)
 
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
@@ -320,9 +366,11 @@ 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)
 
+				stat = IO.read(file).split(/(\(.*\))/)[-1] &.split
+				return nil unless stat
+
+				utime2, stime2, starttime2 = *stat.values_at(11, 12, 19).map(&:to_f)
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
 				total_time2 = utime2 + stime2
@@ -361,8 +409,11 @@ module LinuxStat
 				ticks = get_ticks
 
 				return nil unless File.readable?(file)
-				utime, stime, starttime = IO.read(file)
-					.split.values_at(13, 14, 21).map(&:to_f)
+
+				stat = IO.read(file).split(/(\(.*\))/)[-1] &.split
+				return nil unless stat
+
+				utime, stime, starttime = *stat.values_at(11, 12, 19).map(&:to_f)
 
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
@@ -372,8 +423,11 @@ 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)
+
+				stat = IO.read(file).split(/(\(.*\))/)[-1] &.split
+				return nil unless stat
+
+				utime2, stime2, starttime2 = *stat.values_at(11, 12, 19).map(&:to_f)
 
 				uptime = IO.read('/proc/uptime'.freeze).to_f * ticks
 
@@ -409,7 +463,7 @@ module LinuxStat
 				file = "/proc/#{pid}/stat".freeze
 				return nil unless File.readable?(file)
 
-				data = IO.foreach(file, ' '.freeze).first(20)[-1]
+				data = IO.read(file).split(/(\(.*\))/)[-1] &.split &.at(17)
 				data ? data.to_i : nil
 			end
 
@@ -434,7 +488,8 @@ module LinuxStat
 				file = "/proc/#{pid}/stat".freeze
 				return nil unless File.readable?(file)
 
-				IO.read(file).split[38].to_i
+				data = IO.read(file).split(/(\(.*\))/)[-1] &.split &.at(36)
+				data ? data.to_i : nil
 			end
 
 			##
@@ -517,8 +572,11 @@ module LinuxStat
 				@@u_readable ||= File.readable?(uptime)
 				return nil unless @@u_readable && File.readable?(stat_file)
 
+				stat = IO.read(stat_file).split(/(\(.*\))/)[-1] &.split
+				return nil unless stat
+
 				u = IO.foreach(uptime, ' '.freeze).next.to_f
-				st = (IO.foreach(stat_file, ' '.freeze).first(22)[-1].to_f / get_ticks)
+				st = stat[19].to_f / get_ticks
 
 				# Getting two Time objects and dealing with floating point numbers
 				# Just to make sure the time goes monotonically
@@ -567,8 +625,11 @@ module LinuxStat
 				@@u_readable ||= File.readable?(uptime)
 				return nil unless @@u_readable && File.readable?(stat_file)
 
+				stat = IO.read(stat_file).split(/(\(.*\))/)[-1] &.split
+				return nil unless stat
+
 				IO.foreach(uptime, ' '.freeze).next.to_f
-					.-(IO.read(stat_file).split[21].to_f / get_ticks).round(2)
+					.-(stat[19].to_f / get_ticks).round(2)
 			end
 
 			##
@@ -592,7 +653,11 @@ module LinuxStat
 			def state(pid = $$)
 				file = "/proc/#{pid}/stat".freeze
 				return ''.freeze unless File.readable?(file)
-				IO.foreach(file, ' '.freeze).first(3)[-1].tap(&:rstrip!).freeze
+
+				stat = IO.read(file).split(/(\(.*\))/)[-1]
+				return '' unless stat
+
+				stat[/\s.+?/].strip
 			end
 
 			##
@@ -608,7 +673,10 @@ module LinuxStat
 				file = "/proc/#{pid}/stat"
 				return nil unless File.readable?(file)
 
-				IO.foreach(file, ' ').first(19)[-1].to_i
+				stat = IO.read(file).split(/(\(.*\))/)[-1] &.split
+				return nil unless stat
+
+				stat[16].to_i
 			end
 
 			##