/kernel

A hobby operating system, in Rust
  1. Rust 89.3%
  2. Assembly 8.1%
  3. Makefile 2.6%
Rust Assembly Makefile
Find file
Latest commit 56b2b7d Dec 24, 2016 @steveklabnik steveklabnik committed on GitHub Merge pull request #71 from slayerjain/readme_bug 
#70 updated the Readme file
Permalink
Failed to load latest commit information.
console take out my personal stuff from authorship Oct 1, 2016
interrupts Move idt_ref -> IdtRef::new Oct 1, 2016
keyboard Simplify matching in keyboard scancode decoding Oct 2, 2016
pic fixes typo in comment Oct 3, 2016
src Merge pull request #94 from 0xAX/boot-pagin-one-instr Oct 3, 2016
.gitignore Remove example source code. Sep 27, 2016
.travis.yml Remove example source code. Sep 27, 2016
Cargo.lock Use inb/outb from x86 instead of inline asm Oct 2, 2016
Cargo.toml Give up and make the kernel context global. Oct 1, 2016
Makefile Add in keyboard crate to do keyboard handling. Oct 1, 2016
README.md language improved Dec 24, 2016
build.rs Remove example source code. Sep 27, 2016
grub.cfg Remove example source code. Sep 27, 2016
layout.ld Remove example source code. Sep 27, 2016
x86_64-unknown-intermezzos-gnu.json Remove example source code. Sep 27, 2016

README.md

intermezzOS: kernel

Build Status

intermezzOS is a hobby operating system. This repository is for its kernel. See the website for more.

Also, feel free to join us at #intermezzOS on Freenode’s IRC network, if you want to chat.

Building

Make sure you have a nightly Rust installed. Something like this:

$ rustc --version
rustc 1.14.0-nightly (289f3a4ca 2016-09-29)

If you don’t have Rust installed (and maybe even if you've installed Rust some other way), you should use rustup to get it; it makes using multiple Rust versions very easy.

Then get this stuff:

  • nasm
  • ld
  • grub-mkrescue: you may also need to install xorriso
  • qemu-system-x86_64

If you're on OS X, you might want to use this script to get them. You'll also need to set this in your ~/.cargo/config:

[target.x86_64-unknown-intermezzos-gnu]
linker = "/Users/yourusername/opt/bin/x86_64-pc-elf-gcc"

Where yourusername is your username.

This project uses the xargo crate. To get it:

 $ cargo install xargo

Note: xargo has a few dependencies, check its readme to make sure you've got them installed.

After all that setup, it’s as easy as:

$ make run

This will:

  • Build libcore for our x86_64-unknown-intermezzos-gnu target with Xargo
  • Build the Rust code with Cargo
  • Compile the bit of assembly needed to boot
  • Link it all together
  • Build an ISO out of it all
  • Run that ISO in qemu

License

This project is dual licensed under Apache2/MIT. See the two LICENSE-* files for details.

Code of conduct

The intermezzOS project has a Code of Conduct, please observe it.