docs(scripting): T starts at the run's start but is wall clock from there; document the late-notice, ceiling and counter rules (#827 review F4)
The proto comment, VirtualTags.md and CLAUDE.md said the soft deadline measures the script's own execution and that starvation never counts. Only the time before the run STARTS is excluded; from the start it is wall-clock time, as in process, so a GC pause or a starved / suspended worker during the run still counts. A mid-run freeze test is not added: it races the script's own return against the watchdog's notice; documented as not covered. Also documents F2 (late notice cancels and counts), F3 (progress ceiling, killed_unresponsive) and F5 (answer = stalled | retrigger).
This commit is contained in:
@@ -12,9 +12,10 @@ using ZB.MOM.WW.OtOpcUa.Core.Scripting.Protocol.V1;
|
||||
namespace ZB.MOM.WW.OtOpcUa.ScriptWorker.Tests;
|
||||
|
||||
/// <summary>
|
||||
/// lmxopcua#827: the soft deadline T measures the script's OWN execution — the worker runs it from the moment an
|
||||
/// evaluation thread starts the run — so the pipe round trip and the time a starved worker waits to be scheduled
|
||||
/// no longer count against the script. The host keeps a transport deadline (T + G from submit) and reports passing
|
||||
/// lmxopcua#827: the soft deadline T starts when an evaluation thread starts the run — the worker runs that clock —
|
||||
/// so the pipe round trip and the time a starved worker takes to START the run no longer count against the script.
|
||||
/// From the start it is wall-clock time, as in process: a pause DURING the run still counts, and is not tested
|
||||
/// here (a mid-run freeze races the script's own return against the watchdog's notice). The host keeps a transport deadline (T + G from submit) and reports passing
|
||||
/// it as a runner fault (<see cref="ScriptRunOutcome.WorkerUnresponsiveReason"/>, BadResourceUnavailable), never as a
|
||||
/// script timeout. The starved worker is made real here: its process is suspended (SIGSTOP / NtSuspendProcess)
|
||||
/// while a trivial script is submitted.
|
||||
|
||||
Reference in New Issue
Block a user