2019-02-08 10:04:23 +00:00
# Serenity
2019-02-12 14:47:37 +00:00
x86 Unix-like operating system for IBM PC-compatibles.
2019-02-08 10:04:23 +00:00
## About
2019-03-08 00:10:33 +00:00
I always wondered what it would be like to write my own operating system, but I never took it seriously. Until now.
2019-03-20 14:52:37 +00:00
I've grown tired of cutesy and condescending software that doesn't take itself or the user seriously. This is my effort to bring back the feeling of computing I once knew.
Roughly speaking, the goal here is a marriage between the aesthetic of late-1990s productivity software and the power-user accessibility of late-2000s \*nix. This is a system by me, for me, based on the things I like.
2019-02-08 10:04:23 +00:00
2019-02-12 14:47:37 +00:00
## Screenshot
2019-03-20 14:52:37 +00:00
2019-02-12 14:47:37 +00:00
2019-02-08 10:04:23 +00:00
## Current features
* Pre-emptive multitasking
2019-03-08 00:10:33 +00:00
* Compositing window server
2019-03-20 14:52:37 +00:00
* IPv4 networking with ARP, TCP, UDP and ICMP
2019-02-27 12:17:43 +00:00
* ext2 filesystem
2019-02-08 10:04:23 +00:00
* Unix-like libc and userland
2019-02-27 12:17:43 +00:00
* mmap()
* /proc filesystem
* Local sockets
2019-02-08 10:04:23 +00:00
* Pseudoterminals
* Event-driven GUI library
2019-03-20 14:52:37 +00:00
* Text editor
* IRC client
* DNS lookup
2019-02-08 10:04:23 +00:00
* Other stuff I can't think of right now...
2019-03-20 14:52:37 +00:00
## How do I build and run this?
2019-02-17 08:45:39 +00:00
2019-02-27 12:17:43 +00:00
You need a freestanding cross-compiler for the i686-elf target (for the kernel) and another
2019-03-08 00:10:33 +00:00
cross-compiler for the i686-pc-serenity target (for all the userspace stuff.) It's probably possible to coerce it into building with vanilla gcc/clang if you pass all the right compiler flags, but I haven't been doing that for a while.
2019-02-27 12:17:43 +00:00
2019-03-20 14:52:37 +00:00
There's [a helpful guide on building a GCC cross-compiler ](https://wiki.osdev.org/GCC_Cross-Compiler ) on the OSDev wiki.
2019-02-27 12:17:43 +00:00
I've only tested this on an Ubuntu 18.10 host with GCC 8.2.0, so I'm not sure it works anywhere else.
2019-02-22 09:45:32 +00:00
If you'd like to run it, here's how you'd get it to boot:
2019-02-17 08:45:39 +00:00
cd Kernel
./makeall.sh
2019-03-20 14:52:37 +00:00
./run # Runs in QEMU
./run b # Runs in bochs (limited networking support)
2019-02-17 08:45:39 +00:00
2019-02-08 10:04:23 +00:00
## Author
* **Andreas Kling** - [awesomekling ](https://github.com/awesomekling )
## License
Undecided. Probably something close to 2-clause BSD.
