oos

• oos is an Operating System with the goal of using the ooc language for as much of the code as possible
• oos stands for ooc operating system
• Repository: https://github.com/tsion/oos
• IRC: ##oos on freenode

Downloading and Compiling oos

You will need to have installed gcc, scons, nasm, genisoimage (cdrkit), and ooc. I recommend you get the very latest version of ooc from the git repo, because ooc is still in development and oos relies on some recent bugfixes.

After you have all that, it is as simple as:

$ git clone git://github.com/tsion/oos.git
$ cd oos
$ scons

Running oos

I've provided a script for running oos in the Bochs emulator.

$ ./run.sh

You should be able to use oos with qemu or any emulator of your choice by telling your emulator to boot the iso/shiny.iso CD image.

$ qemu -cdrom iso/oos.iso

Running oos on real hardware is untested and not recommended (I am not responsible for any fires, explosions, or alien abductions that may result), but in theory it should work. I'll keep my fingers crossed.

UPDATE: sdkmvx has tested oos on real hardware, and it worked for him!

Debugging oos

I have also created a script to run bochs listening for a remote gdb connection on port 1234. You need to compile bochs with --enable-gdb-stub to use this script!

$ ./debug.sh

When you run that, bochs will say "Waiting for gdb connection on port 1234." You can now connect with gdb from another terminal. Use --symbols=path/to/oos.exe so that gdb is aware of our function and variable names.

$ gdb --symbols=Src/Kernel/oos.exe
GNU gdb (GDB) 7.0
Copyright (C) 2009 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
and "show warranty" for details.
This GDB was configured as "x86_64-unknown-linux-gnu".
For bug reporting instructions, please see:
<https://www.gnu.org/software/gdb/bugs/>.
Reading symbols from /home/scott/code/os/oos/Src/Kernel/oos.exe...done.
(gdb) target remote :1234
Remote debugging using :1234
warning: Remote failure reply: Eff
0x0000fff0 in ?? ()
(gdb) break kmain
Breakpoint 1 at 0x100c2c: file ooc_tmp/oos/Src/Kernel/Main.c, line 11.
(gdb) c
Continuing.
Breakpoint 1, kmain (mb=0x354a0, magic=732803074) at ooc_tmp/oos/Src/Kernel/Main.c:11
11  void kmain(MultibootInfo *mb, uint32_t magic) {
(gdb) bt
#0  kmain (mb=0x354a0, magic=732803074) at ooc_tmp/oos/Src/Kernel/Main.c:11
#1  0x00100018 in _start () at Src/Kernel/Boot.asm:25

This can be extremely useful for finding those annoying little problems! The same can also be done with and GUI front-end to gdb, just consult its documentation on how to do a remote gdb connection. And by the way, since I compile with ooc -g, gdb can walk through ooc code line by line, and display the ooc source of the line it's on. Hooray!

Note: gdb can do a lot, check out 'help' (duh).

Note again: nemiver is a decent GTK+ GUI front-end for gdb. Or if you like to like to live on the 'K' side of life, there is kdbg.

Features

• el zilcho
• Can I call printing colour text a feature? =)

Todo

• interrupts/exceptions - Done!
• syscalls - almost done
• memory management
• drivers for keyboard, display (text display driver mostly done), serial, filesystems, floppy, etc
• modules / elf32 loading
• ooc stdlib (all things like strlen, strcmp, etc, will be in pure ooc)

Thanks

• nddrylliog and everyone else involved in creating the ooc language!
• OSDev, for all the great tutorials and informative articles
• The creators of dux OS. I read and stole a lot of code from them. :)