Skip to content

Latest commit

 

History

History
66 lines (55 loc) · 2.05 KB

README.md

File metadata and controls

66 lines (55 loc) · 2.05 KB
Raw
                                         .d88b,  MMMMMMMMMMM MMMMMMMMMMM
                                   qq         8  MMP"""""YMM MP""""""`MM 
                                   88    d8888P  M' .mmm. `M M  mmmmm..M 
                        .d8888b. d8888P  8       M  MMMMM  M M.      `YM 
                        88'  `88   88    `8888'  M  MMMMM  M MMMMMMM.  M 
                        88.  .88   88            M. `MMM' .M M. .MMM'  M 
                        `88888P8   dP            MMb.   .dMM Mb.     .dM 
                                                 MMMMMMMMMMM MMMMMMMMMMM 
                        
                            Another Tiny Test Operating System
                                   by Martin Velikov

attOS: Another Tiny Test Operating System

atOS is a research operating system made for fun and educational purposes, like many of its ancestors.

Install Dependencies

atOS needs the following build dependencies:

  • make
  • ld for x86_64
  • grub + xorriso
  • qemu with x86_64 support
  • cargo + rustc and a nightly Rust toolchain

If you want to debug it, you also need gdb.

On Arch Linux, these dependencies can be installed with the command

$ sudo pacman -S base-devel grub xorriso rustup qemu-full
$ rustup install nightly

Build & Run

You may build the bootable .iso file with

$ make

You may emulate the built atOS with

$ make run

You may build and emulate atOS in one command with

$ make dev

Directory Layout

  • iso - filesystem of the .iso file of the OS
  • src - source code
    • init - multiboot2 entry point that performs setup and jumps into the kernel
    • kernel - kernel written in Rust
  • target - compiled artifacts
    • atos-kernel.bin - linked kernel binary
    • atos.iso - bootable OS image

References