Description

A Ruby interface for getting process information.

Synopsis

   
   require 'sys/proctable'
   include Sys

   # Everything
   ProcTable.ps{ |p|
      puts p.pid.to_s
      puts p.comm
      ...
   }

   or

   # Just one process
   s = ProcTable.ps(2123)
   puts s.pid.to_s
   puts s.comm
   ...

   # Return the results as an array of ProcTableStructs
   a = ProcTable.ps
   a.each do |p|
      puts a.pid
      ...
   end
   

Constants

VERSION

Returns the current version number for this package (as a string).

Class Methods

ProcTable.fields

Returns an array of fields available on the current OS.

ProcTable.ps(pid=nil)
ProcTable.ps{ |s| … }

If no pid is included as an argument, in block form it returns a struct of type ProcTableStruct for every process in the proc table. Otherwise it returns an array of ProcTable struct's. If a pid is provided it will return a single ProcTable struct for that pid, or nil if it is not found.

Supported fields

You can view the supported fields with the "fields()" class method. However, all platforms share a cmdline and comm field.

Future Plans

Add support for more platforms, e.g. AIX, IRIX, etc.

Known Bugs

None that I am aware of. Please log any bugs on the RubyForge project page at http://www.rubyforge.org/projects/sysutils

License

Ruby's

Copyright

(C) 2003-2006 Daniel J. Berger
All Rights Reserved.

Warranty

This package is provided "as is" and without any exblockquotess or implied warranties, including, without limitation, the implied warranties of merchantability and fitness for a particular purpose.

Author

Daniel J. Berger
djberg96 at nospam at gmail dot com
imperator on IRC (Freenode)

See Also

ps, proc