jan/rrt
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
rrt/docs/shell-load-graph.md

6.7 KiB
Raw Blame History

Shell Load Graph

Generated shell-load startup graph artifacts live under artifacts/exports/rt3-1.06/:

  • shell-load-subgraph.dot
  • shell-load-subgraph.md
  • setup-window-subgraph.dot
  • setup-window-subgraph.md
  • setup-window-submodes-depth5-subgraph.dot
  • setup-window-submodes-depth5-subgraph.md
  • setup-window-submodes-depth5-forward-subgraph.dot
  • setup-window-submodes-depth5-forward-subgraph.md
  • runtime-effect-service-depth7-subgraph.dot
  • runtime-effect-service-depth7-subgraph.md
  • runtime-effect-service-depth7-forward-subgraph.dot
  • runtime-effect-service-depth7-forward-subgraph.md

The current graph is intentionally bounded rather than whole-program:

  • seed nodes:
    • 0x00438890 shell_active_mode_run_profile_startup_and_load_dispatch
    • 0x00482ec0 shell_transition_mode
  • traversal:
    • note-address references in function-map.csv
    • depth 2
    • backreferences enabled

This keeps the artifact useful for naming and branch comparison instead of exploding into generic utility helpers.

The paired Setup.win graph is a narrower owner-family export:

  • seeds:
    • 0x00504010 shell_setup_window_construct
    • 0x005033d0 shell_setup_window_handle_message
    • 0x00502c00 shell_setup_window_select_launch_mode_and_apply_shell_state
    • 0x00502910 shell_setup_window_refresh_mode_dependent_lists
    • 0x00502550 shell_setup_window_refresh_selection_lists_and_summary_fields
    • 0x00502220 shell_setup_window_publish_selected_profile_labels_and_preview_surface

Regenerate it with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/shell-load-subgraph \
  --seed 0x00438890 \
  --seed 0x00482ec0 \
  --depth 2 \
  --include-backrefs \
  --title "Shell Load Startup Subgraph"

And for the narrower Setup.win graph:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/setup-window-subgraph \
  --seed 0x00504010 \
  --seed 0x005033d0 \
  --seed 0x00502c00 \
  --seed 0x00502910 \
  --seed 0x00502550 \
  --seed 0x00502220 \
  --depth 2 \
  --include-backrefs \
  --title "Setup Window Dispatch Subgraph"

The current exporter is intentionally note-driven:

  • nodes come from function-map.csv
  • edges come from address references embedded in notes
  • so it is best used as a bounded reasoning aid over already-curated rows, not as a substitute for raw disassembly or xref recovery

There is now also a deeper Setup.win submode export:

  • the backref-enabled depth-5 variant is exploratory and broad
    • seeds: the same constructor, dispatcher, selector, and refresh owners
    • depth: 5
    • backrefs: enabled
    • current size: 369 nodes / 753 edges
  • the forward-only depth-5 variant is the recommended artifact for submode work
    • seeds: the same constructor, dispatcher, selector, and refresh owners
    • depth: 5
    • backrefs: disabled
    • current size: 126 nodes / 246 edges

Generate the exploratory backref-enabled graph with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/setup-window-submodes-depth5-subgraph \
  --seed 0x00504010 \
  --seed 0x005033d0 \
  --seed 0x00502c00 \
  --seed 0x00502910 \
  --seed 0x005027b0 \
  --seed 0x00502550 \
  --seed 0x00502220 \
  --depth 5 \
  --include-backrefs \
  --title "Setup Window Submode Subgraph (Depth 5)"

Generate the narrower forward-only graph with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/setup-window-submodes-depth5-forward-subgraph \
  --seed 0x00504010 \
  --seed 0x005033d0 \
  --seed 0x00502c00 \
  --seed 0x00502910 \
  --seed 0x005027b0 \
  --seed 0x00502550 \
  --seed 0x00502220 \
  --depth 5 \
  --title "Setup Window Submode Subgraph (Depth 5, Forward Only)"

There is now also a deeper runtime-effect export around the scenario event collection service loop:

  • the backref-enabled depth-7 variant is exploratory and broad
    • seeds:
      • 0x004323a0 scenario_runtime_effect_record_service_and_dispatch_linked_compact_effects
      • 0x00431b20 world_apply_compact_runtime_effect_record_to_resolved_targets
      • 0x00430b50 scenario_runtime_effect_record_build_followon_effect_from_compact_record_and_targets
      • 0x00432ea0 scenario_event_collection_allocate_runtime_effect_record_from_compact_payload
    • depth: 7
    • backrefs: enabled
    • current size: 525 nodes / 1235 edges
  • the forward-only depth-7 variant is the recommended artifact for this branch
    • same seeds
    • depth: 7
    • backrefs: disabled
    • current size: 293 nodes / 752 edges

Generate the exploratory backref-enabled graph with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/runtime-effect-service-depth7-subgraph \
  --seed 0x004323a0 \
  --seed 0x00431b20 \
  --seed 0x00430b50 \
  --seed 0x00432ea0 \
  --depth 7 \
  --include-backrefs \
  --title "Scenario Runtime Effect Service Subgraph (Depth 7)"

Generate the narrower forward-only graph with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/runtime-effect-service-depth7-forward-subgraph \
  --seed 0x004323a0 \
  --seed 0x00431b20 \
  --seed 0x00430b50 \
  --seed 0x00432ea0 \
  --depth 7 \
  --title "Scenario Runtime Effect Service Subgraph (Depth 7, Forward Only)"

There is now also a narrower startup-kind-8 export for the ordinary bring-up lane:

  • artifact:
    • artifacts/exports/rt3-1.06/runtime-effect-kind8-startup-subgraph.{dot,md}
  • seeds:
    • 0x00444d92
    • 0x00432f40
    • 0x004323a0
    • 0x00431b20
    • 0x00433130
  • depth:
    • 5
  • current size:
    • 702 nodes / 2076 edges

Generate it with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/runtime-effect-kind8-startup-subgraph \
  --seed 0x00444d92 \
  --seed 0x00432f40 \
  --seed 0x004323a0 \
  --seed 0x00431b20 \
  --seed 0x00433130 \
  --depth 5 \
  --title "Startup Kind-8 Runtime Effect Subgraph"

There is now also a smaller bringup-refresh export centered on the owner above that lane:

  • artifact:
    • artifacts/exports/rt3-1.06/world-entry-bringup-refresh-subgraph.{dot,md}
  • seeds:
    • 0x00443a50
  • depth:
    • 3
  • current size:
    • 343 nodes / 989 edges

Generate it with:

python3 tools/py/export_function_subgraph.py \
  artifacts/exports/rt3-1.06/function-map.csv \
  artifacts/exports/rt3-1.06/world-entry-bringup-refresh-subgraph \
  --seed 0x00443a50 \
  --depth 3 \
  --title "World Entry Bringup Refresh Subgraph"