Skip to content

Latest commit

 

History

History
155 lines (117 loc) · 4.67 KB

README.md

File metadata and controls

155 lines (117 loc) · 4.67 KB
Raw

yanix

Just a UNIX-like kernel build on caffeine and sleep deprivation. I call it yanix (Yet Another uNIX clone) The goal is to make it as POSIX compliant as possible and self sustaining.

yanix-screenshot Now able to run doom!

This project is a hobby os so this is not perfect, I am currently trying to make the codebase as clean as possible so others can learn from this os and build their own. However some parts, especially the older parts of the os, are not the prettiest / most well documented code ever.

You are welcome to make any pull requests and help build this os further.

If you are starting out I really recommend the osdev.org wiki as a lot of the code here is build on the information found on that wiki. For more helpfull links check the bottom of this page

Currently supported features:

CPU-based Features:

Supported Architectures:

  • x86

  • x86-64

  • arm

  • Multitasking

  • Multiprocessing

  • User mode

Kernel Features:

  • Monolithic kernel
  • Preemptible kernel
  • Virtual filesystem
  • Elf exec driver
  • Memory management
  • Ramdisk support
  • Moduling system

Supported Filesystems:

  • ext2
  • fat32
  • ext3
  • ext4

Supported Devices & Drivers:

  • i8042 (PS/2 Controller)
  • Ramdisk (memory mapped storage device)
  • ps2 mouse
  • ps2 keyboard
  • CMOS driver
  • PCI driver
  • ata
  • networking

Supported Video Interfaces:

  • VESA 3.0 graphics
  • Standard vga terminal buffer

System Features:

  • Home made bootloader

Features/stuff coming in next updates:

  • Time system
  • Networking
  • Code cleaning because it is a mess at some places
  • Documenting the important stuff
  • Redo the ext2 driver because it is very messy and incomplete

Ported software

Right now we are working hard on porting other unix software to this operating system. The first port ever completed is FIGlet and it runs perfectly on yanix!

__   __          _        _                                                   
\ \ / /_ _ _ __ (_)_  __ (_)___    __ ___      _____  ___  ___  _ __ ___   ___ 
 \ V / _` | '_ \| \ \/ / | / __|  / _` \ \ /\ / / _ \/ __|/ _ \| '_ ` _ \ / _ \
  | | (_| | | | | |>  <  | \__ \ | (_| |\ V  V /  __/\__ \ (_) | | | | | |  __/
  |_|\__,_|_| |_|_/_/\_\ |_|___/  \__,_| \_/\_/ \___||___/\___/|_| |_| |_|\___|
  • FIGlet
  • Bash
  • TCC
  • nasm
  • smlrcc
  • doom (well, kind of. Who needs input or sound anyways)
  • bitfetch
  • lua
  • GCC
  • Python

Getting it to work on your machine:

In order to build and run yanix you will need the following items:

  • NASM assembler
  • the yanix toolchain
  • maindisk.iso

The last two can be found here. Just put both files in the main yanix/ directory.

Building

First mount maindisk.iso like so:

sudo make mount_disk

Then to build yanix run

make clean && make run

Running

To start yanix in qemu run make run in terminal and it should start running in qemu.

Links

A big thanks to anyone that helped on one of the articles found bellow without those people this project would not have been possible.

osdev wiki and forum:

The James Molloy kernel development tutorials:

A few notes about these tutorials: I personally would not recommend these articles if you just are starting out as these generally do not explain the material very deeply and you are at risk of just copying code that works and not really understanding what happens under the hood. The tutorials also have some bugs in them check (this page)[https://wiki.osdev.org/James_Molloy%27s_Tutorial_Known_Bugs] this page for more information

Writing a Simple Operating System from scratch - Nick Blundell

This is a pdf that explains all the beginnings of an os and it's bootloader, the document explains the material very good.

os-tutorial - cfenollosa

This page is also very good if you are just starting out although it is mostly based on the document by Nick Blundell that explains everything, so you might as well use that.

The Internet

If you still struggle to understand something our want to implement something that is not listed in any of these documents you can still search the web. Sadly enough a lot of os development sites and articles are now down because of various reasons but there is still a lot just lying around waiting for you to find it.