linux_stat 0.4.2 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62a54b165b53e0fe6fddad20ab6b39b8a0d57e1a02186f995fcf0341cc69aae0
-  data.tar.gz: 8bc58cc3c8b72e117892cd8f987c924337d2ab10995d14b3fb7735064e4b3685
+  metadata.gz: 349ddabe649c7cdec58e01537c6c28ab47f9d30b413208baf5fae4c0c7a26804
+  data.tar.gz: e66ba391b2264c53f6d2619ee64d8907e5435079b29bcc76bf2d54516ea82949
 SHA512:
-  metadata.gz: a5490c31315132793840e3e849996f0545b08b3b416eadef3ba6979dcbad89d31329b69dad403295f8cc7e17a677f6d8df032c42706162b251b6ed921a3d11e4
-  data.tar.gz: 0100faa162b904042e8143b8dec85b45a3cb82543c693514049df17834890b12034cb1561d8c69ba606e9ebc81fba1550b255ad6d17d70a552011eb9aaf5300f
+  metadata.gz: 1f7274982f6330ed5023b6e7adf33f325163e382c9fdc81be8181c65ad182ba1e77433af792e1167d603673af147ff7e0601a42975f25ac2393206db755a27f5
+  data.tar.gz: 61d48ba5bcf4598d8df63173bfbecfe4fd6a91552f32195a540e344961ee4e2ebcb9decf492d092b41ca034908b82948b9e6d727e678e3b41f434c5771794070

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Sourav Goswami
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -288,7 +288,7 @@ LinuxStat::Process.zombie
 ### LinuxStat::ProcessInfo
 ```
 LinuxStat::ProcessInfo.cmdline
-=> "ruby bin/linuxstat.rb -md"
+=> "ruby exe/linuxstat.rb -md"
 
 LinuxStat::ProcessInfo.command_name
 => "ruby"
@@ -399,6 +399,59 @@ LinuxStat::Uname.version
 => "#1 SMP PREEMPT Wed, 21 Oct 2020 01:11:20 +0000"
 
 ```
+
+### LinuxStat::User
+```
+LinuxStat::User.get_euid
+=> 1000
+
+LinuxStat::User.get_gid
+=> 1000
+
+LinuxStat::User.get_uid
+=> 1000
+
+LinuxStat::User.get_user
+=> "sourav"
+
+LinuxStat::User.gid_by_username
+=> 1000
+
+LinuxStat::User.gids
+=> {:root=>0, :bin=>1, :daemon=>2, :mail=>12, :ftp=>11, :http=>33, :nobody=>65534, :dbus=>81, :"systemd-journal-remote"=>982, :"systemd-network"=>981, :"systemd-resolve"=>980, :"systemd-timesync"=>979, :"systemd-coredump"=>978, :uuidd=>68, :avahi=>977, :...
+
+LinuxStat::User.home_by_gid
+=> "/home/sourav"
+
+LinuxStat::User.home_by_username
+=> "/home/sourav"
+
+LinuxStat::User.home_directories
+=> {:root=>"/root", :bin=>"/", :daemon=>"/", :mail=>"/var/spool/mail", :ftp=>"/srv/ftp", :http=>"/srv/http", :nobody=>"/", :dbus=>"/", :"systemd-journal-remote"=>"/", :"systemd-network"=>"/", :"systemd-resolve"=>"/", :"systemd-timesync"=>"/", :"systemd-c...
+
+LinuxStat::User.homes_by_uid
+=> ["/home/sourav"]
+
+LinuxStat::User.ids
+=> {:root=>{:uid=>0, :gid=>0}, :bin=>{:uid=>1, :gid=>1}, :daemon=>{:uid=>2, :gid=>2}, :mail=>{:uid=>8, :gid=>12}, :ftp=>{:uid=>14, :gid=>11}, :http=>{:uid=>33, :gid=>33}, :nobody=>{:uid=>65534, :gid=>65534}, :dbus=>{:uid=>81, :gid=>81}, :"systemd-journal...
+
+LinuxStat::User.list
+=> ["root", "bin", "daemon", "mail", "ftp", "http", "nobody", "dbus", "systemd-journal-remote", "systemd-network", "systemd-resolve", "systemd-timesync", "systemd-coredump", "uuidd", "avahi", "colord", "git", "lxdm", "polkitd", "rtkit", "usbmux", "sourav...
+
+LinuxStat::User.uid_by_username
+=> 1000
+
+LinuxStat::User.uids
+=> {:root=>0, :bin=>1, :daemon=>2, :mail=>8, :ftp=>14, :http=>33, :nobody=>65534, :dbus=>81, :"systemd-journal-remote"=>982, :"systemd-network"=>981, :"systemd-resolve"=>980, :"systemd-timesync"=>979, :"systemd-coredump"=>978, :uuidd=>68, :avahi=>977, :c...
+
+LinuxStat::User.username_by_gid
+=> "sourav"
+
+LinuxStat::User.usernames_by_uid
+=> ["sourav"]
+
+```
+
 ---
 
 ## Note 1: Filesystem
@@ -513,6 +566,71 @@ irb(main):003:0> t = Time.now ; puts LinuxStat::FS.stat('/') ; Time.now - t
 
 To learn more about them, just run ri and the method name. To see all available methods:
 
+## Note 4: User
+Most of the LinuxStat::User supports arguments.
+
+For example, to get a user's home by the username:
+
+```
+$ irb
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::User.home_by_username('root')
+=> "/root"
+
+irb(main):003:0> LinuxStat::User.home_by_username('ftp')
+=> "/srv/ftp"
+
+irb(main):004:0> LinuxStat::User.home_by_username('mail')
+=> "/var/spool/mail"
+```
+
+Or to get the user's home by the GID/UID:
+
+```
+$ irb
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::User.homes_by_uid(1001)
+=> ["/home/userx", "/home/userz"]
+
+irb(main):003:0> LinuxStat::User.homes_by_uid(1000)
+=> ["/home/sourav"]
+
+irb(main):004:0> LinuxStat::User.home_by_gid(1001)
+=> "/home/userx"
+
+irb(main):005:0> LinuxStat::User.home_by_gid(1000)
+=> "/home/sourav"
+
+irb(main):006:0> LinuxStat::User.home_by_gid(0)
+=> "/root"
+```
+
+Or to get the UID/GID by username:
+
+```
+$ irb 
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::User.uid_by_username('root')
+=> 0
+
+irb(main):003:0> LinuxStat::User.uid_by_username('ftp')
+=> 14
+
+irb(main):004:0> LinuxStat::User.gid_by_username('ftp')
+=> 11
+
+irb(main):005:0> LinuxStat::User.gid_by_username('InvalidUser')
+=> nil
+```
+
+Read the ri documentation for more info.
+
 ---
 
 ## Return Types
@@ -558,31 +676,37 @@ Issues regarding running LinuxStat on termux are also welcomed.
 ---
 
 ## Development
+After checking out the repo, compile and install this gem onto your local machine with `bundle exec rake install`
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To test all modules, run `rake install` and then `exe/linuxstat.rb`. Also check "Testing" below.
 
 ---
 
 ## Testing
-Like other gems, this doesn't have a test like RSpec. We suggest using the bin/linuxstat.rb file on various systems.
+Like other gems, this doesn't have a test like RSpec.
+
+We suggest using the exe/linuxstat.rb file on various Linux systems to test.
+
+First you need to execute `bundle exec rake install` to compile and install this gem.
+
 If you need to test a specific module, say the CPU, just run it like this:
 
 ```
-$ ruby bin/linuxstat.rb CPU
+$ ruby exe/linuxstat.rb CPU
 ```
 
 Or:
 ```
-$ ruby bin/linuxstat.rb cpu
+$ ruby exe/linuxstat.rb cpu
 ```
 
 That is, the argument passed is not case-sensitive.
 But if the argument passed isn't available and outright wrong, it will run all the module methods. For example, you can't do:
 
 ```
-$ ruby bin/linuxstat.rb upc
+$ ruby exe/linuxstat.rb upc
 ```
 This is not a valid module and can't be run.
 

data/bin/console

@@ -1,4 +1,4 @@
 #!/usr/bin/env ruby
 $-v = true
-%w(bundler/setup linux_stat irb).each(&method(:require))
+%w(linux_stat irb).each(&method(:require))
 IRB.start(__FILE__)

data/bin/setup

@@ -4,5 +4,3 @@ IFS=$'\n\t'
 set -vx
 
 bundle install
-
-# Do any other automated setup that you need to do here

data/{bin → exe}/linuxstat.rb

@@ -1,16 +1,12 @@
 #!/usr/bin/env ruby
+$-v = true
+
 begin
 	require 'linux_stat'
 rescue LoadError
-	puts "The Gem needs to be installed before this test can be run!"
+	abort "The Gem needs to be installed before this test can be run!"
 end
 
-$-v = true
-
-# Print time each method takes unless --no-time or -nt option is passed
-markdown = ARGV.any? { |x| x[/^\-(\-markdown|md)$/] }
-html = ARGV.any? { |x| x[/^\-(\-html|html)$/] }
-
 # Check which conflicting argument (e.g., `-md -html` together) is passed last
 # Always use the last argument
 conflicting, hash = [
@@ -38,6 +34,7 @@ end
 
 MARKDOWN, HTML = hash[:markdown], hash[:html]
 
+# Print time each method takes unless --no-time or -nt option is passed
 PRINT_TIME = (MARKDOWN || HTML) ? false : !ARGV.any? { |x| x[/^\-\-no-time$/] || x[/^\-nt$/] }
 
 %w(--markdown -md --no-time -nt --html -html).each(&ARGV.method(:delete))
@@ -99,10 +96,11 @@ execute.sort.each do |c|
 		puts
 	end
 
-	meths.length > 0
+	if meths.length > 0
 		if MARKDOWN
 			puts "```\n\n"
 		elsif HTML
 			puts "</pre>"
 		end
+	end
 end

data/ext/sysconf/sysconf.c

@@ -37,6 +37,23 @@ static VALUE getPosixVersion(VALUE obj) {
 	return INT2FIX(sysconf(_SC_VERSION)) ;
 }
 
+static VALUE getUser(VALUE obj) {
+	char *name = getlogin() ;
+	return name ? rb_str_new_cstr(name) : rb_str_new_cstr("") ;
+}
+
+static VALUE getUID(VALUE obj) {
+	return INT2FIX(getuid()) ;
+}
+
+static VALUE getGID(VALUE obj) {
+	return INT2FIX(getgid()) ;
+}
+
+static VALUE getEUID(VALUE obj) {
+	return INT2FIX(geteuid()) ;
+}
+
 void Init_sysconf() {
 	VALUE _linux_stat = rb_define_module("LinuxStat") ;
 	VALUE _sysconf = rb_define_module_under(_linux_stat, "Sysconf") ;
@@ -50,4 +67,11 @@ void Init_sysconf() {
 	rb_define_module_function(_sysconf, "stream_max", getStreamMax, 0) ;
 	rb_define_module_function(_sysconf, "tty_name_max", getTTYNameMax, 0) ;
 	rb_define_module_function(_sysconf, "posix_version", getPosixVersion, 0) ;
+
+	rb_define_module_function(_sysconf, "get_uid", getUID, 0) ;
+	rb_define_module_function(_sysconf, "get_gid", getGID, 0) ;
+	rb_define_module_function(_sysconf, "get_euid", getEUID, 0) ;
+
+	rb_define_module_function(_sysconf, "get_user", getUser, 0) ;
+	rb_define_module_function(_sysconf, "get_login", getUser, 0) ;
 }

data/lib/linux_stat.rb

@@ -18,3 +18,4 @@ require "linux_stat/filesystem"
 require "linux_stat/sysconf"
 require "linux_stat/kernel"
 require "linux_stat/process_info"
+require 'linux_stat/user'

data/lib/linux_stat/kernel.rb

@@ -133,8 +133,6 @@ module LinuxStat
 				end
 			end
 
-			alias release version
-
 			# Reads maximum 1024 bytes from /proc/version and returns the string.
 			# The output is also cached ; as changing the value in runtime is unexpected.
 			def string
@@ -148,6 +146,7 @@ module LinuxStat
 				@@tick ||= LinuxStat::Sysconf.sc_clk_tck
 			end
 
+			alias release version
 			alias clk_tck ticks
 
 			private

data/lib/linux_stat/process_info.rb

@@ -127,9 +127,10 @@ module LinuxStat
 			#
 			# If the info isn't available it will return nil.
 			def memory(pid = $$)
-				_rss_anon = IO.readlines("/proc/#{pid}/status")
-					.find { |x| x.start_with?('RssAnon') }
+				file = "/proc/#{pid}/status".freeze
+				return nil unless File.readable?(file)
 
+				_rss_anon = IO.readlines(file).find { |x| x.start_with?('RssAnon') }
 				_rss_anon ? _rss_anon.split[1].to_i : nil
 			end
 
@@ -144,7 +145,10 @@ module LinuxStat
 			#
 			# If the info isn't available it will return nil.
 			def virtual_memory(pid = $$)
-				_virtual_memory = IO.read("/proc/#{pid}/stat".freeze).split[22]
+				file = "/proc/#{pid}/stat".freeze
+				return nil unless File.readable?(file)
+
+				_virtual_memory = IO.read(file).split[22]
 				_virtual_memory ? _virtual_memory.to_i.fdiv(1024).to_i : nil
 			end
 
@@ -159,7 +163,10 @@ module LinuxStat
 			#
 			# If the info isn't available it will return nil.
 			def resident_memory(pid = $$)
-				_vm_rss = IO.readlines("/proc/#{pid}/status")
+				file = "/proc/#{pid}/status".freeze
+				return nil unless File.readable?(file)
+
+				_vm_rss = IO.readlines(file)
 					.find { |x| x.start_with?('VmRSS') }
 
 				_vm_rss ? _vm_rss.split[1].to_i : nil
@@ -301,6 +308,10 @@ module LinuxStat
 				IO.read("/proc/#{pid}/stat".freeze).split[38].to_i
 			end
 
+			# def owned_by
+
+			# end
+
 			private
 			def get_ticks
 				@@ticks ||= Sysconf.sc_clk_tck

data/lib/linux_stat/user.rb

@@ -0,0 +1,258 @@
+module LinuxStat
+	module User
+		class << self
+			# Returns an array of users as string
+			# For example:
+			#    ["root", "bin", "daemon", "mail", "ftp", "http", "nobody"]
+			# But if the status isn't available it will return an empty Array.
+			def list
+				return [] unless passwd_readable?
+				passwd.map { |x| x[/.+?:/][0..-2].freeze }
+			end
+
+			# Returns all the Group ids directories as Hash.
+			# For example:
+			#    {:root=>{:uid=>0, :gid=>0}, :bin=>{:uid=>1, :gid=>1}, :daemon=>{:uid=>2, :gid=>2}, :mail=>{:uid=>8, :gid=>12}, :ftp=>{:uid=>14, :gid=>11}}
+			#
+			# But if the status isn't available it will return an empty Hash.
+			def ids
+				return {} unless passwd_readable?
+				passwd.reduce({}) { |h, x|
+					splitted = x.split(?:)
+
+					h.merge!(splitted[0].to_sym => {
+						uid: splitted[2].to_i, gid: splitted[3].to_i
+					})
+				}
+			end
+
+			# Returns all the user IDs as Hash.
+			# For example:
+			#    LinuxStat::User.uids
+			#    => {:root=>0, :bin=>1, :daemon=>2, :mail=>8, :ftp=>14}
+			#
+			# But if the status isn't available it will return an empty Hash.
+			def uids
+				return {} unless passwd_readable?
+				passwd.reduce({}) { |h, x|
+					splitted = x.split(?:)
+					h.merge!(splitted[0].to_sym => splitted[2].to_i)
+				}
+			end
+
+			# Returns all the Group identifiers as Hash.
+			# For example:
+			#    LinuxStat::User.gids
+			#    => {:root=>0, :bin=>1, :daemon=>2, :mail=>12, :ftp=>11}
+			#
+			# But if the status isn't available it will return an empty Hash.
+			def gids
+				return {} unless passwd_readable?
+				passwd.reduce({}) { |h, x|
+					splitted = x.split(?:)
+					h.merge!(splitted[0].to_sym => splitted[3].to_i)
+				}
+			end
+
+			# Returns all the home directories as Hash.
+			# For example:
+			#    LinuxStat::User.home_directories
+			#    => {:root=>"/root", :bin=>"/", :daemon=>"/", :mail=>"/var/spool/mail", :ftp=>"/srv/ftp", :http=>"/srv/http", :nobody=>"/"}
+			#
+			# But if the status isn't available it will return an empty Hash.
+			def home_directories
+				return {} unless passwd_readable?
+				passwd.reduce({}) { |h, x|
+					splitted = x.split(?:)
+					h.merge!(splitted[0].to_sym => splitted[5])
+				}
+			end
+
+			# Returns the user ID as integer
+			# It directly calls LinuxStat::Sysconf.get_user
+			#
+			# It doesn't get affected with the assignment of USER environment variable.
+			def get_user
+				LinuxStat::Sysconf.get_user
+			end
+
+			# Returns the user ID as integer
+			# It directly calls LinuxStat::Sysconf.get_uid
+			def get_uid
+				LinuxStat::Sysconf.get_uid
+			end
+
+			# Returns the group ID as integer
+			# It directly calls LinuxStat::Sysconf.get_uid
+			def get_gid
+				LinuxStat::Sysconf.get_gid
+			end
+
+			# Returns the effective user ID as integer
+			# It directly calls LinuxStat::Sysconf.get_euid
+			def get_euid
+				LinuxStat::Sysconf.get_euid
+			end
+
+			# def usernames_by_uid(gid = get_uid)
+			# Where uid is the group id of the user. By default it's the uid of the current user.
+			#
+			# It returns an Array containing the username corresponding to the uid.
+			#
+			# For example:
+			#    LinuxStat::User.usernames_by_uid(1001)
+			#    => ["userx", "usery"]
+			#
+			# But if the info isn't available it will return an empty Array.
+			def usernames_by_uid(uid = get_uid)
+				return [] unless passwd_readable?
+
+				usernames = []
+				passwd.each do |x|
+					splitted = x.split(?:.freeze)
+					usernames << splitted[0] if splitted[2].to_i == uid
+				end
+				usernames
+			end
+
+			# def username_by_gid(gid = get_gid)
+			# Where gid is the group id of the user. By default it's the gid of the current user.
+			#
+			# It returns a String cotaining the username corresponding to the gid
+			# But if the info isn't available it will return an empty frozen String.
+			def username_by_gid(gid = get_gid)
+				return ''.freeze unless passwd_readable?
+
+				username = ''
+				passwd.each do |x|
+					splitted = x.split(?:.freeze)
+					if splitted[2].to_i == gid
+						username = splitted[0]
+						break
+					end
+				end
+				username
+			end
+
+			# gid_by_username(username = get_user)
+			# Where username is the username to look for, by default it is the current user.
+			#
+			# It returns the gid by the username.
+			# For example:
+			#    LinuxStat::User.gid_by_username('root')
+			#    => "0"
+			#
+			# The return type is Integer.
+			# But if user passed doesn't exist or if the info isn't available, it will return nil.
+			def gid_by_username(username = get_user)
+				return nil unless passwd_readable?
+
+				gid = nil
+				passwd.each do |x|
+					splitted = x.split(?:.freeze)
+					if splitted[0] == username
+						gid = splitted[3].to_i
+						break
+					end
+				end
+				gid
+			end
+
+			# uid_by_username(username = get_user)
+			# Where username is the username to look for, by default it is the current user.
+			#
+			# It returns the uid by the username.
+			# For example:
+			#    LinuxStat::User.uid_by_username('root')
+			#    => 0
+			#
+			# The return type is Integer.
+			# But if user passed doesn't exist or if the info isn't available, it will return nil.
+			def uid_by_username(username = get_user)
+				return nil unless passwd_readable?
+
+				uid = nil
+				passwd.each do |x|
+					splitted = x.split(?:.freeze)
+					if splitted[0] == username
+						uid = splitted[2].to_i
+						break
+					end
+				end
+				uid
+			end
+
+			# home_by_username(user = get_user)
+			# Where user is the name of the user.
+			# Returns the user's home. By default it returns the home of the current user.
+			#
+			# If the info isn't available, it will return ENV['HOME].to_s.freeze
+			def home_by_username(user = get_user)
+				return ENV['HOME'].to_s.freeze unless passwd_readable?
+
+				home = ''
+				passwd.each { |x|
+					splitted = x.split(?:)
+					if splitted[0] == user
+						home = splitted[5]
+						break
+					end
+				}
+				home
+			end
+
+			# home_by_uid(id = get_uid)
+			# Gets all the users home directory with user id.
+			# It returns an Array in this format:
+			#    LinuxStat::User.homes_by_uid(1001)
+			#    => ["/home/userx", "/home/usery"]
+			#
+			# Assuming both the users share same UID.
+			#
+			# If the info isn't available, it will return an empty Array.
+			def homes_by_uid(id = get_uid)
+				return [] unless passwd_readable?
+
+				home = []
+				passwd.each do |x|
+					splitted = x.split(?:.freeze)
+					home << splitted[5] if splitted[2].to_i == id
+				end
+				home
+			end
+
+			# home_by_gid(id = get_uid)
+			# Gets the home of the user corresponding to the GID.
+			# It returns a String in this format:
+			#
+			# Assuming both the users share same UID.
+			#
+			# If the info isn't available, it will return an empty frozen String.
+			def home_by_gid(id = get_gid)
+				return ''.freeze unless passwd_readable?
+
+				home = ''
+				passwd.each do |x|
+					splitted = x.split(?:.freeze)
+
+					if splitted[3].to_i == id
+						home = splitted[5]
+						break
+					end
+				end
+				home
+			end
+
+			private
+			def passwd
+				@@passwd_file ||= '/etc/passwd'.freeze
+				IO.readlines(@@passwd_file)
+			end
+
+			def passwd_readable?
+				@@passwd_file ||= '/etc/passwd'.freeze
+				@@passwd_readable ||= File.readable?(@@passwd_file)
+			end
+		end
+	end
+end

data/lib/linux_stat/version.rb

@@ -1,3 +1,3 @@
 module LinuxStat
-	VERSION = "0.4.2"
+	VERSION = "0.5.1"
 end

metadata

@@ -1,19 +1,21 @@
 --- !ruby/object:Gem::Specification
 name: linux_stat
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.5.1
 platform: ruby
 authors:
 - Sourav Goswami
 autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 2020-12-05 00:00:00.000000000 Z
 dependencies: []
-description: Efficient linux system reporting gem. Linux Only | Efficient | Reliable
+description: Linux only, efficient linux system utilization reporting and system monitoring
+  gem
 email:
 - souravgoswami@protonmail.com
-executables: []
+executables:
+- linuxstat.rb
 extensions:
 - ext/fs_stat/extconf.rb
 - ext/sysconf/extconf.rb
@@ -21,10 +23,11 @@ extensions:
 extra_rdoc_files:
 - README.md
 files:
+- LICENSE.txt
 - README.md
 - bin/console
-- bin/linuxstat.rb
 - bin/setup
+- exe/linuxstat.rb
 - ext/fs_stat/extconf.rb
 - ext/fs_stat/fs_stat.c
 - ext/sysconf/extconf.rb
@@ -44,6 +47,7 @@ files:
 - lib/linux_stat/process.rb
 - lib/linux_stat/process_info.rb
 - lib/linux_stat/swap.rb
+- lib/linux_stat/user.rb
 - lib/linux_stat/version.rb
 homepage: https://github.com/Souravgoswami/linux_stat/
 licenses: