Module: LinuxStat::Process

Defined in:
lib/linux_stat/process.rb

Overview

Shows various information about a process that is either running, sleeping, idle or a zombie.

Class Method Summary collapse

Class Method Details

.cmdlines ⇒ Object

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.



47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/linux_stat/process.rb', line 47

def cmdlines
  h, i = {}, -1

  l = LinuxStat::ProcFS.list_process
  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.store(x, cmdlines)
    rescue StandardError
    end
  end
  h
end

.count ⇒ Object

Counts and returns the total number of process running on the system.

The return type is Integer.



19
20
21
 
# File 'lib/linux_stat/process.rb', line 19

def count
  LinuxStat::ProcFS.list_process.length
end

.idle ⇒ Object

Returns all the id of processes that are idle. The return type is an Array of Integers.



110
111
112
113
114
 
# File 'lib/linux_stat/process.rb', line 110

def idle
  LinuxStat::ProcFS.list_process.select { |x|
    LinuxStat::ProcFS.ps_state(x) == ?I.freeze
  }
end

.last_pid ⇒ Object

Returns the last_pid of the system. It directly calls LS::ProcFS.last_pid

The return value is Integer, but if the status isn’t available, it will return nil



150
151
152
 
# File 'lib/linux_stat/process.rb', line 150

def last_pid
  LinuxStat::ProcFS.last_pid
end

.list ⇒ Object

Returns the list of processes from /proc/. The output doesn’t guarantee a sorted list, in fact it’s shuffled most of the time.

The return type is an Array of Integers.



11
12
13
 
# File 'lib/linux_stat/process.rb', line 11

def list
  LinuxStat::ProcFS.list_process
end

.names ⇒ Object

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.



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/linux_stat/process.rb', line 26

def names
  h, i = {}, -1

  l = LinuxStat::ProcFS.list_process
  count = l.length

  while(i += 1) < count
    x = l[i]

    begin
      h.store(x, IO.read("/proc/#{x}/comm").strip)
    rescue StandardError
    end
  end
  h
end

.running ⇒ Object

Returns all the id of processes that are running. The return type is an Array of Integers.



128
129
130
131
132
 
# File 'lib/linux_stat/process.rb', line 128

def running
  LinuxStat::ProcFS.list_process.select { |x|
    LinuxStat::ProcFS.ps_state(x) == ?R.freeze
  }
end

.sleeping ⇒ Object

Returns all the id of processes that are sleeping. The return type is an Array of Integers.



101
102
103
104
105
 
# File 'lib/linux_stat/process.rb', line 101

def sleeping
  LinuxStat::ProcFS.list_process.select { |x|
    LinuxStat::ProcFS.ps_state(x) == ?S.freeze
  }
end

.stopped ⇒ Object

Returns all the id of processes that are stopped. The return type is an Array of Integers.



137
138
139
140
141
142
 
# File 'lib/linux_stat/process.rb', line 137

def stopped
  LinuxStat::ProcFS.list_process.select { |x|
    v = LinuxStat::ProcFS.ps_state(x)
    v == ?T.freeze || v == ?t.freeze
  }
end

.types ⇒ Object

Returns all the id of processes mapped with their status as a Hash.



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
 
# File 'lib/linux_stat/process.rb', line 68

def types
  h, i = {}, -1

  l = LinuxStat::ProcFS.list_process
  count = l.length

  while(i += 1) < count
    x = l[i]

    begin
      h.store(x,
        case LinuxStat::ProcFS.ps_state(x)
          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 StandardError
    end
  end

  h
end

.zombie ⇒ Object

Returns all the id of processes that are zombies. The return type is an Array of Integers.



119
120
121
122
123
 
# File 'lib/linux_stat/process.rb', line 119

def zombie
  LinuxStat::ProcFS.list_process.select { |x|
    LinuxStat::ProcFS.ps_state(x) == ?Z.freeze
  }
end