sys-proctable 0.8.1-x86-linux → 0.8.2-x86-linux

data/CHANGES

@@ -1,3 +1,22 @@
+== 0.9.0 - 14-Oct-2009
+* Changed the license to Artistic 2.0.
+* Fixed a bug in the OS X code where a segfault would occur when an attempt
+  was made to gather resource usage information on zombie processes. From
+  now on that information is always set to nil for zombie processes. Thanks
+  go to Tom Lianza for the spot and Philip Kromer for investigating the
+  root cause of the failure.
+* Removed the FreeBSD code that read out of /proc. It was a pain from a
+  maintenance point of view, and most FreeBSD installs do not mount /proc
+  by default. The FreeBSD platform now uses the same code that the other
+  BSD platforms use.
+* Fixed a bug in the BSD code where the ProcTable::Error class had the
+  wrong parent class.
+* Some major gemspec updates, including an updated license. The platform
+  handling logic is now in the Rakefile in the 'gem' task.
+* Updated the README file to include an additional acknowledgement, a
+  license change and some minor formatting changes.
+* The test-unit library was changed from a runtime to a development dependency.
+
 == 0.8.1 - 6-Apr-2009
 * The Linux and Solaris libraries now handle the possibility of a process
   terminating in the middle of a read more gracefully. If that happens, they

data/MANIFEST

@@ -1,38 +1,30 @@
-CHANGES
-INSTALL
-MANIFEST
-Rakefile
-sys-proctable.gemspec
-
-doc/freebsd.txt
-doc/hpux.txt
-doc/linux.txt
-doc/solaris.txt
-doc/top.txt
-doc/windows.txt
-
-example/example_ps.rb
-
-ext/extconf.rb
-ext/bsd/bsd.c
-ext/darwin/darwin.c
-ext/freebsd/freebsd.c
-ext/freebsd/freebsd.h
-ext/hpux/hpux.c
-ext/hpux/hpux.h
-ext/version.h
-
-lib/sys/top.rb
-lib/sys/linux.rb
-lib/sys/sunos.rb
-lib/sys/windows.rb
-
-test/test_sys_proctable_all.rb
-test/test_sys_proctable_darwin.rb
-test/test_sys_proctable_freebsd.rb
-test/test_sys_proctable_hpux.rb
-test/test_sys_proctable_kvm.rb
-test/test_sys_proctable_linux.rb
-test/test_sys_proctable_sunos.rb
-test/test_sys_proctable_windows.rb
-test/test_sys_top.rb
+* CHANGES
+* MANIFEST
+* Rakefile
+* README
+* sys-proctable.gemspec
+* doc/bsd.txt
+* doc/hpux.txt
+* doc/linux.txt
+* doc/solaris.txt
+* doc/top.txt
+* doc/windows.txt
+* example/example_ps.rb
+* ext/bsd/extconf.rb
+* ext/bsd/sys/proctable.c
+* ext/darwin/extconf.rb
+* ext/darwin/sys/proctable.c
+* ext/hpux/extconf.rb
+* ext/hpux/sys/proctable.c
+* lib/sys/top.rb
+* lib/linux/sys/proctable.rb
+* lib/sunos/sys/proctable.rb
+* lib/windows/sys/proctable.rb
+* test/test_sys_proctable_all.rb
+* test/test_sys_proctable_darwin.rb
+* test/test_sys_proctable_hpux.rb
+* test/test_sys_proctable_bsd.rb
+* test/test_sys_proctable_linux.rb
+* test/test_sys_proctable_sunos.rb
+* test/test_sys_proctable_windows.rb
+* test/test_sys_top.rb

data/README

@@ -1,21 +1,30 @@
-= Description
+== Description
    A Ruby interface for gathering process information.
 
-= Prerequisites
+== Prerequisites
 * Ruby 1.8.2 or later
-* Test::Unit 2.x
+* Test::Unit 2.x (development only)
 
-= Supported Platforms
+== Supported Platforms
 * Windows NT family (NT, 2000, XP, etc)
-* Linux
-* FreeBSD
-* Solaris 2.8+
-* HP-UX
-* OS X
+* Linux 2.6+
+* BSD (various flavors)
+* Solaris 8+
+* HP-UX 10+
+* OS X 10.4+
 
-= Installation
-* rake test (optional)
-* rake install
+== Installation
+=== Rubygems
+gem install sys-proctable
+
+You may need to specify a platform in some cases. For example:
+
+gem install sys-proctable --platform mswin32 # Windows
+gem install sys-proctable --platform sunos   # Solaris
+gem install sys-proctalbe --platform linux   # Linux
+
+=== Standard
+rake install
 
 = Synopsis
    require 'sys/proctable'
@@ -43,24 +52,14 @@
       ...
    end
 
-= Notes 
+== Notes 
    Windows users may pass a host name as a second argument to get process
    information from a different host. This relies on the WMI service running.
 
-   If you're building C source code, the ts_all.rb file is autogenerated for
-   you.
-
-= Known Issues
-=== FreeBSD
-   If you're building on FreeBSD, a standard /proc filesystem read approach is
-   used if mounted. Otherwise, a kvm interface is used. There are more fields
-   available with the kvm interface, but keep in mind that you need to be a
-   member of the kvm group (or root) to use this. You can tweak the extconf.rb
-   file manually if you want to force the issue.
-   
-=== OpenBSD, NetBSD
-   This library will attempt to use the kvm interface. It is untested,
-   however.
+== Known Issues
+=== BSD
+   A kvm interface is used. That means the owner of the process using the
+   sys-proctable library needs to be a member of the kvm group (or root).
 
 === Solaris
    The cmdline member on Solaris is limited to 80 characters unless you (or
@@ -75,27 +74,19 @@
    Proc::ProcessTable module. You can find that module on CPAN. Point your
    browser at http://search.cpan.org.
 
-=== Misc
-   If you build your library as a C extension (which is what will happen if
-   you run the 'build', 'test', or 'install' Rake tasks), then the .rb files
-   file under 'lib/sys/' are renamed to '.orig', except top.rb. This is
-   necessary to prevent mkmf from installing them during a 'make install'.
-
-   The 'clean' Rake task will rename them back to '.rb'.
-
 === Thread Safety
-   I am not currently using a thread-safe version of readdir().  I am not
-   especially concerned about it either.  If you are trying to read information
+   I am not currently using a thread-safe version of readdir(). I am not
+   especially concerned about it either. If you are trying to read information
    out of /proc from different threads at the same time there is something
    seriously wrong with your code logic. Using readdir_r() still won't solve
    all potential thread safety issues anyway.
 
-= Future Plans
+== Future Plans
    Research has indicated that the kvm approach is less favored than a sysctl
    approach on BSD variants. I will try to add this interface in a future
    release.
 
-= Acknowledgements
+== Acknowledgements
    This library is largely based on the Perl module Proc::ProcessTable by
    Dan Urist. Many ideas, as well as large chunks of code, were taken
    from his work. So, a big THANK YOU goes out to Dan Urist.
@@ -109,29 +100,27 @@
    Thanks go to James Hranicky for providing a patch that grabs name, eid,
    euid, gid and guid info in the Linux version, along with some general
    debugging help.
+   
+   Thanks go to David Felstead for the original OS X code.
 
    Finally I'd like to thank all the folks who have submitted bug reports
    and/or patches.
 
-= Help Wanted
-   I do not have access to all platforms. There are a few other major platforms
-   out there, namely AIX, OpenBSD, and IRIX, among others, that I would
-   like to see ports for. There are two ways you can help - either submit code
-   for your particular platform or give me an account on your platform so I can
-   develop on it.
+== Help Wanted
+   I do not have access to all platforms. If your platform is not supported
+   then you will need to either submit a patch or give me a remote account
+   on a box with a compiler so that I can write the code.
 
-= More documentation
+== More documentation
    See the documentation under the 'doc' directory for more information,
    including platform specific notes and issues.
 
-= License
-   Ruby's
+== License
+   Artistic 2.0
     
-= Copyright
+== Copyright
    (C) 2003-2009 Daniel J. Berger
    All Rights Reserved.
 
-= Author
+== Author
    Daniel J. Berger
-   djberg96 at nospam at gmail dot com
-   imperator on IRC (Freenode)

data/Rakefile

@@ -0,0 +1,167 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rbconfig'
+
+desc 'Clean the build files for C versions of sys-proctable'
+task :clean do
+   rm_rf('.test-result') if File.exists?('.test-result')
+   Dir['*.gem'].each{ |f| File.delete(f) }
+   
+   case Config::CONFIG['host_os']
+      when /bsd/i
+        dir = 'ext/bsd'
+      when /darwin/i
+        dir = 'ext/darwin'
+      when /hpux/i
+        dir = 'ext/hpux'
+   end
+
+   unless Config::CONFIG['host_os'] =~ /win32|mswin|dos|cygwin|mingw|linux|sunos|solaris/i
+      Dir.chdir(dir) do
+         if Dir['*.o'].length > 0
+            sh 'make distclean'
+            Dir['sys/proctable.*'].each{ |f| rm(f) if File.extname(f) != '.c' }
+         end
+      end
+   end
+end
+
+desc 'Build the sys-proctable library for C versions of sys-proctable'
+task :build => [:clean] do
+   case Config::CONFIG['host_os']
+      when /bsd/i
+        dir = 'ext/bsd'
+      when /darwin/i
+        dir = 'ext/darwin'
+      when /hpux/i
+        dir = 'ext/hpux'
+   end
+
+   unless Config::CONFIG['host_os'] =~ /win32|mswin|dos|cygwin|mingw|linux|sunos|solaris/i
+      Dir.chdir(dir) do
+         ruby 'extconf.rb'
+         sh 'make'
+         cp 'proctable.' + Config::CONFIG['DLEXT'], 'sys'
+      end
+   end
+end
+
+desc 'Install the sys-proctable library'
+task :install => [:build] do
+   file = nil
+   dir  = File.join(Config::CONFIG['sitelibdir'], 'sys')
+
+   Dir.mkdir(dir) unless File.exists?(dir)
+
+   case Config::CONFIG['host_os']
+      when /mswin|win32|msdos|cygwin|mingw/i
+         file = 'lib/windows/sys/proctable.rb'
+      when /linux/i
+         file = 'lib/linux/sys/proctable.rb'
+      when /sunos|solaris/i
+         file = 'lib/sunos/sys/proctable.rb'
+      when /bsd/i
+         Dir.chdir('ext/bsd'){ sh 'make install' }
+      when /darwin/i
+         Dir.chdir('ext/darwin'){ sh 'make install' }
+      when /hpux/i
+         Dir.chdir('ext/hpux'){ sh 'make install' }
+   end
+
+   cp(file, dir, :verbose => true) if file
+end
+
+desc 'Uninstall the sys-proctable library'
+task :uninstall do
+   case Config::CONFIG['host_os']
+      when /win32|mswin|dos|cygwin|mingw|linux|sunos|solaris/i
+         dir  = File.join(Config::CONFIG['sitelibdir'], 'sys')
+         file = File.join(dir, 'proctable.rb')
+      else
+         dir  = File.join(Config::CONFIG['sitearchdir'], 'sys')
+         file = File.join(dir, 'proctable.' + Config::CONFIG['DLEXT'])
+   end
+
+   rm(file) 
+end
+
+desc 'Run the benchmark suite'
+task :bench => [:build] do
+   sh "ruby -Ilib benchmarks/bench_ps.rb"
+end
+
+desc 'Run the example program'
+task :example => [:build] do
+   sh 'ruby -Ilib -Iext examples/example_ps.rb'
+end
+
+desc 'Run the test suite'
+Rake::TestTask.new do |t|
+   task :test => :build
+   t.libs << 'test'
+   
+   case Config::CONFIG['host_os']
+   when /mswin|msdos|cygwin|mingw/i
+      t.test_files = FileList['test/test_sys_proctable_windows.rb']
+      t.libs << 'lib/windows'
+   when /linux/i
+      t.test_files = FileList['test/test_sys_proctable_linux.rb']
+      t.libs << 'lib/linux'
+   when /sunos|solaris/i
+      t.test_files = FileList['test/test_sys_proctable_sunos.rb']
+      t.libs << 'lib/sunos'
+   when /darwin/i
+      t.libs << 'ext/darwin'
+      t.test_files = FileList['test/test_sys_proctable_darwin.rb']
+   when /bsd/i
+      t.libs << 'ext/bsd'
+      t.test_files = FileList['test/test_sys_proctable_bsd.rb']  
+   when /hpux/i
+      t.libs << 'ext/hpux'
+      t.test_files = FileList['test/test_sys_proctable_hpux.rb']  
+   end
+end
+
+desc 'Create a gem'
+task :gem do
+   spec = eval(IO.read('sys-proctable.gemspec'))
+
+   case Config::CONFIG['host_os']
+      when /bsd/i
+         spec.files << 'ext/bsd/sys/proctable.c'
+         spec.extra_rdoc_files << 'ext/bsd/sys/proctable.c'
+         spec.test_files << 'test/test_sys_proctable_bsd.rb'
+         spec.extensions = ['ext/bsd/extconf.rb']
+      when /darwin/i
+         spec.files << 'ext/darwin/sys/proctable.c'
+         spec.extra_rdoc_files << 'ext/darwin/sys/proctable.c'
+         spec.test_files << 'test/test_sys_proctable_darwin.rb'
+         spec.extensions = ['ext/darwin/extconf.rb']
+      when /hpux/i
+         spec.files << 'ext/hpux/sys/proctable.c'
+         spec.extra_rdoc_files << 'ext/hpux/sys/proctable.c'
+         spec.test_files << 'test/test_sys_proctable_hpux.rb'
+         spec.extensions = ['ext/hpux/extconf.rb']
+      when /linux/i
+         spec.require_paths = ['lib', 'lib/linux']
+         spec.files += ['lib/linux/sys/proctable.rb']
+         spec.test_files << 'test/test_sys_proctable_linux.rb'
+      when /sunos|solaris/i
+         spec.require_paths = ['lib', 'lib/sunos']
+         spec.files += ['lib/sunos/sys/proctable.rb']
+         spec.test_files << 'test/test_sys_proctable_sunos.rb'
+      when /mswin|win32|dos|cygwin|mingw/i
+         spec.require_paths = ['lib', 'lib/windows']
+         spec.files += ['lib/windows/sys/proctable.rb']
+         spec.test_files << 'test/test_sys_proctable_windows.rb'
+   end
+
+   Gem::Builder.new(spec).build
+end
+
+desc 'Install the sys-proctable library as a gem'
+task :install_gem => [:gem] do
+   gem_name = Dir['*.gem'].first
+   sh "gem install #{gem_name}"
+end

data/benchmarks/bench_ps.rb

@@ -0,0 +1,21 @@
+########################################################################
+# bench_ps.rb
+#
+# Benchmark program to show overall speed and compare the block form
+# versus the non-block form. You should run this benchmark via the
+# 'rake bench' Rake task.
+########################################################################
+require 'benchmark'
+require 'sys/proctable'
+
+MAX = 10
+
+Benchmark.bm do |bench|
+   bench.report("Block form"){
+      MAX.times{ Sys::ProcTable.ps{} }
+   }
+
+   bench.report("Non-block form"){
+      MAX.times{ Sys::ProcTable.ps }
+   }
+end

data/doc/top.txt

@@ -7,9 +7,8 @@
 
 = Synopsis
    require "sys/top"
-   include Sys
 
-   Top.top(5).each{ |ps|
+   Sys::Top.top(5).each{ |ps|
       p ps
    }
 	
@@ -18,7 +17,7 @@ VERSION
    Returns the version number of this package as a String.
 	
 = Class Methods
-Top.top(number=10, field="pctcpu")
+Sys::Top.top(number=10, field="pctcpu")
    Returns an array of ProcTableStruct's.  The size of the array (i.e. the
    number of processes) that it returns is based on +number+, and sorted by
    +pctcpu+.  By default, the size and field values are 10 and "pctcpu",
@@ -33,7 +32,7 @@ Top.top(number=10, field="pctcpu")
    http://www.rubyforge.org/projects/sysutils
 	
 = License
-   Ruby's
+   Artistic 2.0
 	
 = Copyright
    (C) 2004-2009 Daniel J. Berger
@@ -45,6 +44,4 @@ Top.top(number=10, field="pctcpu")
    warranties of merchantability and fitness for a particular purpose.
 
 = Author
-   Daniel J. Berger
-   djberg96 at nospam at gmail dot com
-   imperator on IRC (Freenode)
+   Daniel J. Berger

data/examples/example_ps.rb

@@ -0,0 +1,20 @@
+#######################################################################
+# example_ps.rb
+#
+# Generic test program that demonstrates the use of ProcTable.ps. You
+# can run this via the 'rake example' task.
+#
+# Modify as you see fit
+#######################################################################
+require 'sys/proctable'
+include Sys
+
+puts "VERSION: " + ProcTable::VERSION
+sleep 2
+
+ProcTable.ps{ |s|
+   ProcTable.fields.each{ |field|
+      puts "#{field}: " + s.send(field).to_s    
+   }
+   puts '=' * 30
+}

data/lib/{sys → linux/sys}/proctable.rb

@@ -3,12 +3,14 @@ module Sys
 
    # The ProcTable class encapsulates process table information.
    class ProcTable
+
+      class Error < StandardError; end
       
       # There is no constructor
       private_class_method :new
 
       # The version of the sys-proctable library
-      VERSION = '0.8.1'
+      VERSION = '0.9.0'
 
       private
 

data/lib/sys/top.rb

@@ -18,9 +18,11 @@ module Sys
       # 
       def self.top(num=10, field='pctcpu')
          field = field.to_s if field.is_a?(Symbol)
+         
+         windows = /mswin|win32|dos|cygwin|mingw/i
 
          # Sort by pid on Windows by default
-         if Config::CONFIG['host_os'].match('mswin') && field == 'pctcpu'
+         if Config::CONFIG['host_os'].match(windows) && field == 'pctcpu'
             field = 'pid'
          end
          

data/sys-proctable.gemspec

@@ -0,0 +1,40 @@
+require 'rubygems'
+require 'rbconfig'
+
+Gem::Specification.new do |gem|
+   gem.name       = 'sys-proctable'
+   gem.version    = '0.8.2'
+   gem.author     = 'Daniel J. Berger'
+   gem.license    = 'Artistic 2.0' 
+   gem.email      = 'djberg96@gmail.com'
+   gem.homepage   = 'http://www.rubyforge.org/projects/sysutils'
+   gem.platform   = Gem::Platform::CURRENT
+   gem.summary    = 'An interface for providing process table information'
+   gem.has_rdoc   = true
+   gem.test_files = ['test/test_sys_proctable_all.rb']
+   
+   # Additional files for your platform are added by the 'rake gem' task.
+   gem.files = [
+      'benchmarks/bench_ps.rb',
+      'examples/example_ps.rb',
+      'lib/sys/top.rb',
+      'CHANGES',
+      'MANIFEST',
+      'Rakefile',
+      'README',
+      'sys-proctable.gemspec'
+   ]
+
+   gem.rubyforge_project = 'sysutils'
+   gem.extra_rdoc_files  = ['CHANGES', 'README', 'MANIFEST', 'doc/top.txt']
+
+   gem.add_development_dependency('test-unit', '>= 2.0.3')
+
+   gem.description = <<-EOF
+      The sys-proctable library provides an interface for gathering information
+      about processes on your system, i.e. the process table. Most major
+      platforms are supported and, while different platforms may return
+      different information, the external interface is identical across
+      platforms.
+   EOF
+end

data/test/test_sys_proctable_all.rb

@@ -23,7 +23,7 @@ class TC_ProcTable_All < Test::Unit::TestCase
    end
 
    def test_version
-      assert_equal('0.8.1', ProcTable::VERSION)
+      assert_equal('0.9.0', ProcTable::VERSION)
    end
 
    def test_fields
@@ -69,6 +69,11 @@ class TC_ProcTable_All < Test::Unit::TestCase
    def test_new_not_allowed
       assert_raise(NoMethodError){ Sys::ProcTable.new }
    end
+
+   def test_error_class_defined
+      assert_not_nil(Sys::ProcTable::Error)
+      assert_kind_of(StandardError, Sys::ProcTable::Error.new)
+   end
    
    def teardown
       @pid  = nil

data/test/test_sys_proctable_linux.rb

@@ -224,7 +224,7 @@ class TC_ProcTable_Linux < Test::Unit::TestCase
 
    def test_wchan
       assert_respond_to(@ptable, :wchan)
-      assert_kind_of(Fixnum, @ptable.wchan)
+      assert_kind_of(Numeric, @ptable.wchan)
    end
 
    def test_nswap

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: sys-proctable
 version: !ruby/object:Gem::Version 
-  version: 0.8.1
+  version: 0.8.2
 platform: x86-linux
 authors: 
 - Daniel J. Berger
@@ -9,20 +9,20 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-01-29 00:00:00 -07:00
+date: 2010-04-23 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: test-unit
-  type: :runtime
+  type: :development
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 2.0.2
+        version: 2.0.3
     version: 
-description: An interface for providing process table information
+description: "      The sys-proctable library provides an interface for gathering information\n      about processes on your system, i.e. the process table. Most major\n      platforms are supported and, while different platforms may return\n      different information, the external interface is identical across\n      platforms.\n"
 email: djberg96@gmail.com
 executables: []
 
@@ -33,28 +33,33 @@ extra_rdoc_files:
 - README
 - MANIFEST
 - doc/top.txt
-- doc/linux.txt
 files: 
+- benchmarks/bench_ps.rb
+- examples/example_ps.rb
 - lib/sys/top.rb
-- test/test_sys_proctable_all.rb
 - CHANGES
-- README
 - MANIFEST
+- Rakefile
+- README
+- sys-proctable.gemspec
+- test/test_sys_proctable_all.rb
 - doc/top.txt
-- lib/sys/proctable.rb
-- doc/linux.txt
+- lib/linux/sys/proctable.rb
 has_rdoc: true
 homepage: http://www.rubyforge.org/projects/sysutils
+licenses: 
+- Artistic 2.0
 post_install_message: 
 rdoc_options: []
 
 require_paths: 
 - lib
+- lib/linux
 required_ruby_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      version: 1.8.2
+      version: "0"
   version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
@@ -65,9 +70,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: sysutils
-rubygems_version: 1.3.1
+rubygems_version: 1.3.3
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: An interface for providing process table information
 test_files: 
 - test/test_sys_proctable_all.rb

data/doc/linux.txt

@@ -1,83 +0,0 @@
-= Description
-   A Ruby interface for gathering process table information. This is a pure
-   Ruby implementation that reads data out of your /proc filesystem.
-
-= Synopsis
-   require 'sys/proctable'
-   include Sys
-
-   # Everything
-   ProcTable.ps{ |p|
-      puts p.pid.to_s
-      puts p.comm
-      ...
-   }
-
-   or
-
-   # Just one process
-   p = ProcTable.ps(2123)
-   puts p.pid.to_s
-   puts p.comm
-   ...
-
-   or
-
-   # 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's or processes are included as arguments, in block form it
-   returns a struct of type ProcTableStruct for every process in the proc
-   table.  Otherwise it returns an array of ProcTableStruct's.
-
-   If a process id is provided, a single ProcTable struct is returned, or
-   nil if the pid is not found.
-
-= Exception Classes
-ProcTable::Error < StandardError
-   Raised if the /proc field is unreadable and/or unmounted.
-
-= Supported fields
-   You can view the supported fields with the "fields()" class method.
-
-= Future Plans
-   None at this time. Please post any feature requests on the project page
-   at http://www.rubyforge.org/projects/sysutils.
-
-= Known Bugs
-   None known.  Please log any bugs on the project page at
-   http://www.rubyforge.org/projects/sysutils
-
-= License
-   Ruby's
-
-= Copyright
-   (C) 2003-2009 Daniel J. Berger
-    All Rights Reserved
-    
-= Warranty
-   This package is provided "as is" and without any express 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(5)