Prepare for the move to Fedora
tools/posix/setup-fedora.sh installs the toolchain and reports what it cannot: PowerShell has no Fedora package, and bootcheck is the test suite, so the script says how to get pwsh rather than failing quietly. It also checks /dev/kvm, since a Ryzen box can run the tests at native speed. docs/moving-to-linux.md is the actual procedure: copy the repo, restore the memory, install, build. The memory travels inside the repo and `memory-sync.sh import` puts it under the key this machine derives from its own path -- /home/nexoniarz/Documents/SchOS becomes -home-nexoniarz-Documents-SchOS, where D:\DEV\SchOS was D--DEV-SchOS. OVMF discovery no longer assumes QEMU's Windows layout. Fedora ships edk2-ovmf to /usr/share/edk2/ovmf/, Debian and Arch differ again, so the Makefile searches a list and names the packages when it finds nothing. Tested through the shell rather than $(wildcard): on Windows make is a native binary using Win32 file calls, while `command -v` returns an MSYS path like /c/Users/..., which $(wildcard) cannot see -- it returned nothing on a machine that had the firmware. Two things only that machine can test: `make ports` builds musl, toybox and mksh from source, which Windows cannot do at all; and the SchFS round-trip needs symlinks and hard links, so it has never actually run.
This commit is contained in:
parent
d41a0b1618
commit
4ac7e19397
5 changed files with 249 additions and 4 deletions
|
|
@ -104,6 +104,16 @@ outstanding:
|
|||
`Join-Path $root 'build\x'` produces a *filename containing a backslash* on a
|
||||
Unix host.
|
||||
|
||||
## Fedora, in one command
|
||||
|
||||
```sh
|
||||
tools/posix/setup-fedora.sh --check # what is missing
|
||||
tools/posix/setup-fedora.sh # install it
|
||||
```
|
||||
|
||||
Moving an existing checkout to a Linux machine: see
|
||||
[moving-to-linux.md](moving-to-linux.md).
|
||||
|
||||
## Working on two machines
|
||||
|
||||
Claude Code's project memory is kept in the repo and moved with:
|
||||
|
|
|
|||
120
docs/moving-to-linux.md
Normal file
120
docs/moving-to-linux.md
Normal file
|
|
@ -0,0 +1,120 @@
|
|||
<!-- SPDX-License-Identifier: Apache-2.0 -->
|
||||
# Moving the project to a Linux machine
|
||||
|
||||
Written for the move to `/home/nexoniarz/Documents/SchOS` on Fedora 44. Nothing
|
||||
here is Fedora-specific except the package names.
|
||||
|
||||
## 1. Copy the repo
|
||||
|
||||
Copy the whole directory, `.git` included. Everything that matters is committed
|
||||
— 17 commits, no remote — and that includes the project memory, which lives in
|
||||
`.claude/memory/` precisely so it survives this.
|
||||
|
||||
```sh
|
||||
# whatever transport suits: a USB stick, rsync, scp
|
||||
rsync -a /path/to/SchOS/ /home/nexoniarz/Documents/SchOS/
|
||||
cd /home/nexoniarz/Documents/SchOS
|
||||
git log --oneline | head -3 # should show the same commits
|
||||
git status # should be clean
|
||||
```
|
||||
|
||||
`build/` and `sysroot/` are ignored and do not need copying — `make` rebuilds
|
||||
them. **One exception**: `sysroot/bin/` holds musl, toybox and mksh, which
|
||||
cannot be built on Windows and so were staged there once. On Linux they *can*
|
||||
be built, so let the build produce them (`make ports`) rather than carrying
|
||||
stale binaries across. The staged copies predate the SchOS rename anyway —
|
||||
`sysroot/bin/sh` still contains the symbol `__schunix_tp`.
|
||||
|
||||
## 2. Restore the memory
|
||||
|
||||
Claude Code keeps per-project memory under a key derived from the project's
|
||||
absolute path, so it differs per machine:
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| `D:\DEV\SchOS` | `D--DEV-SchOS` |
|
||||
| `/home/nexoniarz/Documents/SchOS` | `-home-nexoniarz-Documents-SchOS` |
|
||||
|
||||
One command puts it where this machine looks:
|
||||
|
||||
```sh
|
||||
tools/posix/memory-sync.sh status # shows both sides, changes nothing
|
||||
tools/posix/memory-sync.sh import # repo -> ~/.claude/projects/<key>/memory/
|
||||
```
|
||||
|
||||
That writes to
|
||||
`/home/nexoniarz/.claude/projects/-home-nexoniarz-Documents-SchOS/memory/`.
|
||||
|
||||
After a session that learned something, `export` and commit, so the knowledge
|
||||
travels back:
|
||||
|
||||
```sh
|
||||
tools/posix/memory-sync.sh export && git add -A && git commit -m "memory: ..."
|
||||
```
|
||||
|
||||
## 3. Install the toolchain
|
||||
|
||||
```sh
|
||||
tools/posix/setup-fedora.sh --check # report what is missing
|
||||
tools/posix/setup-fedora.sh # install it
|
||||
```
|
||||
|
||||
That covers clang, lld, llvm, make, gcc, perl, python3, qemu-system-x86,
|
||||
edk2-ovmf, xorriso and mtools. See [building.md](building.md) for what each is
|
||||
for and for the other supported hosts.
|
||||
|
||||
**PowerShell is the one thing dnf cannot supply.** `tools/windows/bootcheck.ps1`
|
||||
is the boot test suite, and `pwsh` runs it on Linux perfectly well — there is
|
||||
simply no Fedora package. The script prints the two ways to get it. Nothing
|
||||
else needs it: `make`, `make schfs-check` and `make qemu` all work without.
|
||||
|
||||
## 4. Build and check
|
||||
|
||||
```sh
|
||||
make # kernel + root filesystem -> schos.img
|
||||
make schfs-check # B-tree, object and image suites -- all host-native
|
||||
make qemu # boot it
|
||||
```
|
||||
|
||||
Two things will behave differently here, both improvements:
|
||||
|
||||
- **`make ports` works.** musl, toybox and mksh build from source. On Windows
|
||||
the build skips them and uses whatever is staged.
|
||||
- **The SchFS round-trip test runs.** It needs symlinks and hard links, which
|
||||
Git Bash cannot create, so on Windows it skips with a message. This is the
|
||||
first machine that can actually exercise that path — worth running early,
|
||||
since it is the one part of SchFS never yet tested.
|
||||
|
||||
## 5. KVM
|
||||
|
||||
A Ryzen 7000 has SVM, so QEMU can run at native speed instead of emulating:
|
||||
|
||||
```sh
|
||||
ls -l /dev/kvm # should exist
|
||||
sudo usermod -aG kvm $(id -un) # if it exists but is not readable
|
||||
```
|
||||
|
||||
Then add `-enable-kvm` to a QEMU command line. It is deliberately **not** the
|
||||
default in the Makefile: the test suite's timings were established under TCG,
|
||||
and changing the execution engine underneath them is a variable worth
|
||||
introducing on purpose rather than by accident.
|
||||
|
||||
## 6. UEFI
|
||||
|
||||
`make qemu-uefi` boots the UEFI path under OVMF. The Makefile searches the
|
||||
usual locations for the firmware and Fedora's `edk2-ovmf`
|
||||
(`/usr/share/edk2/ovmf/OVMF_CODE.fd`) is among them.
|
||||
|
||||
Note the open bug before spending time on it: under OVMF the kernel reports
|
||||
`e820: only 8 MB usable`, because `e820_init` takes the usable run *containing
|
||||
the kernel* and OVMF puts an ACPI NVS region at 0x800000, genuinely fragmenting
|
||||
it. The loader's map is correct; the kernel's one-contiguous-run assumption is
|
||||
BIOS-shaped. The fix is to free each usable region rather than one range, which
|
||||
touches `kalloc`.
|
||||
|
||||
## The hardware, for reference
|
||||
|
||||
Fedora 44, Ryzen 5 7000-series, RTX 4050, 16 GB DDR5. Nothing in the build cares
|
||||
about the GPU — QEMU runs headless for tests and uses its own emulated display
|
||||
otherwise. The Nvidia driver matters only if you want a QEMU window, and the
|
||||
`nouveau`/proprietary choice makes no difference to SchOS either way.
|
||||
Loading…
Reference in a new issue