2021-01-31 20:51:31 +00:00
|
|
|
FENIX - Fenris' UNIX(-like)
|
|
|
|
|
===========================
|
|
|
|
|
|
|
|
|
|
FENIX is Kat's pet project to create a fully POSIX-compliant UNIX from scratch.
|
|
|
|
|
It's a big endeavor, but she's nothing if not bold.
|
|
|
|
|
|
|
|
|
|
This repository houses some of the project-wide stuff. It should also have the
|
|
|
|
|
other bits inside of it, but Kat hasn't figured out how to properly manage
|
|
|
|
|
subrepositories yet. Included in this repo are the various notes Kat's taken
|
|
|
|
|
on how she'd like to make this operating system and the various bits of the
|
|
|
|
|
build script used to compile a working OS image, including stuff for creating
|
|
|
|
|
a working cross compiler.
|
|
|
|
|
|
|
|
|
|
Credit where credit is due, the build system is taken from the Meaty Skeleton
|
|
|
|
|
tutorial over on the OSDev Wiki (https://wiki.osdev.org/Meaty_Skeleton). The
|
|
|
|
|
cross-compiler test code, similarly, is based off of the Bare Bones tutorial
|
|
|
|
|
over there. Everything else is project-original. The cross-compiler build
|
|
|
|
|
script was written by Kat and, well, the notes are all Kat's ramblings.
|
|
|
|
|
|
|
|
|
|
Building
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
If you'd like to build FENIX, first, make sure to download the kernel and libc
|
|
|
|
|
repositories into folders named "kernel" and "libc". Additionally, make sure
|
2021-06-13 22:40:52 +00:00
|
|
|
you've successfully built the cross-compiler and added ~/opt/cross (or wherever
|
|
|
|
|
you've install the cross-compiler to) to your PATH. From there, you should just
|
|
|
|
|
need to run `build.sh`. If you'd like an ISO, run `iso.sh` and if you'd like to
|
|
|
|
|
test it using `qemu-system-i386`, simply run `qemu.sh`.
|
2021-01-31 20:51:31 +00:00
|
|
|
|
|
|
|
|
Portability
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
The build scripts should run on any system that supports the syntax used and on
|
|
|
|
|
which you can build the cross-compiler. (They've not been vetted for running on
|
|
|
|
|
pure sh, so if you'd like to check on that, that'd be appreciated.) The
|
|
|
|
|
cross-compiler should build on any system on which the dependencies are
|
|
|
|
|
supported. FENIX itself is currently limited to x86, and has only been tested
|
|
|
|
|
in QEMU, so it may or may not work on whatever real hardware you wanna run it
|
|
|
|
|
on. The notes can be viewed by anything that can view a text file.
|
|
|
|
|
|
|
|
|
|
Copyright
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
Licensed under CC-BY 4.0 by Katlynn Richey
|
|
|
|
|
|
|
|
|
|
FENIX is free software. Feel free to modify and/or distribute it!
|
|
|
|
|
See the file COPYING for more details.
|
