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

56 lines
1.7 KiB
Markdown

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.