win32-process 0.7.0 → 0.7.1

data/lib/win32/process/constants.rb

@@ -1,105 +1,105 @@
-module Process::Constants
-  private
-
-  # Priority constants
-
-  ABOVE_NORMAL_PRIORITY_CLASS = 0x0008000
-  BELOW_NORMAL_PRIORITY_CLASS = 0x0004000
-  HIGH_PRIORITY_CLASS         = 0x0000080
-  IDLE_PRIORITY_CLASS         = 0x0000040
-  NORMAL_PRIORITY_CLASS       = 0x0000020
-  REALTIME_PRIORITY_CLASS     = 0x0000010
-
-  # Error constants
-
-  INVALID_HANDLE_VALUE = 0xffffffff
-  ERROR_ACCESS_DENIED  = 0x00000005
-
-  # Process Access Rights
-
-  PROCESS_TERMINATE         = 0x00000001
-  PROCESS_SET_INFORMATION   = 0x00000200
-  PROCESS_QUERY_INFORMATION = 0x00000400
-  PROCESS_ALL_ACCESS        = 0x001F0FFF
-  PROCESS_VM_READ           = 0x00000010
-
-  # Process wait time for Process.kill
-
-  INFINITE = 0xFFFFFFFF
-
-  # Process creation flags
-
-  CREATE_BREAKAWAY_FROM_JOB        = 0x01000000
-  CREATE_DEFAULT_ERROR_MODE        = 0x04000000
-  CREATE_NEW_CONSOLE               = 0x00000010
-  CREATE_NEW_PROCESS_GROUP         = 0x00000200
-  CREATE_NO_WINDOW                 = 0x08000000
-  CREATE_PROTECTED_PROCESS         = 0x00040000
-  CREATE_PRESERVE_CODE_AUTHZ_LEVEL = 0x02000000
-  CREATE_SEPARATE_WOW_VDM          = 0x00000800
-  CREATE_SHARED_WOW_VDM            = 0x00001000
-  CREATE_SUSPENDED                 = 0x00000004
-  CREATE_UNICODE_ENVIRONMENT       = 0x00000400
-  DEBUG_ONLY_THIS_PROCESS          = 0x00000002
-  DEBUG_PROCESS                    = 0x00000001
-  DETACHED_PROCESS                 = 0x00000008
-  INHERIT_PARENT_AFFINITY          = 0x00010000
-
-  STARTF_USESHOWWINDOW    = 0x00000001
-  STARTF_USESIZE          = 0x00000002
-  STARTF_USEPOSITION      = 0x00000004
-  STARTF_USECOUNTCHARS    = 0x00000008
-  STARTF_USEFILLATTRIBUTE = 0x00000010
-  STARTF_RUNFULLSCREEN    = 0x00000020
-  STARTF_FORCEONFEEDBACK  = 0x00000040
-  STARTF_FORCEOFFFEEDBACK = 0x00000080
-  STARTF_USESTDHANDLES    = 0x00000100
-  STARTF_USEHOTKEY        = 0x00000200
-  STARTF_TITLEISLINKNAME  = 0x00000800
-  STARTF_TITLEISAPPID     = 0x00001000
-  STARTF_PREVENTPINNING   = 0x00002000
-
-  LOGON_WITH_PROFILE        = 0x00000001
-  LOGON_NETCREDENTIALS_ONLY = 0x00000002
-
-  SHUTDOWN_NORETRY = 0x00000001
-
-  # Security
-
-  TokenUser   = 1
-  TOKEN_QUERY = 0x00000008
-
-  # Define these for Windows. They are not actually used but are defined
-  # for interface compatibility.
-
-  PRIO_PROCESS = 0
-  PRIO_PGRP    = 1
-  PRIO_USER    = 2
-
-  # Define these for Windows
-
-  RLIMIT_CPU    = 0 # PerProcessUserTimeLimit
-  RLIMIT_FSIZE  = 1 # Hard coded at 4TB - 64K (assumes NTFS)
-  RLIMIT_AS     = 5 # ProcessMemoryLimit
-  RLIMIT_RSS    = 5 # ProcessMemoryLimit
-  RLIMIT_VMEM   = 5 # ProcessMemoryLimit
-
-  # Job constants
-
-  JOB_OBJECT_SET_ATTRIBUTES       = 0x00000002
-  JOB_OBJECT_QUERY                = 0x00000004
-  JOB_OBJECT_LIMIT_PROCESS_TIME   = 0x00000002
-  JOB_OBJECT_LIMIT_PROCESS_MEMORY = 0x00000100
-  JobObjectExtendedLimitInformation = 9
-
-  # Console Events
-
-  CTRL_C_EVENT     = 0
-  CTRL_BREAK_EVENT = 1
-
-  # Miscellaneous
-
-  HANDLE_FLAG_INHERIT     = 0x00000001
-  SEM_FAILCRITICALERRORS  = 0x00000001
-  SEM_NOGPFAULTERRORBOX   = 0x00000002
-end
+module Process::Constants
+  private
+
+  # Priority constants
+
+  ABOVE_NORMAL_PRIORITY_CLASS = 0x0008000
+  BELOW_NORMAL_PRIORITY_CLASS = 0x0004000
+  HIGH_PRIORITY_CLASS         = 0x0000080
+  IDLE_PRIORITY_CLASS         = 0x0000040
+  NORMAL_PRIORITY_CLASS       = 0x0000020
+  REALTIME_PRIORITY_CLASS     = 0x0000010
+
+  # Error constants
+
+  INVALID_HANDLE_VALUE = 0xffffffff
+  ERROR_ACCESS_DENIED  = 0x00000005
+
+  # Process Access Rights
+
+  PROCESS_TERMINATE         = 0x00000001
+  PROCESS_SET_INFORMATION   = 0x00000200
+  PROCESS_QUERY_INFORMATION = 0x00000400
+  PROCESS_ALL_ACCESS        = 0x001F0FFF
+  PROCESS_VM_READ           = 0x00000010
+
+  # Process wait time for Process.kill
+
+  INFINITE = 0xFFFFFFFF
+
+  # Process creation flags
+
+  CREATE_BREAKAWAY_FROM_JOB        = 0x01000000
+  CREATE_DEFAULT_ERROR_MODE        = 0x04000000
+  CREATE_NEW_CONSOLE               = 0x00000010
+  CREATE_NEW_PROCESS_GROUP         = 0x00000200
+  CREATE_NO_WINDOW                 = 0x08000000
+  CREATE_PROTECTED_PROCESS         = 0x00040000
+  CREATE_PRESERVE_CODE_AUTHZ_LEVEL = 0x02000000
+  CREATE_SEPARATE_WOW_VDM          = 0x00000800
+  CREATE_SHARED_WOW_VDM            = 0x00001000
+  CREATE_SUSPENDED                 = 0x00000004
+  CREATE_UNICODE_ENVIRONMENT       = 0x00000400
+  DEBUG_ONLY_THIS_PROCESS          = 0x00000002
+  DEBUG_PROCESS                    = 0x00000001
+  DETACHED_PROCESS                 = 0x00000008
+  INHERIT_PARENT_AFFINITY          = 0x00010000
+
+  STARTF_USESHOWWINDOW    = 0x00000001
+  STARTF_USESIZE          = 0x00000002
+  STARTF_USEPOSITION      = 0x00000004
+  STARTF_USECOUNTCHARS    = 0x00000008
+  STARTF_USEFILLATTRIBUTE = 0x00000010
+  STARTF_RUNFULLSCREEN    = 0x00000020
+  STARTF_FORCEONFEEDBACK  = 0x00000040
+  STARTF_FORCEOFFFEEDBACK = 0x00000080
+  STARTF_USESTDHANDLES    = 0x00000100
+  STARTF_USEHOTKEY        = 0x00000200
+  STARTF_TITLEISLINKNAME  = 0x00000800
+  STARTF_TITLEISAPPID     = 0x00001000
+  STARTF_PREVENTPINNING   = 0x00002000
+
+  LOGON_WITH_PROFILE        = 0x00000001
+  LOGON_NETCREDENTIALS_ONLY = 0x00000002
+
+  SHUTDOWN_NORETRY = 0x00000001
+
+  # Security
+
+  TokenUser   = 1
+  TOKEN_QUERY = 0x00000008
+
+  # Define these for Windows. They are not actually used but are defined
+  # for interface compatibility.
+
+  PRIO_PROCESS = 0
+  PRIO_PGRP    = 1
+  PRIO_USER    = 2
+
+  # Define these for Windows
+
+  RLIMIT_CPU    = 0 # PerProcessUserTimeLimit
+  RLIMIT_FSIZE  = 1 # Hard coded at 4TB - 64K (assumes NTFS)
+  RLIMIT_AS     = 5 # ProcessMemoryLimit
+  RLIMIT_RSS    = 5 # ProcessMemoryLimit
+  RLIMIT_VMEM   = 5 # ProcessMemoryLimit
+
+  # Job constants
+
+  JOB_OBJECT_SET_ATTRIBUTES       = 0x00000002
+  JOB_OBJECT_QUERY                = 0x00000004
+  JOB_OBJECT_LIMIT_PROCESS_TIME   = 0x00000002
+  JOB_OBJECT_LIMIT_PROCESS_MEMORY = 0x00000100
+  JobObjectExtendedLimitInformation = 9
+
+  # Console Events
+
+  CTRL_C_EVENT     = 0
+  CTRL_BREAK_EVENT = 1
+
+  # Miscellaneous
+
+  HANDLE_FLAG_INHERIT     = 0x00000001
+  SEM_FAILCRITICALERRORS  = 0x00000001
+  SEM_NOGPFAULTERRORBOX   = 0x00000002
+end

data/lib/win32/process/functions.rb

@@ -1,66 +1,72 @@
-if RUBY_PLATFORM == 'java'
-  require 'rubygems'
-  gem 'ffi'
-end
-
-require 'ffi'
-
-module Process::Functions
-  module FFI::Library
-    # Wrapper method for attach_function + private
-    def attach_pfunc(*args)
-      attach_function(*args)
-      private args[0]
-    end
-  end
-
-  extend FFI::Library
-
-  ffi_lib :kernel32
-
-  attach_pfunc :CloseHandle, [:ulong], :bool
-  attach_pfunc :GenerateConsoleCtrlEvent, [:ulong, :ulong], :bool
-  attach_pfunc :GetCurrentProcess, [], :ulong
-  attach_pfunc :GetModuleHandle, :GetModuleHandleA, [:string], :ulong
-  attach_pfunc :GetProcessAffinityMask, [:ulong, :pointer, :pointer], :bool
-  attach_pfunc :GetPriorityClass, [:ulong], :ulong
-  attach_pfunc :GetProcAddress, [:ulong, :string], :ulong
-  attach_pfunc :IsProcessInJob, [:ulong, :pointer, :pointer], :void
-  attach_pfunc :OpenProcess, [:ulong, :bool, :ulong], :ulong
-  attach_pfunc :SetHandleInformation, [:ulong, :ulong, :ulong], :bool
-  attach_pfunc :SetErrorMode, [:uint], :uint
-  attach_pfunc :SetPriorityClass, [:ulong, :ulong], :bool
-  attach_pfunc :TerminateProcess, [:ulong, :uint], :bool
-  attach_pfunc :WaitForSingleObject, [:ulong, :ulong], :ulong
-
-  attach_pfunc :CreateRemoteThread,
-    [:ulong, :pointer, :size_t, :ulong, :pointer, :ulong, :pointer], :ulong
-
-  attach_pfunc :GetVolumeInformationA,
-    [:string, :pointer, :ulong, :pointer, :pointer, :pointer, :pointer, :ulong], :bool
-
-  attach_pfunc :CreateProcessW,
-    [:buffer_in, :buffer_in, :pointer, :pointer, :bool,
-     :ulong, :buffer_in, :buffer_in, :pointer, :pointer], :bool
-
-  attach_pfunc :AssignProcessToJobObject, [:ulong, :ulong], :bool
-  attach_pfunc :CreateJobObjectA, [:pointer, :string], :ulong
-  attach_pfunc :OpenJobObjectA, [:ulong, :bool, :string], :ulong
-  attach_pfunc :QueryInformationJobObject, [:ulong, :int, :pointer, :ulong, :pointer], :bool
-  attach_pfunc :SetInformationJobObject, [:ulong, :int, :pointer, :ulong], :bool
-
-  ffi_lib :advapi32
-
-  attach_pfunc :ConvertSidToStringSidA, [:buffer_in, :pointer], :bool
-  attach_pfunc :GetTokenInformation, [:ulong, :int, :pointer, :ulong, :pointer], :bool
-  attach_pfunc :OpenProcessToken, [:ulong, :ulong, :pointer], :bool
-
-  attach_pfunc :CreateProcessWithLogonW,
-    [:buffer_in, :buffer_in, :buffer_in, :ulong, :buffer_in, :buffer_in,
-     :ulong, :buffer_in, :buffer_in, :pointer, :pointer], :bool
-
-  ffi_lib FFI::Library::LIBC
-
-  attach_pfunc :get_errno, :_get_errno, [:pointer], :int
-  attach_pfunc :get_osfhandle, :_get_osfhandle, [:int], :ulong
-end
+if RUBY_PLATFORM == 'java'
+  require 'rubygems'
+  gem 'ffi'
+end
+
+require 'ffi'
+
+module Process::Functions
+  module FFI::Library
+    # Wrapper method for attach_function + private
+    def attach_pfunc(*args)
+      attach_function(*args)
+      private args[0]
+    end
+  end
+
+  extend FFI::Library
+
+  ffi_lib :kernel32
+
+  attach_pfunc :CloseHandle, [:ulong], :bool
+  attach_pfunc :GenerateConsoleCtrlEvent, [:ulong, :ulong], :bool
+  attach_pfunc :GetCurrentProcess, [], :ulong
+  attach_pfunc :GetModuleHandle, :GetModuleHandleA, [:string], :ulong
+  attach_pfunc :GetProcessAffinityMask, [:ulong, :pointer, :pointer], :bool
+  attach_pfunc :GetPriorityClass, [:ulong], :ulong
+  attach_pfunc :GetProcAddress, [:ulong, :string], :ulong
+  attach_pfunc :GetVersionExA, [:pointer], :bool
+  attach_pfunc :IsProcessInJob, [:ulong, :pointer, :pointer], :void
+  attach_pfunc :OpenProcess, [:ulong, :bool, :ulong], :ulong
+  attach_pfunc :SetHandleInformation, [:ulong, :ulong, :ulong], :bool
+  attach_pfunc :SetErrorMode, [:uint], :uint
+  attach_pfunc :SetPriorityClass, [:ulong, :ulong], :bool
+  attach_pfunc :TerminateProcess, [:ulong, :uint], :bool
+  attach_pfunc :WaitForSingleObject, [:ulong, :ulong], :ulong
+
+  attach_pfunc :CreateRemoteThread,
+    [:ulong, :pointer, :size_t, :ulong, :pointer, :ulong, :pointer], :ulong
+
+  attach_pfunc :GetVolumeInformationA,
+    [:string, :pointer, :ulong, :pointer, :pointer, :pointer, :pointer, :ulong], :bool
+
+  attach_pfunc :CreateProcessW,
+    [:buffer_in, :buffer_in, :pointer, :pointer, :bool,
+     :ulong, :buffer_in, :buffer_in, :pointer, :pointer], :bool
+
+  attach_pfunc :AssignProcessToJobObject, [:ulong, :ulong], :bool
+  attach_pfunc :CreateJobObjectA, [:pointer, :string], :ulong
+  attach_pfunc :OpenJobObjectA, [:ulong, :bool, :string], :ulong
+  attach_pfunc :QueryInformationJobObject, [:ulong, :int, :pointer, :ulong, :pointer], :bool
+  attach_pfunc :SetInformationJobObject, [:ulong, :int, :pointer, :ulong], :bool
+
+  ffi_lib :advapi32
+
+  attach_pfunc :ConvertSidToStringSidA, [:buffer_in, :pointer], :bool
+  attach_pfunc :GetTokenInformation, [:ulong, :int, :pointer, :ulong, :pointer], :bool
+  attach_pfunc :OpenProcessToken, [:ulong, :ulong, :pointer], :bool
+
+  attach_pfunc :CreateProcessWithLogonW,
+    [:buffer_in, :buffer_in, :buffer_in, :ulong, :buffer_in, :buffer_in,
+     :ulong, :buffer_in, :buffer_in, :pointer, :pointer], :bool
+
+  ffi_lib FFI::Library::LIBC
+
+  attach_pfunc :get_osfhandle, :_get_osfhandle, [:int], :ulong
+
+  begin
+    attach_pfunc :get_errno, :_get_errno, [:pointer], :int
+  rescue FFI::NotFoundError
+    # Do nothing, Windows XP or earlier.
+  end
+end

data/lib/win32/process/helper.rb

@@ -1,13 +1,13 @@
-class String
-  # Convert a regular string to a wide character string. This does not
-  # modify the receiver.
-  def to_wide_string
-    (self + 0.chr).encode('UTF-16LE')
-  end
-
-  # Convert a regular string to a wide character string. This modifies
-  # the receiver.
-  def to_wide_string!
-    replace((self + 0.chr).encode('UTF-16LE'))
-  end
-end
+class String
+  # Convert a regular string to a wide character string. This does not
+  # modify the receiver.
+  def to_wide_string
+    (self + 0.chr).encode('UTF-16LE')
+  end
+
+  # Convert a regular string to a wide character string. This modifies
+  # the receiver.
+  def to_wide_string!
+    replace((self + 0.chr).encode('UTF-16LE'))
+  end
+end

data/lib/win32/process/structs.rb

@@ -1,103 +1,114 @@
-if RUBY_PLATFORM == 'java'
-  require 'rubygems'
-  gem 'ffi'
-end
-
-require 'ffi'
-
-module Process::Structs
-  extend FFI::Library
-
-  private
-
-  # sizeof(LARGE_INTEGER) == 8
-  class LARGE_INTEGER < FFI::Union
-    layout(:QuadPart, :long_long)
-  end
-
-  # sizeof(IO_COUNTERS) == 48
-  class IO_COUNTERS < FFI::Struct
-    layout(
-      :ReadOperationCount, :ulong_long,
-      :WriteOperationCount, :ulong_long,
-      :OtherOperationCount, :ulong_long,
-      :ReadTransferCount, :ulong_long,
-      :WriteTransferCount, :ulong_long,
-      :OtherTransferCount, :ulong_long
-    )
-  end
-
-  class JOBJECT_BASIC_LIMIT_INFORMATION < FFI::Struct
-    layout(
-      :PerProcessUserTimeLimit, LARGE_INTEGER,
-      :PerJobUserTimeLimit, LARGE_INTEGER,
-      :LimitFlags, :ulong,
-      :MinimumWorkingSetSize, :size_t,
-      :MaximumWorkingSetSize, :size_t,
-      :ActiveProcessLimit, :ulong,
-      :Affinity, :pointer,
-      :PriorityClass, :ulong,
-      :SchedulingClass, :ulong
-    )
-  end
-
-  class JOBJECT_EXTENDED_LIMIT_INFORMATION < FFI::Struct
-    layout(
-      :BasicLimitInformation, JOBJECT_BASIC_LIMIT_INFORMATION,
-      :IoInfo, IO_COUNTERS,
-      :ProcessMemoryLimit, :size_t,
-      :JobMemoryLimit, :size_t,
-      :PeakProcessMemoryUsed, :size_t,
-      :PeakJobMemoryUsed, :size_t
-    )
-  end
-
-  class SECURITY_ATTRIBUTES < FFI::Struct
-    layout(
-      :nLength, :ulong,
-      :lpSecurityDescriptor, :pointer,
-      :bInheritHandle, :bool
-    )
-  end
-
-  # sizeof(STARTUPINFO) == 68
-  class STARTUPINFO < FFI::Struct
-    layout(
-      :cb, :ulong,
-      :lpReserved, :string,
-      :lpDesktop, :string,
-      :lpTitle, :string,
-      :dwX, :ulong,
-      :dwY, :ulong,
-      :dwXSize, :ulong,
-      :dwYSize, :ulong,
-      :dwXCountChars, :ulong,
-      :dwYCountChars, :ulong,
-      :dwFillAttribute, :ulong,
-      :dwFlags, :ulong,
-      :wShowWindow, :short,
-      :cbReserved2, :short,
-      :lpReserved2, :pointer,
-      :hStdInput, :ulong,
-      :hStdOutput, :ulong,
-      :hStdError, :ulong
-    )
-  end
-
-  class PROCESS_INFORMATION < FFI::Struct
-    layout(
-      :hProcess, :ulong,
-      :hThread, :ulong,
-      :dwProcessId, :ulong,
-      :dwThreadId, :ulong
-    )
-  end
-
-  # Used by Process.create
-  ProcessInfo = Struct.new("ProcessInfo",
-    :process_handle,
-    :thread_handle,
-    :process_id,
-    :thread_id
-  )
-end
+if RUBY_PLATFORM == 'java'
+  require 'rubygems'
+  gem 'ffi'
+end
+
+require 'ffi'
+
+module Process::Structs
+  extend FFI::Library
+
+  private
+
+  # sizeof(LARGE_INTEGER) == 8
+  class LARGE_INTEGER < FFI::Union
+    layout(:QuadPart, :long_long)
+  end
+
+  # sizeof(IO_COUNTERS) == 48
+  class IO_COUNTERS < FFI::Struct
+    layout(
+      :ReadOperationCount, :ulong_long,
+      :WriteOperationCount, :ulong_long,
+      :OtherOperationCount, :ulong_long,
+      :ReadTransferCount, :ulong_long,
+      :WriteTransferCount, :ulong_long,
+      :OtherTransferCount, :ulong_long
+    )
+  end
+
+  class JOBJECT_BASIC_LIMIT_INFORMATION < FFI::Struct
+    layout(
+      :PerProcessUserTimeLimit, LARGE_INTEGER,
+      :PerJobUserTimeLimit, LARGE_INTEGER,
+      :LimitFlags, :ulong,
+      :MinimumWorkingSetSize, :size_t,
+      :MaximumWorkingSetSize, :size_t,
+      :ActiveProcessLimit, :ulong,
+      :Affinity, :pointer,
+      :PriorityClass, :ulong,
+      :SchedulingClass, :ulong
+    )
+  end
+
+  class JOBJECT_EXTENDED_LIMIT_INFORMATION < FFI::Struct
+    layout(
+      :BasicLimitInformation, JOBJECT_BASIC_LIMIT_INFORMATION,
+      :IoInfo, IO_COUNTERS,
+      :ProcessMemoryLimit, :size_t,
+      :JobMemoryLimit, :size_t,
+      :PeakProcessMemoryUsed, :size_t,
+      :PeakJobMemoryUsed, :size_t
+    )
+  end
+
+  class SECURITY_ATTRIBUTES < FFI::Struct
+    layout(
+      :nLength, :ulong,
+      :lpSecurityDescriptor, :pointer,
+      :bInheritHandle, :bool
+    )
+  end
+
+  # sizeof(STARTUPINFO) == 68
+  class STARTUPINFO < FFI::Struct
+    layout(
+      :cb, :ulong,
+      :lpReserved, :string,
+      :lpDesktop, :string,
+      :lpTitle, :string,
+      :dwX, :ulong,
+      :dwY, :ulong,
+      :dwXSize, :ulong,
+      :dwYSize, :ulong,
+      :dwXCountChars, :ulong,
+      :dwYCountChars, :ulong,
+      :dwFillAttribute, :ulong,
+      :dwFlags, :ulong,
+      :wShowWindow, :short,
+      :cbReserved2, :short,
+      :lpReserved2, :pointer,
+      :hStdInput, :ulong,
+      :hStdOutput, :ulong,
+      :hStdError, :ulong
+    )
+  end
+
+  class PROCESS_INFORMATION < FFI::Struct
+    layout(
+      :hProcess, :ulong,
+      :hThread, :ulong,
+      :dwProcessId, :ulong,
+      :dwThreadId, :ulong
+    )
+  end
+
+  class OSVERSIONINFO < FFI::Struct
+    layout(
+      :dwOSVersionInfoSize, :ulong,
+      :dwMajorVersion, :ulong,
+      :dwMinorVersion, :ulong,
+      :dwBuildNumber, :ulong,
+      :dwPlatformId, :ulong,
+      :szCSDVersion, [:char, 128]
+    )
+  end
+
+  # Used by Process.create
+  ProcessInfo = Struct.new("ProcessInfo",
+    :process_handle,
+    :thread_handle,
+    :process_id,
+    :thread_id
+  )
+end