docs: add troubleshooting guide, WSL2 build path, and checkpoint reuse#48
Closed
dinxsh wants to merge 2 commits into
Closed
docs: add troubleshooting guide, WSL2 build path, and checkpoint reuse#48dinxsh wants to merge 2 commits into
dinxsh wants to merge 2 commits into
Conversation
…e section Documents 7 confirmed build failures with exact fixes, adds a complete WSL2/Windows build procedure covering binfmt_misc setup, loop device creation, kpartx daemon, and all required patches. Adds a checkpoint reuse note explaining debian-rootfs.img.zst can be reused across build-images.sh runs. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- IMGSIZE sed: use s/IMGSIZE:=4GiB/IMGSIZE:=8GiB/g (simpler, matches actual line format) - fakemachine sed: apply to both build-rootfs-img.sh and build-images.sh - All commands verified against actual script source Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Author
|
Closing this in favour of contributing the content to the new README that @zhovner has drafted in #27. The troubleshooting entries, WSL2 build path, and checkpoint reuse section documented here are all still valid - I will port them to the new README branch once that PR is ready to receive contributions. Apologies for the noise on the old file. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
debian-rootfs.img.zstcan be reused acrossbuild-images.shrunsWhy
Every error listed is a build stopper with a cryptic message and no documented fix. The WSL2 path works end-to-end with the patches documented here - confirmed on a full build run producing
debian-512-flipper-one-*.img.gz.No build scripts are modified. This PR is purely additive to the README.
Errors documented
execv(sh) failed: Exec format errorupdate-binfmts --enablebefore buildlstat .../linux_tmp: no such file or directoryIMG_OUT=out(relative path)fallocate: Operation not supportedIMG_OUT/TMPDIRon Linux ext4, not NTFSfakemachine: command not foundif [ -c /dev/kvm... ]toif falsebmaptool: image size will not fit block deviceIMGSIZE=8GiBin both scriptscp: Input/output erroron 8 GiB imagecpwithmvinbuild-images.shNo space left on deviceduring kernel installIMGSIZE=8GiBinbuild-rootfs-img.sh🤖 Generated with Claude Code