Building and Running

Building and Running LimonOS

LimonOS is a 64-bit x86_64 operating system. To compile and run it, you will need a Linux-based environment.

Prerequisites

To build the OS, you will need:

• A Linux environment (or WSL on Windows).
• x86_64-elf-gcc cross-compiler (or a standard GCC toolchain with multilib support).
• nasm assembler.
• make and xorriso (for creating the ISO image).
• QEMU for testing the OS in a virtual machine.

(Note: The repository includes setup scripts to help install these dependencies).

How to Build (Windows)

If you are on Windows, the easiest way to build LimonOS is using WSL (Windows Subsystem for Linux).

1. Make sure WSL is installed and set up on your machine.
2. Clone the repository: git clone https://github.com/AnonimusShamshiAlex/LimonOS.git
3. Run the provided batch file (build.bat).
4. The batch file will automatically invoke the WSL Linux environment, compile the C and Assembly source code, and use the Limine bootloader to generate a bootable ISO file.

How to Build (Linux)

If you are already on a Linux system:

1. Clone the repository.
2. Run the build script: make (or execute the build script provided in the root directory).
3. This will compile the kernel and generate an ISO image using Limine.

Running in a Virtual Machine

Once the build is complete, you will have a bootable ISO image.

1. Open your virtualization software (e.g., QEMU, VirtualBox, or VMware).
2. Create a new virtual machine (x86_64 architecture).
3. Mount the generated ISO file as a CD-ROM.
4. Boot the VM. You should see the LimonOS interface load.

For QEMU, you can typically run it directly from the terminal: qemu-system-x86_64 -cdrom limonos.iso -m 512M -serial stdio