dflush susp-eval-id
The dflush command unwinds the stack to eliminate frames generated by suspended computations. Typically, these frames can occur when using the dprint –nowait command. Other possibilities are if an error occurred in a function call in an eval point, in an expression in a Tools > Evaluate window, or if you use a $stop function.
|
If you don’t use an argument, the CLI unwinds the top-most suspended evaluation in all threads in the current focus.
|
|
|
If you use a susp-eval-id, the CLI unwinds each stack of all threads in the current focus, flushing all pending computations up to and including the frame associated with the ID.
|
|
|
If you use the –all option, the CLI flushes all suspended evaluations in all threads in the current focus.
|
If no evaluations are suspended, the CLI ignores this command. If you do not indicate a focus, the default focus is the thread of interest.
The following example uses the dprint command to place five suspended routines on the stack. It then uses the dflush command to remove them. This example uses the dflush command in three different ways.
d1.<> dwhere
0 nothing2 PC=0x00012520, FP=0xffbef130 [fork.cxx#310]
0 nothing2 PC=0x00012520, FP=0xffbef130 [fork.cxx#310]