quinn-os/README.md
2016-02-05 16:59:52 +10:00

54 lines
1.7 KiB
Markdown

![quinn_header.png](https://bitbucket.org/repo/8qeGEo/images/49156466-quinn_header.png)
This is the repository for the hobby operating system **Quinn** for more information please visit my website: http://quinn-os.com/
### 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 libcloog-isl-dev libmpc-dev texinfo nasm git wget make g++
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://bitbucket.org/apamment/quinn-os/raw/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.