docs: update QEMU mode docs for =PATH syntax and uncompressed initramfs
This commit is contained in:
@@ -38,7 +38,7 @@ ecr [OPTIONS] <DISTRO[:VERSION]> [-- COMMAND...]
|
||||
| `--no-cache` | Force a fresh download, bypassing the cache |
|
||||
| `-v, --verbose` | Print diagnostic output (URLs, layer info, extraction steps) |
|
||||
| `-a, --arch <ARCH>` | Target architecture (`amd64`, `arm64`, `armhf`, `riscv64`, …) |
|
||||
| `--kernel [PATH]` | Boot with QEMU system emulation. Downloads Alpine's `linux-virt` kernel if no path provided |
|
||||
| `--kernel[=PATH]` | Boot with QEMU system emulation. Downloads Alpine's `linux-virt` kernel if no `=PATH` given |
|
||||
| `-m, --memory <SIZE>` | Memory for QEMU VM (default: 2G, only with `--kernel`) |
|
||||
|
||||
## Examples
|
||||
@@ -62,8 +62,8 @@ ecr --no-cache fedora
|
||||
# Boot with QEMU system emulation (auto-downloads default kernel)
|
||||
ecr --kernel alpine
|
||||
|
||||
# Boot with your own kernel
|
||||
ecr --kernel /boot/vmlinuz ubuntu
|
||||
# Boot with your own kernel (note the `=` — a space would parse the path as the distro)
|
||||
ecr --kernel=/boot/vmlinuz ubuntu
|
||||
|
||||
# Boot with custom memory
|
||||
ecr --kernel --memory 4G alpine
|
||||
@@ -78,16 +78,18 @@ When `--kernel` is specified, ecr boots the rootfs in a full QEMU virtual machin
|
||||
ecr --kernel alpine
|
||||
|
||||
# Use your own kernel
|
||||
ecr --kernel /boot/vmlinuz ubuntu
|
||||
ecr --kernel=/boot/vmlinuz ubuntu
|
||||
```
|
||||
|
||||
This mode:
|
||||
- Creates a gzipped CPIO initramfs from the rootfs
|
||||
- Creates an uncompressed CPIO initramfs from the rootfs (streamed to disk)
|
||||
- Boots QEMU with your kernel (or auto-downloads Alpine's `linux-virt` kernel)
|
||||
- Provides full VM isolation
|
||||
- Works for any architecture (no binfmt_misc needed)
|
||||
- Caches the default kernel in `~/.cache/ecr/`
|
||||
|
||||
Host bind mounts (`--bind`, `--bind-rw`) are not applied in this mode.
|
||||
|
||||
Requirements:
|
||||
- `qemu-system-<arch>` installed
|
||||
- For custom kernels: kernel must have serial console support
|
||||
|
||||
Reference in New Issue
Block a user