win32-process 0.7.5 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 7abeeac7e3b746666569ab363e702c8939a4a596
-  data.tar.gz: 693447613255756de95668ddfefa702ecc5b9921
+SHA256:
+  metadata.gz: 5f5cdcabac1da0aebf77bd252b0647899dfee2632e34e626f18a9951a9d17e62
+  data.tar.gz: 39382a91f43eba2e0c00f1b92e3f53de3a49b87e689b22683cf5c08f395077b7
 SHA512:
-  metadata.gz: 2a7faa782828c7a8cbbf54f997ded9a3c97023b641417207e03938378520f0072b29e7fc1d11c26307e59c94ff975cdfdfebdbe9cbc0adedf2abe57a1251ecee
-  data.tar.gz: 9a1ba82a14f16365850fbc7e50787c3233fedd3d54307757202dd60d05a9f4057cc4e617d3ad7d97783861c4098ee82c6bfdb56a8d4210d6404aca1a0682e613
+  metadata.gz: fe1ba6453b70b3712322a588b83708c2eb5f657d97e443c974162be290f009488c28ddb57de1212bcb141a57006f6d0db2e59244b19583da21265df2cab35d83
+  data.tar.gz: b38df396da190521cbf3fa0975e8087d6f7435956996716b3fe3416ae0d5565e32787c3794a943a7f74c98cb4d31b8c704882b53f6a88d265c7e334a1da1923b

data/README.md

@@ -0,0 +1,74 @@
+# win32-process
+
+[![Gem Version](https://badge.fury.io/rb/win32-process.svg)](https://badge.fury.io/rb/win32-process)
+
+This library provides analogues of the :getpriority, :setpriority, :getrlimit, :setrlimit and :uid methods for MS Windows. It also adds the new methods :job?, :get_affinity, and :create, and redefines the :kill method.
+
+## Prerequisites
+
+- ffi
+- sys-proctable (dev only)
+- test-unit 2 (dev only)
+
+## Supported Platforms
+
+This library is supported on Windows 2000 or later.
+
+## Installation
+
+```
+gem install win32-process
+```
+
+## Usage
+
+```ruby
+require 'win32/process'
+
+p Process.job? # => true or false
+
+info = Process.create( :app_name => "notepad.exe", :creation_flags => Process::DETACHED_PROCESS, :process_inherit => false, :thread_inherit => true, :cwd => "C:\" )
+
+p info.process_id
+```
+
+## Developer's Notes
+
+### Removal of Process.fork in release 0.7.0
+
+The Process.fork method was originally experimental but it has never been particularly useful in practice. On top of that, it required special implementations of the Process.waitXXX methods, so it was a maintenance issue as well.
+
+With Ruby 1.9 now becoming standard and its addition of Process.spawn and friends (and concomitant support for the Process.waitXXX methods) I felt it was time to remove it.
+
+You can still simulate Process.fork if you like using Process.create, which is how it was implemented internally anyway. A better solution might be to follow in the footsteps of ActiveState Perl, which uses native threads to simulate fork on Windows.
+
+### Changes in the custom Process.kill method for 0.7.0
+
+The Process.kill method in 0.7.0 more closely matches the spec now, but the internal method for killing processes is still nicer for most signals. With the release of 0.7.0 users can now specify options that provide finer control over how a process is killed. See the documentation for details.
+
+## The removal of the custom Process.ppid method
+
+This was added at some point in the Ruby 1.9 dev cycle so it was removed from this library.
+
+## Known Issues
+
+JRuby doesn't seem to like SIGBRK for Process.kill.
+
+Any issues or bugs should be reported on the project page at <https://github.com/djberg96/win32-process>.
+
+## License
+
+Artistic 2.0
+
+## Copyright
+
+(C) 2003-2015 Daniel J. Berger All Rights Reserved
+
+## Warranty
+
+This library 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(s)
+
+- Park Heesob
+- Daniel J. Berger

data/lib/win32-process.rb

@@ -0,0 +1 @@
+require_relative 'win32/process'

data/lib/win32/process.rb

@@ -10,7 +10,7 @@ module Process
   extend Process::Constants
 
   # The version of the win32-process library.
-  WIN32_PROCESS_VERSION = '0.7.5'
+  WIN32_PROCESS_VERSION = '0.9.0'
 
   # Disable popups. This mostly affects the Process.kill method.
   SetErrorMode(SEM_FAILCRITICALERRORS | SEM_NOGPFAULTERRORBOX)
@@ -99,7 +99,7 @@ module Process
       raise TypeError, int unless int.is_a?(Fixnum)   # Match spec
       int = Process.pid if int == 0                   # Match spec
 
-      handle = OpenProcess(PROCESS_QUERY_INFORMATION, false, int)
+      handle = OpenProcess(PROCESS_QUERY_INFORMATION, 0, int)
 
       if handle == 0
         raise SystemCallError, FFI.errno, "OpenProcess"
@@ -141,7 +141,7 @@ module Process
       raise TypeError unless int_priority.is_a?(Integer)  # Match spec
       int = Process.pid if int == 0                       # Match spec
 
-      handle = OpenProcess(PROCESS_SET_INFORMATION, false , int)
+      handle = OpenProcess(PROCESS_SET_INFORMATION, 0 , int)
 
       if handle == 0
         raise SystemCallError, FFI.errno, "OpenProcess"
@@ -256,7 +256,7 @@ module Process
 
       # Put the current process in a job if it's not already in one
       if in_job && defined?(@win32_process_job_name)
-        handle = OpenJobObjectA(JOB_OBJECT_QUERY, true, @win32_process_job_name)
+        handle = OpenJobObjectA(JOB_OBJECT_QUERY, 1, @win32_process_job_name)
         raise SystemCallError, FFI.errno, "OpenJobObject" if handle == 0
       else
         @win32_process_job_name = 'ruby_' + Process.pid.to_s
@@ -347,7 +347,7 @@ module Process
 
       # Put the current process in a job if it's not already in one
       if in_job && defined? @win32_process_job_name
-        handle = OpenJobObjectA(JOB_OBJECT_SET_ATTRIBUTES, true, @win32_process_job_name)
+        handle = OpenJobObjectA(JOB_OBJECT_SET_ATTRIBUTES, 1, @win32_process_job_name)
         raise SystemCallError, FFI.errno, "OpenJobObject" if handle == 0
       else
         @win32_process_job_name = 'ruby_' + Process.pid.to_s
@@ -543,7 +543,7 @@ module Process
       if hash['process_inherit']
         process_security = SECURITY_ATTRIBUTES.new
         process_security[:nLength] = 12
-        process_security[:bInheritHandle] = true
+        process_security[:bInheritHandle] = 1
       end
 
       # Thread SECURITY_ATTRIBUTE structure
@@ -552,7 +552,7 @@ module Process
       if hash['thread_inherit']
         thread_security = SECURITY_ATTRIBUTES.new
         thread_security[:nLength] = 12
-        thread_security[:bInheritHandle] = true
+        thread_security[:bInheritHandle] = 1
       end
 
       # Automatically handle stdin, stdout and stderr as either IO objects
@@ -668,7 +668,7 @@ module Process
           raise SystemCallError.new("CreateProcessWithLogonW", FFI.errno)
         end
       else
-        inherit  = hash['inherit'] || false
+        inherit = hash['inherit'] ? 1 : 0
 
         bool = CreateProcessW(
           app,                    # App name
@@ -741,8 +741,6 @@ module Process
     #   Process.kill(1, 12345, :exit_proc => 'ExitProcess', :module => 'kernel32')
     #
     def kill(signal, *pids)
-      raise SecurityError if $SAFE && $SAFE >= 2 # Match the spec
-
       # Match the spec, require at least 2 arguments
       if pids.length == 0
         raise ArgumentError, "wrong number of arguments (1 for at least 2)"
@@ -814,7 +812,7 @@ module Process
         end
 
         begin
-          handle = OpenProcess(access, false, pid)
+          handle = OpenProcess(access, 0, pid)
 
           if signal != 0 && handle == 0
             raise SystemCallError, FFI.errno, "OpenProcess"
@@ -890,7 +888,7 @@ module Process
     # when stdin, stdout or stderr are set to custom values.
     #
     def get_exitcode(pid)
-      handle = OpenProcess(PROCESS_QUERY_INFORMATION, false, pid)
+      handle = OpenProcess(PROCESS_QUERY_INFORMATION, 0, pid)
 
       if handle == INVALID_HANDLE_VALUE
         raise SystemCallError.new("OpenProcess", FFI.errno)
@@ -914,6 +912,75 @@ module Process
         exitcode
       end
     end
+
+    # Returns a list of process information structs in the form of a hash,
+    # with the pid as the key, and an array of information as the value of
+    # that key. The type of information in that array depends on the
+    # +info_type+ parameter. The possible values for +info_type+, and the
+    # type of information they each return is as follows:
+    #
+    #   :thread  => ThreadSnapInfo[:thread_id, :process_id, :base_priority]
+    #   :heap    => HeapSnapInfo[:address, :block_size, :flags, :process_id, :heap_id]
+    #   :module  => ModuleSnapInfo[:process_id, :address, :module_size, :handle, :name, :path]
+    #   :process => ProcessSnapInfo[:process_id, :threads, :parent_process_id, :priority, :flags, :path]
+    #
+    # If no argument is provided, then :thread is assumed. Note that it is up
+    # to you to filter by pid if you wish.
+    #
+    # Example:
+    #
+    #   # Get all thread info
+    #   Process.snapshot.each{ |pid, v|
+    #     puts "PID: #{pid}"
+    #     p v
+    #   }
+    #
+    #   # Get module info for just the current process
+    #   p Process.snapshot(:module)[Process.pid]
+    #
+    #   # Get heap info for just the current process
+    #   p Process.snapshot(:heap)[Process.pid]
+    #
+    #   # Show pids of all running processes
+    #   p Process.snapshot(:process).keys
+    #
+    def snapshot(info_type = 'thread')
+      case info_type.to_s.downcase
+        when 'thread'
+          flag = TH32CS_SNAPTHREAD
+        when 'heap'
+          flag = TH32CS_SNAPHEAPLIST
+        when 'module'
+          flag = TH32CS_SNAPMODULE
+        when 'process'
+          flag = TH32CS_SNAPPROCESS
+        else
+          raise ArgumentError, "info_type '#{info_type}' unsupported"
+      end
+
+      begin
+        handle = CreateToolhelp32Snapshot(flag, Process.pid)
+
+        if handle == INVALID_HANDLE_VALUE
+          raise SystemCallError.new('CreateToolhelp32Snapshot', FFI.errno)
+        end
+
+        case info_type.to_s.downcase
+          when 'thread'
+            array = get_thread_info(handle)
+          when 'heap'
+            array = get_heap_info(handle)
+          when 'module'
+            array = get_module_info(handle)
+          when 'process'
+            array = get_process_info(handle)
+        end
+
+        array
+      ensure
+        CloseHandle(handle) if handle
+      end
+    end
   end
 
   class << self
@@ -926,6 +993,137 @@ module Process
       bool ? buf.read_string : nil
     end
 
+    # Return thread info for Process.snapshot
+    def get_thread_info(handle, pid = nil)
+      lpte = THREADENTRY32.new
+      lpte[:dwSize] = lpte.size
+
+      hash = Hash.new{ |h,k| h[k] = [] }
+
+      if Thread32First(handle, lpte)
+        hash[lpte[:th32OwnerProcessID]] << ThreadSnapInfo.new(lpte[:th32ThreadID], lpte[:th32OwnerProcessID], lpte[:tpBasePri])
+      else
+        if FFI.errno == ERROR_NO_MORE_FILES
+          return hash
+        else
+          raise SystemCallError.new('Thread32First', FFI.errno)
+        end
+      end
+
+      while Thread32Next(handle, lpte)
+        hash[lpte[:th32OwnerProcessID]] << ThreadSnapInfo.new(lpte[:th32ThreadID], lpte[:th32OwnerProcessID], lpte[:tpBasePri])
+      end
+
+      hash
+    end
+
+    # Return heap info for Process.snapshot
+    def get_heap_info(handle)
+      hash = Hash.new{ |h,k| h[k] = [] }
+
+      hl = HEAPLIST32.new
+      hl[:dwSize] = hl.size
+
+      if Heap32ListFirst(handle, hl)
+        while Heap32ListNext(handle, hl)
+          he = HEAPENTRY32.new
+          he[:dwSize] = he.size
+
+          if Heap32First(he, Process.pid, hl[:th32HeapID])
+            hash[he[:th32ProcessID]] << HeapSnapInfo.new(he[:dwAddress], he[:dwBlockSize], he[:dwFlags], he[:th32ProcessID], he[:th32HeapID])
+          else
+            if FFI.errno == ERROR_NO_MORE_FILES
+              break
+            else
+              raise SystemCallError.new('Heap32First', FFI.errno)
+            end
+          end
+
+          while Heap32Next(he)
+            hash[he[:th32ProcessID]] << HeapSnapInfo.new(he[:dwAddress], he[:dwBlockSize], he[:dwFlags], he[:th32ProcessID], he[:th32HeapID])
+          end
+        end
+      end
+
+      hash
+    end
+
+    # Return module info for Process.snapshot
+    def get_module_info(handle)
+      hash = Hash.new{ |h,k| h[k] = [] }
+
+      me = MODULEENTRY32.new
+      me[:dwSize] = me.size
+
+      if Module32First(handle, me)
+        hash[me[:th32ProcessID]] << ModuleSnapInfo.new(
+          me[:th32ProcessID],
+          me[:modBaseAddr].to_i,
+          me[:modBaseSize],
+          me[:hModule],
+          me[:szModule].to_s,
+          me[:szExePath].to_s
+        )
+      else
+        if FFI.errno == ERROR_NO_MORE_FILES
+          return hash
+        else
+          raise SystemCallError.new('Module32First', FFI.errno)
+        end
+      end
+
+      while Module32Next(handle, me)
+        hash[me[:th32ProcessID]] << ModuleSnapInfo.new(
+          me[:th32ProcessID],
+          me[:modBaseAddr].to_i,
+          me[:modBaseSize],
+          me[:hModule],
+          me[:szModule].to_s,
+          me[:szExePath].to_s
+        )
+      end
+
+      hash
+    end
+
+    # Return process info for Process.snapshot
+    def get_process_info(handle)
+      hash = Hash.new{ |h,k| h[k] = [] }
+
+      pe = PROCESSENTRY32.new
+      pe[:dwSize] = pe.size
+
+      if Process32First(handle, pe)
+        hash[pe[:th32ProcessID]] = ProcessSnapInfo.new(
+          pe[:th32ProcessID],
+          pe[:cntThreads],
+          pe[:th32ParentProcessID],
+          pe[:pcPriClassBase],
+          pe[:dwFlags],
+          pe[:szExeFile].to_s
+        )
+      else
+        if FFI.errno == ERROR_NO_MORE_FILES
+          return hash
+        else
+          raise SystemCallError.new('Process32First', FFI.errno)
+        end
+      end
+
+      while Process32Next(handle, pe)
+        hash[pe[:th32ProcessID]] = ProcessSnapInfo.new(
+          pe[:th32ProcessID],
+          pe[:cntThreads],
+          pe[:th32ParentProcessID],
+          pe[:pcPriClassBase],
+          pe[:dwFlags],
+          pe[:szExeFile].to_s
+        )
+      end
+
+      hash
+    end
+
     # Private method that returns the Windows major version number.
     def windows_version
       ver = OSVERSIONINFO.new

data/lib/win32/process/constants.rb

@@ -110,4 +110,12 @@ module Process::Constants
   # GetExitCodeProcess
 
   STILL_ACTIVE = 259
+
+  # Snapshot constants
+
+  TH32CS_SNAPHEAPLIST = 0x00000001
+  TH32CS_SNAPPROCESS  = 0x00000002
+  TH32CS_SNAPTHREAD   = 0x00000004
+  TH32CS_SNAPMODULE   = 0x00000008
+  ERROR_NO_MORE_FILES = 0x00000018
 end

data/lib/win32/process/functions.rb

@@ -7,10 +7,12 @@ require 'ffi'
 
 module Process::Functions
   module FFI::Library
-    # Wrapper method for attach_function + private
-    def attach_pfunc(*args)
-      attach_function(*args)
-      private args[0]
+    unless instance_methods.include?(:attach_pfunc)
+      # Wrapper method for attach_function + private
+      def attach_pfunc(*args)
+        attach_function(*args)
+        private args[0]
+      end
     end
   end
 
@@ -24,6 +26,7 @@ module Process::Functions
   ffi_lib :kernel32
 
   attach_pfunc :CloseHandle, [:handle], :bool
+  attach_pfunc :CreateToolhelp32Snapshot, [:dword, :dword], :handle
   attach_pfunc :GenerateConsoleCtrlEvent, [:dword, :dword], :bool
   attach_pfunc :GetCurrentProcess, [], :handle
   attach_pfunc :GetModuleHandle, :GetModuleHandleA, [:string], :hmodule
@@ -31,12 +34,22 @@ module Process::Functions
   attach_pfunc :GetPriorityClass, [:handle], :dword
   attach_pfunc :GetProcAddress, [:hmodule, :string], :pointer
   attach_pfunc :GetVersionExA, [:pointer], :bool
+  attach_pfunc :Heap32ListFirst, [:handle, :pointer], :bool
+  attach_pfunc :Heap32ListNext, [:handle, :pointer], :bool
+  attach_pfunc :Heap32First, [:pointer, :dword, :uintptr_t], :bool
+  attach_pfunc :Heap32Next, [:pointer], :bool
+  attach_pfunc :Module32First, [:handle, :pointer], :bool
+  attach_pfunc :Module32Next, [:handle, :pointer], :bool
   attach_pfunc :IsProcessInJob, [:handle, :pointer, :pointer], :bool # 2nd arg optional
-  attach_pfunc :OpenProcess, [:dword, :bool, :dword], :handle
+  attach_pfunc :OpenProcess, [:dword, :int, :dword], :handle
+  attach_pfunc :Process32First, [:handle, :pointer], :bool
+  attach_pfunc :Process32Next, [:handle, :pointer], :bool
   attach_pfunc :SetHandleInformation, [:handle, :dword, :dword], :bool
   attach_pfunc :SetErrorMode, [:uint], :uint
   attach_pfunc :SetPriorityClass, [:handle, :dword], :bool
   attach_pfunc :TerminateProcess, [:handle, :uint], :bool
+  attach_pfunc :Thread32First, [:handle, :pointer], :bool
+  attach_pfunc :Thread32Next, [:handle, :pointer], :bool
   attach_pfunc :WaitForSingleObject, [:handle, :dword], :dword
 
   attach_pfunc :CreateRemoteThread,
@@ -46,12 +59,12 @@ module Process::Functions
     [:string, :pointer, :dword, :pointer, :pointer, :pointer, :pointer, :dword], :bool
 
   attach_pfunc :CreateProcessW,
-    [:buffer_in, :buffer_in, :pointer, :pointer, :bool,
+    [:buffer_in, :buffer_inout, :pointer, :pointer, :int,
      :dword, :buffer_in, :buffer_in, :pointer, :pointer], :bool
 
   attach_pfunc :AssignProcessToJobObject, [:handle, :handle], :bool
   attach_pfunc :CreateJobObjectA, [:pointer, :string], :handle
-  attach_pfunc :OpenJobObjectA, [:dword, :bool, :string], :handle
+  attach_pfunc :OpenJobObjectA, [:dword, :int, :string], :handle
   attach_pfunc :QueryInformationJobObject, [:handle, :int, :pointer, :dword, :pointer], :bool
   attach_pfunc :SetInformationJobObject, [:handle, :int, :pointer, :dword], :bool
   attach_pfunc :GetExitCodeProcess, [:handle, :pointer], :bool
@@ -63,7 +76,7 @@ module Process::Functions
   attach_pfunc :OpenProcessToken, [:handle, :dword, :pointer], :bool
 
   attach_pfunc :CreateProcessWithLogonW,
-    [:buffer_in, :buffer_in, :buffer_in, :dword, :buffer_in, :buffer_in,
+    [:buffer_in, :buffer_in, :buffer_in, :dword, :buffer_in, :buffer_inout,
      :dword, :buffer_in, :buffer_in, :pointer, :pointer], :bool
 
   ffi_lib FFI::Library::LIBC

data/lib/win32/process/helper.rb

@@ -10,4 +10,4 @@ class String
   def to_wide_string!
     replace((self + 0.chr).encode('UTF-16LE'))
   end
-end
+end

data/lib/win32/process/structs.rb

@@ -60,7 +60,7 @@ module Process::Structs
     layout(
       :nLength, :dword,
       :lpSecurityDescriptor, :pointer,
-      :bInheritHandle, :bool
+      :bInheritHandle, :int
     )
   end
 
@@ -108,11 +108,111 @@ module Process::Structs
     )
   end
 
+  class THREADENTRY32 < FFI::Struct
+    layout(
+      :dwSize, :dword,
+      :cntUsage, :dword,
+      :th32ThreadID, :dword,
+      :th32OwnerProcessID, :dword,
+      :tpBasePri, :long,
+      :tpDeltaPri, :long,
+      :dwFlags, :dword
+    )
+  end
+
+  class HEAPLIST32 < FFI::Struct
+    layout(
+      :dwSize, :size_t,
+      :th32ProcessID, :dword,
+      :th32HeapID, :uintptr_t,
+      :dwFlags, :dword
+    )
+  end
+
+  class HEAPENTRY32 < FFI::Struct
+    layout(
+      :dwSize, :size_t,
+      :hHandle, :handle,
+      :dwAddress, :uintptr_t,
+      :dwBlockSize, :size_t,
+      :dwFlags, :dword,
+      :dwLockCount, :dword,
+      :dwResvd, :dword,
+      :th32ProcessID, :dword,
+      :th32HeapID, :uintptr_t
+    )
+  end
+
+  class MODULEENTRY32 < FFI::Struct
+    layout(
+      :dwSize, :dword,
+      :th32ModuleID, :dword,
+      :th32ProcessID, :dword,
+      :GlblcntUsage, :dword,
+      :ProccntUsage, :dword,
+      :modBaseAddr, :pointer,
+      :modBaseSize, :dword,
+      :hModule, :handle,
+      :szModule, [:char, 256],
+      :szExePath, [:char, 260]
+    )
+  end
+
+  class PROCESSENTRY32 < FFI::Struct
+    layout(
+      :dwSize, :dword,
+      :cntUsage, :dword,
+      :th32ProcessID, :dword,
+      :th32DefaultHeapID, :uintptr_t,
+      :th32ModuleID, :dword,
+      :cntThreads, :dword,
+      :th32ParentProcessID, :dword,
+      :pcPriClassBase, :long,
+      :dwFlags, :dword,
+      :szExeFile, [:char, 260]
+    )
+  end
+
   # Used by Process.create
+
   ProcessInfo = Struct.new("ProcessInfo",
     :process_handle,
     :thread_handle,
     :process_id,
     :thread_id
   )
+
+  # Used by Process.snapshot
+
+  ThreadSnapInfo = Struct.new("ThreadSnapInfo",
+    :thread_id,
+    :process_id,
+    :base_priority
+  )
+
+  HeapSnapInfo = Struct.new("HeapSnapInfo",
+    :address,
+    :block_size,
+    :flags,
+    :process_id,
+    :heap_id
+  )
+
+  ModuleSnapInfo = Struct.new("ModuleSnapInfo",
+    :process_id,
+    :address,
+    :module_size,
+    :handle,
+    :name,
+    :path
+  )
+
+  ProcessSnapInfo = Struct.new("ProcessSnapInfo",
+    :process_id,
+    :threads,
+    :parent_process_id,
+    :priority,
+    :flags,
+    :path
+  )
 end

data/test/test_win32_process.rb

@@ -25,7 +25,7 @@ class TC_Win32Process < Test::Unit::TestCase
   end
 
   test "win32-process version is set to the correct value" do
-    assert_equal('0.7.5', Process::WIN32_PROCESS_VERSION)
+    assert_equal('0.9.0', Process::WIN32_PROCESS_VERSION)
   end
 
   test "create basic functionality" do
@@ -298,6 +298,23 @@ class TC_Win32Process < Test::Unit::TestCase
     assert_not_respond_to(Process, :volume_type)
   end
 
+  test "snapshot method basic functionality" do
+    assert_respond_to(Process, :snapshot)
+    assert_nothing_raised{ Process.snapshot }
+    assert_kind_of(Hash, Process.snapshot)
+  end
+
+  test "snapshot accepts :thread, :module or :heap arguments" do
+    assert_nothing_raised{ Process.snapshot(:thread) }
+    assert_nothing_raised{ Process.snapshot(:module) }
+    #assert_nothing_raised{ Process.snapshot(:heap) }
+    assert_nothing_raised{ Process.snapshot(:process) }
+  end
+
+  test "snapshot raises an error if an invalid argument is passed" do
+    assert_raise(ArgumentError){ Process.snapshot(:bogus) }
+  end
+
   test "ffi functions are private" do
     assert_not_respond_to(Process, :CloseHandle)
     assert_not_respond_to(Process, :GetCurrentProcess)

data/test/test_win32_process_kill.rb

@@ -116,28 +116,6 @@ class TC_Win32_Process_Kill < Test::Unit::TestCase
   #  assert_raise(Errno::EPERM){ Process.kill(9, 1) }
   #end
 
-  test "kill raises a SecurityError if $SAFE level is 2 or greater" do
-    omit_if(@ruby == 'jruby')
-    assert_raise(SecurityError){
-      proc do
-        $SAFE = 2
-        @pid = Process.spawn(@cmd)
-        Process.kill(9, @pid)
-      end.call
-    }
-  end
-
-  test "kill works if the $SAFE level is 1 or lower" do
-    omit_if(@ruby == 'jruby')
-    assert_nothing_raised{
-      proc do
-        $SAFE = 1
-        @pid = Process.spawn(@cmd)
-        Process.kill(9, @pid)
-      end.call
-    }
-  end
-
 =begin
   test "kill(0) can't tell if the process ended, use get_exitcode instead" do
     pid = Process.create(

data/win32-process.gemspec

@@ -1,23 +1,18 @@
-require 'rubygems'
-
 Gem::Specification.new do |spec|
-  spec.name       = 'win32-process'
-  spec.version    = '0.7.5'
-  spec.license    = 'Artistic 2.0'
-  spec.authors    = ['Daniel Berger', 'Park Heesob']
-  spec.email      = 'djberg96@gmail.com'
-  spec.homepage   = 'https://github.com/djberg96/win32-process'
-  spec.summary    = 'Adds and redefines several Process methods for MS Windows'
-  spec.test_files = Dir['test/*.rb']
-  spec.files      = Dir['**/*'].reject{ |f| f.include?('git') }
-
-  spec.extra_rdoc_files  = ['README', 'CHANGES', 'MANIFEST']
+  spec.name       = "win32-process"
+  spec.version    = "0.9.0"
+  spec.license    = "Artistic-2.0"
+  spec.authors    = ["Daniel Berger", "Park Heesob"]
+  spec.email      = "djberg96@gmail.com"
+  spec.homepage   = "https://github.com/chef/win32-process"
+  spec.summary    = "Adds and redefines several Process methods for Microsoft Windows"
+  spec.test_files = Dir["test/*.rb"]
+  spec.files      = `git ls-files -z`.split("\x0").reject { |f| f.match(/^(\..*|Gemfile|Rakefile|examples|test|CHANGELOG.md)/) }
 
-  spec.required_ruby_version = '> 1.9.0'
-  spec.add_dependency('ffi', '>= 1.0.0')
+  spec.extra_rdoc_files = ["README.md"]
 
-  spec.add_development_dependency('rake')
-  spec.add_development_dependency('test-unit', '>= 2.4.0')
+  spec.required_ruby_version = "> 1.9.0"
+  spec.add_dependency("ffi", ">= 1.0.0")
 
   spec.description = <<-EOF
     The win32-process library implements several Process methods that are

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: win32-process
 version: !ruby/object:Gem::Version
-  version: 0.7.5
+  version: 0.9.0
 platform: ruby
 authors:
 - Daniel Berger
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-03 00:00:00.000000000 Z
+date: 2020-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -25,34 +25,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.0
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: test-unit
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.4.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.4.0
 description: |2
       The win32-process library implements several Process methods that are
       either unimplemented or dysfunctional in some way in the default Ruby
@@ -62,16 +34,10 @@ email: djberg96@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- README
-- CHANGES
-- MANIFEST
+- README.md
 files:
-- CHANGES
-- MANIFEST
-- README
-- Rakefile
-- examples/example_create.rb
-- examples/example_kill.rb
+- README.md
+- lib/win32-process.rb
 - lib/win32/process.rb
 - lib/win32/process/constants.rb
 - lib/win32/process/functions.rb
@@ -80,9 +46,9 @@ files:
 - test/test_win32_process.rb
 - test/test_win32_process_kill.rb
 - win32-process.gemspec
-homepage: https://github.com/djberg96/win32-process
+homepage: https://github.com/chef/win32-process
 licenses:
-- Artistic 2.0
+- Artistic-2.0
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -99,11 +65,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
-summary: Adds and redefines several Process methods for MS Windows
+summary: Adds and redefines several Process methods for Microsoft Windows
 test_files:
 - test/test_win32_process.rb
 - test/test_win32_process_kill.rb

data/CHANGES

@@ -1,250 +0,0 @@
-= 0.7.5 - 3-Mar-2015
-* Use require_relative where possible.
-* Fixed a bug in Process.setrlimit. Note that this method has been marked
-  as experimental until further notice.
-* Minor updates to gemspec and Rakefile.
-* Added known issue for JRuby and SIGBRK to the README.
-
-= 0.7.4 - 21-Oct-2013
-* Fixed the INVALID_HANDLE_VALUE constant for 64-bit versions of Ruby.
-* Added Rake as a development dependency.
-
-= 0.7.3 - 25-Sep-2013
-* Added the Process.get_exitcode method. Thanks go to mthiede for the patch.
-* The Process.kill method raises a SecurityError if the $SAFE level is 2
-  or higher. This was done to match the spec.
-* Fixed a bug in our custom Process.uid method that affected 64-bit Ruby.
-* A note was added to use the Process.spawn method instead of Process.create
-  method where practical.
-
-= 0.7.2 - 8-Apr-2013
-* Fixed a 64 bit issue caused by the fact that HANDLE's were set as ulong
-  instead of intptr_t. Thanks go to Crossverse the spot.
-* Added some typedefs in the underlying FFI code for Windows data types.
-
-= 0.7.1 - 3-Jan-2013
-* The _get_errno function is apparently not exported on on Windows XP or
-  earlier. On those platforms, FFI.errno is now used instead. Thanks go
-  to Lars Christensen for the report.
-
-= 0.7.0 - 22-Aug-2012
-* Converted to use FFI instead of win32-api.
-* Now requires Ruby 1.9.x or later.
-* Removed the experimental Process.fork function. This obviated the necessity
-  of custom implementations of other methods, like Process.waitpid, so those
-  no longer have custom implementations either. These also proved to be
-  somewhat problematic with Ruby 1.9.x anyway.
-* Removed the custom Process.ppid method because Ruby 1.9.x now supports it.
-* The Process.kill method now supports the :exit_proc, :dll_module and
-  :wait_time options for signals 1 and 4-8.
-
-= 0.6.5 - 27-Dec-2010
-* Fixed getpriority and setpriority so that the underlying process handle is
-  always closed. Thanks go to Rafal Michalski	for the spot and patch. 
-* Updated getpriority and setpriority so that there are no longer any
-  default arguments. This now matches the MRI spec.
-* Updated Process.create so that illegal options now raise an ArgumentError
-  instead of a Process::Error.
-* Fixed a bug in an error message in the Process.create method where the actual
-  error message was getting lost.
-* Refactored the test suite to use test-unit 2.x features, and make tests a
-  little more robust in general.
-
-= 0.6.4 - 13-Nov-2010
-* Altered the wait, wait2, waitpid and waitpid2 methods to match the current
-  MRI interface, i.e. they accept and optional pid and flags, though the
-  latter is ignored. Thanks go to Robert Wahler for the spot.
-* Renamed the example scripts to avoid any potential confusion with actual
-  test scripts and cleaned them up a bit.
-* Added Rake tasks to run the example programs.
-* Updated the MANIFEST.
-
-= 0.6.3 - 9-Nov-2010
-* Fixed a bug in the Process.kill method where the remote thread created
-  was not being properly closed. Thanks go to Ben Nagy for the spot.
-* Added the Process.job? method that returns whether or not the current process
-  is already in a job.
-* Added the Process.setrlimit method. Like the Process.getrlimit method it
-  only supports a limited subset of resources.
-* Rakefile tweaks.
-
-= 0.6.2 - 19-Dec-2009
-* Fixed an issue where stdin, stdout and stderr might not be inheritable
-  even if the inherit option was set. Thanks go to Michael Buselli for the
-  spot and the patch.
-* Added a basic implementation of Process.getrlimit.
-* Added the Process.get_affinity method.
-* Added test-unit 2.x and sys-proctable as development dependencies.
-* Added the :uninstall and :build_gem Rake tasks to the Rakefile.
-* Bumped required version of windows-pr to 1.0.6.
-
-= 0.6.1 - 16-Jul-2009
-* Added the Process.uid method. This method returns a user id (really, the RID
-  of the SID) by default, but can also take an optional parameter to return
-  a binary SID instead at the user's discretion.
-* Added working implementations of Process.getpriority and Process.setpriority.
-  Note they they only work for processes, not process groups or users.
-* Set license to Artistic 2.0, and updated the gemspec.
-
-= 0.6.0 - 31-Oct-2008
-* The mandatory argument for Process.create has been switched from 'app_name'
-  to 'command_line', to be more in line with underlying CreateProcess API.
-  Note that 'command_line' will default to 'app_name' if only the latter is
-  set, but both may be set individually. Keep in mind that 'app_name' must
-  be a full path to the executable. Thanks go to Jeremy Bopp for the patch.
-* Removed the deprecated ProcessError constant. Use Process::Error instead.
-* Explicitly include and extend the Windows::Thread module now. Thanks go to
-  Qi Lu for the spot.
-* Slightly more robust internal code handling for some of the other methods,
-  typically related to ensuring that HANDLE's are closed.
-* Example programs are now included with the gem.
-
-= 0.5.9 - 14-Jun-2008
-* Added a proper implementation of Process.ppid.
-
-= 0.5.8 - 24-Mar-2008
-* Fixed a bug in Process.create where the handles in the PROCESS_INFORMATION
-  struct were not closed, regardless of the 'close_handles' option. Thanks
-  go to Lars Christensen for the spot and the patch.
-
-= 0.5.7 - 27-Mar-2008
-* Fixed issues with thread_inherit and process_inherit in the Process.create
-  method. This in turn required an update to windows-pr. Thanks go to Steve
-  Shreeve for the spot.
-* Fixed a potential issue with startf_flags and stdin/stdout/stderr handling.
-  Thanks again go to Steve Shreeve for the spot and the patch.
-* Fixed the code so that it no longer emits redefinition warnings.
-* Fixed a bug in the Rake install task (for non-gem installations).
-
-== 0.5.6 - 13-Mar-2008
-* Fixed a bug in the Process.waitpid2 method where it wasn't returning the
-  proper exit code. Thanks go to Jeremy Bopp for the spot and the patch.
-* In the spirit of DWIM, if the 'stdin', 'stdout' or 'stderr' keys are
-  encountered in the startup_info hash, then the inherit flag is automatically
-  set to true and the startf_flags key is automatically OR'd with the
-  STARTF_USESTDHANDLES value. Thanks go to Sander Pool for the inspiration.
-
-== 0.5.5 - 12-Dec-2007
-* The Process.create method now automatically closes the process and thread
-  handles in the ProcessInfo struct before returning, unless you explicitly
-  tell it not to via the 'close_handles' option.
-* The Process.create method now supports creating a process as another user
-  via the 'with_logon', 'password' and 'domain' options.
-
-== 0.5.4 - 23-Nov-2007
-* Changed ProcessError to Process::Error.
-* Now requires windows-pr 0.7.3 or later because of some reorganization in
-  that library with regards to thread functions.
-* Better cleanup of HANDLE's in a couple methods when failure occurs.
-* Added an additional require/include necessitated by a change in the method
-  organization in the windows-pr library.
-
-== 0.5.3 - 29-Jul-2007
-* Added a Rakefile with tasks for installation and testing.
-* Removed the install.rb file (now handled by the Rakefile).
-* Updated the README and MANIFEST files.
-
-== 0.5.2 - 22-Jan-2007
-* The startup_info parameter for the Process.create method now accepts
-  'stdin', 'stdout', and 'stderr' as valid parameters, which you can pass
-  a Ruby IO object or a fileno in order to redirect output from the created
-  process.
-
-== 0.5.1 - 24-Aug-2006
-* Fixed a bug in the Process.create method where the return value for
-  CreateProcess() was being evaluated incorrectly.  Thanks go to David Haney
-  for the spot.
-* Added a slightly nicer error message if an invalid value is passed to the
-  Process.create method.
-* Removed an extraneous '%' character from an error message.
-
-== 0.5.0 - 29-Jul-2006
-* The Process.create method now returns a ProcessInfo struct instead of the
-  pid.  Note that you can still grab the pid out of the struct if needed.
-* The Process.create method now allows the process_inherit and
-  thread_inherit options which determine whether a process or thread
-  object's handles are inheritable, respectively.
-* The wait and wait2 methods will now work if GetProcessId() isn't defined
-  on your system.
-* The 'inherit?' hash option was changed to just 'inherit' (no question mark).
-* Minor doc correction - the 'inherit' option defaults to false, not true.
-
-== 0.4.2 - 29-May-2006
-* Fixed a typo/bug in Process.kill for signal 3, where I had accidentally
-  used CTRL_BRK_EVENT instead of the correct CTRL_BREAK_EVENT.  Thanks go
-  to Luis Lavena for the spot.
-
-== 0.4.1 - 13-May-2006
-* Fixed a bug where spaces in $LOAD_PATH would cause Process.fork to fail.
-  Thanks go to Justin Bailey for the spot and patch.
-* Added a short synopsis to the README file.
-
-== 0.4.0 - 7-May-2006
-* Now pure Ruby, courtesy of the Win32API package.
-* Now comes with a gem.
-* Modified Process.kill to send a signal to the current process if pid 0
-  is specified, as per the current 1.8 behavior.
-* Process.create now accepts the 'environment' key/value, where you can
-  pass a semicolon-separated string as the environment for the new process.
-* Moved the GUI related options of Process.create to subkeys of the
-  'startup_info' key.  See documentation for details.
-* Replaced Win32::ProcessError with just ProcessError.
-
-== 0.3.3 - 16-Apr-2006
-* Fixed a bug in Process.create with regards to creation_flags.  Thanks go
-  to Tophe Vigny for the spot.
-
-== 0.3.2 - 12-Aug-2005
-* Fixed a bug in Process.kill where a segfault could occur.  Thanks go to
-  Bill Atkins for the spot.
-* Changed VERSION to WIN32_PROCESS_VERSION, because it's a module.
-* Made the CHANGES, README and doc/process.txt documents rdoc friendly.
-* Removed the process.rd file.
-
-== 0.3.1 - 9-Dec-2004
-* Modified Process.fork to return an actual PID instead of a handle.  This
-  means that it should work with Process.kill and other methods that expect
-  an actual PID.
-* Modified Process.kill to understand the strings "SIGINT", "INT", "SIGBRK",
-  "BRK", "SIGKILL" and "KILL".  These correspond to signals 2, 3 and 9,
-  respectively.
-* Added better $LOAD_PATH handling for Process.fork.  Thanks go to Aslak
-  Hellesoy for the spot and the patch.
-* Replaced all instances of rb_sys_fail(0) with rb_raise().  This is because
-  of a strange bug in the Windows Installer that hasn't been nailed down yet.
-  This means that you can't rescue Errno::ENOENT any more, but will have to
-  rescue StandardError.  This only affects Process.kill.
-* The signals that were formerly 1 and 2 and now 2 and 3.  I did this because
-  I wanted the same signal number for SIGINT as it is on *nix.
-* Added a test_kill.rb script under the examples directory.
-* Other minor cleanup and corrections.
-
-== 0.3.0 - 25-Jul-2004
-* Added the create() method.
-* Moved the example programs to doc/examples.
-* Updated the docs, and toned down claims of fork's similarity to the Unix
-  version.
-* Minor updates to the test suite.
-
-== 0.2.1 - 17-May-2004
-* Made all methods module functions, except fork, rather than singleton
-  methods.
-* Minor doc changes.
-
-== 0.2.0 - 11-May-2004
-* Removed the Win32 module/namespace.  You no longer 'include Win32' and you
-  no longer need to prefix Process with 'Win32::'.
-* The fork() method is now a global function as well as a method of the
-  Process module.  That means you can call 'fork' instead of 'Process.fork'
-  if you like.
-* Doc updates to reflect the above changes.
-
-== 0.1.1 - 6-Mar-2004
-* Fixed bug where spaces in the directory name caused the fork() method to
-  fail (Park).
-* Normalized tc_process.rb somewhat to make it easier to run outside of the
-  test directory if desired.
-* Fixed up tc_process.rb a bit.
-
-== 0.1.0 - 19-Feb-2004
-* Initial release

data/MANIFEST

@@ -1,13 +0,0 @@
-* CHANGES
-* README
-* MANIFEST
-* Rakefile
-* win32-process.gemspec
-* examples/example_create.rb
-* examples/example_kill.rb
-* lib/win32/process.rb
-* lib/win32/process/constants.rb
-* lib/win32/process/functions.rb
-* lib/win32/process/helper.rb
-* lib/win32/process/structs.rb
-* test/test_process.rb

data/README

@@ -1,78 +0,0 @@
-= Description
-  This library provides analogues of the :getpriority, :setpriority, :getrlimit,
-  :setrlimit and :uid methods for MS Windows. It also adds the new methods :job?,
-  :get_affinity, and :create, and redefines the :kill method.
- 
-= Prerequisites
-  * ffi
-  * sys-proctable (dev only)
-  * test-unit 2 (dev only)
-
-= Supported Platforms
-  This library is supported on Windows 2000 or later.
-
-= Installation
-  gem install win32-process
-
-= Synopsis
-  require 'win32/process'
-
-  p Process.job? # => true or false
-
-  info = Process.create(
-    :app_name         => "notepad.exe",
-    :creation_flags   => Process::DETACHED_PROCESS,
-    :process_inherit  => false,
-    :thread_inherit   => true,
-    :cwd              => "C:\\"
-  )
-
-  p info.process_id
-	
-= Developer's Notes
-== Removal of Process.fork in release 0.7.0
-   The Process.fork method was originally experimental but it has never
-   been particularly useful in practice. On top of that, it required special
-   implementations of the Process.waitXXX methods, so it was a maintenance
-   issue as well.
-   
-   With Ruby 1.9 now becoming standard and its addition of Process.spawn
-   and friends (and concomitant support for the Process.waitXXX methods) I
-   felt it was time to remove it.
-
-   You can still simulate Process.fork if you like using Process.create, which
-   is how it was implemented internally anyway. A better solution might be
-   to follow in the footsteps of ActiveState Perl, which uses native threads
-   to simulate fork on Windows.
-	
-== Changes in the custom Process.kill method for 0.7.0
-   The Process.kill method in 0.7.0 more closely matches the spec now, but
-   the internal method for killing processes is still nicer for most signals.
-   With the release of 0.7.0 users can now specify options that provide finer
-   control over how a process is killed. See the documentation for details. 
-
-== The removal of the custom Process.ppid method
-   This was added at some point in the Ruby 1.9 dev cycle so it was removed
-   from this library.
-
-= Known Issues
-  JRuby doesn't seem to like SIGBRK for Process.kill.
-
-  Any issues or bugs should be reported on the project page at
-  https://github.com/djberg96/win32-process.
-	
-= License
-  Artistic 2.0
-	
-= Copyright
-  (C) 2003-2015 Daniel J. Berger
-  All Rights Reserved
-		
-= Warranty
-  This library 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(s)
-  Park Heesob	
-  Daniel J. Berger

data/Rakefile

@@ -1,63 +0,0 @@
-require 'rake'
-require 'rake/clean'
-require 'rake/testtask'
-require 'rbconfig'
-include RbConfig
-
-CLEAN.include('**/*.gem', '**/*.rbc', '**/*.log')
-
-namespace :gem do
-  desc 'Create the win32-process gem'
-  task :create => [:clean] do
-    spec = eval(IO.read('win32-process.gemspec'))
-    if Gem::VERSION < "2.0"
-      Gem::Builder.new(spec).build
-    else
-      require 'rubygems/package'
-      Gem::Package.build(spec)
-    end
-  end
-
-  desc 'Install the win32-process gem'
-  task :install => [:create] do
-    file = Dir["*.gem"].first
-    sh "gem install -l #{file}"
-  end
-end
-
-namespace :example do
-  desc 'Run the fork + wait example'
-  task :fork_wait do
-    sh "ruby -Ilib examples/example_fork_wait.rb"
-  end
-
-  desc 'Run the fork + waitpid example'
-  task :fork_waitpid do
-    sh "ruby -Ilib examples/example_fork_waitpid.rb"
-  end
-
-  desc 'Run the kill example'
-  task :kill do
-    sh "ruby -Ilib examples/example_kill.rb"
-  end
-
-  desc 'Run the create example'
-  task :create do
-    sh "ruby -Ilib examples/example_create.rb"
-  end
-end
-
-namespace :test do
-  Rake::TestTask.new(:kill) do |t|
-    t.verbose = true
-    t.warning = true
-    t.test_files = FileList['test/test_win32_process_kill.rb']
-  end
-end
-
-Rake::TestTask.new do |t|
-  t.verbose = true
-  t.warning = true
-end
-
-task :default => :test

data/examples/example_create.rb

@@ -1,35 +0,0 @@
-##########################################################################
-# example_create.rb
-#
-# Simple test program for the Process.create() method. You can run this
-# code via the 'example:create' task.
-##########################################################################
-require "win32/process"
-
-p Process::WIN32_PROCESS_VERSION
-
-struct = Process.create(
-   :app_name         => "notepad.exe",
-   :creation_flags   => Process::DETACHED_PROCESS,
-   :process_inherit  => false,
-   :thread_inherit   => true,
-   :cwd              => "C:\\",
-   :inherit          => true,
-   :environment      => "SYSTEMROOT=#{ENV['SYSTEMROOT']};PATH=C:\\"
-)
-
-p struct
-
-=begin
-# Don't run this from an existing terminal
-pid = Process.create(
-   :app_name       => "cmd.exe",
-   :creation_flags => Process::DETACHED_PROCESS,
-   :startf_flags   => Process::USEPOSITION,
-   :x              => 0,
-   :y              => 0,
-   :title          => "Hi Dan"
-)
-
-puts "Pid of new process: #{pid}"
-=end

data/examples/example_kill.rb

@@ -1,34 +0,0 @@
-##########################################################################
-# example_kill.rb
-#
-# Generic test script for futzing around Process.kill. This script
-# requires the sys-proctable library.
-#
-# You can run this example via the 'example:kill' task.
-##########################################################################
-require "win32/process"
-
-begin
-  require "sys/proctable"
-rescue LoadError
-  STDERR.puts "Whoa there!"
-  STDERR.puts "This script requires the sys-proctable package to work."
-  STDERR.puts "You can find it at http://ruby-sysutils.sf.net"
-  STDERR.puts "Exiting..."
-  exit
-end
-
-include Sys
-
-puts "VERSION: " + Process::WIN32_PROCESS_VERSION
-
-IO.popen("notepad")
-sleep 1 # Give it a chance to start before checking for its pid
-
-pids = []
-
-ProcTable.ps{ |s|
-  pids.push(s.pid) if s.cmdline =~ /notepad/i
-}
-
-p Process.kill(9,pids.last)