Skip to content

Runtime diagnostics: launch_trace / launch_trace_max runtime options - #156

Merged
phantoslayer21 merged 2 commits into
mainfrom
runtime/launch-trace-option
Nov 14, 2026
Merged

phantoslayer21 merged 2 commits into
mainfrom
runtime/launch-trace-option

Conversation

@phantoslayer21

Copy link
Copy Markdown
Owner

Refs #89

WG_LAUNCH_TRACE=<file> (one line per kernel launch, clean/runtime/device.cpp trace_launch) is read from the
environment, which a game started by Steam or its own launcher does not inherit from us. Two runtime options set it
inside the game process:

  • launch_trace=<file>: sets WG_LAUNCH_TRACE (interop option parser, Windows);
  • launch_trace_max=<lines>: sets the new WG_LAUNCH_TRACE_MAX, which stops the trace after that many lines (a
    game at 60 fps writes about 20 lines per frame).

Nothing changes without them.

Tested: used in the first Model L game runs (Cyberpunk 2077, Resident Evil Requiem) through
runtime_options=...;launch_trace=<file>;launch_trace_max=200000: the trace listed every Model L kernel once per
frame and stopped at 200,000 lines. No unit test (the trace is a diagnostics file the runtime writes; the option
parsing is three lines).

WG_LAUNCH_TRACE=<file> (one line per kernel launch) is read from the environment, which a game started by its store
launcher does not inherit from us. The interop's runtime options launch_trace=<file> and launch_trace_max=<lines> set
WG_LAUNCH_TRACE and the new WG_LAUNCH_TRACE_MAX (stop after that many lines) inside the game process. Nothing changes
without them.

Refs #89

Signed-off-by: phantoslayer21 <156617979+phantoslayer21@users.noreply.github.com>
@phantoslayer21
phantoslayer21 marked this pull request as ready for review November 14, 2026 08:13
Signed-off-by: phantoslayer21 <156617979+phantoslayer21@users.noreply.github.com>
@phantoslayer21
phantoslayer21 merged commit 42c1dcc into main Nov 14, 2026
9 checks passed
@phantoslayer21
phantoslayer21 deleted the runtime/launch-trace-option branch November 14, 2026 15:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant