Skip to content

Latest commit

 

History

History
53 lines (33 loc) · 1.71 KB

README.md

File metadata and controls

53 lines (33 loc) · 1.71 KB
Raw

ByteOS

A simple hobby operating system for the x86_64 architecture, written in C.

Screenshot

The design is heavily influenced by the Linux kernel, and as such you may find many similarities between the two.

This repository is licensed under the GPLv3. See LICENSE.md for more details.

Historical Note

I wrote most of the code here when I was 16-17 and didn't know better. There are some parts (mainly the bits involving atomics) that I'm not particularly proud of, so copy at your own peril. If you find a problem, feel free to open an issue or send a PR.

Building

You will need:

  • GNU binutils for x86_64-elf
  • gcc for x86_64-elf with -mno-red-zone and C11 capabilities (instructions)
  • Make
  • NASM
  • GRUB 2.02 (Multiboot2 compatible - may need to build from source)

Then, to build byteos.iso, simply run:

make

Running

You will need (in addition to the above dependencies):

  • QEMU x86_64

Then, to run in QEMU:

make run

Debugging

Debugging requires a specially patched version of GDB for interoperability with QEMU. Once you have this installed, simply run the debug make target.

Testing

First run the update-modules make target to download the necessary files. Then, simply run make test.

See Makefile for more details.

Contributing

Feel free to open an issue if you have any questions/concerns or a pull-request if you would like to contribute some code.

Special thanks to no92 for massively cleaning up the build system.