vinc
/
moros
mirror of https://github.com/vinc/moros.git
1
5
Fork 0
Code Issues Projects Releases Wiki Activity
MOROS: Obscure Rust Operating System 🦉
152 Commits 16 Branches 16 Tags 6.2 MiB
Rust 86.7%
HTML 7.9%
Python 1.6%
Shell 1.3%
Common Lisp 1.2%
Other 1.3%
Go to file
Vincent Ollivier 00fcfa7e08
Remove dependency on rlibc (#115) 		2020-11-12 23:07:02 +01:00
.cargo Remove dependency on rlibc (#115) 2020-11-12 23:07:02 +01:00
doc Add pcnet driver (#82) 2020-10-31 23:20:41 +01:00
dsk Improve console (#74) 2020-07-10 08:18:34 +02:00
run Update ATA driver (#41) 2020-04-13 11:36:04 +02:00
src Remove dependency on rlibc (#115) 2020-11-12 23:07:02 +01:00
.gitignore Update gitignore 2020-07-03 23:49:58 +02:00
CHANGELOG.md Add new `mem` command (#113) 2020-11-10 22:11:33 +01:00
Cargo.lock Remove dependency on rlibc (#115) 2020-11-12 23:07:02 +01:00
Cargo.toml Remove dependency on rlibc (#115) 2020-11-12 23:07:02 +01:00
LICENSE Add license 2019-12-29 11:19:29 +01:00
Makefile Add pcnet driver (#82) 2020-10-31 23:20:41 +01:00
README.md Add ACPI shutdown (#111) 2020-11-08 18:51:09 +01:00
moros.png Rename screenshot 2020-07-27 07:23:23 +02:00
rust-toolchain Start MOROS project 2019-12-28 18:37:49 +01:00
x86_64-moros.json Add password hashing 2020-01-03 22:01:48 +01:00

README.md

MOROS: Obscure Rust Operating System

MOROS is a toy operating system written in Rust for the x86 architecture.

This project started from the seventh post of the second edition of Writing an OS in Rust by Philipp Oppermann and by reading the OSDev wiki along with many open source kernels.

screenshot

Features

  • External bootloader (using bootloader)
  • x86 CPU support (using x86_64)
  • Hardware interrupts (using pic8259_simple)
  • PS/2 Keyboard (using pc-keyboard)
  • VGA Text mode output
  • Serial output (using uart_16550)
  • Paging
  • Heap allocation (using linked_list_allocator)
  • ACPI shutdown (using acpi and aml)
  • RTC clock
  • PCI enumeration
  • ATA PIO mode
  • Random number generator
  • RTL8139 network card
  • AMD PCNET network card
  • DHCP/IP/TCP/UDP/DNS/HTTP protocols (using smoltcp)
  • Basic filesystem
  • Basic shell
  • Basic text editor
  • Basic file and network commands
  • A LOT OF SHORTCUTS TO GET EVERYTHING WORKING
  • HERE BE DRAGONS
  • Processes
  • Multitasking
  • A real userspace

Setup

Install tools:

$ curl https://sh.rustup.rs -sSf | sh
$ rustup install nightly
$ rustup default nightly
$ rustup component add rust-src
$ rustup component add llvm-tools-preview
$ cargo install bootimage

Clone repo:

$ git clone https://github.com/vinc/moros
$ cd moros

Usage

Build image to disk.img:

$ make image output=vga keyboard=qwerty nic=rtl8139

Run on QEMU:

$ make qemu output=vga nic=rtl8139

Run on a native x86 computer by copying the bootloader and kernel to a hard drive or USB stick (but there is currently no USB driver so the filesystem will not be available):

$ sudo dd if=target/x86_64-moros/release/bootimage-moros.bin of=/dev/sdx && sync

In both cases, MOROS will open a console in diskless mode after boot if no filesystem is detected. The following command will setup the filesystem on the first hard drive of the first ATA bus, allowing you to exit the diskless mode and log in as a normal user:

> install

Be careful not to overwrite the hard drive of your OS when using dd inside your OS, and install or disk format inside MOROS.

LICENSE

MOROS is released under MIT.