quinn-os/README.md
2024-01-06 21:30:03 +10:00

1.7 KiB

This is the repository for the hobby operating system Quinn

WARNING

This code is experimental. Lots of things don't work, lots of it is really bad.

How do I get set up?

Make sure you have the prerequisits to build gcc, binutils and newlib, and NASM.

sudo apt-get install build-essential libgmp3-dev libmpfr-dev libisl-dev libmpc-dev texinfo nasm git wget make g++ libtool-bin pkg-config

Download the latest toolchain builder script. This will download the source, compiler, binutils and newlib into a directory called Quinn in your home directory.

https://scove.talismanbbs.com/git/QuinnOS/quinn-os/raw/branch/master/make_toolchain.sh

Once the toolchain has been downloaded, it will also set your path to include:

$HOME/Quinn/cross/bin

This is where your toolchain lives, if you close the terminal or open a new one you will have to issue the command:

export PATH=$HOME/Quinn/cross/bin:$PATH

To build the kernel, you will need issue the following commands:

cd $HOME/Quinn/src/quinn-os/
make

This will build a kernel called kernel.bin

To build the libraries for the userland (freetype etc)

./make_userlibs.sh

This script will report an error (freetype doesn't install properly, but it doesn't matter).

To build the userland issue the command

./make_userland.sh

This will build the userland and place the nessecary files into:

$HOME/Quinn/fsroot

You can then build a disk image (assuming you have SUDO setup and are running Linux)

./make_diskimage.sh

This will spit out a disk.img file under $HOME/Quinn/images You can convert that image to virtualbox with the command

VBoxManage convertdd disk.img disk.vdi

That should be enough information to get you up and running.