gbowne1/ClassicOS
2
2
Fork 0
mirror of https://github.com/gbowne1/ClassicOS.git synced 2026-01-01 21:15:20 -08:00
Code Issues 2 Packages Projects 1 Releases Wiki Activity

update readme

Browse Source
This commit is contained in:
Borna Šoštarić
2025-12-19 23:44:00 +01:00
parent 45acbb5c04
commit 66f9056406
1 changed files with 21 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
README.md
View File

@@ -5,7 +5,7 @@
[![Platform](https://img.shields.io/badge/platform-x86_IA32-lightgrey?style=flat-square)](https://en.wikipedia.org/wiki/IA-32) [![Platform](https://img.shields.io/badge/platform-x86_IA32-lightgrey?style=flat-square)](https://en.wikipedia.org/wiki/IA-32)
[![Made with](https://img.shields.io/badge/made%20with-C%20%26%20NASM-9cf?style=flat-square)](#) [![Made with](https://img.shields.io/badge/made%20with-C%20%26%20NASM-9cf?style=flat-square)](#)
> **ClassicOS** is a 32-bit Intel x86 operating system built from scratch using C, NASM, and GCC. > **ClassicOS** is a 32-bit Intel x86 operating system built from scratch using C, NASM, and GCC.
> Designed for 386, 486, and Pentium-class CPUs, it runs in protected mode, outputs to VGA text mode and serial ports, and supports floppy/HDD boot with basic FAT support. > Designed for 386, 486, and Pentium-class CPUs, it runs in protected mode, outputs to VGA text mode and serial ports, and supports floppy/HDD boot with basic FAT support.
--- ---
@@ -35,6 +35,7 @@ You’ll need the following tools installed:
- `qemu-system-i386` - `qemu-system-i386`
Optional: Optional:
- `gdb` - `gdb`
- `vncviewer` (TigerVNC or similar) - `vncviewer` (TigerVNC or similar)
@@ -42,13 +43,27 @@ Optional:
## 🛠️ Building ClassicOS ## 🛠️ Building ClassicOS
Clone and build: Clone repository:
```bash ```sh
git clone https://github.com/gbowne1/ClassicOS.git git clone https://github.com/gbowne1/ClassicOS.git
cd ClassicOS cd ClassicOS
make
``` ```
build kernel Run `configure` script to build a cross-compiler toolchain for `i386-elf`:
for %f in (*.c) do gcc -m32 -O0 -Wall -Wextra -Werror -pedantic -ffreestanding -nostdlib -fno-pic -fno-stack-protector -fno-pie -march=i386 -mtune=i386 -c "%f" -o "%f.o"
```sh
./configure
```
Source the `.build.env` file to add the cross-compiler toolchain to your PATH:
```sh
source .build.env
```
Build the kernel:
```sh
make
```