sys-proctable 0.7.6 → 1.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 00ee6aa318ca856d8b83e26685289b1c3eae3817
+  data.tar.gz: 4af42eeef3367f56b8c6ec9383393ba16900af3e
+SHA512:
+  metadata.gz: 7ce22a2caf51c2909024450fad56c15f3ca4d895524b70b6cc7584da8786055fb8a1b2c9b7fe80aadb88d18065d1470368c51d1b0dbb7ccbf34318ab2144d487
+  data.tar.gz: d81c7f01727cf1521374410b9c473c82b6d5b04d92315d5e4427346c91eead836f43f70b46979e1df6f3eaa858a1677e95e2141bfae737cb75691aee507b77b3

data.tar.gz.sig

@@ -0,0 +1 @@
+�t����+�xe`��~kĂ��x�U�y��@�&��o�}��_�����z-FX�w��^���c#-vNP���k-9��cSQ��l"�)�{L���n�׌���!�R�9���r�����{�3��J��7�Y�ˆ8ٲ�<�5�e�tq  O�rۏ�y�A3j/��\�x����X`�m"�f�GZ���×�'w�ސ��|��{D�nw8R2���S�0S�7��Spؼ�p)��ɴn�/��hь�ݨ�����6�}�p_a�ͫ�s��кO��� �8���/��A��!����ι2��}�ޑA��=#X�=�A����v�Y�%?����2�ƥ�Z	H�,���*m'�sv4��Ģ��\�{(�(J�qC��ĥ��

data/CHANGES

@@ -1,3 +1,168 @@
+== 1.2.0 - 20-Feb-2018
+* There has been an API change. The ProcTable.ps method now uses keyword
+  arguments. The 'pid' option is universal, the rest depend on the platform.
+* Support for HP-UX has been dropped, both because it was the last remaining
+  platform that still used C code, and because it's basically a dead platform.
+* There are no more platform-specific gems. There is now a single gem that
+  will load the appropriate code based on your host's operating system.
+* The tests were switched from test-unit to rspec.
+* Lots of Rakefile updates based on the above changes.
+* The cert was updated.
+
+== 1.1.5 - 10-Aug-2017
+* Fixed a warning that cropped up in Ruby 2.4.x because I was type checking
+  against Fixnum. Those have been replaced with Numeric.
+
+== 1.1.4 - 30-Mar-2017
+* Fixed a potential issue where OSX could return a struct with invalid data.
+* Set the default field to :pid for OSX when using Sys::Top.
+* Fixed a duplicate test warning for OSX.
+
+== 1.1.3 - 28-Sep-2016
+* Fixed an issue on OSX where the value returned for argc is invalid.
+
+== 1.1.2 - 18-Sep-2016
+* Fixed cmdline parsing and handling for OSX. Thanks go to Ben Mathwig for
+  the spot and the patch.
+
+== 1.1.1 - 30-Jun-2016
+* Added thread information for OS X.
+* Fixed VERSION constant for HP-UX.
+
+== 1.1.0 - 27-Jun-2016
+* License was changed to Apache 2.0.
+* The OS X version now requires OS X 10.7 or later.
+* Scrapped the C implementation for OS X, and replaced it with a libproc wrapper
+  using FFI, so it is now pure Ruby. Note that some new struct members have been
+  added, while others have been dropped. This includes pctcpu, so Sys::Top does
+  not work at the moment.
+* Rakefile updates to accomodate the changes for OS X.
+* Some test suite updates and refactoring.
+
+== 1.0.0 - 11-Jan-2016
+* Added smaps information for Linux. Thanks go to Joe Rafaniello for the patch.
+* This really should not have been a major release, sorry.
+
+== 0.9.9 - 8-Nov-2015
+* Added support for cgroups on Linux. Thanks go to Dennis Günnewig for the patch.
+* Added a sys-proctable.rb file for convenience.
+* This gem is now signed.
+* Gem related tasks in the Rakefile now assume Rubygems 2.x.
+
+== 0.9.8 - 18-Apr-2015
+* Fixed a bug in the gemspec. Last version got yanked.
+
+== 0.9.7 - 18-Apr-2015
+* Fixed a bug in the OSX code that could cause the ps method to fail. Thanks
+  go to Koshevoy Anton for the spot.
+* Some internal refactoring of version handling. Now all platforms use a
+  single version file.
+* Replaced vm_size_t and lwpid_t with universal data types on FreeBSD because
+  FFI on FreeBSD 10 no longer understands them. Thanks go to Mike Owens for
+  the spot.
+
+== 0.9.6 - 24-Feb-2015
+* Added NLWP field on Linux. Thanks go to Rich Chatterton for the patch.
+
+== 0.9.5 - 10-Feb-2015
+* Significant cleanup and memory reduction of the OSX code. Thanks go
+  to Ivan (toy) for the patches.
+* Skip over /proc/<file>/status if unreadable on Linux. Thanks go to Jianjun
+  Mao for the patch.
+
+== 0.9.4 - 4-Mar-2014
+* Added support for AIX 5.3 or later courtesy of Rick Ohnemus.
+* The Solaris version now uses FFI structs instead of a packed array.
+  It solved issues with 64-bit versions of Ruby and it's self-documenting.
+* The FreeBSD version has been converted to use FFI. In addition, additional
+  struct members have been added, and members that previously returned nil
+  now return meaningful data.
+* Support for NetBSD and OpenBSD has been temporarily dropped. Considering
+  that the C code did not build on those platforms anyway, I doubt most of
+  you will notice. Patches for those platforms are welcome, but only using FFI.
+
+== 0.9.3 - 17-Mar-2013
+* Fixed a bug on OSX where a long command string arg could cause
+  a segfault. Thanks go to Nathaniel Bibler for the spot.
+* Changed the gem platform from mingw to mingw32 for Windows.
+
+== 0.9.2 - 8-Oct-2012
+* Added cmdline support for OS X. Thanks go to Matthias Zirnstein for
+  the patch.
+* Warning cleanup for 1.9.
+* Updated the gem platform handling. Replaced the borked string approach
+  with a two element array for Gem::Platform.new.
+* MS date strings are now parse with DateTime instead of Date.
+
+== 0.9.1 - 3-Aug-2011
+* Added the pctcpu and pctmem members for Linux.
+* Added Errno::ESRCH to a rescue clause on Linux that fixed a bug
+  where a missing entry wasn't being skipped when run as root. Thanks
+  go to Austin Ziegler for the spot and patch.
+* Fixed a build warning for Darwin.
+* Updates to the test suite for both Darwin and Linux.
+* Added an explicit type check for BSD for pids.
+* Added nicer error messages for BSD if kvm_open fails.
+* Added .core files to the clean task.
+* Altered the platform settings in the Rakefile so that generated gems
+  use 'universal' platform architectures for any particular operating system.
+
+== 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
+  merely skip to the next record, i.e. it's all or nothing. Thanks go to
+  Heejong Lee for the spot and patch.
+* Fixed a bug in the Linux version where embedded nulls were not being
+  stripped out of the cmdline data.
+* Added the comm alias back to the Solaris version. Thanks go to Jun Young Kim
+  for the spot.
+
+== 0.8.0 - 26-Jan-2009
+* The Linux and Solaris versions of this library are now pure Ruby. Be warned,
+  however, that only Solaris 8 and later are now supported. This may change
+  in a future release if there's demand to support 2.6 and 2.7.
+* Some Struct::ProcTableStruct members have changed. As a general rule they
+  now more closely match the C struct member name. See individual platforms
+  for more details.
+* Bug fix for the cmd_args struct member on Solaris.
+* Bug fixes for OS X. Added a VERSION constant, fixed struct name, and changed
+  pct_cpu to pctcpu.
+* The .new method is now explicitly illegal.
+* The Struct::ProcTableStruct instances are now frozen. This is read-only data.
+* Added the peak_page_file_usage and status members on MS Windows. The status
+  member is always nil, but was added for completeness.
+* Fixed the quota_peak_paged_pool_usage member on MS Windows.
+* ProcTableError is now ProcTable::Error.
+* Minor test case fix for kvm/bsd based versions.
+* Added the 'time' library as a require for Windows (to parse MS date/time
+  format strings).
+* The kvm (bsd.c) implementation now works for FreeBSD 7.
+* Added many more tests.
+* Added some benchmarking code in the 'benchmarks' directory.
+* Added a 'bench' Rake task.
+* Renamed the test_ps.rb file to example_ps.rb in order to avoid any possible
+  confusion with actual test files.
+* Added an 'example' rake task to run the example file.
+
 == 0.7.6 - 11-Jul-2007
 * Fixed the starttime for Linux. Thanks go to Yaroslav Dmitriev for the spot.
 * Fixed a bug in the MS Windows version within a private method that parsed

data/MANIFEST

@@ -1,41 +1,33 @@
-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
-
-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/linux/linux.c
-ext/linux/linux.h
-ext/sunos/sunos.c
-ext/sunos/sunos.h
-ext/version.h
-
-examples/test_ps.rb
-
-lib/top.rb
-
-lib/sys/windows.rb
-
-test/tc_all.rb
-test/tc_freebsd.rb
-test/tc_hpux.rb
-test/tc_linux.rb
-test/tc_sunos.rb
-test/tc_top.rb
-test/tc_windows.rb
-test/tc_kvm_bsd.rb
-test/test_memleak.rb
+* CHANGES
+* MANIFEST
+* Rakefile
+* README
+* sys-proctable.gemspec
+* doc/aix.txt
+* doc/bsd.txt
+* doc/hpux.txt
+* doc/linux.txt
+* doc/solaris.txt
+* doc/top.txt
+* doc/windows.txt
+* example/example_ps.rb
+* ext/hpux/extconf.rb
+* ext/hpux/sys/proctable.c
+* lib/sys-proctable.rb
+* lib/sys/top.rb
+* lib/sys/proctable/version.rb
+* lib/aix/sys/proctable.rb
+* lib/darwin/sys/proctable.rb
+* lib/freebsd/sys/proctable.rb
+* lib/linux/sys/proctable.rb
+* lib/sunos/sys/proctable.rb
+* lib/windows/sys/proctable.rb
+* test/test_sys_proctable_aix.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_linux.rb
+* test/test_sys_proctable_sunos.rb
+* test/test_sys_proctable_windows.rb
+* test/test_sys_top.rb

data/README

@@ -1,140 +1,120 @@
-= Description
-   A Ruby interface for gathering process information.
-
-= Prerequisites
-=== Unix
-   Ruby 1.8.0 or later.
-=== MS Windows
-   Ruby 1.8.2 or later.
-
-= Supported Platforms
-* Windows NT family (NT, 2000, XP, etc)
-* Linux
-* FreeBSD (/proc or kvm)
-* Solaris
-* HP-UX
-* OS X
-
-= Installation
-* rake test (optional)
-* rake install
-
-= 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
-
-= 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
-=== BSD
-   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.
-
-   Not all fields are available on FreeBSD 5.x (yet). OpenBSD and NetBSD are
-   not yet supported.
+== Description
+  A Ruby interface for gathering process information.
+
+== Prerequisites
+* Test::Unit 2.x (development only)
+
+== Supported Platforms
+* Windows 2000 or later
+* Linux 2.6+
+* FreeBSD
+* Solaris 8+
+* HP-UX 10+
+* OS X 10.7+
+* AIX 5.3+
+
+== Installation
+  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-proctable --platform linux   # Linux
+  gem install sys-proctable --platform freebsd # FreeBSD
+  gem install sys-proctable --platform darwin  # OS X
+
+== Synopsis
+  require 'sys/proctable'
+  include Sys
+
+  # Everything
+  ProcTable.ps{ |p|
+    puts p.pid.to_s
+    puts p.comm
+    # ...
+  }
+
+  # 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 p.pid
+    # ...
+  end
+
+== 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.
+
+== Known Issues
+=== FreeBSD
+  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).
+
+=== Bundler
+  Bundler seems to have trouble installing the proper gem because of the
+  platform specific gem names. To deal with that, run this command first:
+
+    bundle config specific_platform true
+
+  You can follow the issue at:
+
+    https://github.com/bundler/bundler/issues/5536  
 
 === Solaris
-   The cmdline member on solaris is limited to 80 characters unless you (or
-   your program) own the process. This is a Solaris design flaw/feature.
+  The cmdline member on Solaris is limited to 80 characters unless you (or
+  your program) own the process. This is a Solaris design flaw/feature.
 
 === OS X
-   At the moment you do not get the full command line string. The code required
-   to get this information is obnoxious and I don't have any compelling desire
-   to add it. However, if you're willing to submit a patch I'll accept it.
-
-   You can find a good starting point with the OS X code found in Dan Urist's
-   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 windows.rb
-   file under 'lib/sys/' is renamed to 'windows.orig'. This is necessary to
-   prevent mkmf from auto-installing it during the 'make install' phase.
-
-   The 'clean' Rake task will rename it back to 'windows.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
-   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
-   I'm considering using a pure Ruby version for Linux. 
-
-   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 the 0.8.0
-   release.
-
-= Acknowledgements
-   This package 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.
-
-   A big thanks also goes out to Mike Hall who was very helpful with ideas,
-   logic and testing.
-
-   Thanks also go to Sean Chittenden for providing an account on one of his
-   FreeBSD machines. This is how the FreeBSD support was (initially) added.
-
-   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.
-
-   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.
-
-= More documentation
-   See the documentation under the 'doc' directory for your platform for more
-   information, including platform specific notes and issues.
-
-= License
-   Ruby's
+  The libproc interface is used. That means you will only get list of
+  processes that you have access to. To get a full listing, run as root.
+
+== Future Plans
+  Add support for NetBSD and OpenBSD.
+  Convert remaining C code (just HP-UX at this point) to FFI.
+
+== Acknowledgements
+  This library was originally 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.
+
+  A big thanks also goes out to Mike Hall who was very helpful with ideas,
+  logic and testing.
+
+  Thanks also go to Sean Chittenden for providing an account on one of his
+  FreeBSD machines. This is how the FreeBSD support was (initially) added.
+
+  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. Thanks also go
+  to Matthias Zirnstein for adding the original cmdline support for OS X.
+
+  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. 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
+  See the documentation under the 'doc' directory for more information,
+  including platform specific notes and issues.
+
+== License
+  Apache 2.0
     
-= Copyright
-   (C) 2003-2007 Daniel J. Berger
-   All Rights Reserved.
-
-= Author
-   Daniel J. Berger
-   djberg96 at nospam at gmail dot com
-   imperator on IRC (Freenode)
+== Copyright
+  (C) 2003-2016 Daniel J. Berger
+  All Rights Reserved.
+
+== Author
+  Daniel J. Berger