sys-proctable 0.7.6 → 1.2.0

data/spec/sys_proctable_sunos_spec.rb

@@ -0,0 +1,316 @@
+#######################################################################
+# sys_proctable_sunos_spec.rb
+#
+# Test suite for sys-proctable for SunOS/Solaris. This should be run
+# run via the 'rake test' task.
+#######################################################################
+require 'rspec'
+require 'sys/proctable'
+require_relative 'sys_proctable_all_spec'
+
+describe Sys::ProcTable do
+  let(:fields){
+    %w[
+        flag nlwp pid ppid pgid sid uid euid gid egid addr size
+        rssize ttydev pctcpu pctmem start time ctime fname psargs
+        wstat argc argv envp dmodel taskid projid nzomb poolid
+        zoneid contract lwpid wchan stype state sname nice syscall
+        pri clname name onpro bindpro bindpset count tstamp create
+        term rtime utime stime ttime tftime dftime kftime ltime
+        slptime wtime stoptime minf majf nswap inblk oublk msnd
+        mrcv sigs vctx ictx sysc ioch path contracts fd cmd_args
+        environ cmdline
+      ]
+  }
+
+  context "fields singleton method" do
+    it "responds to a fields method" do
+      expect(described_class).to respond_to(:fields)
+    end
+
+    it "returns the expected results for the fields method" do
+      expect(described_class.fields).to be_kind_of(Array)
+      expect(described_class.fields).to eql(fields)
+    end
+  end
+
+  context "ProcTable::Struct members" do
+    subject { described_class.ps(pid: Process.pid) }
+
+    it "contains a pid member and returns the expected value" do
+      expect(subject).to respond_to(:pid)
+      expect(subject.pid).to be_kind_of(Numeric)
+      expect(subject.pid).to eql(Process.pid)
+    end
+
+    it "contains a ppid member and returns the expected value" do
+      expect(subject).to respond_to(:ppid)
+      expect(subject.ppid).to be_kind_of(Numeric)
+      expect(subject.ppid).to eql(Process.ppid)
+    end
+
+    it "contains a pgid member and returns the expected value" do
+      expect(subject).to respond_to(:pgid)
+      expect(subject.pgid).to be_kind_of(Numeric)
+      expect(subject.pgid).to eql(Process.getpgrp)
+    end
+
+    it "has a flag member that returns the expected value" do
+      expect(subject).to respond_to(:flag)
+      expect(subject.flag).to be_kind_of(Integer)
+    end
+
+    it "has an nlwp member that returns the expected value" do
+      expect(subject).to respond_to(:nlwp)
+      expect(subject.nlwp).to be_kind_of(Integer)
+      expect(subject.nlwp).to be >= 0
+    end
+
+    it "has a sid member that returns the expected value" do
+      expect(subject).to respond_to(:sid)
+      expect(subject.sid).to be_kind_of(Integer)
+      expect(subject.sid).to be >= 0
+    end
+
+    it "has a uid member that returns the expected value" do
+      expect(subject).to respond_to(:uid)
+      expect(subject.uid).to be_kind_of(Integer)
+      expect(subject.uid).to eql(Process.uid)
+    end
+
+    it "has a euid member that returns the expected value" do
+      expect(subject).to respond_to(:euid)
+      expect(subject.euid).to be_kind_of(Integer)
+      expect(subject.euid).to eql(Process.euid)
+    end
+
+    it "has a gid member that returns the expected value" do
+      expect(subject).to respond_to(:gid)
+      expect(subject.gid).to be_kind_of(Integer)
+      expect(subject.gid).to eql(Process.gid)
+    end
+
+    it "has a egid member that returns the expected value" do
+      expect(subject).to respond_to(:egid)
+      expect(subject.egid).to be_kind_of(Integer)
+      expect(subject.egid).to eql(Process.egid)
+    end
+
+    it "has an addr member that returns the expected value" do
+      expect(subject).to respond_to(:addr)
+      expect(subject.addr).to be_kind_of(Integer)
+      expect(subject.addr).to be >= 0
+    end
+
+    it "has a size member that returns the expected value" do
+      expect(subject).to respond_to(:size)
+      expect(subject.size).to be_kind_of(Integer)
+      expect(subject.size).to be >= 0
+    end
+
+    it "has a rssize member that returns the expected value" do
+      expect(subject).to respond_to(:rssize)
+      expect(subject.rssize).to be_kind_of(Integer)
+      expect(subject.rssize).to be >= 0
+    end
+
+    it "has a ttydev member that returns the expected value" do
+      expect(subject).to respond_to(:ttydev)
+      expect(subject.ttydev).to be_kind_of(Integer)
+      expect(subject.ttydev).to be >= -1
+    end
+
+    it "has a pctcpu member that returns the expected value" do
+      expect(subject).to respond_to(:pctcpu)
+      expect(subject.pctcpu).to be_kind_of(Float)
+      expect(subject.pctcpu).to be >= 0.0
+    end
+
+    it "has a pctmem member that returns the expected value" do
+      expect(subject).to respond_to(:pctmem)
+      expect(subject.pctmem).to be_kind_of(Float)
+      expect(subject.pctmem).to be >= 0.0
+    end
+
+    it "has a start member that returns the expected value" do
+      expect(subject).to respond_to(:start)
+      expect(subject.start).to be_kind_of(Time)
+    end
+
+    it "has a time member that returns the expected value" do
+      expect(subject).to respond_to(:time)
+      expect(subject.time).to be_kind_of(Integer)
+      expect(subject.time).to be >= 0
+    end
+
+    it "has a ctime member that returns the expected value" do
+      expect(subject).to respond_to(:ctime)
+      expect(subject.ctime).to be_kind_of(Integer)
+      expect(subject.ctime).to be >= 0
+    end
+
+    it "has a fname member that returns the expected value" do
+      expect(subject).to respond_to(:fname)
+      expect(subject.fname).to be_kind_of(String)
+      expect(subject.fname.size).to be > 0
+    end
+
+    it "has a comm alias member" do
+      expect(subject.method(:comm)).to eql(subject.method(:fname))
+    end
+
+    it "has a psargs member that returns the expected value" do
+      expect(subject).to respond_to(:psargs)
+      expect(subject.psargs).to be_kind_of(String)
+      expect(subject.psargs.size).to be > 0
+    end
+
+    it "has a wstat member that returns the expected value" do
+      expect(subject).to respond_to(:wstat)
+      expect(subject.wstat).to be_kind_of(Integer)
+      expect(subject.wstat).to be >= 0
+    end
+
+    it "has an args member that returns the expected value" do
+      expect(subject).to respond_to(:argc)
+      expect(subject.argc).to be_kind_of(Integer)
+      expect(subject.argc).to be >= 0
+    end
+
+    it "has an argv member that returns the expected value" do
+      expect(subject).to respond_to(:argv)
+      expect(subject.argv).to be_kind_of(Integer)
+      expect(subject.argv).to be >= 0
+    end
+
+    it "has a envp member that returns the expected value" do
+      expect(subject).to respond_to(:envp)
+      expect(subject.envp).to be_kind_of(Integer)
+      expect(subject.envp).to be >= 0
+    end
+
+    it "has a dmodel member that returns the expected value" do
+      expect(subject).to respond_to(:dmodel)
+      expect(subject.dmodel).to be_kind_of(Integer)
+      expect(subject.dmodel).to be >= 0
+    end
+
+    it "has a taskid member that returns the expected value" do
+      expect(subject).to respond_to(:taskid)
+      expect(subject.taskid).to be_kind_of(Integer)
+      expect(subject.taskid).to be >= 0
+    end
+
+    it "has a projid member that returns the expected value" do
+      expect(subject).to respond_to(:projid)
+      expect(subject.projid).to be_kind_of(Integer)
+      expect(subject.projid).to be >= 0
+    end
+
+    it "has a nzomb member that returns the expected value" do
+      expect(subject).to respond_to(:nzomb)
+      expect(subject.nzomb).to be_kind_of(Integer)
+      expect(subject.nzomb).to be >= 0
+    end
+
+    it "has a poolid member that returns the expected value" do
+      expect(subject).to respond_to(:poolid)
+      expect(subject.poolid).to be_kind_of(Integer)
+      expect(subject.poolid).to be >= 0
+    end
+
+    it "has a zoneid member that returns the expected value" do
+      expect(subject).to respond_to(:zoneid)
+      expect(subject.zoneid).to be_kind_of(Integer)
+      expect(subject.zoneid).to be >= 0
+    end
+
+    it "has a contract member that returns the expected value" do
+      expect(subject).to respond_to(:contract)
+      expect(subject.contract).to be_kind_of(Integer)
+      expect(subject.contract).to be >= 0
+    end
+  end
+
+  context "lwpsinfo struct" do
+    subject { described_class.ps(pid: Process.pid) }
+
+    it "has a lwpid member that returns the expected value" do
+      expect(subject).to respond_to(:lwpid)
+      expect(subject.lwpid).to be_kind_of(Integer)
+      expect(subject.lwpid).to be >= 0
+    end
+
+    it "has a wchan member that returns the expected value" do
+      expect(subject).to respond_to(:wchan)
+      expect(subject.wchan).to be_kind_of(Integer)
+      expect(subject.wchan).to be >= 0
+    end
+
+    it "has a stype member that returns the expected value" do
+      expect(subject).to respond_to(:stype)
+      expect(subject.stype).to be_kind_of(Integer)
+      expect(subject.stype).to be >= 0
+    end
+
+    it "has a state member that returns the expected value" do
+      expect(subject).to respond_to(:state)
+      expect(subject.state).to be_kind_of(Fixnum)
+      expect(subject.state).to be >= 0
+    end
+
+    it "has a sname member that returns the expected value" do
+      expect(subject).to respond_to(:sname)
+      expect(subject.sname).to be_kind_of(String)
+      expect(['S','R','Z','T','I','O']).to include(subject.sname)
+    end
+
+    it "has a nice member that returns the expected value" do
+      expect(subject).to respond_to(:nice)
+      expect(subject.nice).to be_kind_of(Fixnum)
+      expect(subject.nice).to be >= 0
+    end
+
+    it "has a syscall member that returns the expected value" do
+      expect(subject).to respond_to(:syscall)
+      expect(subject.syscall).to be_kind_of(Fixnum)
+      expect(subject.syscall).to be >= 0
+    end
+
+    it "has a pri member that returns the expected value" do
+      expect(subject).to respond_to(:pri)
+      expect(subject.pri).to be_kind_of(Fixnum)
+      expect(subject.pri).to be >= 0
+    end
+
+    it "has a clname member that returns the expected value" do
+      expect(subject).to respond_to(:clname)
+      expect(subject.clname).to be_kind_of(String)
+      expect(subject.clname.size).to be_between(0,8)
+    end
+
+    it "has a name member that returns the expected value" do
+      expect(subject).to respond_to(:name)
+      expect(subject.name).to be_kind_of(String)
+      expect(subject.name.size).to be_between(0,16)
+    end
+
+    it "has an onpro member that returns the expected value" do
+      expect(subject).to respond_to(:onpro)
+      expect(subject.onpro).to be_kind_of(Fixnum)
+      expect(subject.onpro).to be >= 0
+    end
+
+    it "has a bindpro member that returns the expected value" do
+      expect(subject).to respond_to(:bindpro)
+      expect(subject.bindpro).to be_kind_of(Fixnum)
+      expect(subject.bindpro).to be >= -1
+    end
+
+    it "has a bindpset member that returns the expected value" do
+      expect(subject).to respond_to(:bindpset)
+      expect(subject.bindpset).to be_kind_of(Fixnum)
+      expect(subject.bindpset).to be >= -1
+    end
+  end
+end

data/spec/sys_proctable_windows_spec.rb

@@ -0,0 +1,317 @@
+############################################################################
+# sys_proctable_windows_spec.rb
+#
+# Test suite for the sys-proctable library for MS Windows. This should be
+# run via the 'rake test' task.
+############################################################################
+require 'rspec'
+require 'sys-proctable'
+require 'socket'
+require_relative 'sys_proctable_all_spec'
+
+describe Sys::ProcTable do
+  let(:hostname) { Socket.gethostname }
+  let(:fields) {
+    %w[
+        caption
+        cmdline
+        comm
+        creation_class_name
+        creation_date
+        cs_creation_class_name
+        cs_name description
+        executable_path
+        execution_state
+        handle
+        handle_count
+        install_date
+        kernel_mode_time
+        maximum_working_set_size
+        minimum_working_set_size name
+        os_creation_class_name
+        os_name
+        other_operation_count
+        other_transfer_count
+        page_faults
+        page_file_usage
+        ppid
+        peak_page_file_usage
+        peak_virtual_size
+        peak_working_set_size
+        priority
+        private_page_count
+        pid
+        quota_non_paged_pool_usage
+        quota_paged_pool_usage
+        quota_peak_non_paged_pool_usage
+        quota_peak_paged_pool_usage
+        read_operation_count
+        read_transfer_count
+        session_id
+        status
+        termination_date
+        thread_count
+        user_mode_time
+        virtual_size
+        windows_version
+        working_set_size
+        write_operation_count
+        write_transfer_count
+     ]
+  }
+
+  context "fields" do
+    it "responds to a fields method" do
+      expect(described_class).to respond_to(:fields)
+    end
+
+    it "returns the expected results for the fields method" do
+      expect(described_class.fields).to be_kind_of(Array)
+      expect(described_class.fields).to eql(fields)
+    end
+  end
+
+  context "ps" do
+    it "accepts an optional host" do
+      expect{ described_class.ps(host: hostname) }.to_not raise_error
+    end
+
+    it "ignores unused options" do
+      expect{ described_class.ps(:smaps => false) }.to_not raise_error
+    end
+  end
+
+  context "ProcTable::Struct members" do
+    subject { described_class.ps.first }
+
+    it "has a write_transfer_count struct member with the expected data type" do
+      expect(subject).to respond_to(:write_transfer_count)
+      expect(subject.write_transfer_count).to be_kind_of(Integer)
+    end
+
+    it "has a write_operation_count struct member with the expected data type" do
+      expect(subject).to respond_to(:write_operation_count)
+      expect(subject.write_operation_count).to be_kind_of(Integer)
+    end
+
+    it "has a working_set_size struct member with the expected data type" do
+      expect(subject).to respond_to(:working_set_size)
+      expect(subject.working_set_size).to be_kind_of(Integer)
+    end
+
+    it "has a windows_version struct member with the expected data type" do
+      expect(subject).to respond_to(:windows_version)
+      expect(subject.windows_version).to be_kind_of(String)
+    end
+
+    it "has a virtual_size struct member with the expected data type" do
+      expect(subject).to respond_to(:virtual_size)
+      expect(subject.virtual_size).to be_kind_of(Integer)
+    end
+
+    it "has a user_mode_time struct member with the expected data type" do
+      expect(subject).to respond_to(:user_mode_time)
+      expect(subject.user_mode_time).to be_kind_of(Integer)
+    end
+
+    it "has a thread_count struct member with the expected data type" do
+      expect(subject).to respond_to(:thread_count)
+      expect(subject.thread_count).to be_kind_of(Integer)
+    end
+
+    it "has a termination_date struct member with the expected data type" do
+      expect(subject).to respond_to(:termination_date)
+      expect(subject.termination_date).to be_kind_of(Date) if subject.termination_date
+    end
+
+    it "has a status struct member with the expected data type" do
+      expect(subject).to respond_to(:status)
+      expect(subject.status).to be_nil # Always nil according to MSDN
+    end
+
+    it "has a session_id struct member with the expected data type" do
+      expect(subject).to respond_to(:session_id)
+      expect(subject.session_id).to be_kind_of(Integer)
+    end
+
+    it "has a read_transfer_count struct member with the expected data type" do
+      expect(subject).to respond_to(:read_transfer_count)
+      expect(subject.read_transfer_count).to be_kind_of(Integer)
+    end
+
+    it "has a read_operation_count struct member with the expected data type" do
+      expect(subject).to respond_to(:read_operation_count)
+      expect(subject.read_operation_count).to be_kind_of(Integer)
+    end
+
+    it "has a quota_peak_paged_pool_usage struct member with the expected data type" do
+      expect(subject).to respond_to(:quota_peak_paged_pool_usage)
+      expect(subject.quota_peak_paged_pool_usage).to be_kind_of(Integer)
+    end
+
+    it "has a quota_peak_non_paged_pool_usage struct member with the expected data type" do
+      expect(subject).to respond_to(:quota_peak_non_paged_pool_usage)
+      expect(subject.quota_peak_non_paged_pool_usage).to be_kind_of(Integer)
+    end
+
+    it "has a quota_paged_pool_usage struct member with the expected data type" do
+      expect(subject).to respond_to(:quota_paged_pool_usage)
+      expect(subject.quota_paged_pool_usage).to be_kind_of(Integer)
+    end
+
+    it "has a quota_non_paged_pool_usage struct member with the expected data type" do
+      expect(subject).to respond_to(:quota_non_paged_pool_usage)
+      expect(subject.quota_non_paged_pool_usage).to be_kind_of(Integer)
+    end
+
+    it "has a pid struct member with the expected data type" do
+      expect(subject).to respond_to(:pid)
+      expect(subject.pid).to be_kind_of(Integer)
+    end
+
+    it "has a private_page_count struct member with the expected data type" do
+      expect(subject).to respond_to(:private_page_count)
+      expect(subject.private_page_count).to be_kind_of(Integer)
+    end
+
+    it "has a priority struct member with the expected data type" do
+      expect(subject).to respond_to(:priority)
+      expect(subject.priority).to be_kind_of(Integer)
+    end
+
+    it "has a peak_working_set_size struct member with the expected data type" do
+      expect(subject).to respond_to(:peak_working_set_size)
+      expect(subject.peak_working_set_size).to be_kind_of(Integer)
+    end
+
+    it "has a peak_virtual_size struct member with the expected data type" do
+      expect(subject).to respond_to(:peak_virtual_size)
+      expect(subject.peak_virtual_size).to be_kind_of(Integer)
+    end
+
+    it "has a peak_page_file_usage struct member with the expected data type" do
+      expect(subject).to respond_to(:peak_page_file_usage)
+      expect(subject.peak_page_file_usage).to be_kind_of(Integer)
+    end
+
+    it "has a ppid struct member with the expected data type" do
+      expect(subject).to respond_to(:ppid)
+      expect(subject.ppid).to be_kind_of(Integer)
+    end
+
+    it "has a page_file_usage struct member with the expected data type" do
+      expect(subject).to respond_to(:page_file_usage)
+      expect(subject.page_file_usage).to be_kind_of(Integer)
+    end
+
+    it "has a page_faults struct member with the expected data type" do
+      expect(subject).to respond_to(:page_faults)
+      expect(subject.page_faults).to be_kind_of(Integer)
+    end
+
+    it "has a other_transfer_count struct member with the expected data type" do
+      expect(subject).to respond_to(:other_transfer_count)
+      expect(subject.other_transfer_count).to be_kind_of(Integer)
+    end
+
+    it "has a other_operation_count struct member with the expected data type" do
+      expect(subject).to respond_to(:other_operation_count)
+      expect(subject.other_operation_count).to be_kind_of(Integer)
+    end
+
+    it "has a os_name struct member with the expected data type" do
+      expect(subject).to respond_to(:os_name)
+      expect(subject.os_name).to be_kind_of(String)
+    end
+
+    it "has a os_creation_class_name struct member with the expected data type" do
+      expect(subject).to respond_to(:os_creation_class_name)
+      expect(subject.os_creation_class_name).to be_kind_of(String)
+    end
+
+    it "has a name struct member with the expected data type" do
+      expect(subject).to respond_to(:name)
+      expect(subject.name).to be_kind_of(String)
+    end
+
+    it "has a minimum_working_set_size struct member with the expected data type" do
+      expect(subject).to respond_to(:minimum_working_set_size)
+      expect(subject.minimum_working_set_size).to be_kind_of(Integer) if subject.minimum_working_set_size
+    end
+
+    it "has a maximum_working_set_size struct member with the expected data type" do
+      expect(subject).to respond_to(:maximum_working_set_size)
+      expect(subject.maximum_working_set_size).to be_kind_of(Integer) if subject.maximum_working_set_size
+    end
+
+    it "has a kernel_mode_time struct member with the expected data type" do
+      expect(subject).to respond_to(:kernel_mode_time)
+      expect(subject.kernel_mode_time).to be_kind_of(Integer)
+    end
+
+    it "has a install_date struct member with the expected data type" do
+      expect(subject).to respond_to(:install_date)
+      expect(subject.install_date).to be_kind_of(Date) if subject.install_date
+    end
+
+    it "has a handle_count struct member with the expected data type" do
+      expect(subject).to respond_to(:handle_count)
+      expect(subject.handle_count).to be_kind_of(Integer)
+    end
+
+    it "has a handle struct member with the expected data type" do
+      expect(subject).to respond_to(:handle)
+      expect(subject.handle).to be_kind_of(String)
+    end
+
+    it "has a execution_state struct member with the expected data type" do
+      expect(subject).to respond_to(:execution_state)
+      expect(subject.execution_state).to be_nil
+    end
+
+    it "has a executable_path struct member with the expected data type" do
+      expect(subject).to respond_to(:executable_path)
+      expect(subject.executable_path).to be_kind_of(String) if subject.executable_path
+    end
+
+    it "has a description struct member with the expected data type" do
+      expect(subject).to respond_to(:description)
+      expect(subject.description).to be_kind_of(String)
+    end
+
+    it "has a cs_name struct member with the expected data type" do
+      expect(subject).to respond_to(:cs_name)
+      expect(subject.cs_name).to be_kind_of(String)
+    end
+
+    it "has a cs_creation_class_name struct member with the expected data type" do
+      expect(subject).to respond_to(:cs_creation_class_name)
+      expect(subject.cs_creation_class_name).to be_kind_of(String)
+    end
+
+    it "has a creation_date struct member with the expected data type" do
+      expect(subject).to respond_to(:creation_date)
+      expect(subject.creation_date).to be_kind_of(Date) if subject.creation_date
+    end
+
+    it "has a creation_class_name struct member with the expected data type" do
+      expect(subject).to respond_to(:creation_class_name)
+      expect(subject.creation_class_name).to be_kind_of(String)
+    end
+
+    it "has a comm struct member with the expected data type" do
+      expect(subject).to respond_to(:comm)
+      expect(subject.comm).to be_kind_of(String)
+    end
+
+    it "has a cmdline struct member with the expected data type" do
+      expect(subject).to respond_to(:cmdline)
+      expect(subject.cmdline).to be_kind_of(String) if subject.cmdline
+    end
+
+    it "has a caption struct member with the expected data type" do
+      expect(subject).to respond_to(:caption)
+      expect(subject.caption).to be_kind_of(String)
+    end
+  end
+end