t3hn3rd
466173613f
continuous-integration/drone/push Build is failing
Replace placeholder content in doc/compat/, doc/lvglh/, and doc/toolchain/ with comprehensive documentation derived from the source files. - compat: document Wasuro WASM VM compatibility shims - lvglh: document LVGL v9.2.2 configuration, fonts, and patches - toolchain: document all 13 build pipeline scripts
38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
# compile_isogen.sh
|
|
|
|
Creates a bootable GRUB ISO image containing the Asuro kernel.
|
|
|
|
## Overview
|
|
|
|
`compile_isogen.sh` copies the compiled kernel binary into the ISO directory structure and invokes `grub-mkrescue` to produce a bootable CD-ROM image. The resulting `Asuro.iso` can be booted in any x86 emulator (QEMU, VirtualBox, etc.) or written to physical media.
|
|
|
|
## Prerequisites
|
|
|
|
- `grub-mkrescue` (from GRUB utilities) and `xorriso` (its backend) must be available.
|
|
- `bin/kernel.bin` must exist (produced by `compile_link.sh`).
|
|
- The `iso/boot/` directory must exist and contain a GRUB configuration file (`iso/boot/grub/grub.cfg`).
|
|
|
|
## Inputs
|
|
|
|
| Source | Description |
|
|
|--------|-------------|
|
|
| `bin/kernel.bin` | The linked kernel binary. |
|
|
| `iso/` | Pre-existing ISO directory tree with GRUB configuration. |
|
|
|
|
## Outputs
|
|
|
|
| File | Description |
|
|
|------|-------------|
|
|
| `Asuro.iso` | Bootable GRUB rescue ISO image. |
|
|
| `iso/boot/asuro.bin` | Copy of the kernel binary placed into the ISO tree. |
|
|
|
|
## Behavior
|
|
|
|
1. Copies `bin/kernel.bin` to `iso/boot/asuro.bin`.
|
|
2. Runs `grub-mkrescue -o Asuro.iso iso` to generate the bootable ISO from the `iso/` directory tree.
|
|
|
|
## Notes
|
|
|
|
- The GRUB configuration in `iso/boot/grub/grub.cfg` must reference `asuro.bin` as the kernel to load.
|
|
- The ISO is generated in the project root directory.
|