+> Please note: this is the kernel, not a bootable image, it require a bootloader
+> to boot and specify the rootfs.
+
+## Get Started
+
+If you are impatient, or just want something to run and don't want to went
+through tedious process of configuring rootfs and tweak kernel parameters. You
+can use the `live_debug.sh` provided in the lunaix root directory to quickly
+bring up the system with default parameters (also used by the author for
+debugging).
+
+### Quick Start
+
+This will get you up and running real quick. We will use `x86_64` as example.
+
+Assuming a Linux or other Unix-like shell environment. We also expect you to be able to sort out trivial issues like missing packages.
+
+**Select your target**
+```sh
+$ export ARCH=x86_64
+```
+
+**Check Python**
+```sh
+$ python --version
+```
+
+Ensure at least `3.11`
+
+**Check compiler**
+```sh
+$ gcc -dumpmachine
+```
+
+Ensure `x86_64-linux-gnu` or anything resemble `x86_64`
+
+**Check QEMU**
+```sh
+$ which qemu-system-x86_64
+```
+
+Should display a valid installation path
+
+**Optional: Setting up Cross-Compiler**
+
+```sh
+$ export CX_PREFIX=x86_64-linux-gnu-
+```
+
+**Run Configuration**
+```sh
+make config
+```
+
+Then hitting `q` in the interactive shell to accept default setting.
+
+**Build stock rootfs**
+
+```sh
+make rootfs
+```
+
+Note, this requires root for creating fs image. You can check script `lunaix-os/scripts/mkrootfs` if you feel uncertain.
+
+**Build & Run**
+```sh
+./live_debug.sh
+```
+
+you should see gdb now take control of your shell
+
+**Connect to serial via telnet**
+
+Open up another window or session
+```sh
+telnet localhost 12345
+```
+
+**Commence simulation**
+
+Back to the gdb session and type `c` to countine
+
+
+**Watch Lunaix booting!**
+
+Congrats, enjoy your lunaix! (or submit an issue)
+
+
+### Not so Quick Start
+
+Here is a slower and yet more verbose steps:
+
+1. Select an architecture `<arch>`
+2. Check the compilation prerequisites and presence of `qemu-system-<arch>`
+3. Optionally export `CX_PREFIX` if you are building for another architecture.
+4. Run `make ARCH=<arch> rootfs` to build stock rootfs image, require support
+ of `dd`，`mkfs.ext2`, `mount -o loop`, `mktemp`.
+5. Run `ARCH=<arch> live_debug.sh` to boot in QEMU with gdb hooked (one should
+ see a gdb session)
+6. telnet to `localhost:12345`, this is QEMU emulated serial port
+7. type `c` in the active gdb session and commence emulation.
+8. Congrats, enjoy your lunaix!
+(or submit an issue)
+
git://scm.lunaixsky.com / lunaix-os.git / blobdiff