*nix Users

Building the kernel binary

Use the makefile in the root folder:

$ make

or

$ make subdirs ; make kernel ; make clean

This compiles the source files and links them together in a single binary file called kernel.bin, then it deletes unneeded files.

Creating the kernel image

Download the GRUB floppy image from the Downloads section. Run the script mkimage.sh and make sure you have the kernel binary and the GRUB image in the same directory. You might want to change the mount path in the script if you want to mount the floppy image somewhere else. The script will actually merge the kernel image and the GRUB image into one image which you will boot (see it's name in the script).

If you have any problems:

1. Be sure that /mnt/floppy extists and it's a directory: try

sudo rm -rf /mtn/floppy; sudo mkdir /mnt/floppy;

in your console

2. if you get any error like " mount: could not find any device /dev/loop# ", try

sudo modprobe loop

in your console.

Booting

Open the image in your favorite VM.

example for qemu (we are testing our OS with QEMU and BOCHS - we prefer QEMU):

$ qemu --soundhw all -fda boot.img

--- if you want to use Bochs, see the bochs configuration file in the archives

---

Users that already have qemu

, ld, nasm and gcc may run the script build.sh to build the project at once (not recommended for debugging) or build and run the project by excecuting the script buildandrun.sh

$ sh ./build.sh $ sh ./buildandrun.sh

Microsoft Windows Users

Building the kernel binary

Download DJGPP and use it. We don't use this tool so we can't tell you more about this (or we may write sth here later)... In the website of DJGPP you can find more information about compiling/building etc.

Creating the kernel image

kj4658:This is very dificult, as there seems to be no port for the vital "cc" binary needed to build the kernel. There is another obstacle(the image's FAT must be manually edited under Win), but, though a solution is ready, this is useless without the ability to build the kernel. Please be patient!

Booting

Open the image in your favorite VM.

QEMU for Windows System binary is infected with a virus, as I read in their site. So you can use Bochs or VMWare