ABI and Calling Conventions: Debug Playbook

Debug playbook

Debug Playbook for ABI and Calling Conventions centers on call/return overhead cycles, register spill rate, and stack bandwidth pressure. Tie every claim to a measurable artifact and an owner-controlled action.

1. Freeze workload seed, binary, compiler, firmware, and thermal setup.

2. Find first persistent stage loss in timeline.

3. Build one reduced reproducer for dominant hypothesis.

4. Patch minimal fix with explicit rollback gate.

5. Re-run full correctness + performance + power matrix.

Debug decision tree

ROOT-CAUSE TREE - ABI and Calling Conventions

call/return overhead cycles, register spill rate, and stack bandwidth pressure regressed
        |
  reproducible on fixed seed?
      /               \
    no                 yes
    |                   |
env/tool drift      first failing stage?
                    /        |        \
                front-end   execute   memory/system
                   |          |            |
              fetch/decode   port/ROB   cache/TLB/NoC

Stop at first confirmed mechanism, then patch with owner accountability.

Review memo template

CPU DESIGN REVIEW MEMO - ISA & Programmer Model / ABI and Calling Conventions

1. Symptom
   - Watched metric: call/return overhead cycles, register spill rate, and stack bandwidth pressure
   - Failing workload slice: <name>
   - First failing stage: <fetch/decode/rename/execute/memory/system>
   - Revision tags: <binary/compiler/firmware/uarch stepping>

2. Mechanism hypothesis
   - Primary mechanism: ABI register classes, stack alignment, and parameter passing rules determine function-call overhead, spill behavior, and interop safety across compiler, runtime, and libraries.
   - Competing hypotheses: <front-end, scheduler, memory, coherence, physical limits>
   - Missing evidence: <counter snapshot, trace, topology/thermal map>

3. Proposed action
   - Minimal reversible fix: <uarch policy/compiler/runtime/config>
   - Expected movement: <IPC/CPI/latency tail/perf-per-watt>
   - Regression risk: correctness, power, thermal, software compatibility

4. Signoff
   - Re-run artifact: calling-convention compliance report, prologue/epilogue profile, and spill heatmap
   - Required owners: compiler backend owner, runtime ABI owner, performance engineer
   - Final decision: ship, bounded rollout, rollback, or escalate

CPU deep dive

ISA choices are software contracts that directly become decode, verification, and security cost in silicon.

Concept diagram

ISA CONTRACT STACK

instruction semantics -> encoding -> decode/uOP expansion -> architectural state

Metric graph

ISA HEALTH TREND

illegal encoding escapes     █
decode expansion pressure    ████
ABI mismatch incidents       ██

Reports and artifacts

• instruction legality audit

• decode critical-path report

• ABI conformance summary

• trap/CSR latency sheet

Mini case study

A late ISA extension looked harmless but increased decode expansion ratio and pushed front-end timing beyond closure margin.

Debug branches

• Map each ISA feature to decode and retire implications

• Separate architectural correctness from microarchitectural cost

• Validate privileged behavior with precise-state traces

Senior review question

Ask: which CPI/latency evidence proves this topic is truly closed beyond synthetic benchmarks?

Key takeaways

• Always connect microarchitectural counter changes to product workload outcomes.

• Lock binary, compiler, firmware, and thermal metadata before comparing CPU traces.

Common pitfalls

• Treating average IPC as sufficient proof while ignoring latency tails and outliers.

• Applying predictor or prefetch tweaks without first-failing-stage attribution.

• Declaring closure without reproducible perf, correctness, and power gates.

Principal CPU review addendum

ABI and Calling Conventions should be treated as a system behavior, not an isolated block definition. In a shipping CPU core, ISA intent, front-end delivery, speculation depth, scheduler behavior, memory translation, coherence traffic, and physical limits all interact before software observes final IPC or CPI.

ABI register classes, stack alignment, and parameter passing rules determine function-call overhead, spill behavior, and interop safety across compiler, runtime, and libraries. CPU teams pay for repeated inefficiency: one extra bubble, one wrong target, one port conflict, or one translation miss pattern can replicate across billions of instructions and dominate product-level latency and energy.

Use call/return overhead cycles, register spill rate, and stack bandwidth pressure as an investigation start point, not as the conclusion. A counter movement only becomes actionable when paired with workload phase tags, PMU event context, a controlled repro, and artifact evidence such as calling-convention compliance report, prologue/epilogue profile, and spill heatmap.

The ISA is a long-lived software contract whose edge cases become silicon cost and verification risk. Senior review quality comes from proving the full chain: workload request -> microarchitectural response -> measured bottleneck -> smallest owner fix -> regression-safe validation.

Review discipline should force a causal chain: workload shape -> front-end/speculation behavior -> execution/memory pressure -> retire efficiency -> product impact. That chain keeps CPU decisions evidence-driven and owner-accountable.