author | convert-repo |
Thu, 05 Jul 2018 03:33:35 +0000 | |
changeset 23197 | 823c765c176d |
parent 23050 | 7a2a7db8aca6 |
child 23258 | 1d65d1a0af5d |
permissions | -rw-r--r-- |
22693 | 1 |
"{ Encoding: utf8 }" |
2 |
||
1 | 3 |
" |
5 | 4 |
COPYRIGHT (c) 1992 by Claus Gittinger |
159 | 5 |
All Rights Reserved |
1 | 6 |
|
7 |
This software is furnished under a license and may be used |
|
8 |
only in accordance with the terms of that license and with the |
|
9 |
inclusion of the above copyright notice. This software may not |
|
10 |
be provided or otherwise made available to, or used by, any |
|
11 |
other person. No title to or ownership of the software is |
|
12 |
hereby transferred. |
|
13 |
" |
|
5377 | 14 |
"{ Package: 'stx:libbasic' }" |
15 |
||
17407 | 16 |
"{ NameSpace: Smalltalk }" |
17 |
||
1 | 18 |
Link subclass:#Process |
19292 | 19 |
instanceVariableNames:'id lookupActivations lookupDisabled prio state startBlock name |
20 |
restartable interruptActions exitActions suspendSemaphore |
|
21 |
singleStepping emergencySignalHandler suspendActions creatorId |
|
22 |
processGroupId interruptsDisabled priorityRange |
|
21324 | 23 |
exceptionHandlerSet processType environment startTimestamp' |
16562 | 24 |
classVariableNames:'TerminateSignal RestartSignal CaughtSignals' |
772
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
25 |
poolDictionaries:'' |
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
26 |
category:'Kernel-Processes' |
1 | 27 |
! |
28 |
||
1784
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
29 |
!Process class methodsFor:'documentation'! |
88 | 30 |
|
31 |
copyright |
|
32 |
" |
|
33 |
COPYRIGHT (c) 1992 by Claus Gittinger |
|
159 | 34 |
All Rights Reserved |
88 | 35 |
|
36 |
This software is furnished under a license and may be used |
|
37 |
only in accordance with the terms of that license and with the |
|
38 |
inclusion of the above copyright notice. This software may not |
|
39 |
be provided or otherwise made available to, or used by, any |
|
40 |
other person. No title to or ownership of the software is |
|
41 |
hereby transferred. |
|
42 |
" |
|
43 |
! |
|
44 |
||
45 |
documentation |
|
46 |
" |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
47 |
WARNING: |
19969 | 48 |
the offsets of the instance variables lookupActivations and lookupDisabled are known in the VM |
49 |
do not remove them, and do not insert/remove instance variables before them |
|
18189
e06ab6591712
hardcoding instvar offsets is VERY BAD (fix for Jan's lookup bug)
Claus Gittinger <cg@exept.de>
parents:
17544
diff
changeset
|
50 |
|
14722 | 51 |
Instances of Process represent lightweight smalltalk processes |
88 | 52 |
(i.e. threads). These all run in a shared smalltalk/X address space, |
93 | 53 |
and can thus access and communicate via any objects. |
54 |
Do not confuse these with (heavy-weight) unix processes, which are |
|
55 |
created differently, and do NOT run in the same address space. |
|
56 |
Also notice, that heavy-weight process creation takes much longer. |
|
57 |
(see OperatingSystemclass>>fork). |
|
58 |
||
21777 | 59 |
Smalltalk processes do not necessarily need to be implemented as native |
4646
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
60 |
threads - it may, but the actual implementation depends on the underlying |
21777 | 61 |
OS's features. However, even if implemented as native thread, the ST/X |
4646
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
62 |
kernel makes certain, that only one thread executes at a time (with certain, |
20230 | 63 |
well-defined exceptions). The reason is that the required locking in the |
4646
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
64 |
runtime system would make things slower in most cases. |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
65 |
|
202 | 66 |
Processes are typically created by sending #fork or #forkAt: to a block; |
67 |
the block creates a new process, defines itself as its startBlock, |
|
68 |
and (optionally) tells the Processor about the new process. |
|
69 |
||
4646
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
70 |
Scheduling is done by Processor, which is the sole instance of ProcessorScheduler. |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
71 |
In ST/X, the scheduling algorithms are fully implemented (and visible) on the |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
72 |
smalltalk level - beside the threadSwitch primitive, there is virtually no VM |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
73 |
support (i.e. it can be easily changed). |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
74 |
|
93 | 75 |
|
202 | 76 |
Processes can be terminated either soft or via a hardTerminate. |
217 | 77 |
|
202 | 78 |
A soft terminate (see Process>>terminate) will raise a TerminationSignal |
14722 | 79 |
in the process, which can be handled by the process. |
80 |
If no other handler was specified, the processes own handler |
|
81 |
(see Process>>start) will catch the signal and terminate the process. |
|
217 | 82 |
During this signal processing, normal unwind processing takes place, |
14722 | 83 |
this means that with a soft terminate, all valueOnUnwind:/valueNowOrOnUnwind: |
217 | 84 |
cleanup blocks are evaluated. |
202 | 85 |
(so a process which has set up those blocks correctly does not have to |
86 |
care especially about cleanup in case of termination). |
|
2689 | 87 |
Other than that, the TerminateSignal can be caught for special cleanup or |
217 | 88 |
even to make the process continue execution. |
4415
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
89 |
If the process is suspended at termination time, it will be resumed |
14722 | 90 |
in order to perform its cleanup actions (i.e. the cleanup is always |
4415
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
91 |
done in the context of the terminating process itself). |
202 | 92 |
|
93 |
A hard terminate (Process>>terminateNoSignal) will NOT do all of the above, |
|
94 |
but quickly (and without any cleanup) terminate the process. |
|
95 |
The debugger offers a quickTerminate option on its popupMenu for |
|
96 |
situations, when soft termination fails. (for example, if some error was |
|
97 |
coded into a handler or unwind block). |
|
98 |
||
20777 | 99 |
Leaving the processes startBlock has the same effect as a soft-terminate |
4415
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
100 |
(i.e. there is no need to send an explicit terminate). |
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
101 |
|
14722 | 102 |
Notice: |
19969 | 103 |
in Smalltalk/X, processes are gone, when an image is restarted; |
21777 | 104 |
this means that you have to take care of process re-creation yourself. |
19969 | 105 |
Usually, this is done by depending on ObjectMemory, recreating the |
106 |
process(es) when the #returnFromSnapshot-change notifiction arrives. |
|
107 |
||
108 |
All views (actually windowGroups) recreate their window process |
|
109 |
on image-restart. You have to do so manually for your own processes. |
|
93 | 110 |
|
111 |
A later version will allow specification of automatic restart, but |
|
13563 | 112 |
that's not yet implemented. However, even when implemented, restartable processes |
217 | 113 |
will be recreated to restart from the beginning. It will not be possible to |
114 |
automatically continue a processes execution where it left off. |
|
115 |
This is a consequence of the portable implementation of ST/X, since in order to |
|
14722 | 116 |
implement process continuation, the machines stack had to be preserved and |
117 |
recreated. Although this is possible to do (and actually not too complicated), |
|
118 |
this has not been implemented, since the machines stack layout is highly machine/compiler |
|
375 | 119 |
dependent, thus leading to much bigger porting effort of ST/X (which conflicts |
120 |
with ST/X's design goal of being highly portable). |
|
217 | 121 |
|
122 |
Process synchronization: |
|
19969 | 123 |
Synchronization with cooperating processes is supported as usual, |
124 |
via Semaphores (see Semaphore, Delay, SharedQueue etc.) |
|
125 |
||
126 |
With uncooperative processes, only synchronization on suspend |
|
127 |
and termination is possible: |
|
128 |
any other process can wait for a process to suspend or terminate. |
|
129 |
This waiting is implemented by using suspendSemaphore and exitBlocks |
|
130 |
(where an exitSemaphore is signalled). |
|
131 |
See waitUntilSuspended / waitUntilTerminated. |
|
132 |
||
133 |
Implementation note: |
|
134 |
for historic and compatibility reasons, Process is a subclass of Link, |
|
135 |
which means, that instances are directly usable as nodes in a linkedList. |
|
21777 | 136 |
However, this also means that processes can only be elements of a single LinkedList. |
19969 | 137 |
This is somewhat dangerous, as unknowledgable programmers may unwillingly break the |
138 |
scheduler, by placing a process onto another linked list. |
|
139 |
Therefore, we plan to change this in the future. |
|
21777 | 140 |
|
3784 | 141 |
Process states: |
19969 | 142 |
#dead process has (been) terminated; |
21777 | 143 |
the process instance has no underlying |
19969 | 144 |
thread. |
145 |
||
146 |
#run the process is willing to run, |
|
147 |
but not active (i.e. another higher prio |
|
148 |
process is currently executing) |
|
149 |
||
150 |
#active the process is the current process |
|
151 |
(there is only one) |
|
152 |
||
153 |
#ioWait waiting on some io-related semaphore |
|
154 |
(typically in #readWait / #writeWait) |
|
155 |
||
156 |
#eventWait waiting on some GUI event |
|
157 |
||
158 |
#timeWait waiting on a timer-related semaphore |
|
159 |
||
160 |
#wait waiting on some (other) semaphore |
|
161 |
||
162 |
#suspended stopped from execution; however, an interrupt |
|
163 |
will return it into the run state. |
|
164 |
||
165 |
#stopped stopped from execution; an interrupt will |
|
166 |
NOT return it into the run state (for debugging) |
|
167 |
||
168 |
#debug debugger sitting on top of the processes |
|
169 |
stack. |
|
3784 | 170 |
|
171 |
Win32 only: |
|
172 |
||
19969 | 173 |
#osWait waiting on an OS-API call to finish. |
174 |
can be interrupted, terminated and aborted |
|
21777 | 175 |
(i.e. the usual context actions are possible). |
19969 | 176 |
|
177 |
#halted thread was caught while in a blocking API call |
|
178 |
or primitive endless loop and has been halted by |
|
179 |
the scheduler. |
|
180 |
Can only be resumed or hard-terminated - abort |
|
181 |
or soft terminate or unwind actions are not possible. |
|
182 |
(due to win32 limitations) |
|
3784 | 183 |
|
184 |
||
1273 | 185 |
[Instance variables:] |
93 | 186 |
|
19969 | 187 |
id <SmallInteger> a unique process-id |
188 |
||
189 |
creatorId <SmallInteger> the id of the process that |
|
190 |
created me (useful for debugging |
|
191 |
or monitoring). |
|
192 |
||
193 |
processGroupId usually the id of the creator, |
|
194 |
unless the process detached from |
|
195 |
the group and became a groupLeader. |
|
196 |
Groups can be easily terminated |
|
197 |
as a whole. |
|
198 |
Group leaders have a groupId of nil. |
|
199 |
A groupId of 0 (zero) marks a system |
|
200 |
process; these do not prevent a standAlone |
|
201 |
app from exiting. |
|
202 |
||
203 |
prio <SmallInteger> the processes priority |
|
204 |
||
205 |
priorityRange <Interval> the processes dynamic priority range |
|
206 |
(or nil) |
|
207 |
||
208 |
state <Symbol> the processes state |
|
209 |
(for process-monitor) |
|
210 |
||
211 |
startBlock <Block> the startup-block (the one that forked) |
|
212 |
||
213 |
name <String-or-nil> the processes name (if any) |
|
214 |
(for process-monitor) |
|
215 |
||
216 |
suspendSemaphore <Semaphore> triggered when suspend (if nonNil) |
|
217 |
||
218 |
restartable <Boolean> is restartable; if true, the process |
|
219 |
will be restarted when an image is |
|
220 |
restarted. Otherwise, it remains dead. |
|
221 |
Running processes cannot be continued |
|
222 |
at the point where leftOff after an |
|
223 |
image-restart. |
|
224 |
||
225 |
interruptActions <Collection> interrupt actions as defined by interruptWith:, |
|
226 |
performed at interrupt time |
|
227 |
||
228 |
exitActions <Collection of Block> |
|
229 |
additional cleanup actions to perform |
|
230 |
on termination (if nonEmpty) |
|
231 |
||
232 |
emergencySignalHandler <Block> can be used for per-process |
|
233 |
emergency signal handling |
|
234 |
||
235 |
interruptsDisabled <Boolean> flag if interrupts (as installed |
|
236 |
via #interruptWith:) are currently |
|
237 |
disabled. (i.e. on-hold). |
|
238 |
Interrupts will be delivered when |
|
239 |
reenabled. |
|
240 |
||
241 |
exceptionHandlerSet <ExceptionhandlerSet> |
|
242 |
Handled by any process; allows for |
|
243 |
exceptionHandlers and query-answerers to |
|
244 |
be added/removed dynamically. |
|
4646
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
245 |
|
1273 | 246 |
[Class variables:] |
159 | 247 |
|
19969 | 248 |
TerminateSignal <Signal> signal used to terminate processes |
249 |
(should not be caught - or at least |
|
250 |
rejected in handlers). |
|
251 |
If caught and proceeded, a process |
|
252 |
cannot be terminated via #terminate. |
|
253 |
For hardTermination (in case of emergency), |
|
254 |
send it a #erminateNoSignal message. |
|
255 |
||
256 |
RestartSignal <Signal> signal used to restart a process. |
|
257 |
Can be caught in additional handler(s), |
|
258 |
to perform all kind of re-initialization. |
|
259 |
However, these handlers should reject, |
|
260 |
for the restart to be really performed. |
|
1273 | 261 |
|
262 |
[see also:] |
|
19969 | 263 |
ProcessorScheduler |
264 |
Block |
|
265 |
Sempahore SemaphoreSet Delay SharedQueue |
|
266 |
WindowGroup |
|
267 |
(``Working with processes'': programming/processes.html) |
|
1273 | 268 |
|
1294 | 269 |
[author:] |
19969 | 270 |
Claus Gittinger |
1294 | 271 |
|
88 | 272 |
" |
213 | 273 |
! |
274 |
||
14722 | 275 |
examples |
213 | 276 |
" |
277 |
start a background process, computing 1000 factorial 100 times; |
|
278 |
the processes priority is set to not disturb any interactive process. |
|
279 |
Since its prio is higher than the 3D animation demos prio, you will notice, |
|
280 |
that those are suspended while the computation runs. But Interactive views |
|
281 |
(like browsers) will continue to react normal. |
|
5450 | 282 |
[exBegin] |
213 | 283 |
[ |
284 |
'starting' printNL. |
|
285 |
100 timesRepeat:[1000 factorial]. |
|
286 |
'done with factorial' printNL. |
|
287 |
] forkAt:(Processor userBackgroundPriority). |
|
5450 | 288 |
[exEnd] |
213 | 289 |
|
290 |
||
291 |
start a background process, computing 1000 factorial 100 times; |
|
292 |
the processes priority is set to not disturb any process. |
|
293 |
The prio is set to 1 (which is the lowest possible) notice that now, |
|
14722 | 294 |
the 3D animation demos also continue to run. |
5450 | 295 |
[exBegin] |
213 | 296 |
[ |
297 |
'starting' printNL. |
|
298 |
100 timesRepeat:[1000 factorial]. |
|
299 |
'done with factorial' printNL. |
|
300 |
] forkAt:1. |
|
5450 | 301 |
[exEnd] |
213 | 302 |
|
303 |
||
304 |
start a background process, reading a pipe without blocking other |
|
305 |
processes; |
|
5450 | 306 |
[exBegin] |
213 | 307 |
[ |
308 |
|p| |
|
309 |
||
310 |
'starting' printNL. |
|
311 |
p := PipeStream readingFrom:'ls -lR .'. |
|
312 |
[p atEnd] whileFalse:[ |
|
5450 | 313 |
p readWait. |
314 |
p nextLine printNL. |
|
213 | 315 |
]. |
316 |
p close. |
|
317 |
'done with pipe' printNL. |
|
318 |
] forkAt:1. |
|
5450 | 319 |
[exEnd] |
213 | 320 |
|
14722 | 321 |
see more examples in doc/coding |
213 | 322 |
(or search in the browser for senders of fork*) |
323 |
" |
|
88 | 324 |
! ! |
1 | 325 |
|
1784
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
326 |
!Process class methodsFor:'initialization'! |
159 | 327 |
|
328 |
initialize |
|
329 |
TerminateSignal isNil ifTrue:[ |
|
14722 | 330 |
TerminateSignal := TerminateProcessRequest. |
331 |
TerminateSignal notifierString:'unhandled process termination'. |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
332 |
|
14722 | 333 |
RestartSignal := RestartProcessRequest. |
334 |
RestartSignal notifierString:'unhandled process restart'. |
|
302 | 335 |
|
16562 | 336 |
CaughtSignals := SignalSet |
14722 | 337 |
with:AbortAllOperationRequest |
338 |
with:TerminateProcessRequest |
|
339 |
with:RestartProcessRequest. |
|
159 | 340 |
] |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
341 |
|
6212 | 342 |
"Modified: / 17.11.2001 / 11:07:29 / cg" |
159 | 343 |
! ! |
344 |
||
1784
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
345 |
!Process class methodsFor:'instance creation'! |
699 | 346 |
|
347 |
for:aBlock priority:aPrio |
|
348 |
"create a new (unscheduled) process which will execute aBlock at |
|
349 |
a given priority, once scheduled. The process will start execution once |
|
350 |
it gets a #resume-message." |
|
351 |
||
2268
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
352 |
^ self basicNew for:aBlock priority:aPrio |
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
353 |
|
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
354 |
"Modified: 25.1.1997 / 01:23:12 / cg" |
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
355 |
! |
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
356 |
|
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
357 |
new |
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
358 |
"create a new (unscheduled) process which will execute the start |
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
359 |
method, when scheduled. The process will start execution once |
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
360 |
it gets a #resume-message." |
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
361 |
|
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
362 |
^ self basicNew for:nil priority:(Processor activePriority). |
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
363 |
|
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
364 |
"Created: 25.1.1997 / 01:31:05 / cg" |
699 | 365 |
! ! |
366 |
||
1784
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
367 |
!Process class methodsFor:'Signal constants'! |
159 | 368 |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
369 |
restartSignal |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
370 |
"return the signal used for process restart" |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
371 |
|
22693 | 372 |
^ RestartProcessRequest |
373 |
||
374 |
"Created: / 28-10-1996 / 20:26:50 / cg" |
|
375 |
"Modified: / 23-04-2018 / 14:01:47 / stefan" |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
376 |
! |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
377 |
|
159 | 378 |
terminateSignal |
202 | 379 |
"return the signal used for process termination" |
380 |
||
22693 | 381 |
^ TerminateProcessRequest |
382 |
||
383 |
"Modified: / 23-04-2018 / 14:00:26 / stefan" |
|
159 | 384 |
! ! |
385 |
||
1784
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
386 |
!Process class methodsFor:'defaults'! |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
387 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
388 |
defaultMaximumStackSize |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
389 |
"return the default max stack size. All new processes get |
14722 | 390 |
this limit initially. |
391 |
It may be changed for individual processes with: |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
392 |
aProcess setMaximumStackSize:limit" |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
393 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
394 |
%{ /* NOCONTEXT */ |
19293 | 395 |
extern INT __defaultThreadMaxStackSize(); |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
396 |
|
8913 | 397 |
RETURN ( __mkSmallInteger( __defaultThreadMaxStackSize() )); |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
398 |
%} |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
399 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
400 |
" |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
401 |
Process defaultMaximumStackSize |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
402 |
" |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
403 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
404 |
"Modified: 8.5.1996 / 10:22:24 / cg" |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
405 |
! |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
406 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
407 |
defaultMaximumStackSize:numberOfBytes |
14722 | 408 |
"set the default max stack size, return the previous value. |
409 |
All new processes get this stack limit initially. |
|
410 |
It may be changed for individual processes with: |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
411 |
aProcess setMaximumStackSize:limit |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
412 |
Notice: |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
413 |
There is seldom any need to change the default setting, |
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
414 |
except for highly recursive programs." |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
415 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
416 |
%{ /* NOCONTEXT */ |
19293 | 417 |
extern INT __threadSetDefaultMaxStackSize(); |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
418 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
419 |
if (__isSmallInteger(numberOfBytes)) { |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
420 |
RETURN ( __mkSmallInteger(__threadSetDefaultMaxStackSize(__intVal(numberOfBytes)) )); |
1352 | 421 |
} |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
422 |
%} |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
423 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
424 |
" |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
425 |
Process defaultMaximumStackSize:500*1024 |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
426 |
" |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
427 |
|
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
428 |
"Modified: 8.5.1996 / 10:23:26 / cg" |
19292 | 429 |
! |
430 |
||
431 |
wrapStackSize |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
432 |
"return the wrap stack size. |
19292 | 433 |
Under windows, blocking API calls are executed on a separate stack with this size. |
434 |
If you ever encounter that a call to n external library function requires more stack than |
|
435 |
this, you may change this size in your startup (or programmatically) during early startup. |
|
436 |
Returns nil on non-windows machines." |
|
437 |
||
438 |
%{ /* NOCONTEXT */ |
|
439 |
INT sz = 0; |
|
440 |
||
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
441 |
#ifdef __win32__ |
19292 | 442 |
extern INT __getWrapStackSize(); |
443 |
||
444 |
sz = __getWrapStackSize(); |
|
445 |
#endif |
|
19295 | 446 |
RETURN (__MKINT(sz)); |
19292 | 447 |
%} |
448 |
! |
|
449 |
||
450 |
wrapStackSize:newSize |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
451 |
"set the wrap stack size. |
19292 | 452 |
Under windows, blocking API calls are executed on a separate stack with this size. |
453 |
If you ever encounter that a call to n external library function requires more stack than |
|
454 |
this, you may change this size in your startup (or programmatically) during early startup. |
|
455 |
An argument of 0 changes the size back to the default. |
|
456 |
Returns the previous size." |
|
457 |
||
458 |
%{ /* NOCONTEXT */ |
|
459 |
INT __oldSize = 0; |
|
460 |
||
461 |
if (__isSmallInteger(newSize)) { |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
462 |
INT __newSize = __intVal(newSize); |
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
463 |
|
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
464 |
if (__newSize >= 0) { |
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
465 |
#ifdef __win32__ |
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
466 |
extern INT __setWrapStackSize(INT); |
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
467 |
|
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
468 |
__oldSize = __setWrapStackSize(__newSize); |
19292 | 469 |
#endif |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
470 |
} |
19292 | 471 |
} |
19295 | 472 |
RETURN (__MKINT(__oldSize)); |
19292 | 473 |
%} |
1346
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
474 |
! ! |
429d560b7013
allow access to the default stack limit
Claus Gittinger <cg@exept.de>
parents:
1316
diff
changeset
|
475 |
|
3783
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
476 |
!Process class methodsFor:'instance retrieval'! |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
477 |
|
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
478 |
findProcessWithId:id |
21129 | 479 |
<resource: #obsolete> |
3783
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
480 |
"return a process with a particular id. |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
481 |
This is only a debugging helper, to allow |
21129 | 482 |
easy access of a process by name in the MiniDebugger. |
483 |
Do not use - ask Processor instead!!" |
|
484 |
||
3783
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
485 |
|
9226 | 486 |
^ self allSubInstances detect:[:aProcess | aProcess id = id] ifNone:nil. |
3783
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
487 |
|
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
488 |
" |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
489 |
Process findProcessWithId:1 |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
490 |
" |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
491 |
|
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
492 |
"Modified: / 26.8.1998 / 15:39:55 / cg" |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
493 |
! |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
494 |
|
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
495 |
findProcessWithName:name |
21129 | 496 |
<resource: #obsolete> |
3783
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
497 |
"return a process with a particular name. |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
498 |
This is only a debugging helper, to allow |
21129 | 499 |
easy access of a process by name in the MiniDebugger |
500 |
Do not use - ask Processor instead!!" |
|
3783
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
501 |
|
9226 | 502 |
^ self allSubInstances detect:[:aProcess | aProcess name = name] ifNone:nil. |
3783
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
503 |
|
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
504 |
" |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
505 |
Process findProcessWithName:'scheduler' |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
506 |
" |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
507 |
|
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
508 |
"Modified: / 26.8.1998 / 15:40:54 / cg" |
9008
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
509 |
! |
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
510 |
|
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
511 |
findProcessesWithGroupId:aGroupId |
21129 | 512 |
<resource: #obsolete> |
9008
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
513 |
"return a collection of processes with the particular group id. |
21129 | 514 |
Do not use - ask Processor instead!!" |
9008
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
515 |
|
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
516 |
^ self allSubInstances select:[:aProcess | aProcess processGroupId = aGroupId ]. |
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
517 |
|
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
518 |
" |
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
519 |
Process findProcessesWithGroupId: 0 |
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
520 |
" |
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
521 |
|
c4d718e416f1
find all process of the same id, used to suspend all of a group.
ab
parents:
8913
diff
changeset
|
522 |
"Modified: / 26.8.1998 / 15:40:54 / cg" |
3783
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
523 |
! ! |
5ac905a9a8c0
added process-retrievers (for MiniDebugger)
Claus Gittinger <cg@exept.de>
parents:
3776
diff
changeset
|
524 |
|
16182 | 525 |
|
21333 | 526 |
|
23050 | 527 |
|
699 | 528 |
!Process methodsFor:'accessing'! |
529 |
||
4874
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
530 |
beGUIProcess |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
531 |
"mark the receiver as a gui process. |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
532 |
This is currently not used, but allows end-user applications |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
533 |
to terminate all subprocesses which are GUI related, and leave |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
534 |
other background processes in the same process group untouched." |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
535 |
|
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
536 |
processType := #gui |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
537 |
! |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
538 |
|
1531
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
539 |
beGroupLeader |
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
540 |
"make the receiver a processGroupLeader. |
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
541 |
This detaches the process from its creator, so that it will not |
10742 | 542 |
be terminated when it terminates via #terminateGroup. |
5088 | 543 |
Also, processes forked from a groupLeader belong to that group |
544 |
and can be terminated via #terminateGroup - unless they become |
|
545 |
group leaders themself. |
|
1531
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
546 |
(windowgroup processes do this)." |
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
547 |
|
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
548 |
processGroupId := id |
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
549 |
|
10742 | 550 |
"Created: / 08-07-1996 / 14:08:44 / cg" |
551 |
"Modified: / 17-10-2007 / 10:49:09 / cg" |
|
1531
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
552 |
! |
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
553 |
|
2196 | 554 |
beSystemProcess |
555 |
"make the receiver a system process. |
|
556 |
These processes have a groupId of 0. |
|
557 |
When executed as standAlone application, smalltalk exits when |
|
558 |
no more user processes are running. |
|
5088 | 559 |
(i.e. when there are only systemProcesses left) |
2196 | 560 |
To prevent any daemon processes from preventing this exit, |
5088 | 561 |
you should make them systemProcesses" |
2196 | 562 |
|
563 |
processGroupId := 0 |
|
564 |
||
565 |
"Created: 17.1.1997 / 21:42:46 / cg" |
|
566 |
! |
|
567 |
||
699 | 568 |
changePriority:aNumber |
569 |
"same as priority:, but returns the old priority. |
|
818 | 570 |
(cannot do this in #priority: for ST-80 compatibility)" |
699 | 571 |
|
572 |
|oldPrio| |
|
573 |
||
574 |
oldPrio := prio. |
|
575 |
Processor changePriority:aNumber for:self. |
|
576 |
^ oldPrio |
|
818 | 577 |
|
578 |
"Modified: 23.12.1995 / 18:38:53 / cg" |
|
699 | 579 |
! |
580 |
||
1530
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
581 |
creatorId |
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
582 |
"return the processcreators id. |
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
583 |
This has no semantic meaning, but is useful to identify processes |
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
584 |
when debugging." |
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
585 |
|
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
586 |
^ creatorId |
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
587 |
! |
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
588 |
|
4646
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
589 |
exceptionHandlerSet |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
590 |
"retrieve the exceptionHandlerSet, which includes the set of |
16562 | 591 |
exceptionHandlers which are caught by the process. |
4646
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
592 |
Initially being empty, this allows for default handlers to be |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
593 |
dynamically added/removed from the set of handled exceptions/queries." |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
594 |
|
4877 | 595 |
exceptionHandlerSet isNil ifTrue:[ |
5450 | 596 |
exceptionHandlerSet := ExceptionHandlerSet new. |
4877 | 597 |
]. |
4646
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
598 |
^ exceptionHandlerSet |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
599 |
! |
8103e1cbce8a
added exceptionHandlerSet & corresponding docu
Claus Gittinger <cg@exept.de>
parents:
4522
diff
changeset
|
600 |
|
818 | 601 |
id |
602 |
"return the processes id" |
|
603 |
||
604 |
^ id |
|
605 |
! |
|
606 |
||
607 |
name |
|
608 |
"return the processes name" |
|
609 |
||
610 |
^ name |
|
611 |
! |
|
612 |
||
613 |
name:aString |
|
614 |
"set the processes name" |
|
615 |
||
616 |
name := aString |
|
617 |
! |
|
618 |
||
619 |
priority |
|
19452 | 620 |
"return the receiver's priority" |
818 | 621 |
|
622 |
^ prio |
|
623 |
! |
|
624 |
||
625 |
priority:aNumber |
|
626 |
"set my priority" |
|
627 |
||
628 |
Processor changePriority:aNumber for:self. |
|
629 |
! |
|
630 |
||
3679 | 631 |
priorityRange |
3723 | 632 |
"return my dynamic priority range" |
3679 | 633 |
|
634 |
^ priorityRange |
|
635 |
||
3723 | 636 |
"Modified: / 3.8.1998 / 22:55:53 / cg" |
3679 | 637 |
! |
638 |
||
639 |
priorityRange:anInterval |
|
3723 | 640 |
"change my dynamic priority range" |
3679 | 641 |
|
16421 | 642 |
|lowPri hiPri newPrio| |
9084 | 643 |
|
644 |
priorityRange := anInterval. |
|
645 |
anInterval notNil ifTrue:[ |
|
16562 | 646 |
lowPri := priorityRange start. |
647 |
hiPri := priorityRange stop. |
|
648 |
(newPrio := prio) isNil ifTrue:[ |
|
649 |
newPrio := lowPri |
|
650 |
] ifFalse:[ |
|
651 |
prio < lowPri ifTrue:[ |
|
652 |
newPrio := lowPri |
|
653 |
] ifFalse:[ |
|
654 |
prio > hiPri ifTrue:[ |
|
655 |
newPrio := hiPri |
|
656 |
]. |
|
657 |
]. |
|
658 |
]. |
|
659 |
newPrio ~~ prio ifTrue:[ |
|
660 |
self priority:newPrio |
|
661 |
] |
|
9084 | 662 |
]. |
3679 | 663 |
|
3723 | 664 |
"Modified: / 3.8.1998 / 22:56:05 / cg" |
3679 | 665 |
! |
666 |
||
1529
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
667 |
processGroupId |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
668 |
"return the processes processGroup id. |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
669 |
Normally, when created, a processes creator id is taken and used |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
670 |
as the processGroup id. |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
671 |
When #terminateGroup is sent to a process, the process and all of its |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
672 |
group members are terminated together. |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
673 |
|
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
674 |
Processes can detach themself from the process group to prevent being |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
675 |
killed when the parent terminates (windowgroup processes do this)." |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
676 |
|
1530
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
677 |
^ processGroupId |
1529
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
678 |
|
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
679 |
"Created: 8.7.1996 / 13:47:47 / cg" |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
680 |
! |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
681 |
|
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
682 |
processGroupId:aGroupLeadersProcessID |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
683 |
"set the processes processGroup id. |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
684 |
Normally, when created, a processes creator id is taken and used |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
685 |
as the processGroup id. |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
686 |
When #terminateGroup is sent to a process, the process and all of its |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
687 |
group members are terminated together. |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
688 |
|
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
689 |
Processes can detach themself from the process group to prevent being |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
690 |
killed when the parent terminates (windowgroup processes do this)." |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
691 |
|
1530
dfa58f01505c
remember creating processes id - helpful when debugging
Claus Gittinger <cg@exept.de>
parents:
1529
diff
changeset
|
692 |
processGroupId := aGroupLeadersProcessID |
1529
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
693 |
|
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
694 |
"Created: 8.7.1996 / 13:47:53 / cg" |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
695 |
! |
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
696 |
|
818 | 697 |
restartable:aBoolean |
698 |
"set/clear, the restartable flag. |
|
699 |
Restartable processes will automatically be restarted by the |
|
14722 | 700 |
ProcessorScheduler upon image restart. |
818 | 701 |
Others have to be restarted manually." |
702 |
||
703 |
startBlock isNil ifTrue:[ |
|
23016 | 704 |
self proceedableError:'cannot be made restartable when already started'. |
705 |
^ self |
|
818 | 706 |
]. |
707 |
restartable := aBoolean |
|
708 |
||
23016 | 709 |
"Modified: / 23-12-1995 / 18:38:32 / cg" |
710 |
"Modified: / 24-05-2018 / 21:04:04 / Claus Gittinger" |
|
818 | 711 |
! |
712 |
||
713 |
singleStep:aBoolean |
|
714 |
singleStepping := aBoolean |
|
715 |
! |
|
716 |
||
717 |
startBlock |
|
718 |
"return the processes startup-block" |
|
719 |
||
720 |
^ startBlock |
|
721 |
! |
|
722 |
||
21326 | 723 |
startTimestamp |
724 |
"return the processes' start time" |
|
725 |
||
726 |
startTimestamp notNil ifTrue:[ |
|
727 |
^ startTimestamp |
|
728 |
]. |
|
729 |
"/ the very first system process has no starttime set |
|
730 |
startTimestamp := Smalltalk imageStartTime. |
|
731 |
^ startTimestamp |
|
732 |
! |
|
733 |
||
818 | 734 |
state |
735 |
"return a symbol describing the processes state" |
|
736 |
||
737 |
^ state |
|
738 |
! |
|
739 |
||
740 |
state:aSymbol |
|
741 |
"set the state - only to be used from scheduler" |
|
742 |
||
743 |
state := aSymbol |
|
744 |
! |
|
745 |
||
746 |
suspendedContext |
|
14722 | 747 |
"return the processes suspended context |
818 | 748 |
- this is the context from which a process switch into the scheduler |
20251 | 749 |
or another process occurred. |
5088 | 750 |
For the active process, a dead process, or one which |
2888
3e8b5166d90f
a rocess which had no chance yet to run, can be #terminated with
Claus Gittinger <cg@exept.de>
parents:
2857
diff
changeset
|
751 |
had no chance to run yet, nil is returned. |
818 | 752 |
Typically, only the debugger is interested in this one." |
753 |
||
754 |
%{ /* NOCONTEXT */ |
|
755 |
OBJ i; |
|
756 |
||
1133 | 757 |
if (__isSmallInteger(i = __INST(id))) { |
20251 | 758 |
RETURN (__threadContext(__intVal(i))); |
818 | 759 |
} |
760 |
%}. |
|
761 |
^ nil |
|
762 |
! ! |
|
763 |
||
764 |
!Process methodsFor:'accessing-change notifications'! |
|
765 |
||
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
766 |
addExitAction:aBlock |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
767 |
"add aBlock to the processes exit actions. |
5088 | 768 |
This block will be evaluated right before the process dies, |
769 |
and can be used to trigger actions somewhere else (i.e. synchronization)." |
|
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
770 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
771 |
exitActions isNil ifTrue:[ |
5450 | 772 |
exitActions := OrderedCollection new |
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
773 |
]. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
774 |
exitActions add:aBlock |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
775 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
776 |
"Created: 12.1.1997 / 00:34:51 / cg" |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
777 |
! |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
778 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
779 |
addSuspendAction:aBlock |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
780 |
"add aBlock to the processes suspend actions. |
5088 | 781 |
This block will be evaluated when a process gets suspended. |
14722 | 782 |
You may ask what that is useful for - it is useful to flush |
5088 | 783 |
buffered graphic commands of a GUI process (i.e. to force xlib |
784 |
to send buffered commands to the display)." |
|
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
785 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
786 |
suspendActions isNil ifTrue:[ |
5450 | 787 |
suspendActions := OrderedCollection new |
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
788 |
]. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
789 |
suspendActions add:aBlock |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
790 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
791 |
"Modified: 13.12.1995 / 13:44:31 / stefan" |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
792 |
"Created: 12.1.1997 / 00:35:11 / cg" |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
793 |
! |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
794 |
|
699 | 795 |
emergencySignalHandler |
796 |
"return the emergencySignalHandler block. |
|
797 |
See Signal>>documentation for more info." |
|
798 |
||
799 |
^ emergencySignalHandler |
|
800 |
! |
|
801 |
||
802 |
emergencySignalHandler:aOneArgBlock |
|
803 |
"set the emergencySignalHandler block. |
|
804 |
See Signal>>documentation for more info." |
|
805 |
||
806 |
emergencySignalHandler := aOneArgBlock |
|
807 |
! |
|
808 |
||
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
809 |
removeAllExitActions |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
810 |
"remove all exit actions." |
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
811 |
|
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
812 |
exitActions := nil. |
699 | 813 |
|
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
814 |
"Created: 12.1.1997 / 00:36:02 / cg" |
699 | 815 |
! |
816 |
||
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
817 |
removeAllSuspendActions |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
818 |
"remove all suspend actions." |
699 | 819 |
|
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
820 |
suspendActions := nil. |
699 | 821 |
|
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
822 |
"Created: 12.1.1997 / 00:36:16 / cg" |
13016 | 823 |
! |
824 |
||
825 |
removeExitAction:anExitAction ifAbsent:exceptionBlock |
|
826 |
"remove the identical exitAction; if found, remove and return it; |
|
827 |
if not, return the value from evaluating exceptionBlock" |
|
828 |
||
829 |
exitActions notNil ifTrue:[ |
|
14722 | 830 |
^ exitActions removeIdentical:anExitAction ifAbsent:exceptionBlock. |
13016 | 831 |
]. |
832 |
^ exceptionBlock value. |
|
818 | 833 |
! ! |
699 | 834 |
|
818 | 835 |
!Process methodsFor:'accessing-stack'! |
699 | 836 |
|
837 |
maximumStackSize |
|
14722 | 838 |
"returns the processes stack limit - i.e. the process will be |
699 | 839 |
interrupted with a recursionSignal-raise, if it ever |
840 |
needs more stack (in bytes) than this number" |
|
841 |
||
842 |
%{ /* NOCONTEXT */ |
|
19294 | 843 |
extern INT __threadMaxStackSize(); |
699 | 844 |
OBJ i; |
845 |
||
1133 | 846 |
if (__isSmallInteger(i = __INST(id))) { |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
847 |
RETURN( __MKINT(__threadMaxStackSize(__intVal(i))) ); |
699 | 848 |
} |
849 |
%}. |
|
850 |
^ nil |
|
851 |
! |
|
852 |
||
853 |
setMaximumStackSize:limit |
|
854 |
"sets the processes stack limit - i.e. the process will be |
|
855 |
interrupted with a recursionSignal-raise, if it ever |
|
856 |
needs more stack (in bytes) than this number. |
|
857 |
Returns the old value." |
|
858 |
||
859 |
%{ /* NOCONTEXT */ |
|
19294 | 860 |
extern INT __threadSetMaxStackSize(int, unsigned INT); |
699 | 861 |
OBJ i; |
862 |
||
14722 | 863 |
if (__isSmallInteger(i = __INST(id)) |
699 | 864 |
&& __isSmallInteger(limit) ) { |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
865 |
RETURN ( __MKINT(__threadSetMaxStackSize(__intVal(i), __intVal(limit))) ); |
699 | 866 |
} |
867 |
%}. |
|
868 |
^ nil |
|
869 |
! |
|
870 |
||
712
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
871 |
setStackInitialSize:initial increment:increment safe:safe |
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
872 |
"hook for fine-tuning. Sets the processes initialStackSize- and |
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
873 |
and stackIncrement-parameters. Not for normal use." |
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
874 |
|
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
875 |
%{ /* NOCONTEXT */ |
19294 | 876 |
extern INT __threadSetJunkSizes(int, unsigned INT, unsigned INT, unsigned INT); |
19296 | 877 |
|
712
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
878 |
OBJ i; |
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
879 |
|
1133 | 880 |
if (__isSmallInteger(i = __INST(id)) |
712
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
881 |
&& __isSmallInteger(initial) |
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
882 |
&& __isSmallInteger(increment) |
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
883 |
&& __isSmallInteger(safe)) { |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
884 |
RETURN ( __threadSetJunkSizes(__intVal(i), __intVal(initial), __intVal(increment), __intVal(safe)) ? true : false ); |
712
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
885 |
} |
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
886 |
%}. |
40906c842cd2
added entry to control a processes stack allocation
Claus Gittinger <cg@exept.de>
parents:
699
diff
changeset
|
887 |
^ false |
699 | 888 |
! ! |
889 |
||
890 |
!Process methodsFor:'interrupts'! |
|
891 |
||
2725
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
892 |
blockInterrupts |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
893 |
"disable interrupt processing for the receiver process |
14722 | 894 |
- if disabled, incoming interrupts will be registered and handled as |
2725
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
895 |
soon as interrupts are reenabled via unblockInterrupts. |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
896 |
Returns the previous blocking status i.e. true if interrupts |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
897 |
where already blocked. You need this information for proper |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
898 |
unblocking, in case of nested block/unblock calls. |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
899 |
This is similar to OperatingSystem>>blockInterrupts, but only |
14722 | 900 |
affects interrupts for the receiver process |
2725
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
901 |
(i.e. those which are installed via #interruptWith:)" |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
902 |
|
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
903 |
|disabledBefore| |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
904 |
|
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
905 |
disabledBefore := interruptsDisabled. |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
906 |
interruptsDisabled := true. |
22326 | 907 |
^ disabledBefore |
2726 | 908 |
|
909 |
" |
|
910 |
|p1| |
|
911 |
||
912 |
p1 := [ |
|
22326 | 913 |
Transcript showCR:'disabled ...'. |
914 |
Transcript showCR:Processor activeProcess blockInterrupts. |
|
915 |
Transcript showCR:'busy ...'. |
|
916 |
Delay waitForSeconds:10. |
|
917 |
Transcript showCR:'enabled ...'. |
|
918 |
Processor activeProcess unblockInterrupts. |
|
919 |
] forkAt:9. |
|
2726 | 920 |
|
921 |
p1 interruptWith:[Transcript showCR:'interrupted']. |
|
922 |
" |
|
22326 | 923 |
|
924 |
"Modified: / 25-10-2017 / 18:03:39 / stefan" |
|
2725
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
925 |
! |
f5419dbc5f32
allow thread interrupts to be disabled/enabled
Claus Gittinger <cg@exept.de>
parents:
2724
diff
changeset
|
926 |
|
5491 | 927 |
hasInterruptActions |
928 |
"return true, if there are any interrupt actions to evaluate |
|
929 |
(i.e. if the receiver has been interrupted)." |
|
930 |
||
8544
732ed0a3d7ca
use #~~ instead of #> for speed
Stefan Vogel <sv@exept.de>
parents:
8495
diff
changeset
|
931 |
^ interruptActions size ~~ 0 |
5491 | 932 |
! |
933 |
||
699 | 934 |
interruptWith:aBlock |
935 |
"interrupt the receiver and make it evaluate aBlock. |
|
1784
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
936 |
If the receiver is currently suspended it is resumed. |
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
937 |
Notice, that the process will only perform the block immediately, |
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
938 |
IFF its priority is higher than the current processes priority. |
22628 | 939 |
Otherwise, it will remain suspended, until its time comes. |
940 |
||
941 |
aBlock is evaluated with an optional argument: the context, that has been |
|
942 |
interrupted." |
|
1092
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
943 |
|
21448 | 944 |
Processor activeProcess == self ifTrue:[ |
21447 | 945 |
aBlock value |
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
946 |
] ifFalse:[ |
21448 | 947 |
self isDead ifTrue:[ |
21463 | 948 |
"/ trying to register interrupt for dead process. |
949 |
^ self. |
|
21448 | 950 |
]. |
21447 | 951 |
self addInterruptAction:aBlock. |
952 |
Processor scheduleForInterrupt:self. |
|
2724 | 953 |
]. |
8613
b74b646a830b
no, last change leads to a blocking Debugger
Claus Gittinger <cg@exept.de>
parents:
8591
diff
changeset
|
954 |
|
21447 | 955 |
" |
956 |
Processor timeoutHandlerProcess interruptWith:[Transcript showCR:Processor activeProcess]. |
|
957 |
||
958 |
|p| |
|
959 |
p := [] fork. |
|
960 |
p waitUntilTerminated. |
|
961 |
p interruptWith:[Transcript showCR:Processor activeProcess]. |
|
962 |
" |
|
963 |
||
964 |
"Modified: / 12-01-1997 / 00:52:05 / cg" |
|
21463 | 965 |
"Modified: / 16-02-2017 / 18:09:38 / stefan" |
22628 | 966 |
"Modified (comment): / 16-03-2018 / 15:34:46 / stefan" |
1092
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
967 |
! |
699 | 968 |
|
1092
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
969 |
onResumeDo:aBlock |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
970 |
"prepare for the receiver to evaluate aBlock when resumed. |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
971 |
This is like #interruptWith:, but does not resume the receiver |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
972 |
(i.e. it continues its sleep). |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
973 |
This is useful to place a breakpoint on a sleeping process, to be fired |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
974 |
when it awakes." |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
975 |
|
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
976 |
self addInterruptAction:aBlock. |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
977 |
Processor scheduleInterruptActionsOf:self. |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
978 |
|
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
979 |
"Created: 5.3.1996 / 17:28:04 / cg" |
2a8acc60f5b5
added mechanism for a block to be evaluated onResume
Claus Gittinger <cg@exept.de>
parents:
1086
diff
changeset
|
980 |
"Modified: 8.3.1996 / 13:01:21 / cg" |
2839
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
981 |
! |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
982 |
|
2857
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
983 |
stepInterruptHandler:anObject |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
984 |
"set the handler for stepInterrupts occurring in the receiver process. |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
985 |
This is an interface for the debugger and allows it to monitor a threads |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
986 |
stepInterrupts. Returns the previous handler. |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
987 |
Not for general use." |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
988 |
|
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
989 |
%{ /* NOCONTEXT */ |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
990 |
extern OBJ __threadStepInterruptHandler(); |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
991 |
|
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
992 |
RETURN( __threadStepInterruptHandler(anObject) ); |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
993 |
%} |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
994 |
! |
2e9e294d679c
allow setting the stepInterruptHandler
Claus Gittinger <cg@exept.de>
parents:
2845
diff
changeset
|
995 |
|
2839
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
996 |
unblockInterrupts |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
997 |
"enable interrupt processing for the receiver process |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
998 |
- if any interrupts are pending, these will be handled immediately. |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
999 |
When unblocking interrupts, take care of nested block/unblock |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1000 |
calls - you should only unblock after a blockcall if they where |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1001 |
really not blocked before. |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1002 |
This is similar to OperatingSystem>>unblockInterrupts, but only |
14722 | 1003 |
affects interrupts for the receiver process |
2839
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1004 |
(i.e. those which are installed via #interruptWith:)" |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1005 |
|
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1006 |
interruptsDisabled := false. |
21008 | 1007 |
(interruptActions size ~~ 0 and:[Processor activeProcess == self]) ifTrue:[ |
1008 |
self interrupt. |
|
2839
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1009 |
] |
699 | 1010 |
! ! |
1011 |
||
21447 | 1012 |
!Process methodsFor:'interrupts-private'! |
1013 |
||
1014 |
addInterruptAction:aBlock |
|
1015 |
"make the receiver evaluate aBlock when resumed/interrupted. |
|
1016 |
The name is somewhat misleading (actually, its historic): |
|
1017 |
the block is also evaluated on resume." |
|
1018 |
||
1019 |
|wasBlocked| |
|
1020 |
||
1021 |
wasBlocked := OperatingSystem blockInterrupts. |
|
1022 |
interruptActions isNil ifTrue:[ |
|
1023 |
interruptActions := OrderedCollection with:aBlock. |
|
1024 |
] ifFalse:[ |
|
1025 |
interruptActions addFirst:aBlock. |
|
1026 |
]. |
|
1027 |
wasBlocked ifFalse:[OperatingSystem unblockInterrupts]. |
|
1028 |
! |
|
1029 |
||
1030 |
evaluateInterruptActionsWithContext:aContext |
|
1031 |
"evaluate my interrupt-actions." |
|
1032 |
||
22326 | 1033 |
|wasBlocked| |
1034 |
||
1035 |
wasBlocked := OperatingSystem blockInterrupts. |
|
21668 | 1036 |
[interruptActions notEmptyOrNil] whileTrue:[ |
22326 | 1037 |
|action| |
1038 |
||
21668 | 1039 |
action := interruptActions removeFirst. |
1040 |
interruptActions isEmpty ifTrue:[ |
|
1041 |
interruptActions := nil |
|
1042 |
]. |
|
1043 |
wasBlocked ifFalse:[OperatingSystem unblockInterrupts]. |
|
22326 | 1044 |
action valueWithOptionalArgument:aContext. |
1045 |
OperatingSystem blockInterrupts. |
|
21447 | 1046 |
]. |
22326 | 1047 |
wasBlocked ifFalse:[OperatingSystem unblockInterrupts]. |
1048 |
||
1049 |
"Modified: / 25-10-2017 / 17:45:46 / stefan" |
|
21447 | 1050 |
! |
1051 |
||
1052 |
forceInterruptOnReturnOf:aContext |
|
1053 |
"helper entry for debugger. Force a stepInterrupt whenever aContext |
|
1054 |
returns either directly or via an unwind." |
|
1055 |
||
1056 |
aContext markForInterruptOnUnwind. |
|
1057 |
%{ |
|
1058 |
OBJ i; |
|
1059 |
||
1060 |
if (__isSmallInteger(i = __INST(id))) { |
|
1061 |
__threadContextStepInterrupt(__intVal(i), 1); |
|
1062 |
} |
|
1063 |
%} |
|
1064 |
||
1065 |
! |
|
1066 |
||
1067 |
interrupt |
|
1068 |
"evaluate my interrupt-actions. |
|
1069 |
The process will go back to where it got interrupted |
|
1070 |
after doing this. |
|
1071 |
||
1072 |
This is also sent by the VM." |
|
1073 |
||
1074 |
interruptActions size ~~ 0 ifTrue:[ |
|
1075 |
self evaluateInterruptActionsWithContext:thisContext sender. |
|
1076 |
]. |
|
1077 |
! |
|
1078 |
||
1079 |
interruptedIn:aContext |
|
1080 |
"evaluate my interrupt-actions. |
|
1081 |
This is indirectly called by the VM, when some #interruptWith: action |
|
1082 |
was scheduled for the process, and the process is resumed. |
|
1083 |
The process will go back to where it got interrupted after doing this." |
|
1084 |
||
1085 |
"/ the returned value here has a subtle effect: |
|
1086 |
"/ if false, the interrupt is assumed to be not taken, |
|
1087 |
"/ and will be redelivered. |
|
1088 |
||
22326 | 1089 |
interruptsDisabled ifTrue:[ |
21447 | 1090 |
"/ no, I don't want interrupts right now; |
1091 |
"/ try again later. |
|
1092 |
^ false |
|
1093 |
]. |
|
1094 |
||
1095 |
"/ I tend to disable interrupts, while processing interrupt actions; |
|
1096 |
"/ however, this leads to a blocking Debugger sometimes (scroll). |
|
1097 |
"/ [ |
|
1098 |
"/ interruptsDisabled := true. |
|
1099 |
self evaluateInterruptActionsWithContext:aContext. |
|
1100 |
"/ ] ensure:[ |
|
1101 |
"/ interruptsDisabled := false. |
|
1102 |
"/ ]. |
|
1103 |
^ true |
|
1104 |
||
22326 | 1105 |
"Created: / 18-10-1996 / 20:43:39 / cg" |
1106 |
"Modified: / 25-10-2017 / 18:04:01 / stefan" |
|
21447 | 1107 |
! ! |
1108 |
||
699 | 1109 |
!Process methodsFor:'monitoring'! |
1110 |
||
1111 |
numberOfStackBoundaryHits |
|
1112 |
"internal monitoring only - will vanish" |
|
1113 |
||
1114 |
%{ /* NOCONTEXT */ |
|
19294 | 1115 |
extern INT __threadNumberOfStackBoundaryHits(); |
1116 |
INT n; |
|
699 | 1117 |
OBJ i; |
159 | 1118 |
|
1133 | 1119 |
if (__isSmallInteger(i = __INST(id))) { |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
1120 |
n = __threadNumberOfStackBoundaryHits(__intVal(i)); |
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
1121 |
n &= _MAX_INT; |
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
1122 |
RETURN( __mkSmallInteger(n) ); |
699 | 1123 |
} |
1124 |
%}. |
|
1125 |
^ nil |
|
1126 |
! |
|
1127 |
||
1128 |
numberOfStackSegments |
|
1129 |
"return the processes number of stack segments currently used. |
|
1130 |
This method is for monitoring purposes only - it may vanish." |
|
1131 |
||
1132 |
%{ /* NOCONTEXT */ |
|
19297 | 1133 |
extern int __threadStackSegments(); |
699 | 1134 |
OBJ i; |
1135 |
||
1133 | 1136 |
if (__isSmallInteger(i = __INST(id))) { |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
1137 |
RETURN( __mkSmallInteger((INT)__threadStackSegments(__intVal(i))) ); |
699 | 1138 |
} |
1139 |
%}. |
|
1140 |
^ nil |
|
1141 |
! |
|
1142 |
||
1143 |
totalStackSize |
|
1144 |
"return the processes maximum used stack size. |
|
1145 |
This method is for monitoring purposes only - it may vanish." |
|
1146 |
||
1147 |
%{ /* NOCONTEXT */ |
|
19294 | 1148 |
extern INT __threadTotalStackSize(); |
699 | 1149 |
OBJ i; |
1150 |
||
1133 | 1151 |
if (__isSmallInteger(i = __INST(id))) { |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
1152 |
RETURN( __MKINT(__threadTotalStackSize(__intVal(i))) ); |
699 | 1153 |
} |
1154 |
%}. |
|
1155 |
^ nil |
|
1156 |
! |
|
1157 |
||
1158 |
usedStackSize |
|
1159 |
"Return the processes current stack size. |
|
1160 |
This method is for monitoring purposes only - it may vanish." |
|
1161 |
||
1162 |
%{ /* NOCONTEXT */ |
|
14724 | 1163 |
extern unsigned INT __threadUsedStackSize(); |
699 | 1164 |
OBJ i; |
1165 |
||
1133 | 1166 |
if (__isSmallInteger(i = __INST(id))) { |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
1167 |
RETURN( __MKINT(__threadUsedStackSize(__intVal(i))) ); |
699 | 1168 |
} |
1169 |
%}. |
|
1170 |
^ nil |
|
1171 |
! |
|
1172 |
||
1173 |
vmTrace:aBoolean |
|
1174 |
"turn on/off VM message tracing for the receiver. |
|
1175 |
This is meant for ST/X debugging, and may vanish. |
|
1176 |
Expect lots of output, once this is turned on." |
|
1177 |
||
1178 |
%{ /* NOCONTEXT */ |
|
1179 |
OBJ i; |
|
1180 |
||
1133 | 1181 |
if (__isSmallInteger(i = __INST(id))) { |
1182 |
__threadTracing(__intVal(i), aBoolean); |
|
699 | 1183 |
} |
1184 |
%}. |
|
1185 |
! ! |
|
1186 |
||
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1187 |
!Process methodsFor:'obsolete'! |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1188 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1189 |
exitAction:aBlock |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1190 |
"Obsoleted by addExitAction: / removeAllExitActions. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1191 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1192 |
Add aBlock to the processes exit actions. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1193 |
This block will be evaluated right before the process dies. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1194 |
An argument of nil removes all exitActions." |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1195 |
|
5870 | 1196 |
<resource:#obsolete> |
1197 |
||
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1198 |
self obsoleteMethodWarning:'use addExitAction: / removeAllExitActions'. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1199 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1200 |
aBlock isNil ifTrue:[ |
14722 | 1201 |
^ self removeAllExitActions. |
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1202 |
]. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1203 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1204 |
^ self addExitAction:aBlock |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1205 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1206 |
"Modified: 13.12.1995 / 13:44:03 / stefan" |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1207 |
"Modified: 12.1.1997 / 00:39:59 / cg" |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1208 |
! |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1209 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1210 |
suspendAction:aBlock |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1211 |
"Obsoleted by addSuspendAction: / removeAllSuspendActions. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1212 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1213 |
Add aBlock to the processes suspend actions. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1214 |
This block will be evaluated when a process gets suspended. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1215 |
A nil argument removes all suspendActions." |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1216 |
|
5870 | 1217 |
<resource:#obsolete> |
1218 |
||
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1219 |
self obsoleteMethodWarning:'use addSuspendAction: / removeAllSuspendActions'. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1220 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1221 |
aBlock isNil ifTrue:[ |
14722 | 1222 |
^ self removeAllSuspendActions. |
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1223 |
]. |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1224 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1225 |
^ self addSuspendAction:aBlock |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1226 |
|
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1227 |
"Modified: 12.1.1997 / 00:38:22 / cg" |
9361 | 1228 |
! |
1229 |
||
1230 |
terminateAllSubprocesses |
|
1231 |
<resource:#obsolete> |
|
1232 |
self obsoleteMethodWarning:'use #terminateAllSubprocessesInGroup'. |
|
1233 |
self terminateAllSubprocessesInGroup. |
|
1234 |
! |
|
1235 |
||
1236 |
terminateWithAllSubprocesses |
|
1237 |
<resource:#obsolete> |
|
1238 |
self obsoleteMethodWarning:'use #terminateWithAllSubprocessesInGroup'. |
|
1239 |
self terminateWithAllSubprocessesInGroup. |
|
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1240 |
! ! |
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1241 |
|
699 | 1242 |
!Process methodsFor:'printing & storing'! |
1243 |
||
1244 |
printOn:aStream |
|
1245 |
"a little more info in my printed representation" |
|
1246 |
||
1247 |
aStream nextPutAll:state article; |
|
14722 | 1248 |
space; |
1249 |
nextPutAll:state; |
|
1250 |
nextPutAll:' Process ('; |
|
1251 |
nextPutAll:self nameOrId. |
|
6944
491b35cf0bf3
printString changed to include id
Claus Gittinger <cg@exept.de>
parents:
6784
diff
changeset
|
1252 |
name notNil ifTrue:[ |
14722 | 1253 |
aStream |
1254 |
nextPutAll:', id='; |
|
1255 |
nextPutAll:id printString. |
|
6944
491b35cf0bf3
printString changed to include id
Claus Gittinger <cg@exept.de>
parents:
6784
diff
changeset
|
1256 |
]. |
14722 | 1257 |
aStream |
1258 |
nextPutAll:')' |
|
159 | 1259 |
! ! |
1260 |
||
1261 |
!Process methodsFor:'private'! |
|
1262 |
||
1263 |
for:aBlock priority:aPrio |
|
1264 |
"setup the new process - the receiver is not scheduled for |
|
1265 |
execution, to get it running, send it #resume" |
|
1266 |
||
339 | 1267 |
|nm active| |
159 | 1268 |
|
1269 |
prio := aPrio. |
|
1270 |
startBlock := aBlock. |
|
339 | 1271 |
restartable := false. |
22326 | 1272 |
interruptsDisabled := false. |
159 | 1273 |
|
10436
2782fa4bd45a
#newProcess et al never return nil - but raise an exception
Stefan Vogel <sv@exept.de>
parents:
9361
diff
changeset
|
1274 |
Processor newProcessFor:self. |
159 | 1275 |
|
1276 |
" |
|
1277 |
give me a user-friendly name |
|
1278 |
" |
|
339 | 1279 |
active := Processor activeProcess. |
2268
e7e1f98c3bce
allow Process new (for subclasses)
Claus Gittinger <cg@exept.de>
parents:
2262
diff
changeset
|
1280 |
(nm := active name) notNil ifTrue:[ |
22326 | 1281 |
" |
1282 |
avoid name inflation |
|
1283 |
" |
|
1284 |
(nm endsWith:' sub') ifFalse:[ |
|
1285 |
nm := nm , ' [' , active id printString , '] sub' |
|
1286 |
]. |
|
1287 |
name := nm |
|
1529
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
1288 |
]. |
5675
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1289 |
creatorId := active id. |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1290 |
processGroupId := active processGroupId. |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1291 |
(processGroupId isNil or:[processGroupId == 0]) ifTrue:[ |
22326 | 1292 |
processGroupId := creatorId. |
5675
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1293 |
]. |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1294 |
|
4880 | 1295 |
"/ since groupId is used to detect a systemProcess (0), |
1296 |
"/ do not allow a 0 here; need an explicit beSystemProcess. |
|
1297 |
processGroupId == 0 ifTrue:[processGroupId := nil]. |
|
1529
0ba3d19f90d6
set the processGroupId when created
Claus Gittinger <cg@exept.de>
parents:
1524
diff
changeset
|
1298 |
|
22326 | 1299 |
"Modified: / 25-01-1997 / 01:28:54 / cg" |
1300 |
"Modified: / 25-10-2017 / 18:02:52 / stefan" |
|
5812
e23a3fdc75cb
already-dead is a proceedable error
Claus Gittinger <cg@exept.de>
parents:
5683
diff
changeset
|
1301 |
! ! |
159 | 1302 |
|
7257 | 1303 |
!Process methodsFor:'private-scheduler access'! |
1 | 1304 |
|
699 | 1305 |
setId:idNumber state:stateSymbol |
1306 |
"set id and state - not for public use" |
|
375 | 1307 |
|
699 | 1308 |
id := idNumber. |
4880 | 1309 |
creatorId := 0. |
1310 |
processGroupId := nil. |
|
699 | 1311 |
state := stateSymbol. |
8787 | 1312 |
singleStepping isNil ifTrue:[ |
14722 | 1313 |
singleStepping := false |
8787 | 1314 |
]. |
1315 |
restartable isNil ifTrue:[ |
|
14722 | 1316 |
restartable := false |
8787 | 1317 |
]. |
1318 |
interruptsDisabled isNil ifTrue:[ |
|
14722 | 1319 |
interruptsDisabled := false |
8787 | 1320 |
]. |
1844 | 1321 |
|
1322 |
"Modified: 30.10.1996 / 00:35:29 / cg" |
|
182 | 1323 |
! |
1324 |
||
159 | 1325 |
setPriority:aNumber |
1326 |
"set priority without telling processor - not for public use" |
|
1327 |
||
1328 |
prio := aNumber |
|
1329 |
! |
|
1330 |
||
1331 |
setStartBlock:aBlock |
|
19452 | 1332 |
"set the receiver's startup block" |
159 | 1333 |
|
1334 |
startBlock := aBlock |
|
1335 |
! |
|
13 | 1336 |
|
159 | 1337 |
setStateTo:newState if:oldState |
1338 |
state == oldState ifTrue:[state := newState] |
|
1339 |
! |
|
1340 |
||
1341 |
setStateTo:newState if:oldState1 or:oldState2 |
|
1342 |
(state == oldState1 or:[state == oldState2]) ifTrue:[state := newState] |
|
699 | 1343 |
! ! |
1344 |
||
818 | 1345 |
!Process methodsFor:'queries'! |
1346 |
||
5397 | 1347 |
isActive |
1348 |
"return true if I am the active process" |
|
1349 |
||
1350 |
^ Processor activeProcess == self |
|
1351 |
! |
|
1352 |
||
818 | 1353 |
isDead |
10553 | 1354 |
"return true, if the receiver is a dead process" |
818 | 1355 |
|
10553 | 1356 |
^ (id isNil or:[state isNil or:[state == #dead]]) |
818 | 1357 |
|
1358 |
"Modified: 23.12.1995 / 18:35:29 / cg" |
|
1359 |
! |
|
1360 |
||
14359 | 1361 |
isDebugged |
1362 |
"return true, iff the receiver process is currently being debugged |
|
1363 |
(i.e. is stopped and a debugger sits on top of it)" |
|
1364 |
||
1365 |
^ (state == #debug) |
|
1366 |
||
1367 |
"Created: / 26-09-2012 / 14:56:36 / cg" |
|
1368 |
! |
|
1369 |
||
22526 | 1370 |
isDebuggerProcess |
1371 |
"return true, iff the receiver process is currently running a Debugger or |
|
1372 |
an Inspector. Senders may behave differently and e.g. timeout on |
|
1373 |
endless blocking operations." |
|
1374 |
||
1375 |
^ self environmentAt:#isDebuggerProcess ifAbsent:false. |
|
1376 |
||
1377 |
"Created: / 01-02-2018 / 10:15:49 / stefan" |
|
1378 |
! |
|
1379 |
||
4874
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1380 |
isGUIProcess |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1381 |
"return true, if this is a GUI process. |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1382 |
I.e. a windowGroup process. |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1383 |
This is currently not used, but allows end-user applications |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1384 |
to terminate all subprocesses which are GUI related, and leave |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1385 |
other background processes in the same process group untouched." |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1386 |
|
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1387 |
^ processType == #gui |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1388 |
! |
2af584ce2793
added a processType attribute (for beGUI / isGUI)
Claus Gittinger <cg@exept.de>
parents:
4735
diff
changeset
|
1389 |
|
818 | 1390 |
isRestartable |
1391 |
"return true, iff the receiver is restartable" |
|
1392 |
||
1393 |
^ restartable |
|
1394 |
! |
|
1395 |
||
1396 |
isSingleStepping |
|
1397 |
^ singleStepping |
|
1398 |
! |
|
1399 |
||
5643 | 1400 |
isStopped |
1401 |
"return true, iff the receiver is stopped" |
|
1402 |
||
1403 |
^ (state == #stopped) |
|
1404 |
||
1405 |
"Modified: 23.12.1995 / 18:35:29 / cg" |
|
1406 |
! |
|
1407 |
||
2636
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1408 |
isSystemProcess |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1409 |
"return true if aProcess is a system process, |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1410 |
which should not be suspended/terminated etc.." |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1411 |
|
14722 | 1412 |
^ (Processor isPureEventDriven |
2636
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1413 |
or:[id == 0 |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1414 |
or:[processGroupId == 0 |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1415 |
or:[(Display notNil and:[Display dispatchProcess == self]) |
14722 | 1416 |
]]]) |
2636
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1417 |
|
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1418 |
" |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1419 |
Processor activeProcessIsSystemProcess |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1420 |
" |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1421 |
|
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1422 |
"Created: 17.4.1997 / 12:57:37 / stefan" |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1423 |
! |
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1424 |
|
17407 | 1425 |
isUserProcess |
1426 |
"return true if aProcess is a user process." |
|
1427 |
||
1428 |
^ processGroupId ~~ 0 and:[id ~~ 0] |
|
1429 |
! |
|
1430 |
||
818 | 1431 |
nameOrId |
1432 |
"return a string to identify the process - either name or id" |
|
1433 |
||
1434 |
name notNil ifTrue:[^ name]. |
|
1435 |
^ id printString |
|
5675
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1436 |
! |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1437 |
|
9361 | 1438 |
parentProcess |
17244 | 1439 |
"answer my parent. |
1440 |
Notice: we do only keep the id here, to prevent the parentProcess from being |
|
1441 |
referenced (and therefore not garbage collected if it terminates)" |
|
9361 | 1442 |
|
14722 | 1443 |
ProcessorScheduler knownProcessesDo:[:p| |
17544 | 1444 |
p id = creatorId ifTrue:[^ p]. |
14443 | 1445 |
]. |
1446 |
^ nil. |
|
9361 | 1447 |
|
1448 |
" |
|
1449 |
Processor activeProcess parentProcess |
|
1450 |
" |
|
14443 | 1451 |
|
1452 |
"Modified: / 26-10-2012 / 13:15:55 / cg" |
|
9361 | 1453 |
! |
1454 |
||
5675
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1455 |
processGroupLeader |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1456 |
"answer the parent of this process group" |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1457 |
|
5681 | 1458 |
|processes leader next creatorId| |
5675
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1459 |
|
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1460 |
processes := ProcessorScheduler knownProcesses. |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1461 |
leader := processes detect:[:p| p id = processGroupId] ifNone:nil. |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1462 |
leader isNil ifTrue:[ |
14722 | 1463 |
leader := self. |
1464 |
[ |
|
1465 |
creatorId := leader creatorId. |
|
1466 |
next := processes detect:[:p| p id = creatorId |
|
1467 |
and:[p processGroupId = processGroupId]] |
|
1468 |
ifNone:nil. |
|
1469 |
] doWhile:[next notNil and:[leader := next. true]]. |
|
5675
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1470 |
]. |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1471 |
|
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1472 |
^ leader. |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1473 |
|
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1474 |
" |
34d5b32f9259
Do not create a new process group for each grandchild process.
Stefan Vogel <sv@exept.de>
parents:
5643
diff
changeset
|
1475 |
Processor activeProcess processGroupLeader |
5812
e23a3fdc75cb
already-dead is a proceedable error
Claus Gittinger <cg@exept.de>
parents:
5683
diff
changeset
|
1476 |
" |
e23a3fdc75cb
already-dead is a proceedable error
Claus Gittinger <cg@exept.de>
parents:
5683
diff
changeset
|
1477 |
! ! |
818 | 1478 |
|
699 | 1479 |
!Process methodsFor:'special'! |
1480 |
||
15964 | 1481 |
externalLookupPopIfEqual: lookupObject |
1482 |
"Called by method lookup MOP when an lookup context is to be unwound |
|
1483 |
to cleanup lookup stack" |
|
1484 |
lookupActivations first == lookupObject ifTrue:[ |
|
16562 | 1485 |
lookupActivations := lookupActivations second. |
15964 | 1486 |
]. |
1487 |
||
1488 |
"Created: / 04-10-2013 / 10:46:48 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
1489 |
"Modified (comment): / 04-10-2013 / 12:08:17 / Jan Vrany <jan.vrany@fit.cvut.cz>" |
|
1490 |
! |
|
1491 |
||
772
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1492 |
millisecondDelay:millis |
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1493 |
"suspend the current process for some time. |
16846 | 1494 |
Attention: |
17544 | 1495 |
If the receiver is a system process (i.e. scheduler or event dispatcher) |
1496 |
this blocks the whole Smalltalk for the time delta; |
|
1497 |
if it's a normal thread, only that thread is suspended." |
|
772
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1498 |
|
2636
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1499 |
(self isSystemProcess) ifTrue:[ |
17544 | 1500 |
OperatingSystem millisecondDelay:millis |
772
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1501 |
] ifFalse:[ |
17544 | 1502 |
Delay waitForMilliseconds:millis |
772
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1503 |
] |
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1504 |
|
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1505 |
"Created: 16.12.1995 / 13:10:53 / cg" |
2636
8cb50e1b0688
Move #isSystemProcess from ProcessorScheduler to Process.
Stefan Vogel <sv@exept.de>
parents:
2384
diff
changeset
|
1506 |
"Modified: 17.4.1997 / 13:02:25 / stefan" |
772
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1507 |
! |
f86b117950c5
non-blocking/blocking millisecondDelay added
Claus Gittinger <cg@exept.de>
parents:
759
diff
changeset
|
1508 |
|
699 | 1509 |
trapRestrictedMethods:trap |
1510 |
"Allow/deny the execution of restricted methods. |
|
1511 |
Process specific method restriction is not implemented yet, so this call is |
|
1512 |
redirected to ObjectMemory and causes a system wide restriction. |
|
1513 |
||
1514 |
Notice: method restriction is a nonstandard feature, not supported |
|
1515 |
by other smalltalk implementations and not specified in the ANSI spec. |
|
1516 |
This is EXPERIMENTAL - and being evaluated for usability. |
|
1517 |
It may change or even vanish (if it shows to be not useful)." |
|
1518 |
||
1519 |
^ObjectMemory trapRestrictedMethods:trap |
|
1520 |
||
1521 |
" |
|
1522 |
Processor activeProcess trapRestrictedMethods:true |
|
1523 |
Processor activeProcess trapRestrictedMethods:false |
|
1524 |
" |
|
1525 |
||
1526 |
"Created: 8.11.1995 / 19:45:04 / stefan" |
|
1527 |
! |
|
1528 |
||
1529 |
uninterruptablyDo:aBlock |
|
14722 | 1530 |
"execute aBlock with interrupts blocked. |
699 | 1531 |
This does not prevent preemption by a higher priority processes |
1532 |
if any becomes runnable due to the evaluation of aBlock |
|
1533 |
(i.e. if a semaphore is signalled there)." |
|
1534 |
||
1535 |
"we must keep track of blocking-state if this is called nested" |
|
2302 | 1536 |
(OperatingSystem blockInterrupts) ifTrue:[ |
14722 | 1537 |
"/ already blocked |
1538 |
^ aBlock value |
|
2302 | 1539 |
]. |
699 | 1540 |
|
6421
58dca33cf0fc
#valueNowOrOnUnwindDo: -> #ensure:
Claus Gittinger <cg@exept.de>
parents:
6322
diff
changeset
|
1541 |
^ aBlock ensure:[OperatingSystem unblockInterrupts] |
159 | 1542 |
! |
1543 |
||
699 | 1544 |
waitUntilSuspended |
1545 |
"wait until the receiver is suspended." |
|
1546 |
||
5377 | 1547 |
self isDead ifFalse:[ |
22175 | 1548 |
[ |
1549 |
"/ must check again - interrupt could have happened |
|
1550 |
"/ and process already terminated. |
|
1551 |
self isDead ifFalse:[ |
|
1552 |
suspendSemaphore isNil ifTrue:[ |
|
1553 |
suspendSemaphore := Semaphore name:'process suspend' |
|
1554 |
]. |
|
1555 |
suspendSemaphore wait |
|
1556 |
] |
|
1557 |
] valueUninterruptably |
|
5377 | 1558 |
] |
699 | 1559 |
|
22175 | 1560 |
"Modified: / 09-08-2017 / 11:55:51 / cg" |
699 | 1561 |
! |
1562 |
||
1563 |
waitUntilTerminated |
|
1564 |
"wait until the receiver is terminated. |
|
1565 |
This method allows another process to wait till the receiver finishes." |
|
1566 |
||
6774
6711472e6df4
oops - waitUntil terminated for a process that did not rune
penk
parents:
6739
diff
changeset
|
1567 |
self waitUntilTerminatedWithTimeout:nil |
1033 | 1568 |
|
1789 | 1569 |
" |
1570 |
|p| |
|
1571 |
||
6774
6711472e6df4
oops - waitUntil terminated for a process that did not rune
penk
parents:
6739
diff
changeset
|
1572 |
p := [100 timesRepeat:[1000 factorial]] forkAt:4. |
1789 | 1573 |
|
1574 |
Transcript showCR:'now waiting ...'. |
|
1575 |
p waitUntilTerminated. |
|
1576 |
Transcript showCR:'done.' |
|
1577 |
" |
|
1578 |
||
2158
aab75d6439d0
renamed exitAction: and suspendAction: messages - the old name
Claus Gittinger <cg@exept.de>
parents:
2130
diff
changeset
|
1579 |
"Modified: 12.1.1997 / 00:40:59 / cg" |
699 | 1580 |
! |
1581 |
||
4735
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1582 |
waitUntilTerminatedWithTimeout:secondsOrNil |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1583 |
"wait until the receiver is terminated or (if non-nil) until |
14722 | 1584 |
the time period exired. |
13206
bffd4afb5be0
comment/format in: #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
13016
diff
changeset
|
1585 |
Returns true if a timeout occurred. |
8566 | 1586 |
This method allows another process to wait until the receiver finishes |
4735
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1587 |
(optionally) within some time." |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1588 |
|
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1589 |
|sema didTimeout| |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1590 |
|
10553 | 1591 |
didTimeout := false. |
1592 |
||
5377 | 1593 |
self isDead ifFalse:[ |
22175 | 1594 |
[ |
1595 |
"/ must check again - interrupt could have happened |
|
1596 |
"/ and process already terminated. |
|
1597 |
self isDead ifFalse:[ |
|
1598 |
sema := Semaphore name:'process termination'. |
|
1599 |
self addExitAction:[sema signal]. |
|
1600 |
didTimeout := (sema waitWithTimeout:secondsOrNil) isNil |
|
1601 |
] |
|
1602 |
] valueUninterruptably. |
|
5377 | 1603 |
]. |
10553 | 1604 |
^ didTimeout |
4735
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1605 |
|
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1606 |
" |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1607 |
|p| |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1608 |
|
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1609 |
p := [10 timesRepeat:[10000 factorial]] forkAt:4. |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1610 |
|
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1611 |
Transcript showCR:'now waiting ...'. |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1612 |
(p waitUntilTerminatedWithTimeout:2) ifTrue:[ |
22175 | 1613 |
Transcript showCR:'timeout occurred.' |
4735
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1614 |
] |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1615 |
" |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1616 |
|
22175 | 1617 |
"Modified: / 09-08-2017 / 11:55:56 / cg" |
4735
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1618 |
! |
f4aad6d584d1
added #waitUntilTerminatedWithTimeout:
Claus Gittinger <cg@exept.de>
parents:
4646
diff
changeset
|
1619 |
|
9059 | 1620 |
withHigherPriorityDo:aBlock |
1621 |
"execute aBlock at a higher priority." |
|
1622 |
||
1623 |
^ self withPriority:(prio + 1) do:aBlock |
|
1624 |
||
1625 |
" |
|
1626 |
Processor activeProcess withHigherPriorityDo:[3000 factorial] |
|
1627 |
" |
|
1628 |
! |
|
1629 |
||
699 | 1630 |
withLowerPriorityDo:aBlock |
1631 |
"execute aBlock at a lower priority. This can be used to perform |
|
1632 |
time-consuming operations at a more user-friendly priority." |
|
159 | 1633 |
|
699 | 1634 |
^ self withPriority:(prio - 1) do:aBlock |
1635 |
||
1636 |
" |
|
1637 |
Processor activeProcess withLowerPriorityDo:[3000 factorial] |
|
1638 |
" |
|
1639 |
! |
|
1640 |
||
1641 |
withPriority:aPrio do:aBlock |
|
1642 |
"execute aBlock at another priority. This can be used to perform |
|
1643 |
time-consuming operations at a more user-friendly priority, |
|
1644 |
or some critical action at a higher priority. Do not use too high |
|
1645 |
of a priority to avoid locking up the system (event processing takes place |
|
1646 |
at 24)" |
|
1647 |
||
1648 |
|oldprio| |
|
1649 |
||
1650 |
oldprio := prio. |
|
1651 |
self priority:aPrio. |
|
1652 |
||
6421
58dca33cf0fc
#valueNowOrOnUnwindDo: -> #ensure:
Claus Gittinger <cg@exept.de>
parents:
6322
diff
changeset
|
1653 |
^ aBlock ensure:[ |
14722 | 1654 |
self priority:oldprio |
699 | 1655 |
] |
1656 |
||
1657 |
" |
|
1658 |
Processor activeProcess withPriority:7 do:[3000 factorial] |
|
1659 |
" |
|
1660 |
"be careful - even ^C wont work until done: |
|
1661 |
Processor activeProcess withPriority:25 do:[3000 factorial] |
|
1662 |
" |
|
2839
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1663 |
! |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1664 |
|
4433 | 1665 |
withPriority:lowPrio to:highPrio do:aBlock |
1666 |
"execute aBlock at a priority range. This can be used to perform |
|
1667 |
time-consuming operations at a more user-friendly priority, |
|
1668 |
or some critical action at a higher priority. Do not use too high |
|
1669 |
of a priority to avoid locking up the system (event processing takes place |
|
1670 |
at 24)" |
|
1671 |
||
1672 |
|oldprio oldRange| |
|
1673 |
||
1674 |
oldprio := prio. |
|
1675 |
oldRange := priorityRange. |
|
1676 |
self priorityRange:(lowPrio to:highPrio). |
|
1677 |
||
6421
58dca33cf0fc
#valueNowOrOnUnwindDo: -> #ensure:
Claus Gittinger <cg@exept.de>
parents:
6322
diff
changeset
|
1678 |
^ aBlock ensure:[ |
14722 | 1679 |
self priorityRange:oldRange. |
1680 |
self priority:oldprio. |
|
4433 | 1681 |
] |
1682 |
||
1683 |
" |
|
1684 |
Processor activeProcess withPriority:7 to:8 do:[3000 factorial] |
|
1685 |
" |
|
1686 |
! |
|
1687 |
||
2839
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1688 |
withSystemBackgroundPriorityDo:aBlock |
14722 | 1689 |
"execute aBlock at system background priority. |
2839
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1690 |
This can be used to perform |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1691 |
background operations at a more user-friendly priority." |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1692 |
|
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1693 |
^ self withPriority:(Processor systemBackgroundPriority) do:aBlock |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1694 |
|
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1695 |
" |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1696 |
Processor activeProcess withSystemBackgroundPriorityDo:[3000 factorial] |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1697 |
" |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1698 |
|
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1699 |
"Created: 7.8.1997 / 12:56:23 / cg" |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1700 |
! |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1701 |
|
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1702 |
withUserBackgroundPriorityDo:aBlock |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1703 |
"execute aBlock at background priority. This can be used to perform |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1704 |
time-consuming operations at a more user-friendly priority." |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1705 |
|
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1706 |
^ self withPriority:(Processor userBackgroundPriority) do:aBlock |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1707 |
|
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1708 |
" |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1709 |
Processor activeProcess withUserBackgroundPriorityDo:[3000 factorial] |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1710 |
" |
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1711 |
|
22c472b4d24f
added #withUserBackgroundPrioDo / #withSystemBackgroundPrioDo:
Claus Gittinger <cg@exept.de>
parents:
2727
diff
changeset
|
1712 |
"Created: 6.8.1997 / 15:40:02 / cg" |
202 | 1713 |
! ! |
1714 |
||
5256 | 1715 |
!Process methodsFor:'startup'! |
116 | 1716 |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1717 |
imageRestart |
699 | 1718 |
"restart the process from the beginning. |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1719 |
This is sent by the ProcessorScheduler at image restart time, |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1720 |
to all restartable processes." |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1721 |
|
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1722 |
|savedGroupId| |
699 | 1723 |
|
1724 |
"/ ('restart process ' , id printString) errorPrintNL. |
|
1725 |
||
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1726 |
savedGroupId := processGroupId. |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1727 |
|
14722 | 1728 |
(Processor newProcessFor:self withId:id) ifFalse:[ |
5450 | 1729 |
"for some reason, the Processor was unable to create |
1730 |
a VM process for me ...." |
|
699 | 1731 |
|
5450 | 1732 |
('Process [warning]: process ' , id printString , ' failed to restart.') errorPrintCR. |
1733 |
^ nil |
|
699 | 1734 |
]. |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1735 |
processGroupId := savedGroupId. |
699 | 1736 |
self resume |
1086 | 1737 |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1738 |
"Created: 28.10.1996 / 20:32:34 / cg" |
2130
b9e7e1cf98bd
newStyle info & error messages
Claus Gittinger <cg@exept.de>
parents:
1980
diff
changeset
|
1739 |
"Modified: 10.1.1997 / 18:01:13 / cg" |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1740 |
! |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1741 |
|
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1742 |
restart |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1743 |
"restart the process from the beginning. |
21433 | 1744 |
This is only possible, if it's restartable." |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1745 |
|
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1746 |
restartable ifFalse:[ |
23016 | 1747 |
^ self proceedableError:'process is not restartable' |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1748 |
]. |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1749 |
|
22693 | 1750 |
self interruptWith:[RestartProcessRequest raise] |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1751 |
|
21433 | 1752 |
"Modified: / 12-01-1997 / 00:54:32 / cg" |
1753 |
"Modified (comment): / 13-02-2017 / 20:29:07 / cg" |
|
22693 | 1754 |
"Modified: / 23-04-2018 / 14:01:40 / stefan" |
23016 | 1755 |
"Modified: / 24-05-2018 / 21:03:56 / Claus Gittinger" |
699 | 1756 |
! |
1757 |
||
116 | 1758 |
start |
159 | 1759 |
"start the process - this is sent by the VM to the process to get |
1760 |
the process up and running. |
|
329 | 1761 |
Sending #start to the process (instead of directly executing the startBlock) |
14722 | 1762 |
allows more flexible handling of processes, since anything that responds |
329 | 1763 |
to #start can be handled transparently by the VM then ..." |
159 | 1764 |
|
1765 |
|block| |
|
116 | 1766 |
|
21333 | 1767 |
startBlock isNil ifTrue:[ |
1768 |
"is this artificial restriction useful ?" |
|
23016 | 1769 |
self proceedableError:'a process cannot be started twice'. |
21333 | 1770 |
^ self. |
1771 |
]. |
|
1772 |
||
1773 |
"/ |
|
1774 |
"/ just for your convenience ... |
|
1775 |
"/ |
|
1776 |
startTimestamp := Timestamp now. |
|
1777 |
name isNil ifTrue:[ |
|
1778 |
name := '(' , startBlock displayString , ')' |
|
1779 |
]. |
|
1780 |
||
1781 |
"save block for possible restart" |
|
1782 |
block := startBlock. |
|
1783 |
restartable ~~ true ifTrue:[ |
|
1784 |
startBlock := nil |
|
1785 |
]. |
|
1786 |
||
1787 |
[ |
|
21324 | 1788 |
"/ |
21333 | 1789 |
"/ block is the one which received the fork/newProcess some time ago... |
1790 |
"/ |
|
1791 |
self exceptionHandlerSet handleDo:block |
|
1792 |
] on:CaughtSignals do:[:ex | |
|
1793 |
"/ |
|
1794 |
"/ CaughtSignals: handle Process-Termination, Process-Restart and Abort |
|
1795 |
"/ |
|
1796 |
ex creator == RestartProcessRequest ifTrue:[ |
|
1797 |
ex restart |
|
21324 | 1798 |
]. |
21333 | 1799 |
ex return |
1800 |
] ensure:[ |
|
1801 |
self terminateNoSignal |
|
1802 |
]. |
|
1803 |
||
1804 |
"Modified: / 17-11-2001 / 16:45:32 / cg" |
|
1805 |
"Modified: / 31-01-2017 / 16:41:05 / stefan" |
|
23016 | 1806 |
"Modified: / 24-05-2018 / 21:04:12 / Claus Gittinger" |
1 | 1807 |
! ! |
1808 |
||
7263 | 1809 |
!Process methodsFor:'suspend & resume'! |
1 | 1810 |
|
5592 | 1811 |
abort |
14722 | 1812 |
"raise an AbortOperationRequest in the receiver process. |
1813 |
Most processes willing to handle this will return to some save state |
|
5592 | 1814 |
(typically, some kind of event loop). |
1815 |
If not handled, this will result in termination of the process." |
|
1816 |
||
1817 |
Processor activeProcess == self ifTrue:[ |
|
14722 | 1818 |
AbortOperationRequest raiseRequest |
5592 | 1819 |
] ifFalse:[ |
14722 | 1820 |
self interruptWith:[ |
1821 |
AbortOperationRequest raiseRequest |
|
1822 |
]. |
|
5592 | 1823 |
] |
6204
2bafef9151dd
class based exceptions - abortSignal;
Claus Gittinger <cg@exept.de>
parents:
5870
diff
changeset
|
1824 |
|
2bafef9151dd
class based exceptions - abortSignal;
Claus Gittinger <cg@exept.de>
parents:
5870
diff
changeset
|
1825 |
"Modified: / 16.11.2001 / 17:39:18 / cg" |
5592 | 1826 |
! |
1827 |
||
699 | 1828 |
resume |
1829 |
"resume the receiver process" |
|
1830 |
||
4002
341a896cb334
allow stopping a waiting process
Claus Gittinger <cg@exept.de>
parents:
3785
diff
changeset
|
1831 |
state == #stopped ifTrue:[ |
5450 | 1832 |
state := #run. |
4002
341a896cb334
allow stopping a waiting process
Claus Gittinger <cg@exept.de>
parents:
3785
diff
changeset
|
1833 |
]. |
699 | 1834 |
Processor resume:self |
1835 |
! |
|
1836 |
||
1837 |
resumeForSingleSend |
|
1838 |
"resume the receiver process, but only let it execute a single send." |
|
1839 |
||
1840 |
Processor resumeForSingleSend:self |
|
1841 |
! |
|
1842 |
||
326 | 1843 |
stop |
1844 |
"suspend the receiver process - will continue to run when a resume is sent. |
|
1845 |
A stopped process will not be resumed for interrupt processing." |
|
1846 |
||
11283 | 1847 |
self suspendWithState:#stopped. |
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1848 |
|
3679 | 1849 |
"Modified: / 13.12.1995 / 13:22:58 / stefan" |
1850 |
"Modified: / 27.7.1998 / 23:37:15 / cg" |
|
326 | 1851 |
! |
1852 |
||
1 | 1853 |
suspend |
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1854 |
"suspend the receiver process - it will continue to run when a resume is sent. |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1855 |
Notice, that an interrupt will also resume the receiver, |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1856 |
so any waiting code should be prepared for premature return from |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1857 |
a suspend (see wait code in Semaphore). |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1858 |
Use #stop for a hard-suspend, which is not affected by interrupts." |
13 | 1859 |
|
1474 | 1860 |
self suspendWithState:#suspended |
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1861 |
|
1474 | 1862 |
"Modified: 17.6.1996 / 14:41:34 / cg" |
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1863 |
! |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1864 |
|
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1865 |
suspendWithState:aStateSymbol |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1866 |
"like suspend, this suspends the receiver process until a resume is sent. |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1867 |
This sets the state to the argument, aStateSymbol, which is shown |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1868 |
in the ProcessMonitor (instead of #suspended). |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1869 |
(i.e. no new functionality, but a bit more debuggability) |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1870 |
Notice, that an interrupt will also resume the receiver, |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1871 |
so any waiting code should be prepared for premature return from |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1872 |
a suspend (see wait code in Semaphore). |
16312 | 1873 |
Use #stop for a hard-suspend, which is not affected by interrupts. |
1874 |
Should be called with interrupts disabled." |
|
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1875 |
|
23038 | 1876 |
<resource: #skipInDebuggersWalkBack> |
1877 |
||
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1878 |
suspendSemaphore notNil ifTrue:[suspendSemaphore signalForAll]. |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1879 |
suspendActions notNil ifTrue:[ |
23038 | 1880 |
|savedState| |
1881 |
||
1882 |
savedState := state. |
|
1883 |
state := #aboutToSuspend. |
|
1884 |
suspendActions do:[:action | action value]. |
|
1885 |
state ~~ #aboutToSuspend ifTrue:[ |
|
1886 |
"/ mhmh - one of the suspendActions lead to making me active again; |
|
1887 |
"/ bail out. |
|
1888 |
"/ This fixes the Semaphore was signalled, but process did not run error, |
|
1889 |
"/ which can happen when a process with a suspend action goes into a readWait, |
|
1890 |
"/ and the suspend action does a thread switch, and the readWait semaphore gets |
|
1891 |
"/ signalled before we come back here. Then the semaphore wakeup will have already |
|
1892 |
"/ place me back into the run state, so I should not go into a suspend below. |
|
1893 |
^ self. |
|
1894 |
]. |
|
1895 |
state := savedState. |
|
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1896 |
]. |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1897 |
|
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1898 |
" |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1899 |
this is a bit of a kludge: allow someone else to |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1900 |
set the state to something like #ioWait etc. |
19452 | 1901 |
In this case, do not set the receiver's state to #suspend. |
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1902 |
(All of this to enhance the output of the process monitor ...) |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1903 |
" |
14722 | 1904 |
(state == #active |
1905 |
or:[state == #run |
|
4002
341a896cb334
allow stopping a waiting process
Claus Gittinger <cg@exept.de>
parents:
3785
diff
changeset
|
1906 |
or:[aStateSymbol == #stopped]]) ifTrue:[ |
23038 | 1907 |
state := aStateSymbol. |
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
1908 |
]. |
1 | 1909 |
Processor suspend:self |
23038 | 1910 |
|
1911 |
"Modified: / 30-05-2018 / 13:57:00 / Claus Gittinger" |
|
1 | 1912 |
! |
1913 |
||
1914 |
terminate |
|
14722 | 1915 |
"terminate the receiver process. |
1916 |
Termination is done by raising the terminateSignal in the receiver process, |
|
2689 | 1917 |
which can be caught. |
22693 | 1918 |
If the process is stopped, it will be resumed so that it can die. |
375 | 1919 |
All unwind actions and the exit-actions (if any) |
4415
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
1920 |
will be performed before the process is really terminated. |
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
1921 |
Notice, that the terminate actions are performed by the receiver, |
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
1922 |
at its current priority. Therefore, in case higher prio processes are |
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
1923 |
running, it may take any arbitrary time until the termination is eventually |
dff1649c072c
resume the process when terminated.
Claus Gittinger <cg@exept.de>
parents:
4002
diff
changeset
|
1924 |
done." |
10 | 1925 |
|
22693 | 1926 |
self terminateWithException:TerminateProcessRequest newException. |
21313 | 1927 |
|
1928 |
"Modified: / 24-08-1998 / 18:29:46 / cg" |
|
22693 | 1929 |
"Modified: / 23-04-2018 / 14:31:06 / stefan" |
1930 |
"Modified (comment): / 23-04-2018 / 15:40:43 / stefan" |
|
159 | 1931 |
! |
1932 |
||
4875 | 1933 |
terminateAllGUISubprocesses |
19452 | 1934 |
"terminate all the receiver's gui subprocesses and their children as well |
5683
3312d4d798dc
terminateAllGUISubprocesses no longer restricted to processGroup.
Stefan Vogel <sv@exept.de>
parents:
5681
diff
changeset
|
1935 |
(i.e. all processes which are offsprings of the receiver, except for |
4875 | 1936 |
the receiver itself)." |
1937 |
||
5377 | 1938 |
id isNil ifTrue:[ |
20808 | 1939 |
"/ problem: |
1940 |
"/ if receiver is already dead, its id is nil. |
|
1941 |
"/ children are found by looking for processes with a parentID identical to |
|
1942 |
"/ mine - ifNil, system processes are found, which is probably not what you |
|
1943 |
"/ want ... |
|
1944 |
"/ FIX: remember the id (or don't nil it when terminating) |
|
1945 |
"/ requires VM changes. |
|
1946 |
ProcessorScheduler invalidProcessSignal |
|
1947 |
raiseRequestWith:self |
|
1948 |
errorString:'process is already dead - cannot determine child processes'. |
|
1949 |
^ self |
|
5377 | 1950 |
]. |
4875 | 1951 |
ProcessorScheduler knownProcesses do:[:aProcess | |
21313 | 1952 |
(aProcess ~~ self and:[aProcess creatorId == id and:[aProcess isGUIProcess]]) ifTrue:[ |
1953 |
aProcess terminateWithAllGUISubprocesses |
|
1954 |
]. |
|
4875 | 1955 |
]. |
1956 |
||
14443 | 1957 |
"Created: / 28-10-1996 / 20:43:32 / cg" |
1958 |
"Modified: / 26-10-2012 / 13:16:35 / cg" |
|
21313 | 1959 |
"Modified: / 24-01-2017 / 17:38:10 / stefan" |
5812
e23a3fdc75cb
already-dead is a proceedable error
Claus Gittinger <cg@exept.de>
parents:
5683
diff
changeset
|
1960 |
! |
4875 | 1961 |
|
6783 | 1962 |
terminateAllSubprocessesInGroup |
1963 |
"terminate all subprocesses which have the receiver process as groupID, |
|
1964 |
and their group-children as well. |
|
19452 | 1965 |
(i.e. all processes in the receiver's process group, except for the receiver itself, |
6783 | 1966 |
and recursively oll of their group processes.)." |
1531
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
1967 |
|
5377 | 1968 |
id isNil ifTrue:[ |
20808 | 1969 |
"/ problem: |
1970 |
"/ if receiver is already dead, its id is nil. |
|
1971 |
"/ children are found by looking for processes with a parentID identical to |
|
1972 |
"/ mine - ifNil, system processes are found, which is probably not what you |
|
1973 |
"/ want ... |
|
1974 |
"/ FIX: remember the id (or don't nil it when terminating) |
|
1975 |
"/ requires VM changes. |
|
1976 |
ProcessorScheduler invalidProcessSignal |
|
1977 |
raiseRequestWith:self |
|
1978 |
errorString:'process is already dead - cannot determine child processes'. |
|
1979 |
^ self |
|
5377 | 1980 |
]. |
9300 | 1981 |
self terminateAllSubprocessesInGroup:id |
1982 |
! |
|
1983 |
||
1984 |
terminateAllSubprocessesInGroup:aGroup |
|
1985 |
"terminate all subprocesses which have aGroup as groupID, |
|
1986 |
and their group-children as well. |
|
19452 | 1987 |
(i.e. all processes in the receiver's process group, except for the receiver itself, |
9300 | 1988 |
and recursively oll of their group processes.)." |
1989 |
||
1531
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
1990 |
ProcessorScheduler knownProcesses do:[:aProcess | |
21313 | 1991 |
(aProcess ~~ self and:[aProcess processGroupId == aGroup]) ifTrue:[ |
1992 |
aProcess terminateWithAllSubprocessesInGroup |
|
1993 |
]. |
|
1531
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
1994 |
]. |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1995 |
|
21313 | 1996 |
"Created: / 28-10-1996 / 20:43:32 / cg" |
1997 |
"Modified: / 03-11-1997 / 00:28:06 / cg" |
|
1998 |
"Modified: / 24-01-2017 / 17:42:33 / stefan" |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
1999 |
! |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2000 |
|
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2001 |
terminateGroup |
14722 | 2002 |
"terminate the receiver with all of its created subprocesses |
19452 | 2003 |
that are in the receiver's process group." |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2004 |
|
5683
3312d4d798dc
terminateAllGUISubprocesses no longer restricted to processGroup.
Stefan Vogel <sv@exept.de>
parents:
5681
diff
changeset
|
2005 |
id isNil ifTrue:[ |
20808 | 2006 |
"/ problem: |
2007 |
"/ if receiver is already dead, its id is nil. |
|
2008 |
"/ children are found by looking for processes with a parentID identical to |
|
2009 |
"/ mine - ifNil, system processes are found, which is probably not what you |
|
2010 |
"/ want ... |
|
2011 |
"/ FIX: remember the id (or don't nil it when terminating) |
|
2012 |
"/ requires VM changes. |
|
2013 |
ProcessorScheduler invalidProcessSignal |
|
2014 |
raiseRequestWith:self |
|
2015 |
errorString:'process is already dead - cannot determine child processes'. |
|
2016 |
^ self |
|
5683
3312d4d798dc
terminateAllGUISubprocesses no longer restricted to processGroup.
Stefan Vogel <sv@exept.de>
parents:
5681
diff
changeset
|
2017 |
]. |
3312d4d798dc
terminateAllGUISubprocesses no longer restricted to processGroup.
Stefan Vogel <sv@exept.de>
parents:
5681
diff
changeset
|
2018 |
ProcessorScheduler knownProcesses do:[:aProcess | |
21313 | 2019 |
(aProcess ~~ self and:[aProcess processGroupId == id]) ifTrue:[ |
2020 |
aProcess terminate |
|
2021 |
]. |
|
5683
3312d4d798dc
terminateAllGUISubprocesses no longer restricted to processGroup.
Stefan Vogel <sv@exept.de>
parents:
5681
diff
changeset
|
2022 |
]. |
5812
e23a3fdc75cb
already-dead is a proceedable error
Claus Gittinger <cg@exept.de>
parents:
5683
diff
changeset
|
2023 |
self terminate |
21313 | 2024 |
|
2025 |
"Modified: / 24-01-2017 / 17:41:12 / stefan" |
|
5812
e23a3fdc75cb
already-dead is a proceedable error
Claus Gittinger <cg@exept.de>
parents:
5683
diff
changeset
|
2026 |
! |
1531
2a61dad6c7ce
added #beGroupLeader & #terminateGroup
Claus Gittinger <cg@exept.de>
parents:
1530
diff
changeset
|
2027 |
|
159 | 2028 |
terminateNoSignal |
2197 | 2029 |
"hard-terminate the receiver process without sending a terminateSignal |
375 | 2030 |
or performing any unwind-handling. |
2197 | 2031 |
However, exit-actions are performed. |
2032 |
This is useful in case of emergency, when a buggy terminationHandler |
|
2033 |
prevents you from getting a process to terminate." |
|
375 | 2034 |
|
2035 |
|block| |
|
159 | 2036 |
|
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
2037 |
"/ this is treated like the final suspend |
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
2038 |
suspendActions notNil ifTrue:[ |
5450 | 2039 |
[suspendActions isEmpty] whileFalse:[ |
2040 |
block := suspendActions removeFirst. |
|
2041 |
block value. |
|
2042 |
] |
|
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
2043 |
]. |
375 | 2044 |
exitActions notNil ifTrue:[ |
5450 | 2045 |
[exitActions isEmpty] whileFalse:[ |
2046 |
block := exitActions removeFirst. |
|
2047 |
block value. |
|
2048 |
] |
|
375 | 2049 |
]. |
329 | 2050 |
suspendSemaphore notNil ifTrue:[suspendSemaphore signalForAll]. |
159 | 2051 |
Processor terminateNoSignal:self |
752
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
2052 |
|
0259dd855289
new suspendAction, Semaphore & ProcSched stuff from stefan
Claus Gittinger <cg@exept.de>
parents:
712
diff
changeset
|
2053 |
"Modified: 13.12.1995 / 13:40:14 / stefan" |
2384 | 2054 |
"Modified: 12.2.1997 / 12:41:38 / cg" |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2055 |
! |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2056 |
|
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2057 |
terminateSubprocesses |
19751 | 2058 |
"terminate all the receiver's subprocesses |
19452 | 2059 |
(i.e. all processes in the receiver's process group, except for |
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2060 |
the receiver itself)." |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2061 |
|
5377 | 2062 |
id isNil ifTrue:[ |
20808 | 2063 |
"/ problem: |
2064 |
"/ if receiver is already dead, its id is nil. |
|
2065 |
"/ children are found by looking for processes with a parentID identical to |
|
2066 |
"/ mine - ifNil, system processes are found, which is probably not what you |
|
2067 |
"/ want ... |
|
2068 |
"/ FIX: remember the id (or don't nil it when terminating) |
|
2069 |
"/ requires VM changes. |
|
2070 |
ProcessorScheduler invalidProcessSignal |
|
2071 |
raiseRequestWith:self |
|
2072 |
errorString:'process is already dead - cannot determine child processes'. |
|
2073 |
^ self |
|
10496
1198c42b85f5
Be conservative when setting helper processes of executeCommand:...
Stefan Vogel <sv@exept.de>
parents:
10436
diff
changeset
|
2074 |
]. |
1198c42b85f5
Be conservative when setting helper processes of executeCommand:...
Stefan Vogel <sv@exept.de>
parents:
10436
diff
changeset
|
2075 |
processGroupId == 0 ifTrue:[ |
20808 | 2076 |
ProcessorScheduler invalidProcessSignal |
2077 |
raiseWith:self errorString:'trying to terminate the system process group'. |
|
5377 | 2078 |
]. |
21313 | 2079 |
ProcessorScheduler knownProcesses do:[:eachProcess | |
2080 |
eachProcess ~~ self ifTrue:[ |
|
2081 |
|eachProcessGroupId| |
|
2082 |
||
2083 |
eachProcessGroupId := eachProcess processGroupId. |
|
2084 |
(eachProcessGroupId == processGroupId or:[eachProcessGroupId == id]) ifTrue:[ |
|
2085 |
eachProcess terminate |
|
2086 |
]. |
|
2087 |
]. |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2088 |
]. |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2089 |
|
21313 | 2090 |
"Created: / 28-10-1996 / 20:41:49 / cg" |
2091 |
"Modified: / 26-08-1997 / 03:09:57 / cg" |
|
2092 |
"Modified: / 24-01-2017 / 17:35:25 / stefan" |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2093 |
! |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2094 |
|
4875 | 2095 |
terminateWithAllGUISubprocesses |
6783 | 2096 |
"terminate the receiver with all of its created gui subprocesses and their gui children." |
4875 | 2097 |
|
2098 |
self terminateAllGUISubprocesses. |
|
2099 |
self terminate |
|
2100 |
||
2101 |
"Modified: 28.10.1996 / 20:42:00 / cg" |
|
2102 |
"Created: 28.10.1996 / 20:44:07 / cg" |
|
2103 |
! |
|
2104 |
||
6783 | 2105 |
terminateWithAllSubprocessesInGroup |
2106 |
"terminate the receiver with |
|
19452 | 2107 |
all subprocesses which have the receiver's process ID as groupID, |
6783 | 2108 |
and their group-children as well. |
19751 | 2109 |
(i.e. the receiver plus all processes in the receiver's process group, |
6783 | 2110 |
and recursively all of their group processes)." |
2111 |
||
2112 |
self terminateAllSubprocessesInGroup. |
|
1837
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2113 |
self terminate |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2114 |
|
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2115 |
"Modified: 28.10.1996 / 20:42:00 / cg" |
7e3b67a1adab
more subprocess termination variants
Claus Gittinger <cg@exept.de>
parents:
1789
diff
changeset
|
2116 |
"Created: 28.10.1996 / 20:44:07 / cg" |
22693 | 2117 |
! |
2118 |
||
2119 |
terminateWithException:aTerminateException |
|
2120 |
"terminate the receiver process. |
|
2121 |
Termination is done by raising aTerminateException in the receiver process, |
|
2122 |
which can be caught. |
|
2123 |
If the process is stopped, it will be resumed so that it can die. |
|
2124 |
All unwind actions and the exit-actions (if any) |
|
2125 |
will be performed before the process is really terminated. |
|
2126 |
Notice, that the terminate actions are performed by the receiver, |
|
2127 |
at its current priority. Therefore, in case higher prio processes are |
|
2128 |
running, it may take any arbitrary time until the termination is eventually |
|
2129 |
done." |
|
2130 |
||
2131 |
|wasBlocked| |
|
2132 |
||
2133 |
Processor activeProcess == self ifTrue:[ |
|
2134 |
"suicide: terminating myself" |
|
2135 |
NoHandlerError handle:[:ex | |
|
2136 |
"unhandled TerminateProcessRequest is not an error - |
|
2137 |
the interrupt may be delivered before a |
|
2138 |
low priority process has set up the exception handler" |
|
2139 |
ex exception ~~ aTerminateException ifTrue:[ |
|
2140 |
ex reject. |
|
2141 |
]. |
|
2142 |
] do:[ |
|
2143 |
aTerminateException raise. |
|
2144 |
]. |
|
2145 |
self terminateNoSignal. |
|
2146 |
"not reached" |
|
2147 |
^ self. |
|
2148 |
]. |
|
2149 |
||
2150 |
"the receiver is terminated from another process" |
|
2151 |
wasBlocked := OperatingSystem blockInterrupts. |
|
2152 |
[ |
|
2153 |
(state isNil or:[state == #dead]) ifTrue:[ |
|
2154 |
^ self. |
|
2155 |
]. |
|
2156 |
state == #osWait ifTrue:[ |
|
2157 |
"osWait processes cannot be interrupted" |
|
2158 |
self terminateNoSignal. |
|
2159 |
^ self. |
|
2160 |
]. |
|
2161 |
||
2162 |
self suspendedContext isNil ifTrue:[ |
|
2163 |
"if the receiver had no chance to execute yet, |
|
2164 |
it can be shot down without a signal" |
|
2165 |
self terminateNoSignal. |
|
2166 |
^ self |
|
2167 |
] |
|
2168 |
] ensure:[ |
|
2169 |
wasBlocked ifFalse:[OperatingSystem unblockInterrupts] |
|
2170 |
]. |
|
2171 |
||
2172 |
"register an interrupt action, so that I am terminating myself" |
|
2173 |
self interruptWith:[ |
|
2174 |
self terminateWithException:aTerminateException. |
|
2175 |
]. |
|
2176 |
"maybe I am stopped - resume so that I can die" |
|
2177 |
self resume. |
|
2178 |
||
2179 |
"Created: / 23-04-2018 / 14:29:34 / stefan" |
|
2180 |
"Modified (comment): / 23-04-2018 / 15:41:07 / stefan" |
|
1 | 2181 |
! ! |
2182 |
||
21333 | 2183 |
|
6739 | 2184 |
!Process methodsFor:'thread local storage'! |
2185 |
||
19387 | 2186 |
environment |
2187 |
"return the dictionary holding thread local variables, or nil if there are none" |
|
2188 |
||
2189 |
^ environment |
|
2190 |
! |
|
2191 |
||
2192 |
environment:aDictionary |
|
2193 |
"set the dictionary holding thread local variables, or nil if there are to be none" |
|
2194 |
||
2195 |
environment := aDictionary |
|
2196 |
! |
|
2197 |
||
7427 | 2198 |
environmentAt:aKey |
2199 |
"return the value of a thread local variable, or raise an error, if no such variable exists" |
|
2200 |
||
14722 | 2201 |
^ self |
2202 |
environmentAt:aKey |
|
2203 |
ifAbsent:[ |
|
2204 |
self errorKeyNotFound:aKey. |
|
2205 |
] |
|
7427 | 2206 |
! |
2207 |
||
2208 |
environmentAt:aKey ifAbsent:defaultValue |
|
2209 |
"return the value of a thread local variable, or the value of defaultValue if no such variable exists" |
|
6739 | 2210 |
|
2211 |
|val| |
|
2212 |
||
7427 | 2213 |
environment isNil ifTrue:[^ defaultValue value]. |
2214 |
val := environment at:aKey ifAbsent:[^ defaultValue value]. |
|
6739 | 2215 |
^ val value. |
2216 |
! |
|
2217 |
||
7427 | 2218 |
environmentAt:aKey put:aValue |
2219 |
"set the value of a thread local variable. Returns aValue" |
|
2220 |
||
2221 |
|var| |
|
2222 |
||
2223 |
environment isNil ifTrue:[ |
|
20067 | 2224 |
environment := IdentityDictionary new |
7427 | 2225 |
]. |
20067 | 2226 |
var := environment at:aKey ifAbsentPut:[ValueHolder new]. |
7427 | 2227 |
var value:aValue. |
2228 |
^ aValue |
|
2229 |
! |
|
2230 |
||
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2231 |
environmentIncludesKey:aKey |
19388 | 2232 |
"true if there is a thread local variable, false if no such variable exists" |
2233 |
||
20067 | 2234 |
^ environment notNil and:[environment includesKey:aKey] |
19388 | 2235 |
! |
2236 |
||
19377 | 2237 |
stderr |
2238 |
"the processes stderr. |
|
2239 |
By default, this is Stderr, but it can be overwritten |
|
2240 |
(for example to redirect a thread's error output to some other place" |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2241 |
|
19377 | 2242 |
^ self environmentAt:#Stderr ifAbsent:Stderr |
2243 |
||
2244 |
" |
|
22183 | 2245 |
Processor activeProcess stderr |
19377 | 2246 |
" |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2247 |
|
19377 | 2248 |
" |
2249 |
|out sema| |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2250 |
|
19377 | 2251 |
out := WriteStream on:''. |
2252 |
sema := Semaphore new. |
|
2253 |
[ |
|
22183 | 2254 |
Processor activeProcess environmentAt:#Stderr put:out. |
2255 |
'hello world' errorPrintCR. |
|
2256 |
sema signal. |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2257 |
] fork. |
19377 | 2258 |
sema wait. |
2259 |
Transcript showCR:('output was: ''',out contents,''''). |
|
2260 |
" |
|
2261 |
! |
|
2262 |
||
2263 |
stdin |
|
2264 |
"the processes stdin. |
|
2265 |
By default, this is Stdin, but it can be overwritten |
|
2266 |
(for example to redirect a thread's input from some other place" |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2267 |
|
19377 | 2268 |
^ self environmentAt:#Stdin ifAbsent:Stdin |
2269 |
! |
|
2270 |
||
2271 |
stdout |
|
2272 |
"the processes stdout. |
|
2273 |
By default, this is Stdout, but it can be overwritten |
|
2274 |
(for example to redirect a thread's output to some other place" |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2275 |
|
19377 | 2276 |
^ self environmentAt:#Stdout ifAbsent:Stdout |
2277 |
! |
|
2278 |
||
7427 | 2279 |
threadVariableValueOf:aKey |
20682 | 2280 |
"return the value of a thread local variable, |
2281 |
or nil if no such variable exists" |
|
7427 | 2282 |
|
2283 |
^ self environmentAt:aKey ifAbsent:nil |
|
16047 | 2284 |
|
2285 |
" |
|
2286 |
see example in withThreadVariable:boundTo:do: |
|
2287 |
" |
|
7427 | 2288 |
! |
2289 |
||
19377 | 2290 |
transcript |
2291 |
"the processes transcript. |
|
2292 |
By default, this is Transcript, but it can be overwritten |
|
2293 |
(for example to redirect a thread's output to some other place" |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2294 |
|
19380 | 2295 |
^ self environmentAt:#Transcript ifAbsent:[Transcript] |
19377 | 2296 |
! |
2297 |
||
19387 | 2298 |
withThreadLocalVariables:aDictionary do:aBlock |
2299 |
"evaluate a block with threadLocalVariables from aDictionary; |
|
2300 |
restore the old bindings afterwards." |
|
2301 |
||
2302 |
|oldEnv result| |
|
2303 |
||
2304 |
oldEnv := environment. |
|
2305 |
||
2306 |
[ |
|
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2307 |
environment := aDictionary. |
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2308 |
result := aBlock value. |
19387 | 2309 |
] ensure:[ |
19860
324edacff5cc
unified cpu and os defines;
Claus Gittinger <cg@exept.de>
parents:
19751
diff
changeset
|
2310 |
environment := oldEnv. |
19387 | 2311 |
]. |
2312 |
^ result |
|
2313 |
! |
|
2314 |
||
6739 | 2315 |
withThreadVariable:variableNameSymbol boundTo:aValue do:aBlock |
7427 | 2316 |
"evaluate a block with the threadLocalVariable being bound to aValue; |
2317 |
undo the variable binding afterwards." |
|
2318 |
||
23050 | 2319 |
|var oldValue| |
6739 | 2320 |
|
2321 |
environment isNil ifTrue:[ |
|
20682 | 2322 |
environment := IdentityDictionary new |
6739 | 2323 |
]. |
2324 |
var := environment at:variableNameSymbol ifAbsent:nil. |
|
2325 |
var isNil ifTrue:[ |
|
20682 | 2326 |
var := ValueHolder new. |
2327 |
environment at:variableNameSymbol put:var. |
|
6739 | 2328 |
]. |
2329 |
||
2330 |
oldValue := var value. |
|
23050 | 2331 |
^ [ |
20682 | 2332 |
var value:aValue. |
23050 | 2333 |
aBlock value. |
6739 | 2334 |
] ensure:[ |
20682 | 2335 |
oldValue isNil |
2336 |
ifTrue:[ environment removeKey:variableNameSymbol] |
|
2337 |
ifFalse:[ var value:oldValue ] |
|
6739 | 2338 |
]. |
16047 | 2339 |
|
2340 |
" |
|
2341 |
|printIt| |
|
2342 |
||
20682 | 2343 |
printIt := [ |
2344 |
Transcript |
|
2345 |
showCR:'foo is now ', |
|
2346 |
(Processor activeProcess threadVariableValueOf:#foo) printString |
|
2347 |
]. |
|
16047 | 2348 |
|
2349 |
Processor activeProcess |
|
20682 | 2350 |
withThreadVariable:#foo |
2351 |
boundTo:1234 |
|
2352 |
do:[ |
|
2353 |
printIt value. |
|
2354 |
Processor activeProcess |
|
2355 |
withThreadVariable:#foo |
|
2356 |
boundTo:2345 |
|
2357 |
do:[ |
|
2358 |
printIt value |
|
2359 |
]. |
|
2360 |
] |
|
16047 | 2361 |
" |
23050 | 2362 |
|
2363 |
"Modified: / 05-06-2018 / 16:41:11 / Stefan Vogel" |
|
6739 | 2364 |
! ! |
2365 |
||
1784
af6446feffae
optionally pass the interruptedContext to a #interruptWith: block
Claus Gittinger <cg@exept.de>
parents:
1728
diff
changeset
|
2366 |
!Process class methodsFor:'documentation'! |
159 | 2367 |
|
19293 | 2368 |
version |
2369 |
^ '$Header$' |
|
2370 |
! |
|
2371 |
||
13398 | 2372 |
version_CVS |
19292 | 2373 |
^ '$Header$' |
12764
c3da6be46ff1
use _MAX_INT instead of 0x3fffffff in primitive code when generating SmallIntegers
Stefan Vogel <sv@exept.de>
parents:
11416
diff
changeset
|
2374 |
! |
c3da6be46ff1
use _MAX_INT instead of 0x3fffffff in primitive code when generating SmallIntegers
Stefan Vogel <sv@exept.de>
parents:
11416
diff
changeset
|
2375 |
|
13398 | 2376 |
version_SVN |
15964 | 2377 |
^ '$ Id: Process.st 10643 2011-06-08 21:53:07Z vranyj1 $' |
159 | 2378 |
! ! |
6774
6711472e6df4
oops - waitUntil terminated for a process that did not rune
penk
parents:
6739
diff
changeset
|
2379 |
|
15117 | 2380 |
|
699 | 2381 |
Process initialize! |