win32-process 0.6.2 → 0.6.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/CHANGES +189 -180
- data/MANIFEST +10 -10
- data/README +117 -118
- data/Rakefile +28 -35
- data/examples/test_create.rb +39 -39
- data/examples/test_fork_wait.rb +33 -33
- data/examples/test_fork_waitpid.rb +50 -50
- data/examples/test_kill.rb +34 -34
- data/lib/win32/process.rb +1098 -1004
- data/test/test_win32_process.rb +207 -179
- data/win32-process.gemspec +29 -29
- metadata +47 -19
data/CHANGES
CHANGED
|
@@ -1,180 +1,189 @@
|
|
|
1
|
-
= 0.6.
|
|
2
|
-
* Fixed
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
* Added the Process.
|
|
7
|
-
|
|
8
|
-
*
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
* Added
|
|
16
|
-
|
|
17
|
-
*
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
*
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
* Fixed
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
*
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
*
|
|
75
|
-
*
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
*
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
*
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
*
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
*
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
*
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
*
|
|
118
|
-
|
|
119
|
-
*
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
*
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
*
|
|
129
|
-
|
|
130
|
-
*
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
*
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
*
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
*
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
*
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
1
|
+
= 0.6.3 - 9-Nov-2010
|
|
2
|
+
* Fixed a bug in the Process.kill method where the remote thread created
|
|
3
|
+
was not being properly closed. Thanks go to Ben Nagy for the spot.
|
|
4
|
+
* Added the Process.job? method that returns whether or not the current process
|
|
5
|
+
is already in a job.
|
|
6
|
+
* Added the Process.setrlimit method. Like the Process.getrlimit method it
|
|
7
|
+
only supports a limited subset of resources.
|
|
8
|
+
* Rakefile tweaks.
|
|
9
|
+
|
|
10
|
+
= 0.6.2 - 19-Dec-2009
|
|
11
|
+
* Fixed an issue where stdin, stdout and stderr might not be inheritable
|
|
12
|
+
even if the inherit option was set. Thanks go to Michael Buselli for the
|
|
13
|
+
spot and the patch.
|
|
14
|
+
* Added a basic implementation of Process.getrlimit.
|
|
15
|
+
* Added the Process.get_affinity method.
|
|
16
|
+
* Added test-unit 2.x and sys-proctable as development dependencies.
|
|
17
|
+
* Added the :uninstall and :build_gem Rake tasks to the Rakefile.
|
|
18
|
+
* Bumped required version of windows-pr to 1.0.6.
|
|
19
|
+
|
|
20
|
+
= 0.6.1 - 16-Jul-2009
|
|
21
|
+
* Added the Process.uid method. This method returns a user id (really, the RID
|
|
22
|
+
of the SID) by default, but can also take an optional parameter to return
|
|
23
|
+
a binary SID instead at the user's discretion.
|
|
24
|
+
* Added working implementations of Process.getpriority and Process.setpriority.
|
|
25
|
+
Note they they only work for processes, not process groups or users.
|
|
26
|
+
* Set license to Artistic 2.0, and updated the gemspec.
|
|
27
|
+
|
|
28
|
+
= 0.6.0 - 31-Oct-2008
|
|
29
|
+
* The mandatory argument for Process.create has been switched from 'app_name'
|
|
30
|
+
to 'command_line', to be more in line with underlying CreateProcess API.
|
|
31
|
+
Note that 'command_line' will default to 'app_name' if only the latter is
|
|
32
|
+
set, but both may be set individually. Keep in mind that 'app_name' must
|
|
33
|
+
be a full path to the executable. Thanks go to Jeremy Bopp for the patch.
|
|
34
|
+
* Removed the deprecated ProcessError constant. Use Process::Error instead.
|
|
35
|
+
* Explicitly include and extend the Windows::Thread module now. Thanks go to
|
|
36
|
+
Qi Lu for the spot.
|
|
37
|
+
* Slightly more robust internal code handling for some of the other methods,
|
|
38
|
+
typically related to ensuring that HANDLE's are closed.
|
|
39
|
+
* Example programs are now included with the gem.
|
|
40
|
+
|
|
41
|
+
= 0.5.9 - 14-Jun-2008
|
|
42
|
+
* Added a proper implementation of Process.ppid.
|
|
43
|
+
|
|
44
|
+
= 0.5.8 - 24-Mar-2008
|
|
45
|
+
* Fixed a bug in Process.create where the handles in the PROCESS_INFORMATION
|
|
46
|
+
struct were not closed, regardless of the 'close_handles' option. Thanks
|
|
47
|
+
go to Lars Christensen for the spot and the patch.
|
|
48
|
+
|
|
49
|
+
= 0.5.7 - 27-Mar-2008
|
|
50
|
+
* Fixed issues with thread_inherit and process_inherit in the Process.create
|
|
51
|
+
method. This in turn required an update to windows-pr. Thanks go to Steve
|
|
52
|
+
Shreeve for the spot.
|
|
53
|
+
* Fixed a potential issue with startf_flags and stdin/stdout/stderr handling.
|
|
54
|
+
Thanks again go to Steve Shreeve for the spot and the patch.
|
|
55
|
+
* Fixed the code so that it no longer emits redefinition warnings.
|
|
56
|
+
* Fixed a bug in the Rake install task (for non-gem installations).
|
|
57
|
+
|
|
58
|
+
== 0.5.6 - 13-Mar-2008
|
|
59
|
+
* Fixed a bug in the Process.waitpid2 method where it wasn't returning the
|
|
60
|
+
proper exit code. Thanks go to Jeremy Bopp for the spot and the patch.
|
|
61
|
+
* In the spirit of DWIM, if the 'stdin', 'stdout' or 'stderr' keys are
|
|
62
|
+
encountered in the startup_info hash, then the inherit flag is automatically
|
|
63
|
+
set to true and the startf_flags key is automatically OR'd with the
|
|
64
|
+
STARTF_USESTDHANDLES value. Thanks go to Sander Pool for the inspiration.
|
|
65
|
+
|
|
66
|
+
== 0.5.5 - 12-Dec-2007
|
|
67
|
+
* The Process.create method now automatically closes the process and thread
|
|
68
|
+
handles in the ProcessInfo struct before returning, unless you explicitly
|
|
69
|
+
tell it not to via the 'close_handles' option.
|
|
70
|
+
* The Process.create method now supports creating a process as another user
|
|
71
|
+
via the 'with_logon', 'password' and 'domain' options.
|
|
72
|
+
|
|
73
|
+
== 0.5.4 - 23-Nov-2007
|
|
74
|
+
* Changed ProcessError to Process::Error.
|
|
75
|
+
* Now requires windows-pr 0.7.3 or later because of some reorganization in
|
|
76
|
+
that library with regards to thread functions.
|
|
77
|
+
* Better cleanup of HANDLE's in a couple methods when failure occurs.
|
|
78
|
+
* Added an additional require/include necessitated by a change in the method
|
|
79
|
+
organization in the windows-pr library.
|
|
80
|
+
|
|
81
|
+
== 0.5.3 - 29-Jul-2007
|
|
82
|
+
* Added a Rakefile with tasks for installation and testing.
|
|
83
|
+
* Removed the install.rb file (now handled by the Rakefile).
|
|
84
|
+
* Updated the README and MANIFEST files.
|
|
85
|
+
|
|
86
|
+
== 0.5.2 - 22-Jan-2007
|
|
87
|
+
* The startup_info parameter for the Process.create method now accepts
|
|
88
|
+
'stdin', 'stdout', and 'stderr' as valid parameters, which you can pass
|
|
89
|
+
a Ruby IO object or a fileno in order to redirect output from the created
|
|
90
|
+
process.
|
|
91
|
+
|
|
92
|
+
== 0.5.1 - 24-Aug-2006
|
|
93
|
+
* Fixed a bug in the Process.create method where the return value for
|
|
94
|
+
CreateProcess() was being evaluated incorrectly. Thanks go to David Haney
|
|
95
|
+
for the spot.
|
|
96
|
+
* Added a slightly nicer error message if an invalid value is passed to the
|
|
97
|
+
Process.create method.
|
|
98
|
+
* Removed an extraneous '%' character from an error message.
|
|
99
|
+
|
|
100
|
+
== 0.5.0 - 29-Jul-2006
|
|
101
|
+
* The Process.create method now returns a ProcessInfo struct instead of the
|
|
102
|
+
pid. Note that you can still grab the pid out of the struct if needed.
|
|
103
|
+
* The Process.create method now allows the process_inherit and
|
|
104
|
+
thread_inherit options which determine whether a process or thread
|
|
105
|
+
object's handles are inheritable, respectively.
|
|
106
|
+
* The wait and wait2 methods will now work if GetProcessId() isn't defined
|
|
107
|
+
on your system.
|
|
108
|
+
* The 'inherit?' hash option was changed to just 'inherit' (no question mark).
|
|
109
|
+
* Minor doc correction - the 'inherit' option defaults to false, not true.
|
|
110
|
+
|
|
111
|
+
== 0.4.2 - 29-May-2006
|
|
112
|
+
* Fixed a typo/bug in Process.kill for signal 3, where I had accidentally
|
|
113
|
+
used CTRL_BRK_EVENT instead of the correct CTRL_BREAK_EVENT. Thanks go
|
|
114
|
+
to Luis Lavena for the spot.
|
|
115
|
+
|
|
116
|
+
== 0.4.1 - 13-May-2006
|
|
117
|
+
* Fixed a bug where spaces in $LOAD_PATH would cause Process.fork to fail.
|
|
118
|
+
Thanks go to Justin Bailey for the spot and patch.
|
|
119
|
+
* Added a short synopsis to the README file.
|
|
120
|
+
|
|
121
|
+
== 0.4.0 - 7-May-2006
|
|
122
|
+
* Now pure Ruby, courtesy of the Win32API package.
|
|
123
|
+
* Now comes with a gem.
|
|
124
|
+
* Modified Process.kill to send a signal to the current process if pid 0
|
|
125
|
+
is specified, as per the current 1.8 behavior.
|
|
126
|
+
* Process.create now accepts the 'environment' key/value, where you can
|
|
127
|
+
pass a semicolon-separated string as the environment for the new process.
|
|
128
|
+
* Moved the GUI related options of Process.create to subkeys of the
|
|
129
|
+
'startup_info' key. See documentation for details.
|
|
130
|
+
* Replaced Win32::ProcessError with just ProcessError.
|
|
131
|
+
|
|
132
|
+
== 0.3.3 - 16-Apr-2006
|
|
133
|
+
* Fixed a bug in Process.create with regards to creation_flags. Thanks go
|
|
134
|
+
to Tophe Vigny for the spot.
|
|
135
|
+
|
|
136
|
+
== 0.3.2 - 12-Aug-2005
|
|
137
|
+
* Fixed a bug in Process.kill where a segfault could occur. Thanks go to
|
|
138
|
+
Bill Atkins for the spot.
|
|
139
|
+
* Changed VERSION to WIN32_PROCESS_VERSION, because it's a module.
|
|
140
|
+
* Made the CHANGES, README and doc/process.txt documents rdoc friendly.
|
|
141
|
+
* Removed the process.rd file.
|
|
142
|
+
|
|
143
|
+
== 0.3.1 - 9-Dec-2004
|
|
144
|
+
* Modified Process.fork to return an actual PID instead of a handle. This
|
|
145
|
+
means that it should work with Process.kill and other methods that expect
|
|
146
|
+
an actual PID.
|
|
147
|
+
* Modified Process.kill to understand the strings "SIGINT", "INT", "SIGBRK",
|
|
148
|
+
"BRK", "SIGKILL" and "KILL". These correspond to signals 2, 3 and 9,
|
|
149
|
+
respectively.
|
|
150
|
+
* Added better $LOAD_PATH handling for Process.fork. Thanks go to Aslak
|
|
151
|
+
Hellesoy for the spot and the patch.
|
|
152
|
+
* Replaced all instances of rb_sys_fail(0) with rb_raise(). This is because
|
|
153
|
+
of a strange bug in the Windows Installer that hasn't been nailed down yet.
|
|
154
|
+
This means that you can't rescue Errno::ENOENT any more, but will have to
|
|
155
|
+
rescue StandardError. This only affects Process.kill.
|
|
156
|
+
* The signals that were formerly 1 and 2 and now 2 and 3. I did this because
|
|
157
|
+
I wanted the same signal number for SIGINT as it is on *nix.
|
|
158
|
+
* Added a test_kill.rb script under the examples directory.
|
|
159
|
+
* Other minor cleanup and corrections.
|
|
160
|
+
|
|
161
|
+
== 0.3.0 - 25-Jul-2004
|
|
162
|
+
* Added the create() method.
|
|
163
|
+
* Moved the example programs to doc/examples.
|
|
164
|
+
* Updated the docs, and toned down claims of fork's similarity to the Unix
|
|
165
|
+
version.
|
|
166
|
+
* Minor updates to the test suite.
|
|
167
|
+
|
|
168
|
+
== 0.2.1 - 17-May-2004
|
|
169
|
+
* Made all methods module functions, except fork, rather than singleton
|
|
170
|
+
methods.
|
|
171
|
+
* Minor doc changes.
|
|
172
|
+
|
|
173
|
+
== 0.2.0 - 11-May-2004
|
|
174
|
+
* Removed the Win32 module/namespace. You no longer 'include Win32' and you
|
|
175
|
+
no longer need to prefix Process with 'Win32::'.
|
|
176
|
+
* The fork() method is now a global function as well as a method of the
|
|
177
|
+
Process module. That means you can call 'fork' instead of 'Process.fork'
|
|
178
|
+
if you like.
|
|
179
|
+
* Doc updates to reflect the above changes.
|
|
180
|
+
|
|
181
|
+
== 0.1.1 - 6-Mar-2004
|
|
182
|
+
* Fixed bug where spaces in the directory name caused the fork() method to
|
|
183
|
+
fail (Park).
|
|
184
|
+
* Normalized tc_process.rb somewhat to make it easier to run outside of the
|
|
185
|
+
test directory if desired.
|
|
186
|
+
* Fixed up tc_process.rb a bit.
|
|
187
|
+
|
|
188
|
+
== 0.1.0 - 19-Feb-2004
|
|
189
|
+
* Initial release
|
data/MANIFEST
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
* CHANGES
|
|
2
|
-
* README
|
|
3
|
-
* MANIFEST
|
|
4
|
-
* Rakefile
|
|
5
|
-
* win32-process.gemspec
|
|
6
|
-
* examples/test_create.rb
|
|
7
|
-
* examples/test_fork_wait.rb
|
|
8
|
-
* examples/test_fork_waitpid.rb
|
|
9
|
-
* examples/test_kill.rb
|
|
10
|
-
* lib/win32/process.rb
|
|
1
|
+
* CHANGES
|
|
2
|
+
* README
|
|
3
|
+
* MANIFEST
|
|
4
|
+
* Rakefile
|
|
5
|
+
* win32-process.gemspec
|
|
6
|
+
* examples/test_create.rb
|
|
7
|
+
* examples/test_fork_wait.rb
|
|
8
|
+
* examples/test_fork_waitpid.rb
|
|
9
|
+
* examples/test_kill.rb
|
|
10
|
+
* lib/win32/process.rb
|
|
11
11
|
* test/tc_process.rb
|
data/README
CHANGED
|
@@ -1,118 +1,117 @@
|
|
|
1
|
-
= Description
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
= Prerequisites
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
= Supported Platforms
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
= Installation
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
Daniel J. Berger
|
|
1
|
+
= Description
|
|
2
|
+
This package provides the fork, wait, wait2, waitpid, and waitpid2 methods
|
|
3
|
+
for MS Windows. In addition, it provides a different implementation of the
|
|
4
|
+
kill method, a proper implementation of Process.ppid, and decent analogues
|
|
5
|
+
of Process.getpriority, Process.setpriority and Process.getrlimit.
|
|
6
|
+
|
|
7
|
+
= Prerequisites
|
|
8
|
+
Ruby 1.8.2 or later.
|
|
9
|
+
The windows-pr library, 0.8.6 or later.
|
|
10
|
+
The sys-proctable library, 0.7.6 or later (test suite only).
|
|
11
|
+
The test-unit library, 2.0.3 or later (test suite only).
|
|
12
|
+
|
|
13
|
+
= Supported Platforms
|
|
14
|
+
This library is supported on Windows 2000 or later.
|
|
15
|
+
|
|
16
|
+
= Installation
|
|
17
|
+
gem install win32-process
|
|
18
|
+
|
|
19
|
+
= Synopsis
|
|
20
|
+
require 'win32/process'
|
|
21
|
+
|
|
22
|
+
Process.fork{
|
|
23
|
+
3.times{
|
|
24
|
+
puts 'In the child'
|
|
25
|
+
sleep 1
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
Process.wait
|
|
30
|
+
puts 'Done'
|
|
31
|
+
|
|
32
|
+
= Developer's Notes
|
|
33
|
+
== The Process.fork and Process.wait methods
|
|
34
|
+
The fork method is emulated on Windows by spawning another Ruby process
|
|
35
|
+
against $PROGRAM_NAME via the CreateProcess() Win32 API function. It will
|
|
36
|
+
use its parent's environment and starting directory.
|
|
37
|
+
|
|
38
|
+
The various wait methods are a wrapper for the WaitForSingleObject() or
|
|
39
|
+
WaitForMultipleObjects() Win32 API functions, for the wait* and waitpid*
|
|
40
|
+
methods, respectively. In the case of wait2 and waitpid2, the exit value
|
|
41
|
+
is returned via the GetExitCodeProcess() Win32API function.
|
|
42
|
+
|
|
43
|
+
For now the waitpid and waitpid2 calls do not accept a second argument.
|
|
44
|
+
That's because we haven't yet determined if there's a signal we should
|
|
45
|
+
allow to be sent.
|
|
46
|
+
|
|
47
|
+
IMPORTANT!
|
|
48
|
+
Note that because fork is calling CreateProcess($PROGRAM_NAME), it will
|
|
49
|
+
start again from the top of the script instead of from the point of the
|
|
50
|
+
call. We will try to address this in a future release, if possible.
|
|
51
|
+
|
|
52
|
+
== The Process.kill method
|
|
53
|
+
Initially, the kill method will try to get a HANDLE on the PID using the
|
|
54
|
+
OpenProcess() function. If that succeeds, we know the process is running.
|
|
55
|
+
|
|
56
|
+
In the event of signal 2 or signal 3, the GenerateConsoleCtrlEvent()
|
|
57
|
+
function is used to send a signal to that process. These will not kill
|
|
58
|
+
GUI processes. It will not (currently) send a signal to remote
|
|
59
|
+
processes.
|
|
60
|
+
|
|
61
|
+
In the event of signal 1 or 4-8, the CreateRemoteThread() function is used
|
|
62
|
+
after the HANDLE's process has been identified to create a thread
|
|
63
|
+
within that process. The ExitProcess() function is then sent to that
|
|
64
|
+
thread.
|
|
65
|
+
|
|
66
|
+
In the event of signal 9, the TerminateProcess() function is called. This
|
|
67
|
+
will almost certainly kill the process, but doesn't give the process a
|
|
68
|
+
chance to necessarily do any cleanup it might otherwise do.
|
|
69
|
+
|
|
70
|
+
== The Process.ppid method
|
|
71
|
+
In MRI the Process.ppid always returns 0 on MS Windows. With this library
|
|
72
|
+
it returns the actual parent pid.
|
|
73
|
+
|
|
74
|
+
== Differences between Ruby's kill and the Win32 Utils kill
|
|
75
|
+
Ruby does not currently use the CreateRemoteThread() + ExitProcess()
|
|
76
|
+
approach which is, according to everything I've read, a cleaner approach.
|
|
77
|
+
This includes not only online research but also Jeffrey Richter's
|
|
78
|
+
"Advanced Windows Programming, 3rd Edition."
|
|
79
|
+
|
|
80
|
+
Also, the way Process.kill handles multiple pids works slightly differently
|
|
81
|
+
(and better IMHO) in the Win32 Utils version than the way Ruby currently
|
|
82
|
+
provides.
|
|
83
|
+
|
|
84
|
+
The reason Process.kill was originally added, in case anyone cares for
|
|
85
|
+
historical trivia, is that Ruby 1.6.x did not support Process.kill on
|
|
86
|
+
Windows at all.
|
|
87
|
+
|
|
88
|
+
= Notes
|
|
89
|
+
It is unlikely you will be able to kill system processes with this module.
|
|
90
|
+
It's probably better that you don't.
|
|
91
|
+
|
|
92
|
+
= Known Bugs
|
|
93
|
+
None known (though please see the +Details+ section for quirks). Any
|
|
94
|
+
bugs should be reported on the project page at
|
|
95
|
+
http://rubyforge.org/projects/win32utils.
|
|
96
|
+
|
|
97
|
+
= Future Plans
|
|
98
|
+
Train Process.fork to execute from the point of the call rather than the
|
|
99
|
+
top of the script (if possible).
|
|
100
|
+
|
|
101
|
+
Other suggestions welcome.
|
|
102
|
+
|
|
103
|
+
= License
|
|
104
|
+
Artistic 2.0
|
|
105
|
+
|
|
106
|
+
= Copyright
|
|
107
|
+
(C) 2003-2010 Daniel J. Berger
|
|
108
|
+
All Rights Reserved
|
|
109
|
+
|
|
110
|
+
= Warranty
|
|
111
|
+
This library is provided "as is" and without any express or
|
|
112
|
+
implied warranties, including, without limitation, the implied
|
|
113
|
+
warranties of merchantability and fitness for a particular purpose.
|
|
114
|
+
|
|
115
|
+
= Author(s)
|
|
116
|
+
Park Heesob
|
|
117
|
+
Daniel J. Berger
|