Crossplatform: Docker to compile the image file and QEMU for emulation.
For native compilation you will need:

• i386-elf-gcc, i386-elf-ld and i386-elf-g++ for MacOS.
• build-essential and gcc-multilib for Linux / WSL (ubuntu)
• Also need: grub2, xorriso and xxd (for using Grub as bootloader)

To compile the kernel and its needed programs you simply need to run make img and make qemu to open QEMU

1. Clone the repo

   git clone https://github.com/joexbayer/RetrOS-32.git

2. Check that all dependencies are installed (Only for debian based distros)

3. Initialize Git submodules (C-Compiler)

   git submodule update --init --recursive

4. Compile and create image

5. Launch QEMU

6. Use GRUB (Optional)

Currently MacOS cannot natively compile the build tools as they depend on 32bit x86 code. Docker is the simplest way if you still wish to compile the operating system.

1. Clone the repository

   git clone https://github.com/joexbayer/RetrOS-32.git

2. Initialize Git submodules (C-Compiler)

   git submodule update --init --recursive

3. Build using Docker

   docker-compose up --build

Use Docker (see MacOS section) or WSL (see Linux section).

(back to top)

To run RetrOS-32:

• http://copy.sh/v86/ : Upload .img file as Hard disk image.
• QEMU: make qemu or qemu-system-i386 <image name>
• Real hardware: Burn .iso file to USB or CD (Use a GRUB iso)

(back to top)

NETOS - Project
├── Dockerfile 
├── LICENSE.txt
├── Makefile
├── apps (userspace applications)
│   ├── Makefile
│   ├── <app>
│   ├── libcore.a
│   ├── libgraphic.a
│   ├── libnet.a
│   ├── readme.md
│   └── utils
│       └── *.cpp
├── bin 
│   └── *.o
├── boot (custom bootloader)
│   ├── bootloader.s
│   └── multiboot.ld
├── docker-compose.yml
├── docs (documentation)
│   ├── *.md
├── drivers (kernel drivers)
│   └── *.c
├── fs (filesystem)
│   ├── Makefile
│   ├── bin
│   └── *.c
├── graphics
│   └── *.c
├── include
│   ├── arch
│   │   └── *.h
│   ├── fs
│   │   └── *.h
│   ├── gfx
│   │   └── *.h
│   ├── lib
│   │   └── *.h
│   ├── net
│   │   └── *.h
│   └── *.h
├── kernel (main kernel source files)
│   ├── arch
│   │   └── *.c
│   ├── kthreads
│   │   └── *.c
│   └── *.c
├── legacy (old code)
├── lib (libraries)
│   └── *.c
├── net (networking code)
│   └── *.c
├── readme.md
├── rootfs (root filesystem for the OS)
├── tests (testing code)
│   ├── Makefile
│   ├── bin
│   ├── *_test.c
│   └── readme.md
└── tools (build tools)
    ├── scripts
    └── bin
        └── *.c

• Custom Bootloader & GRUB compatible
• Stage 2 bootloader
• Wallpapers
• Mountable image
• Users
• Multi-threaded pre-emptive scheduling
• GDT & TSS kernel / userspace separation
• Interrupt handling
• PS/2 Keyboard & Mouse, PIT, VESA (640x480x8), RTC, Serial drivers, E1000
• PCI.
• 8Bit RGB to 8Bit VGA
• Filesystem
• Textmode VGA only
• Networkstack
• ATA IDE Driver
• Memory
• Graphics
• Terminal, Window Server, Process Informtaion, Finder.
• Library (printf, memcpy, etc)
• IPC
• System calls
• C Compiler / interpreter to bytecode
• Custom VM to run bytecode.
• Editor with Syntax Highlighting
• Calculator
• 3D Game
• Snake game (Textmode only)
• Userspace threads (shared virtual memory)
• Remote virtual terminal over TCP
• LZ compression library
• Tools

See the open issues for a full list of proposed features (and known issues).

(back to top)

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Joe Bayer

Project Link: https://github.com/joexbayer/RetrOS-32

(back to top)

Use this space to list resources you find helpful and would like to give credit to. I've included a few of my favorites to kick things off!

(back to top)