proc-wait3 1.9.0 → 1.9.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +5 -8
- data/CHANGES.md +4 -0
- data/Gemfile +2 -7
- data/MANIFEST.md +1 -1
- data/README.md +6 -4
- data/Rakefile +1 -1
- data/doc/wait3.md +225 -0
- data/examples/example_pause.rb +1 -1
- data/ext/extconf.rb +2 -15
- data/ext/proc/wait3.c +45 -38
- data/proc-wait3.gemspec +8 -7
- data/spec/proc_wait3_spec.rb +40 -32
- data.tar.gz.sig +0 -0
- metadata +6 -5
- metadata.gz.sig +2 -2
- data/doc/wait3.txt +0 -192
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: d2054430d4049b9aa27f1902f704220818bf4e6b8d7d19e428e10e3ed736d6c9
|
|
4
|
+
data.tar.gz: 9be23be7ddad009649f5ec83692102b05334a9013d99a68f1643c1c2eda37b62
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: a6f95da3b81622fd0a4ca7be57f787ec63201be854f28bcb023aec9af3360ef8ec6af228ca3c180dfa7163831456aa57fd68ced837cb40d46f3b262e2a2b4554
|
|
7
|
+
data.tar.gz: fff3abd919e4c0f07ab666ea3f3a1db8d514fa63802fd408b57c87f0c8208d6cf4e886813605156625bc00e8b931405098e5a714d34a91a00830287974603507
|
checksums.yaml.gz.sig
CHANGED
|
@@ -1,8 +1,5 @@
|
|
|
1
|
-
�
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
�
|
|
6
|
-
8�
|
|
7
|
-
K!
|
|
8
|
-
�9��a#q(p�Š�v�B]ڭ�N Ѡ]��_7f�汵��X� 땍
|
|
1
|
+
����M�]
|
|
2
|
+
{�)��N���Xy��*\��'D.˲�g��� >BpX`�/�u���G�F'
|
|
3
|
+
�R�Ѐ�gG��*%.�.{Z�:�eH\vC�R�� ZE��!��|�x��#�X����7�}e ����VzT_�H ���N. Z�#ڴ��%I Z �[�<C��,Ca����Ì1��`�CU�ݻ0�ٶ"iO�6���!��T� *��R��6g!����r��!�S���^-aZhRCv��Y�OW�k��&
|
|
4
|
+
?� �8�lz������� �82�&5Q�_�j� ��l��A����!e � W�&%�F<1��)D��&��k0�Y�f���25�<�(��m����=�6�]���E
|
|
5
|
+
�TT���b&�)
|
data/CHANGES.md
CHANGED
data/Gemfile
CHANGED
data/MANIFEST.md
CHANGED
data/README.md
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
[](https://github.com/djberg96/proc-wait3/actions/workflows/ruby.yml)
|
|
2
|
+
|
|
1
3
|
## Description
|
|
2
4
|
Adds the wait3, wait4, waitid, pause, sigsend, and getrusage methods to the Process module.
|
|
3
5
|
|
|
@@ -32,9 +34,9 @@ Linux users may also notice warnings about implicit declarations. These
|
|
|
32
34
|
are also harmless, and can be silenced by installing the libbsd-dev package
|
|
33
35
|
first.
|
|
34
36
|
|
|
35
|
-
|
|
36
|
-
the WNOHANG flag
|
|
37
|
-
|
|
37
|
+
These methods may fail in conjunction with `fork` with `Errno::EINTR` unless
|
|
38
|
+
you pass the WNOHANG flag, or explicitly ignore the `SIGCHLD` signal. Ruby's
|
|
39
|
+
own `wait` methods appear to essentially be doing that behind the scenes.
|
|
38
40
|
|
|
39
41
|
## Integration with Ruby's process.c
|
|
40
42
|
I considered simply providing a patch to the core process.c file, but I
|
|
@@ -50,4 +52,4 @@ trouble of typing the word "status", since all they're for is comparing or
|
|
|
50
52
|
operating on the status attribute.
|
|
51
53
|
|
|
52
54
|
## Additional Documentation
|
|
53
|
-
Please see the doc/wait3.
|
|
55
|
+
Please see the doc/wait3.md file for detailed documentation.
|
data/Rakefile
CHANGED
|
@@ -30,7 +30,7 @@ namespace :gem do
|
|
|
30
30
|
desc "Create the proc-wait3 gem"
|
|
31
31
|
task :create => [:clean] do
|
|
32
32
|
require 'rubygems/package'
|
|
33
|
-
spec =
|
|
33
|
+
spec = Gem::Specification.load('proc-wait3.gemspec')
|
|
34
34
|
spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
|
|
35
35
|
Gem::Package.build(spec)
|
|
36
36
|
end
|
data/doc/wait3.md
ADDED
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
## Description
|
|
2
|
+
Adds the `wait3`, `wait4`, `waitid`, `pause`, `sigsend`, and `getrusage`
|
|
3
|
+
methods to the Process module.
|
|
4
|
+
|
|
5
|
+
## Synopsis
|
|
6
|
+
```ruby
|
|
7
|
+
require 'proc/wait3'
|
|
8
|
+
|
|
9
|
+
pid = fork{ sleep 1; exit 2 }
|
|
10
|
+
p Time.now
|
|
11
|
+
Process.wait3
|
|
12
|
+
p $?
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Module Methods
|
|
16
|
+
### `Process.pause(signals=nil)`
|
|
17
|
+
|
|
18
|
+
Pauses the current process. If the process receives any of the signals
|
|
19
|
+
you pass as arguments it will return from the pause and continue with
|
|
20
|
+
the execution of your code. Otherwise, it will exit.
|
|
21
|
+
|
|
22
|
+
Note that you must leave out the 'SIG' prefix for the signal name, e.g.
|
|
23
|
+
use 'INT', not 'SIGINT'.
|
|
24
|
+
|
|
25
|
+
Returns the result of the underlying `pause()` function, which should always be -1.
|
|
26
|
+
|
|
27
|
+
### `Process.sigsend(idtype, id, signal=0)`
|
|
28
|
+
|
|
29
|
+
Sends a signal of type "idtype" to a process or process group "id". This
|
|
30
|
+
is more versatile method of sending signals to processes than Process.kill.
|
|
31
|
+
|
|
32
|
+
For a list of valid idtype values, see the "Process type constants" below.
|
|
33
|
+
Not supported on all platforms.
|
|
34
|
+
|
|
35
|
+
### `Proc.wait3(flags=0)`
|
|
36
|
+
|
|
37
|
+
Delays its caller until a signal is received or one of its child processes
|
|
38
|
+
terminates or stops due to tracing.
|
|
39
|
+
|
|
40
|
+
The return value is a ProcStat structure and sets the `$last_status` global
|
|
41
|
+
variable. The special global $? is also set. Raises a SystemError if there
|
|
42
|
+
are no child processes.
|
|
43
|
+
|
|
44
|
+
### `Proc.wait4(pid, flags=0)`
|
|
45
|
+
|
|
46
|
+
Waits for the given child process to exit. Returns a ProcStat structure.
|
|
47
|
+
The `$last_status` global variable is set. Also sets the `$?` special global
|
|
48
|
+
variable.
|
|
49
|
+
|
|
50
|
+
### `Proc.waitid(id_type, id_num=nil, options=nil)`
|
|
51
|
+
|
|
52
|
+
Suspends the calling process until one of its children changes state,
|
|
53
|
+
returning immediately if a child process changed state prior to the call.
|
|
54
|
+
The state of a child process will change if it terminates, stops because
|
|
55
|
+
of a signal, becomes trapped or reaches a breakpoint.
|
|
56
|
+
|
|
57
|
+
The `id_num` corresponds to a process ID or process group ID, depending on
|
|
58
|
+
the value of `id_type`, which may be `Process::P_PID`, `Process::P_PGID` or
|
|
59
|
+
`Process::P_ALL`. If `id_type` is `Process::P_ALL`, then the `id_num` is ignored.
|
|
60
|
+
|
|
61
|
+
The options argument is used to specify which state changes are to be
|
|
62
|
+
waited for. It is constructed from the bitwise-OR of one or more of the
|
|
63
|
+
following constants:
|
|
64
|
+
|
|
65
|
+
* Process::WCONTINUED
|
|
66
|
+
* Process::WEXITED
|
|
67
|
+
* Process::WNOHANG
|
|
68
|
+
* Process::WNOWAIT
|
|
69
|
+
* Process::WSTOPPED
|
|
70
|
+
* Process::WTRAPPED (not supported on all platforms)
|
|
71
|
+
|
|
72
|
+
If `Process::WNOHANG` is set as an option, this method will return
|
|
73
|
+
immediately, whether or not a child has changed state.
|
|
74
|
+
|
|
75
|
+
Calling this method with an `id_type` of `Process::P_ALL` and the options set
|
|
76
|
+
to `Process::EXITED | Process::WTRAPPED` is equivalent to calling
|
|
77
|
+
Process.wait.
|
|
78
|
+
|
|
79
|
+
Returns a `Proc::SigInfo` struct and sets `$?`.
|
|
80
|
+
|
|
81
|
+
Not supported on all platforms.
|
|
82
|
+
|
|
83
|
+
## Standard Constants
|
|
84
|
+
`Process::WAIT3_VERSION`
|
|
85
|
+
|
|
86
|
+
Returns the version of this package as a string.
|
|
87
|
+
|
|
88
|
+
## Process type constants - all platforms
|
|
89
|
+
`Process::P_ALL`
|
|
90
|
+
|
|
91
|
+
All non-system process.
|
|
92
|
+
|
|
93
|
+
`Process::P_PID`
|
|
94
|
+
|
|
95
|
+
A standard process id.
|
|
96
|
+
|
|
97
|
+
`Process::P_PGID`
|
|
98
|
+
|
|
99
|
+
Any non-system process group id.
|
|
100
|
+
|
|
101
|
+
## Process type constants - not all platforms supported
|
|
102
|
+
`Process::P_CID`
|
|
103
|
+
|
|
104
|
+
A scheduler process id.
|
|
105
|
+
|
|
106
|
+
`Process::P_GID`
|
|
107
|
+
|
|
108
|
+
Any non-system effective process group id.
|
|
109
|
+
|
|
110
|
+
`Process::P_PROJID`
|
|
111
|
+
|
|
112
|
+
A project process id. Solaris 8 or later only.
|
|
113
|
+
|
|
114
|
+
`Process::P_SID`
|
|
115
|
+
|
|
116
|
+
A session process id.
|
|
117
|
+
|
|
118
|
+
`Process::P_TASKID`
|
|
119
|
+
|
|
120
|
+
A task process id. Solaris 8 or later only.
|
|
121
|
+
|
|
122
|
+
`Process::P_UID`
|
|
123
|
+
|
|
124
|
+
Any non-system effective process user id.
|
|
125
|
+
|
|
126
|
+
## Additional Process constants - defined if waitid is defined on your system
|
|
127
|
+
`Process::WCONTINUED`
|
|
128
|
+
|
|
129
|
+
Return the status for any child that was stopped and has been continued.
|
|
130
|
+
|
|
131
|
+
`Process::WEXITED`
|
|
132
|
+
|
|
133
|
+
Wait for process(es) to exit.
|
|
134
|
+
|
|
135
|
+
`Process::WNOWAIT`
|
|
136
|
+
|
|
137
|
+
Keep the process in a waitable state.
|
|
138
|
+
|
|
139
|
+
`Process::WSTOPPED`
|
|
140
|
+
|
|
141
|
+
Wait for and return the process status of any child that has stopped upon
|
|
142
|
+
receipt of a signal.
|
|
143
|
+
|
|
144
|
+
`Process::WTRAPPED`
|
|
145
|
+
|
|
146
|
+
Wait for traced process(es) to become trapped or reach a breakpoint.
|
|
147
|
+
|
|
148
|
+
Not supported on all platforms.
|
|
149
|
+
|
|
150
|
+
## RLIMIT constants
|
|
151
|
+
`Process::RLIMIT_AS`
|
|
152
|
+
|
|
153
|
+
A synonym for `RLIMIT_VMEM`.
|
|
154
|
+
|
|
155
|
+
`Process::RLIMIT_CORE`
|
|
156
|
+
|
|
157
|
+
The maximum size of a core file, in bytes, that may be created.
|
|
158
|
+
|
|
159
|
+
`Process::RLIMIT_CPU`
|
|
160
|
+
|
|
161
|
+
The maximum amount of CPU time, in seconds, the process is allowed to use.
|
|
162
|
+
|
|
163
|
+
`Process::RLIMIT_DATA`
|
|
164
|
+
|
|
165
|
+
The maximum size of the process' heap size, in bytes.
|
|
166
|
+
|
|
167
|
+
`Process::RLIMIT_FSIZE`
|
|
168
|
+
|
|
169
|
+
The maximum size of a file, in bytes, that the process may create.
|
|
170
|
+
|
|
171
|
+
`Process::RLIMIT_NOFILE`
|
|
172
|
+
|
|
173
|
+
The maximum value that the kernel may assign to a file descriptor,
|
|
174
|
+
effectively limiting the number of open files for the calling process.
|
|
175
|
+
|
|
176
|
+
`Process::RLIMIT_STACK`
|
|
177
|
+
|
|
178
|
+
The maximum size of the process' stack in bytes.
|
|
179
|
+
|
|
180
|
+
`Process::RLIMIT_VMEM`
|
|
181
|
+
|
|
182
|
+
The maximum size of the process' mapped address space.
|
|
183
|
+
|
|
184
|
+
`Process::RLIM_INFINITY`
|
|
185
|
+
|
|
186
|
+
A infinite limit.
|
|
187
|
+
|
|
188
|
+
`Process::RLIM_SAVED_CUR`
|
|
189
|
+
|
|
190
|
+
Current soft limit.
|
|
191
|
+
|
|
192
|
+
`Process::RLIM_SAVED_MAX`
|
|
193
|
+
|
|
194
|
+
Current hard limit.
|
|
195
|
+
|
|
196
|
+
## Notes
|
|
197
|
+
The `wait3` and `wait4` methods are similar to the `wait2` and `waitpid2`
|
|
198
|
+
methods, except that they return much more information via the rusage
|
|
199
|
+
struct.
|
|
200
|
+
|
|
201
|
+
## Future Plans
|
|
202
|
+
Wrap the wait6 function, and add better BSD support in general.
|
|
203
|
+
|
|
204
|
+
## Known Bugs
|
|
205
|
+
None that I'm aware of. Please log any bugs on the Github project
|
|
206
|
+
page at https://github.com/djberg96/proc-wait3.
|
|
207
|
+
|
|
208
|
+
## License
|
|
209
|
+
Apache-2.0
|
|
210
|
+
|
|
211
|
+
## Copyright
|
|
212
|
+
(C) 2003-2024 Daniel J. Berger
|
|
213
|
+
|
|
214
|
+
All Rights Reserved.
|
|
215
|
+
|
|
216
|
+
## Warranty
|
|
217
|
+
This package is provided "as is" and without any express or
|
|
218
|
+
implied warranties, including, without limitation, the implied
|
|
219
|
+
warranties of merchantability and fitness for a particular purpose.
|
|
220
|
+
|
|
221
|
+
## Author
|
|
222
|
+
Daniel J. Berger
|
|
223
|
+
|
|
224
|
+
## See also
|
|
225
|
+
wait3, wait4, waitid, pause, sigsend
|
data/examples/example_pause.rb
CHANGED
data/ext/extconf.rb
CHANGED
|
@@ -7,7 +7,7 @@ require 'mkmf'
|
|
|
7
7
|
dir_config('proc-wait3')
|
|
8
8
|
|
|
9
9
|
have_header('wait.h')
|
|
10
|
-
have_header('sys/resource.h')
|
|
10
|
+
have_header('sys/resource.h') # apt install libbsd-dev
|
|
11
11
|
have_header('sys/wait.h')
|
|
12
12
|
|
|
13
13
|
# wait3 is mandatory.
|
|
@@ -53,20 +53,7 @@ have_struct_member('struct siginfo', 'si_stime', 'signal.h')
|
|
|
53
53
|
|
|
54
54
|
have_const('P_CID', 'signal.h')
|
|
55
55
|
have_const('P_GID', 'signal.h')
|
|
56
|
-
have_const('P_MYID', 'signal.
|
|
57
|
-
layout(
|
|
58
|
-
:pw_name, :string,
|
|
59
|
-
:pw_passwd, :string,
|
|
60
|
-
:pw_uid, :uint,
|
|
61
|
-
:pw_gid, :uint,
|
|
62
|
-
:pw_change, :ulong,
|
|
63
|
-
:pw_class, :string,
|
|
64
|
-
:pw_gecos, :string,
|
|
65
|
-
:pw_dir, :string,
|
|
66
|
-
:pw_shell, :string,
|
|
67
|
-
:pw_expire, :ulong
|
|
68
|
-
)
|
|
69
|
-
end')
|
|
56
|
+
have_const('P_MYID', 'signal.h')
|
|
70
57
|
have_const('P_SID', 'signal.h')
|
|
71
58
|
have_const('P_UID', 'signal.h')
|
|
72
59
|
|
data/ext/proc/wait3.c
CHANGED
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
VALUE v_last_status;
|
|
30
30
|
VALUE v_procstat_struct, v_siginfo_struct, v_usage_struct;
|
|
31
31
|
|
|
32
|
-
static void sigproc(int signum);
|
|
32
|
+
static void sigproc(int signum, siginfo_t* info, void* ucontext);
|
|
33
33
|
|
|
34
34
|
/*
|
|
35
35
|
* Returns true if this process is stopped. This is only returned
|
|
@@ -163,22 +163,22 @@ static VALUE proc_wait3(int argc, VALUE *argv, VALUE mod){
|
|
|
163
163
|
v_last_status = rb_struct_new(v_procstat_struct,
|
|
164
164
|
INT2FIX(pid),
|
|
165
165
|
INT2FIX(status),
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
166
|
+
rb_float_new((double)r.ru_utime.tv_sec+(double)r.ru_utime.tv_usec/1e6),
|
|
167
|
+
rb_float_new((double)r.ru_stime.tv_sec+(double)r.ru_stime.tv_usec/1e6),
|
|
168
|
+
LONG2NUM(r.ru_maxrss),
|
|
169
|
+
LONG2NUM(r.ru_ixrss),
|
|
170
|
+
LONG2NUM(r.ru_idrss),
|
|
171
|
+
LONG2NUM(r.ru_isrss),
|
|
172
|
+
LONG2NUM(r.ru_minflt),
|
|
173
|
+
LONG2NUM(r.ru_majflt),
|
|
174
|
+
LONG2NUM(r.ru_nswap),
|
|
175
|
+
LONG2NUM(r.ru_inblock),
|
|
176
|
+
LONG2NUM(r.ru_oublock),
|
|
177
|
+
LONG2NUM(r.ru_msgsnd),
|
|
178
|
+
LONG2NUM(r.ru_msgrcv),
|
|
179
|
+
LONG2NUM(r.ru_nsignals),
|
|
180
|
+
LONG2NUM(r.ru_nvcsw),
|
|
181
|
+
LONG2NUM(r.ru_nivcsw),
|
|
182
182
|
pst_wifstopped(status),
|
|
183
183
|
pst_wifsignaled(status),
|
|
184
184
|
pst_wifexited(status),
|
|
@@ -235,22 +235,22 @@ static VALUE proc_wait4(int argc, VALUE *argv, VALUE mod){
|
|
|
235
235
|
v_last_status = rb_struct_new(v_procstat_struct,
|
|
236
236
|
INT2FIX(pid),
|
|
237
237
|
INT2FIX(status),
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
238
|
+
rb_float_new((double)r.ru_utime.tv_sec+(double)r.ru_utime.tv_usec/1e6),
|
|
239
|
+
rb_float_new((double)r.ru_stime.tv_sec+(double)r.ru_stime.tv_usec/1e6),
|
|
240
|
+
LONG2NUM(r.ru_maxrss),
|
|
241
|
+
LONG2NUM(r.ru_ixrss),
|
|
242
|
+
LONG2NUM(r.ru_idrss),
|
|
243
|
+
LONG2NUM(r.ru_isrss),
|
|
244
|
+
LONG2NUM(r.ru_minflt),
|
|
245
|
+
LONG2NUM(r.ru_majflt),
|
|
246
|
+
LONG2NUM(r.ru_nswap),
|
|
247
|
+
LONG2NUM(r.ru_inblock),
|
|
248
|
+
LONG2NUM(r.ru_oublock),
|
|
249
|
+
LONG2NUM(r.ru_msgsnd),
|
|
250
|
+
LONG2NUM(r.ru_msgrcv),
|
|
251
|
+
LONG2NUM(r.ru_nsignals),
|
|
252
|
+
LONG2NUM(r.ru_nvcsw),
|
|
253
|
+
LONG2NUM(r.ru_nivcsw),
|
|
254
254
|
pst_wifstopped(status),
|
|
255
255
|
pst_wifsignaled(status),
|
|
256
256
|
pst_wifexited(status),
|
|
@@ -572,7 +572,7 @@ static VALUE proc_waitid(int argc, VALUE* argv, VALUE mod){
|
|
|
572
572
|
*/
|
|
573
573
|
static VALUE proc_pause(int argc, VALUE* argv, VALUE mod){
|
|
574
574
|
VALUE v_signals;
|
|
575
|
-
int i;
|
|
575
|
+
int i, res;
|
|
576
576
|
long len;
|
|
577
577
|
|
|
578
578
|
rb_scan_args(argc, argv, "0*", &v_signals);
|
|
@@ -585,6 +585,7 @@ static VALUE proc_pause(int argc, VALUE* argv, VALUE mod){
|
|
|
585
585
|
char signame[SIG2STR_MAX];
|
|
586
586
|
unsigned int max = SIG2STR_MAX;
|
|
587
587
|
int signum;
|
|
588
|
+
struct sigaction act, sa;
|
|
588
589
|
|
|
589
590
|
for(i = 0; i < len; i++){
|
|
590
591
|
v_val = rb_ary_shift(v_signals);
|
|
@@ -613,7 +614,13 @@ static VALUE proc_pause(int argc, VALUE* argv, VALUE mod){
|
|
|
613
614
|
signum = NUM2INT(v_val);
|
|
614
615
|
}
|
|
615
616
|
|
|
616
|
-
|
|
617
|
+
memset(&act, 0, sizeof(act));
|
|
618
|
+
act.sa_flags = SA_SIGINFO;
|
|
619
|
+
act.sa_sigaction = sigproc;
|
|
620
|
+
res = sigaction(signum, &act, &sa);
|
|
621
|
+
|
|
622
|
+
if(res)
|
|
623
|
+
rb_sys_fail("sigaction");
|
|
617
624
|
}
|
|
618
625
|
}
|
|
619
626
|
|
|
@@ -624,7 +631,7 @@ static VALUE proc_pause(int argc, VALUE* argv, VALUE mod){
|
|
|
624
631
|
* This is just a placeholder proc to prevent the "pause" method from exiting
|
|
625
632
|
* the program if the appropriate signal is intercepted.
|
|
626
633
|
*/
|
|
627
|
-
static void sigproc(int signum){ /* Do nothing */ }
|
|
634
|
+
static void sigproc(int signum, siginfo_t* info, void* ucontext){ /* Do nothing */ }
|
|
628
635
|
|
|
629
636
|
#ifdef HAVE_SIGSEND
|
|
630
637
|
/*
|
|
@@ -787,7 +794,7 @@ static VALUE proc_getdtablesize(VALUE mod){
|
|
|
787
794
|
* Adds the wait3, wait4, waitid, pause, sigsend, and getrusage methods to the
|
|
788
795
|
* Process module.
|
|
789
796
|
*/
|
|
790
|
-
void Init_wait3()
|
|
797
|
+
void Init_wait3(void)
|
|
791
798
|
{
|
|
792
799
|
v_procstat_struct =
|
|
793
800
|
rb_struct_define("ProcStat","pid","status","utime","stime","maxrss",
|
|
@@ -955,7 +962,7 @@ void Init_wait3()
|
|
|
955
962
|
#endif
|
|
956
963
|
|
|
957
964
|
/* 1.9.0: The version of the proc-wait3 library */
|
|
958
|
-
rb_define_const(rb_mProcess, "WAIT3_VERSION", rb_str_freeze(rb_str_new2("1.9.
|
|
965
|
+
rb_define_const(rb_mProcess, "WAIT3_VERSION", rb_str_freeze(rb_str_new2("1.9.1")));
|
|
959
966
|
|
|
960
967
|
/* Define this last in our Init_wait3 function */
|
|
961
968
|
rb_define_readonly_variable("$last_status", &v_last_status);
|
data/proc-wait3.gemspec
CHANGED
|
@@ -2,7 +2,7 @@ require 'rubygems'
|
|
|
2
2
|
|
|
3
3
|
Gem::Specification.new do |spec|
|
|
4
4
|
spec.name = 'proc-wait3'
|
|
5
|
-
spec.version = '1.9.
|
|
5
|
+
spec.version = '1.9.1'
|
|
6
6
|
spec.author = 'Daniel J. Berger'
|
|
7
7
|
spec.license = 'Apache-2.0'
|
|
8
8
|
spec.email = 'djberg96@gmail.com'
|
|
@@ -17,12 +17,13 @@ Gem::Specification.new do |spec|
|
|
|
17
17
|
spec.add_development_dependency('rspec', '~> 3.9')
|
|
18
18
|
|
|
19
19
|
spec.metadata = {
|
|
20
|
-
'homepage_uri'
|
|
21
|
-
'bug_tracker_uri'
|
|
22
|
-
'changelog_uri'
|
|
23
|
-
'documentation_uri'
|
|
24
|
-
'source_code_uri'
|
|
25
|
-
'wiki_uri'
|
|
20
|
+
'homepage_uri' => 'https://github.com/djberg96/proc-wait3',
|
|
21
|
+
'bug_tracker_uri' => 'https://github.com/djberg96/proc-wait3/issues',
|
|
22
|
+
'changelog_uri' => 'https://github.com/djberg96/proc-wait3/blob/main/CHANGES.md',
|
|
23
|
+
'documentation_uri' => 'https://github.com/djberg96/proc-wait3/wiki',
|
|
24
|
+
'source_code_uri' => 'https://github.com/djberg96/proc-wait3',
|
|
25
|
+
'wiki_uri' => 'https://github.com/djberg96/proc-wait3/wiki',
|
|
26
|
+
'rubygems_mfa_required' => 'true'
|
|
26
27
|
}
|
|
27
28
|
|
|
28
29
|
spec.description = <<-EOF
|
data/spec/proc_wait3_spec.rb
CHANGED
|
@@ -9,11 +9,14 @@ require 'rspec'
|
|
|
9
9
|
require 'rbconfig'
|
|
10
10
|
|
|
11
11
|
RSpec.describe Process do
|
|
12
|
+
# Something in the guts of Ruby was being a pain.
|
|
13
|
+
Signal.trap('CHLD', 'IGNORE') if RUBY_VERSION.to_f < 3
|
|
14
|
+
|
|
12
15
|
let(:solaris) { RbConfig::CONFIG['host_os'] =~ /sunos|solaris/i }
|
|
13
16
|
let(:darwin) { RbConfig::CONFIG['host_os'] =~ /darwin|osx/i }
|
|
14
17
|
let(:hpux) { RbConfig::CONFIG['host_os'] =~ /hpux/i }
|
|
15
18
|
let(:linux) { RbConfig::CONFIG['host_os'] =~ /linux/i }
|
|
16
|
-
let(:
|
|
19
|
+
let(:bsd) { RbConfig::CONFIG['host_os'] =~ /bsd|dragonfly/i }
|
|
17
20
|
|
|
18
21
|
let(:proc_stat_members) {
|
|
19
22
|
%i[
|
|
@@ -25,10 +28,11 @@ RSpec.describe Process do
|
|
|
25
28
|
|
|
26
29
|
before do
|
|
27
30
|
@proc_stat = nil
|
|
31
|
+
@pid = nil
|
|
28
32
|
end
|
|
29
33
|
|
|
30
34
|
example "version constant is set to expected value" do
|
|
31
|
-
expect(Process::WAIT3_VERSION).to eq('1.9.
|
|
35
|
+
expect(Process::WAIT3_VERSION).to eq('1.9.1')
|
|
32
36
|
expect(Process::WAIT3_VERSION).to be_frozen
|
|
33
37
|
end
|
|
34
38
|
|
|
@@ -38,25 +42,25 @@ RSpec.describe Process do
|
|
|
38
42
|
|
|
39
43
|
example "wait3 works as expected" do
|
|
40
44
|
skip 'wait3 test skipped on this platform' if darwin
|
|
41
|
-
fork{ sleep 0.5 }
|
|
45
|
+
@pid = fork{ sleep 0.5 }
|
|
42
46
|
expect{ Process.wait3 }.not_to raise_error
|
|
43
47
|
end
|
|
44
48
|
|
|
45
49
|
example "wait3 returns the expected proc status members" do
|
|
46
50
|
skip 'wait3 test skipped on this platform' if darwin
|
|
47
|
-
fork{ sleep 0.5 }
|
|
51
|
+
@pid = fork{ sleep 0.5 }
|
|
48
52
|
expect{ @proc_stat = Process.wait3 }.not_to raise_error
|
|
49
53
|
expect( @proc_stat.members).to eq(proc_stat_members)
|
|
50
54
|
end
|
|
51
55
|
|
|
52
56
|
example "wait3 with WNOHANG works as expected" do
|
|
53
|
-
fork{ sleep 0.5 }
|
|
57
|
+
@pid = fork{ sleep 0.5 }
|
|
54
58
|
expect{ Process.wait3(Process::WNOHANG) }.not_to raise_error
|
|
55
59
|
end
|
|
56
60
|
|
|
57
61
|
example "wait3 sets and returns $last_status to expected values" do
|
|
58
62
|
skip 'wait3 test skipped on this platform' if darwin
|
|
59
|
-
fork{ sleep 0.5 }
|
|
63
|
+
@pid = fork{ sleep 0.5 }
|
|
60
64
|
Process.wait3
|
|
61
65
|
expect($last_status).to be_kind_of(Struct::ProcStat)
|
|
62
66
|
expect($last_status).not_to be_nil
|
|
@@ -64,14 +68,14 @@ RSpec.describe Process do
|
|
|
64
68
|
|
|
65
69
|
example "wait3 sets pid and status members of $?" do
|
|
66
70
|
skip 'wait3 test skipped on this platform' if darwin
|
|
67
|
-
fork{ sleep 0.5 }
|
|
71
|
+
@pid = fork{ sleep 0.5 }
|
|
68
72
|
Process.wait3
|
|
69
73
|
expect($?).not_to be_nil
|
|
70
74
|
end
|
|
71
75
|
|
|
72
76
|
example "wait3 returns frozen struct" do
|
|
73
77
|
skip 'wait3 test skipped on this platform' if darwin
|
|
74
|
-
fork{ sleep 0.5 }
|
|
78
|
+
@pid = fork{ sleep 0.5 }
|
|
75
79
|
struct = Process.wait3
|
|
76
80
|
expect(struct).to be_frozen
|
|
77
81
|
end
|
|
@@ -97,16 +101,16 @@ RSpec.describe Process do
|
|
|
97
101
|
example "wait4 works as expected" do
|
|
98
102
|
skip 'wait4 test skipped on this platform' if hpux || darwin
|
|
99
103
|
|
|
100
|
-
pid = fork{ sleep 0.5 }
|
|
101
|
-
expect{ @proc_stat = Process.wait4(pid) }.not_to raise_error
|
|
104
|
+
@pid = fork{ sleep 0.5 }
|
|
105
|
+
expect{ @proc_stat = Process.wait4(@pid) }.not_to raise_error
|
|
102
106
|
expect(@proc_stat).to be_kind_of(Struct::ProcStat)
|
|
103
107
|
end
|
|
104
108
|
|
|
105
109
|
example "wait4 sets and returns $last_status to expected values" do
|
|
106
110
|
skip 'wait4 test skipped on this platform' if hpux || darwin
|
|
107
111
|
|
|
108
|
-
pid = fork{ sleep 0.5 }
|
|
109
|
-
Process.wait4(pid)
|
|
112
|
+
@pid = fork{ sleep 0.5 }
|
|
113
|
+
Process.wait4(@pid)
|
|
110
114
|
expect($last_status).to be_kind_of(Struct::ProcStat)
|
|
111
115
|
expect($last_status).not_to be_nil
|
|
112
116
|
end
|
|
@@ -114,45 +118,45 @@ RSpec.describe Process do
|
|
|
114
118
|
example "wait4 sets pid and status members of $?" do
|
|
115
119
|
skip 'wait4 test skipped on this platform' if hpux || darwin
|
|
116
120
|
|
|
117
|
-
pid = fork{ sleep 0.5 }
|
|
118
|
-
Process.wait4(pid)
|
|
121
|
+
@pid = fork{ sleep 0.5 }
|
|
122
|
+
Process.wait4(@pid)
|
|
119
123
|
expect($?).not_to be_nil
|
|
120
124
|
end
|
|
121
125
|
|
|
122
126
|
example "wait4 returns frozen struct" do
|
|
123
127
|
skip 'wait4 test skipped on this platform' if hpux || darwin
|
|
124
128
|
|
|
125
|
-
pid = fork{ sleep 0.5 }
|
|
126
|
-
struct = Process.wait4(pid)
|
|
129
|
+
@pid = fork{ sleep 0.5 }
|
|
130
|
+
struct = Process.wait4(@pid)
|
|
127
131
|
expect(struct).to be_frozen
|
|
128
132
|
end
|
|
129
133
|
|
|
130
134
|
example "waitid method is defined" do
|
|
131
|
-
skip 'waitid test skipped on this platform' if hpux || darwin ||
|
|
135
|
+
skip 'waitid test skipped on this platform' if hpux || darwin || bsd
|
|
132
136
|
|
|
133
137
|
expect(Process).to respond_to(:waitid)
|
|
134
138
|
end
|
|
135
139
|
|
|
136
140
|
example "waitid method works as expected" do
|
|
137
|
-
skip 'waitid test skipped on this platform' if hpux || darwin ||
|
|
141
|
+
skip 'waitid test skipped on this platform' if hpux || darwin || bsd
|
|
138
142
|
|
|
139
|
-
pid = fork{ sleep 0.5 }
|
|
140
|
-
expect{ Process.waitid(Process::P_PID, pid, Process::WEXITED) }.not_to raise_error
|
|
143
|
+
@pid = fork{ sleep 0.5 }
|
|
144
|
+
expect{ Process.waitid(Process::P_PID, @pid, Process::WEXITED) }.not_to raise_error
|
|
141
145
|
end
|
|
142
146
|
|
|
143
147
|
example "waitid method raises expected errors if wrong argument type is passed" do
|
|
144
|
-
skip 'waitid test skipped on this platform' if hpux || darwin ||
|
|
148
|
+
skip 'waitid test skipped on this platform' if hpux || darwin || bsd
|
|
145
149
|
|
|
146
|
-
pid = fork{ sleep 0.5 }
|
|
147
|
-
expect{ Process.waitid("foo", pid, Process::WEXITED) }.to raise_error(TypeError)
|
|
148
|
-
expect{ Process.waitid(Process::P_PID, pid, "foo") }.to raise_error(TypeError)
|
|
150
|
+
@pid = fork{ sleep 0.5 }
|
|
151
|
+
expect{ Process.waitid("foo", @pid, Process::WEXITED) }.to raise_error(TypeError)
|
|
152
|
+
expect{ Process.waitid(Process::P_PID, @pid, "foo") }.to raise_error(TypeError)
|
|
149
153
|
expect{ Process.waitid(Process::P_PID, "foo", Process::WEXITED) }.to raise_error(TypeError)
|
|
150
154
|
end
|
|
151
155
|
|
|
152
156
|
example "waitid method raises expected error if invalid argument is passed" do
|
|
153
|
-
skip 'waitid test skipped on this platform' if hpux || darwin ||
|
|
157
|
+
skip 'waitid test skipped on this platform' if hpux || darwin || bsd
|
|
154
158
|
|
|
155
|
-
fork{ sleep 0.5 }
|
|
159
|
+
@pid = fork{ sleep 0.5 }
|
|
156
160
|
expect{ Process.waitid(Process::P_PID, 99999999, Process::WEXITED) }.to raise_error(Errno::ECHILD)
|
|
157
161
|
end
|
|
158
162
|
|
|
@@ -165,8 +169,8 @@ RSpec.describe Process do
|
|
|
165
169
|
example "sigsend works as expected" do
|
|
166
170
|
skip 'sigsend test skipped on this platform' unless solaris
|
|
167
171
|
|
|
168
|
-
pid = fork{ sleep 0.5 }
|
|
169
|
-
expect{ Process.sigsend(Process::P_PID, pid, 0) }.not_to raise_error
|
|
172
|
+
@pid = fork{ sleep 0.5 }
|
|
173
|
+
expect{ Process.sigsend(Process::P_PID, @pid, 0) }.not_to raise_error
|
|
170
174
|
end
|
|
171
175
|
|
|
172
176
|
example "getrusage method is defined" do
|
|
@@ -174,7 +178,7 @@ RSpec.describe Process do
|
|
|
174
178
|
end
|
|
175
179
|
|
|
176
180
|
example "getrusage works as expected" do
|
|
177
|
-
fork{ sleep 0.5 }
|
|
181
|
+
@pid = fork{ sleep 0.5 }
|
|
178
182
|
|
|
179
183
|
expect{ Process.getrusage }.not_to raise_error
|
|
180
184
|
expect{ Process.getrusage(true) }.not_to raise_error
|
|
@@ -188,7 +192,7 @@ RSpec.describe Process do
|
|
|
188
192
|
example "getrusage returns the expected struct" do
|
|
189
193
|
skip 'getrusage only tested on Linux' unless linux
|
|
190
194
|
|
|
191
|
-
fork{ sleep 0.5 }
|
|
195
|
+
@pid = fork{ sleep 0.5 }
|
|
192
196
|
expect(Process.getrusage).to be_kind_of(Struct::RUsage)
|
|
193
197
|
expect(Process.getrusage.stime).to be_kind_of(Float)
|
|
194
198
|
expect(Process.getrusage.utime).to be_kind_of(Float)
|
|
@@ -199,7 +203,7 @@ RSpec.describe Process do
|
|
|
199
203
|
end
|
|
200
204
|
|
|
201
205
|
example "expected constants are defined" do
|
|
202
|
-
skip 'wait constant check skipped on this platform' if darwin ||
|
|
206
|
+
skip 'wait constant check skipped on this platform' if darwin || bsd
|
|
203
207
|
|
|
204
208
|
expect(Process::WCONTINUED).not_to be_nil
|
|
205
209
|
expect(Process::WEXITED).not_to be_nil
|
|
@@ -211,7 +215,7 @@ RSpec.describe Process do
|
|
|
211
215
|
end
|
|
212
216
|
|
|
213
217
|
example "expected process type flag constants are defined" do
|
|
214
|
-
skip 'process type flag check skipped on this platform' if linux || darwin ||
|
|
218
|
+
skip 'process type flag check skipped on this platform' if linux || darwin || bsd
|
|
215
219
|
|
|
216
220
|
expect(Process::P_ALL).not_to be_nil
|
|
217
221
|
expect(Process::P_CID).not_to be_nil
|
|
@@ -231,4 +235,8 @@ RSpec.describe Process do
|
|
|
231
235
|
expect(Process::P_TASKID).not_to be_nil
|
|
232
236
|
expect(Process::P_PROJID).not_to be_nil
|
|
233
237
|
end
|
|
238
|
+
|
|
239
|
+
def after
|
|
240
|
+
Process.kill(9, @pid) if @pid
|
|
241
|
+
end
|
|
234
242
|
end
|
data.tar.gz.sig
CHANGED
|
Binary file
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: proc-wait3
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.9.
|
|
4
|
+
version: 1.9.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Daniel J. Berger
|
|
@@ -35,7 +35,7 @@ cert_chain:
|
|
|
35
35
|
ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
|
|
36
36
|
WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
|
|
37
37
|
-----END CERTIFICATE-----
|
|
38
|
-
date:
|
|
38
|
+
date: 2024-02-08 00:00:00.000000000 Z
|
|
39
39
|
dependencies:
|
|
40
40
|
- !ruby/object:Gem::Dependency
|
|
41
41
|
name: rake
|
|
@@ -81,7 +81,7 @@ files:
|
|
|
81
81
|
- README.md
|
|
82
82
|
- Rakefile
|
|
83
83
|
- certs/djberg96_pub.pem
|
|
84
|
-
- doc/wait3.
|
|
84
|
+
- doc/wait3.md
|
|
85
85
|
- examples/example_getrusage.rb
|
|
86
86
|
- examples/example_pause.rb
|
|
87
87
|
- examples/example_wait3.rb
|
|
@@ -98,10 +98,11 @@ licenses:
|
|
|
98
98
|
metadata:
|
|
99
99
|
homepage_uri: https://github.com/djberg96/proc-wait3
|
|
100
100
|
bug_tracker_uri: https://github.com/djberg96/proc-wait3/issues
|
|
101
|
-
changelog_uri: https://github.com/djberg96/proc-wait3/blob/
|
|
101
|
+
changelog_uri: https://github.com/djberg96/proc-wait3/blob/main/CHANGES.md
|
|
102
102
|
documentation_uri: https://github.com/djberg96/proc-wait3/wiki
|
|
103
103
|
source_code_uri: https://github.com/djberg96/proc-wait3
|
|
104
104
|
wiki_uri: https://github.com/djberg96/proc-wait3/wiki
|
|
105
|
+
rubygems_mfa_required: 'true'
|
|
105
106
|
post_install_message:
|
|
106
107
|
rdoc_options: []
|
|
107
108
|
require_paths:
|
|
@@ -117,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
117
118
|
- !ruby/object:Gem::Version
|
|
118
119
|
version: '0'
|
|
119
120
|
requirements: []
|
|
120
|
-
rubygems_version: 3.
|
|
121
|
+
rubygems_version: 3.1.6
|
|
121
122
|
signing_key:
|
|
122
123
|
specification_version: 4
|
|
123
124
|
summary: Adds wait3, wait4 and other methods to the Process module
|
metadata.gz.sig
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
�2��z"+�t|��ҺL�U��P�y�OM�ي�Q�����3S��pL� 8hv�.���JLUy����O�M�'q"Hl-������gіEHGh8����*��vQ�Wr���̩�_�ň찻7��H'MzQS)��e��E�F�,���#g�2>�)�=�������
|
|
2
|
+
�^�ا���2�h����X����2�N�7����a����k[�> [P��iSG�|
|
data/doc/wait3.txt
DELETED
|
@@ -1,192 +0,0 @@
|
|
|
1
|
-
== Description
|
|
2
|
-
Adds the wait3, wait4, waitid, pause, sigsend, and getrusage methods to
|
|
3
|
-
the Process module.
|
|
4
|
-
|
|
5
|
-
== Synopsis
|
|
6
|
-
require 'proc/wait3'
|
|
7
|
-
|
|
8
|
-
pid = fork{ sleep 1; exit 2 }
|
|
9
|
-
p Time.now
|
|
10
|
-
Process.wait3
|
|
11
|
-
p $?
|
|
12
|
-
|
|
13
|
-
== Module Methods
|
|
14
|
-
Proc.pause(signals=nil)
|
|
15
|
-
Pauses the current process. If the process receives any of the signals
|
|
16
|
-
you pass as arguments it will return from the pause and continue with
|
|
17
|
-
the execution of your code. Otherwise, it will exit.
|
|
18
|
-
|
|
19
|
-
Note that you must leave out the 'SIG' prefix for the signal name, e.g.
|
|
20
|
-
use 'INT', not 'SIGINT'.
|
|
21
|
-
|
|
22
|
-
Returns the result of the pause() function, which should always be -1.
|
|
23
|
-
|
|
24
|
-
Process.sigsend(idtype, id, signal=0)
|
|
25
|
-
Sends a signal of type "idtype" to a process or process group "id". This
|
|
26
|
-
is more versatile method of sending signals to processes than Process.kill.
|
|
27
|
-
|
|
28
|
-
For a list of valid idtype values, see the "Process type constants" below.
|
|
29
|
-
Not supported on all platforms.
|
|
30
|
-
|
|
31
|
-
Proc.wait3(flags=0)
|
|
32
|
-
Delays its caller until a signal is received or one of its child processes
|
|
33
|
-
terminates or stops due to tracing.
|
|
34
|
-
|
|
35
|
-
The return value is a ProcStat structure and sets the $last_status global
|
|
36
|
-
variable. The special global $? is also set. Raises a SystemError if there
|
|
37
|
-
are no child processes.
|
|
38
|
-
|
|
39
|
-
Proc.wait4(pid, flags=0)
|
|
40
|
-
Waits for the given child process to exit. Returns a ProcStat structure.
|
|
41
|
-
The $last_status global variable is set. Also sets the $? special global
|
|
42
|
-
variable.
|
|
43
|
-
|
|
44
|
-
Proc.waitid(id_type, id_num=nil, options=nil)
|
|
45
|
-
Suspends the calling process until one of its children changes state,
|
|
46
|
-
returning immediately if a child process changed state prior to the call.
|
|
47
|
-
The state of a child process will change if it terminates, stops because
|
|
48
|
-
of a signal, becomes trapped or reaches a breakpoint.
|
|
49
|
-
|
|
50
|
-
The id_num corresponds to a process ID or process group ID, depending on
|
|
51
|
-
the value of +id_type+, which may be Process::P_PID, Process::P_PGID or
|
|
52
|
-
Process::P_ALL. If +id_type+ is Process::P_ALL, then the +id_num+ is ignored.
|
|
53
|
-
|
|
54
|
-
The options argument is used to specify which state changes are to be
|
|
55
|
-
waited for. It is constructed from the bitwise-OR of one or more of the
|
|
56
|
-
following constants:
|
|
57
|
-
|
|
58
|
-
Process::WCONTINUED
|
|
59
|
-
Process::WEXITED
|
|
60
|
-
Process::WNOHANG
|
|
61
|
-
Process::WNOWAIT
|
|
62
|
-
Process::WSTOPPED
|
|
63
|
-
Process::WTRAPPED (not supported on all platforms)
|
|
64
|
-
|
|
65
|
-
If Process::WNOHANG is set as an option, this method will return
|
|
66
|
-
immediately, whether or not a child has changed state.
|
|
67
|
-
|
|
68
|
-
Calling this method with an +id_type+ of Process::P_ALL and the options set
|
|
69
|
-
to 'Process::EXITED | Process::WTRAPPED' is equivalent to calling
|
|
70
|
-
Process.wait.
|
|
71
|
-
|
|
72
|
-
Returns a Proc::SigInfo struct and sets $?.
|
|
73
|
-
|
|
74
|
-
Not supported on all platforms.
|
|
75
|
-
|
|
76
|
-
== Constants
|
|
77
|
-
=== Standard
|
|
78
|
-
Process::WAIT3_VERSION
|
|
79
|
-
Returns the version of this package as a string.
|
|
80
|
-
|
|
81
|
-
=== Process type constants
|
|
82
|
-
==== All platforms
|
|
83
|
-
Process::P_ALL
|
|
84
|
-
All non-system process.
|
|
85
|
-
|
|
86
|
-
Process::P_PID
|
|
87
|
-
A standard process id.
|
|
88
|
-
|
|
89
|
-
Process::P_PGID
|
|
90
|
-
Any non-system process group id.
|
|
91
|
-
|
|
92
|
-
==== Not supported on all platforms
|
|
93
|
-
Process::P_CID
|
|
94
|
-
A scheduler process id.
|
|
95
|
-
|
|
96
|
-
Process::P_GID
|
|
97
|
-
Any non-system effective process group id.
|
|
98
|
-
|
|
99
|
-
Process::P_PROJID
|
|
100
|
-
A project process id. Solaris 8 or later only.
|
|
101
|
-
|
|
102
|
-
Process::P_SID
|
|
103
|
-
A session process id.
|
|
104
|
-
|
|
105
|
-
Process::P_TASKID
|
|
106
|
-
A task process id. Solaris 8 or later only.
|
|
107
|
-
|
|
108
|
-
Process::P_UID
|
|
109
|
-
Any non-system effective process user id.
|
|
110
|
-
|
|
111
|
-
=== The following additional constants are defined if the waitid function is
|
|
112
|
-
supported on your system.
|
|
113
|
-
|
|
114
|
-
Process::WCONTINUED
|
|
115
|
-
Return the status for any child that was stopped and has been continued.
|
|
116
|
-
|
|
117
|
-
Process::WEXITED
|
|
118
|
-
Wait for process(es) to exit.
|
|
119
|
-
|
|
120
|
-
Process::WNOWAIT
|
|
121
|
-
Keep the process in a waitable state.
|
|
122
|
-
|
|
123
|
-
Process::WSTOPPED
|
|
124
|
-
Wait for and return the process status of any child that has stopped upon
|
|
125
|
-
receipt of a signal.
|
|
126
|
-
|
|
127
|
-
Process::WTRAPPED
|
|
128
|
-
Wait for traced process(es) to become trapped or reach a breakpoint.
|
|
129
|
-
|
|
130
|
-
Not supported on all platforms.
|
|
131
|
-
|
|
132
|
-
=== RLIMIT constants
|
|
133
|
-
Process::RLIMIT_AS
|
|
134
|
-
A synonym for RLIMIT_VMEM
|
|
135
|
-
|
|
136
|
-
Process::RLIMIT_CORE
|
|
137
|
-
The maximum size of a core file, in bytes, that may be created.
|
|
138
|
-
|
|
139
|
-
Process::RLIMIT_CPU
|
|
140
|
-
The maximum amount of CPU time, in seconds, the process is allowed to use.
|
|
141
|
-
|
|
142
|
-
Process::RLIMIT_DATA
|
|
143
|
-
The maximum size of the process' heap size, in bytes.
|
|
144
|
-
|
|
145
|
-
Process::RLIMIT_FSIZE
|
|
146
|
-
The maximum size of a file, in bytes, that the process may create.
|
|
147
|
-
|
|
148
|
-
Process::RLIMIT_NOFILE
|
|
149
|
-
The maximum value that the kernel may assign to a file descriptor,
|
|
150
|
-
effectively limiting the number of open files for the calling process.
|
|
151
|
-
|
|
152
|
-
Process::RLIMIT_STACK
|
|
153
|
-
The maximum size of the process' stack in bytes.
|
|
154
|
-
|
|
155
|
-
Process::RLIMIT_VMEM
|
|
156
|
-
The maximum size of the process' mapped address space.
|
|
157
|
-
|
|
158
|
-
Process::RLIM_INFINITY
|
|
159
|
-
A infinite limit.
|
|
160
|
-
|
|
161
|
-
Process::RLIM_SAVED_CUR
|
|
162
|
-
Current soft limit.
|
|
163
|
-
|
|
164
|
-
Process::RLIM_SAVED_MAX
|
|
165
|
-
Current hard limit.
|
|
166
|
-
|
|
167
|
-
== Notes
|
|
168
|
-
The wait3 and wait4 methods are similar to the wait2 and waitpid2
|
|
169
|
-
methods, except that they return much more information via the rusage
|
|
170
|
-
struct.
|
|
171
|
-
|
|
172
|
-
== Known Bugs
|
|
173
|
-
None that I'm aware of. Please log any bugs on the Github project
|
|
174
|
-
page at https://github.com/djberg96/proc-wait3.
|
|
175
|
-
|
|
176
|
-
== License
|
|
177
|
-
Apache-2.0
|
|
178
|
-
|
|
179
|
-
== Copyright
|
|
180
|
-
(C) 2003-2019 Daniel J. Berger
|
|
181
|
-
All Rights Reserved.
|
|
182
|
-
|
|
183
|
-
== Warranty
|
|
184
|
-
This package is provided "as is" and without any express or
|
|
185
|
-
implied warranties, including, without limitation, the implied
|
|
186
|
-
warranties of merchantability and fitness for a particular purpose.
|
|
187
|
-
|
|
188
|
-
== Author
|
|
189
|
-
Daniel J. Berger
|
|
190
|
-
|
|
191
|
-
== See also
|
|
192
|
-
wait3, wait4, waitid, pause, sigsend
|