Skip to content

The user guide says apply refuses on any slot but the committed one, and how to put that right - #256

Merged
DevomB merged 1 commit into
mainfrom
guide-apply-committed
Oct 9, 2026
Merged

DevomB merged 1 commit into
mainfrom
guide-apply-committed

Conversation

@DevomB

@DevomB DevomB commented Oct 9, 2026

Copy link
Copy Markdown
Owner

What was wrong. Since #238, kryptik-update apply (and kryptik update apply, which runs it) refuses on any slot but the one the ESP names as committed. A slot picked in the firmware's boot menu is reported uncommitted by boot-success, and an apply from it would have written over the one release known to boot. The user guide's list of refusals still named only an armed trial, a degraded state and a failed trial. So a reader who booted the other slot would meet a refusal the guide never mentions.

What changed. docs/user-guide.md's update section names that refusal and what its message offers: boot the committed slot, or make the running one committed from the medium (kryptik-recover --commit-slot). The recovery paragraph above it, where one line ran to 120 characters, is rewrapped with no word changed.

How the run proves it. This is docs only, and no script reads this section. The refusal's wording is from_committed in tools/update/kryptik-update, and tools/tests/update-esp.sh covers it.

…and how the refusal's message puts that right

#238 made kryptik-update apply run from the committed slot only; the guide's
list of refusals named an armed trial, a degraded state and a failed trial.
The recovery paragraph's overlong line is rewrapped.
@DevomB
DevomB merged commit c1fe094 into main Oct 9, 2026
11 checks passed
@DevomB
DevomB deleted the guide-apply-committed branch October 9, 2026 02:52
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