Skip to content

F0091 stk-1

Rule: Flip-link is the linker.

Code F0091 (stable, never reused)
Id stk-1
Category stk
Source spirit_level
Fix by hand

Level per tier

Tier Level Reason
small off
small-workspace off
medium off
big off
ai off
embedded deny bedrock error: flip-link not the linker: linker = "flip-link" under [target.<triple>] in .cargo/config.toml
ui off
egui off
units-strict off
units-paranoid off

Why

.cargo/config.toml's [target.<triple>] missing linker = "flip-link", so the firmware links with the plain linker instead.

flip-link moves the stack below .data/.bss so a stack overflow runs into an unmapped guard instead of silently corrupting the first bytes of RAM. Without it, an overflow corrupts whatever static data happens to sit above the stack and the symptom is wherever that data is read next — rarely at the overflow site.

Example

Found independently in embedded_bedrock (ROB-12), typec_dongle (FW-1) and usb_io_fw (PLAT-1): three projects hit the same missing-linker mistake before it became a generator default and a lint.

How to fix

Add linker = "flip-link" under [target.<triple>]; the generator sets this by default for every firmware it produces.

How it is checked

cfg easy: read .cargo/config.toml for the target triple in use and check linker is set to "flip-link".

Source

Ported from embedded_bedrock's firmware check catalogue, STK-1 (book/checks.md, detail in book/checks/stk.md). Found on: embedded_bedrock ROB-12; typec_dongle FW-1; usb_io_fw PLAT-1.

Configure

[lints.stk-1]
level = "deny"
reason = "why this project wants it at this level"

Allow one finding in the code with // spirit-level: allow(stk-1) <reason> (waivers); the code works there too, as in [lints.F0091].