sys-proctable 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 00ee6aa318ca856d8b83e26685289b1c3eae3817
-  data.tar.gz: 4af42eeef3367f56b8c6ec9383393ba16900af3e
+SHA256:
+  metadata.gz: cb96b1cfb746706244c26f2ce85f54740163cb9f9174237fd06767849ca62cb8
+  data.tar.gz: f8b0b6d47efb86e64a630331a3408deb5baf2a6c8b1256bf55a0bad76f9c17c7
 SHA512:
-  metadata.gz: 7ce22a2caf51c2909024450fad56c15f3ca4d895524b70b6cc7584da8786055fb8a1b2c9b7fe80aadb88d18065d1470368c51d1b0dbb7ccbf34318ab2144d487
-  data.tar.gz: d81c7f01727cf1521374410b9c473c82b6d5b04d92315d5e4427346c91eead836f43f70b46979e1df6f3eaa858a1677e95e2141bfae737cb75691aee507b77b3
+  metadata.gz: 72bf0ffb98c4362deeb9506c6d2f50147c327fe0862575b06f5de1d342e6c9b3a7d5a0fd9a51d69e15cd2f1f68f8d8a9d67ceba12b8a8350f123498b759c4ac0
+  data.tar.gz: 9acdc748cffeee40be36cff671b9f8057ec7fd9f416609f326882c28dfa5b9dd4fddba07a56ed9d64fe9d27b2743c242a3a9b04f902a2f9c3b442ab4ca38a2e1

data/CHANGES

@@ -1,6 +1,15 @@
+== 1.2.1 - 8-Jun-2018
+* The code for OSX is now more efficient when a pid argument is provided.
+  Thanks go to Nick LaMuro for his efforts.
+* Added metadata to the gemspec.
+* Switched the README (now README.md) to markdown format. Thanks go to
+  Tim Meusel for the update.
+* Updated the cert. Should be good for ten years now.
+
 == 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.
+  As part of this change, support for Ruby < 2.0 has been dropped.
 * 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

data/README.md

@@ -0,0 +1,158 @@
+# sys-proctable
+
+## Description
+
+  A Ruby interface for gathering process information.
+
+## Prerequisites
+
+* RSpec 3.x (development only)
+
+## Supported Platforms
+
+* Windows 2000 or later
+* Linux 2.6+
+* FreeBSD
+* Solaris 8+
+* OS X 10.7+
+* AIX 5.3+
+
+## Installation
+
+```sh
+gem install sys-proctable
+```
+
+For version 1.1.5 or earlier, you may need to specify a platform in some cases. For example:
+
+```sh
+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
+
+```ruby
+require 'sys/proctable'
+include Sys
+
+# Everything
+ProcTable.ps{ |p|
+  puts p.pid.to_s
+  puts p.comm
+  # ...
+}
+
+# Just one process
+s = ProcTable.ps(pid: 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
+
+Various platforms support different options. Mostly this is to let you
+skip the collection of certain bits of information in order to improve
+speed and/or reduce memory. For example on Linux you can do this to
+skip the collection of smaps information:
+
+```ruby
+Sys::ProcTable.ps(smaps: false)
+```
+
+Windows users may send a host name to get process information from a
+different host. This relies on the WMI service running.
+
+```ruby
+Sys::ProcTable.ps(host: some_host)
+```
+
+## 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
+
+For version 1.1.5 or earlier, Bundler seems to have trouble installing the
+proper gem because of the platform specific gem names. To deal with that,
+run this command first:
+
+```sh
+bundle config specific_platform true
+```
+
+You should not have to do this for version 1.2.0 or later.
+
+### 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.
+
+### OS X
+
+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
+
+Support for Solaris will probably be dropped in the next major release.
+
+## 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-2018 Daniel J. Berger
+All Rights Reserved.
+
+## Author
+
+Daniel J. Berger

data/lib/darwin/sys/proctable.rb

@@ -174,66 +174,98 @@ module Sys
     #
     def self.ps(**kwargs)
       pid = kwargs[:pid]
-      raise TypeError unless pid.is_a?(Numeric) if pid
+      thread_info = kwargs[:thread_info]
 
-      num = proc_listallpids(nil, 0)
-      ptr = FFI::MemoryPointer.new(:pid_t, num)
-      num = proc_listallpids(ptr, ptr.size)
-
-      raise SystemCallError.new('proc_listallpids', FFI.errno) if num == 0
-
-      pids  = ptr.get_array_of_int32(0, num).sort
-      array = block_given? ? nil : []
-
-      pids.each do |lpid|
-        next unless pid == lpid if pid
+      if pid
+        raise TypeError unless pid.is_a?(Numeric)
         info = ProcTaskAllInfo.new
 
-        nb = proc_pidinfo(lpid, PROC_PIDTASKALLINFO, 0, info, info.size)
+        nb = proc_pidinfo(pid, PROC_PIDTASKALLINFO, 0, info, info.size)
 
         if nb <= 0
           if [Errno::EPERM::Errno, Errno::ESRCH::Errno].include?(FFI.errno)
-            next # Either we don't have permission, or the pid no longer exists
+            return # Either we don't have permission, or the pid no longer exists
           else
             raise SystemCallError.new('proc_pidinfo', FFI.errno)
           end
         end
 
-        # Avoid potentially invalid data
-        next if nb != info.size
+        return nil if nb != info.size # Invalid data
 
         struct = ProcTableStruct.new
 
         # Pass by reference
-        get_cmd_args_and_env(lpid, struct)
-        get_thread_info(lpid, struct, info[:ptinfo]) unless kwargs[:thread_info] == false
-
-        # Chop the leading xx_ from the FFI struct members for our ruby struct.
-        info.members.each do |nested|
-          info[nested].members.each do |member|
-            if info[nested][member].is_a?(FFI::StructLayout::CharArray)
-              struct[PROC_STRUCT_FIELD_MAP[member]] = info[nested][member].to_s
+        get_cmd_args_and_env(pid, struct)
+        get_thread_info(pid, struct, info[:ptinfo]) unless thread_info == false
+        apply_info_to_struct(info, struct)
+
+        struct.freeze
+        yield struct if block_given?
+        struct
+      else
+        num = proc_listallpids(nil, 0)
+        ptr = FFI::MemoryPointer.new(:pid_t, num)
+        num = proc_listallpids(ptr, ptr.size)
+
+        raise SystemCallError.new('proc_listallpids', FFI.errno) if num == 0
+
+        pids  = ptr.get_array_of_int32(0, num).sort
+        array = block_given? ? nil : []
+
+        pids.each do |lpid|
+          next unless pid == lpid if pid
+          info = ProcTaskAllInfo.new
+
+          nb = proc_pidinfo(lpid, PROC_PIDTASKALLINFO, 0, info, info.size)
+
+          if nb <= 0
+            if [Errno::EPERM::Errno, Errno::ESRCH::Errno].include?(FFI.errno)
+              next # Either we don't have permission, or the pid no longer exists
             else
-              struct[PROC_STRUCT_FIELD_MAP[member]] = info[nested][member]
+              raise SystemCallError.new('proc_pidinfo', FFI.errno)
             end
           end
-        end
 
-        struct.freeze
+          # Avoid potentially invalid data
+          next if nb != info.size
 
-        if block_given?
-          yield struct
-        else
-          array << struct
+          struct = ProcTableStruct.new
+
+          # Pass by reference
+          get_cmd_args_and_env(lpid, struct)
+          get_thread_info(lpid, struct, info[:ptinfo]) unless thread_info == false
+          apply_info_to_struct(info, struct)
+
+          struct.freeze
+
+          if block_given?
+            yield struct
+          else
+            array << struct
+          end
         end
-      end
 
-      return nil if array.nil?
-      pid ? array.first : array
+        array
+      end
     end
 
     private
 
+    # Pass by reference method that updates the Ruby struct based on the FFI struct.
+    #
+    def self.apply_info_to_struct(info, struct)
+      # Chop the leading xx_ from the FFI struct members for our ruby struct.
+      info.members.each do |nested|
+        info[nested].members.each do |member|
+          if info[nested][member].is_a?(FFI::StructLayout::CharArray)
+            struct[PROC_STRUCT_FIELD_MAP[member]] = info[nested][member].to_s
+          else
+            struct[PROC_STRUCT_FIELD_MAP[member]] = info[nested][member]
+          end
+        end
+      end
+    end
+
     # Returns an array of ThreadInfo objects for the given pid.
     #
     def self.get_thread_info(pid, struct, ptinfo)

data/lib/sys/proctable/version.rb

@@ -1,6 +1,6 @@
 module Sys
   class ProcTable
     # The version of the sys-proctable library
-    VERSION = '1.2.0'.freeze
+    VERSION = '1.2.1'.freeze
   end
 end

data/spec/sys_proctable_all_spec.rb

@@ -16,7 +16,7 @@ describe Sys::ProcTable do
   end
 
   it "has a VERSION constant set to the expected value" do
-    expect(Sys::ProcTable::VERSION).to eql('1.2.0')
+    expect(Sys::ProcTable::VERSION).to eql('1.2.1')
   end
 
   it "defines a custom error class" do

data/sys-proctable.gemspec

@@ -2,7 +2,7 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name       = 'sys-proctable'
-  spec.version    = '1.2.0'
+  spec.version    = '1.2.1'
   spec.author     = 'Daniel J. Berger'
   spec.license    = 'Apache 2.0'
   spec.email      = 'djberg96@gmail.com'
@@ -18,16 +18,25 @@ Gem::Specification.new do |spec|
     'CHANGES',
     'MANIFEST',
     'Rakefile',
-    'README',
+    'README.md',
     'sys-proctable.gemspec'
   ]
 
-  spec.extra_rdoc_files  = ['CHANGES', 'README', 'MANIFEST', 'doc/top.txt']
+  spec.extra_rdoc_files  = ['CHANGES', 'README.md', 'MANIFEST', 'doc/top.txt']
 
   spec.add_dependency('ffi')
   spec.add_development_dependency('rspec')
   spec.add_development_dependency('rake')
 
+  spec.metadata = {
+    'homepage_uri'      => 'https://github.com/djberg96/sys-proctable',
+    'bug_tracker_uri'   => 'https://github.com/djberg96/sys-proctable/issues',
+    'changelog_uri'     => 'https://github.com/djberg96/sys-proctable/blob/master/CHANGES',
+    'documentation_uri' => 'https://github.com/djberg96/sys-proctable/wiki',
+    'source_code_uri'   => 'https://github.com/djberg96/sys-proctable',
+    'wiki_uri'          => 'https://github.com/djberg96/sys-proctable/wiki'
+  }
+
   spec.description = <<-EOF
     The sys-proctable library provides an interface for gathering information
     about processes on your system, i.e. the process table. Most major

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sys-proctable
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -12,30 +12,30 @@ cert_chain:
   -----BEGIN CERTIFICATE-----
   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
-  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
+  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
-  bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBAOFYobQ3ovXNC4RexrdP
-  malr3eyK6lvQuS5DOQpHQrT3sRbrhAy5c2effNmznnUzDDGnHs+ZKkAeVmUDIi+K
-  lfXjV8uPEkLMXUpDndg9rbmQmfie07ixCdE9JYRPwfMTcE+jbtUyZqEUIg7XYmuJ
-  j28bgsq7I9SMOPS9I+3DiEK50NzGd1ixA+RW8yfApC0jU6KkBQBekETvgQ2OOEH+
-  RwoQqLQ2OpujQsmiofRyvpm3i8DNaQ5Awx7dnCrX9M98KxKHrBuAGARUQl6xh7nU
-  vebWtf6p348oBopTwav0fulZ7zF54B0zVWUTBwHP4q9ulOfHYjqUUfu6NixtNisd
-  Qv4Dp82Qi12aeTd4KGBlbnNHSM+SENKlOydE3+ROEUHK+G6LjccwxBHtFMCjCjaD
-  PAH4f+RtfeuBFUJDzQKrM4dfosVHnAoILL4jv4rJNDvkdj7TD2qF1MZblbhc2R5W
-  Ap4PN2gtzmPAyAe1PXf6dT/Jd2b4GNgxYXLCDOufZDviLQIDAQABo3cwdTAJBgNV
-  HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUhSCp+aIknYPSqLCGAaPvJN4n
-  BZYwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
-  YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAQCx5R3MfmTTZAd9+
-  RjqLjSzoaFEnqrhZCpuHzY9xEHmSldwHlzwLy60i4CHP7GySmlzTNZNJmPEG0ev5
-  YGXeRygkbN0x2pvCPdXHwcU4POTlM2JDntLIjWxNkOI9l9QNixuBrliqQ7UCMRkz
-  z+2K66CGGps2pGEPYU1hp0vjn4bQOyM1tPx5GothXvY5E8nd5mWuBjl3EmDLSIeC
-  AEA054SX5fumB3x83fLXQMl4Yw9nje/d8PkJgOUJOfCi5+P2I/YJ5YhjHpozvspN
-  cphsPbIxhkkKY+8YKXQRoHZPNuu0QdMHH6gvYTdjLmz9s4MICkp0Kg5UmWL96oCR
-  IZqb0JCjioPrrG3n/WV/ix5rPQ9MffHVPDFRD4wlbazwYn+A+KB0TxXJndHY9e6x
-  u7vZCyU93PFHpp/w270tu8VbayZSbmxF/oCsRuzWD0+xVsgLejqfWBbyGqwis995
-  p1I1Aujksa9wuoPhNNl8J4zKV1YtYorUDA44xq1iJEUE+ChB
+  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
   -----END CERTIFICATE-----
-date: 2018-02-20 00:00:00.000000000 Z
+date: 2018-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -90,7 +90,7 @@ executables: []
 extensions: []
 extra_rdoc_files:
 - CHANGES
-- README
+- README.md
 - MANIFEST
 - doc/top.txt
 files:
@@ -112,12 +112,18 @@ files:
 - CHANGES
 - MANIFEST
 - Rakefile
-- README
+- README.md
 - sys-proctable.gemspec
 homepage: http://github.com/djberg96/sys-proctable
 licenses:
 - Apache 2.0
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/djberg96/sys-proctable
+  bug_tracker_uri: https://github.com/djberg96/sys-proctable/issues
+  changelog_uri: https://github.com/djberg96/sys-proctable/blob/master/CHANGES
+  documentation_uri: https://github.com/djberg96/sys-proctable/wiki
+  source_code_uri: https://github.com/djberg96/sys-proctable
+  wiki_uri: https://github.com/djberg96/sys-proctable/wiki
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -134,7 +140,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: An interface for providing process table information

data/README

@@ -1,120 +0,0 @@
-== 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.
-
-=== OS X
-  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-2016 Daniel J. Berger
-  All Rights Reserved.
-
-== Author
-  Daniel J. Berger