https://github.com/64/byteos
A simple hobby operating system for the x86-64 architecture
https://github.com/64/byteos
kernel operating-system os x86-64
Last synced: 7 months ago
JSON representation
A simple hobby operating system for the x86-64 architecture
- Host: GitHub
- URL: https://github.com/64/byteos
- Owner: 64
- License: gpl-3.0
- Created: 2016-10-02T14:44:09.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-02-23T09:54:41.000Z (almost 5 years ago)
- Last Synced: 2025-05-06T03:38:17.609Z (8 months ago)
- Topics: kernel, operating-system, os, x86-64
- Language: C
- Homepage:
- Size: 497 KB
- Stars: 70
- Watchers: 6
- Forks: 17
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ByteOS
A simple hobby operating system for the x86_64 architecture, written in C.
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](http://wiki.osdev.org/Libgcc_without_red_zone))
* Make
* NASM
* GRUB 2.02 (Multiboot2 compatible - may need to build from source)
Then, to build `byteos.iso`, simply run:
```sh
make
```
## Running
You will need (in addition to the above dependencies):
* QEMU `x86_64`
Then, to run in QEMU:
```sh
make run
```
## Debugging
Debugging requires a [specially patched version of GDB](http://wiki.osdev.org/QEMU_and_GDB_in_long_mode#Workaround_2%3A_Patching_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`](https://github.com/64/ByteOS/blob/master/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](https://github.com/no92) for massively cleaning up the build system.