raeofsunshine
/
KimisOS
mirror of https://github.com/raeofsunshinedev/KimisOS.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
A Totally Fr Operating System
147 Commits 3 Branches 0 Tags 540 KiB
C 81.2%
Assembly 16.1%
Makefile 2.1%
Shell 0.6%
Go to file
notsomeidiot123 e366dc75d8 Modified files to fit new VFS 2026-03-14 13:48:00 -04:00
docs Fixed kstdlib.c:vector_push, implemented modules.c:dispatch_message() 2026-03-02 23:12:01 -05:00
src Modified files to fit new VFS 2026-03-14 13:48:00 -04:00
tools Cosmetic changes, free root in tools/diskwrite.c 2026-02-02 02:58:55 -05:00
.gitignore Loading initrd instead of modules separately 2025-09-27 14:38:32 -04:00
LICENSE Added license agreement based off of the DBAD license 2025-08-27 16:36:44 -04:00
README.md Added README 2025-09-26 12:08:30 -04:00
c_build_helper.sh Various critical bug fixes across many files 2026-02-02 02:39:49 -05:00
initrc.conf Implemented MOUNT command for initrc.conf. Documentation in initrc.conf. (initrc.c:initrc_read()) 2026-03-03 21:12:26 -05:00
linker.ld fcreate now works for virtual files and directories, and mounted filesystems 2025-09-10 15:39:51 -04:00
makefile Add locking and fix race condition for ata_read() 2026-02-28 21:48:45 -05:00

README.md

Kimi's OS

A totally FR Operating System made by yours truly!

Details

Kimi's OS is an x86 32-bit Modular operating system created as a hobby project. It uses a custom-made bootloader also made by me.

My goal for this project is to make something modular in design that can be swapped out as it's running with other or updated modules without a full reboot. Sadly updating the kernel will still require a full restart.

I'm focused on making this as stable as possible, and (eventually) secure. Right now there's not many security features, but it's a work in progress. If anyone that knows anything about cybersecurity has any suggestions on how to implement security features, please open an issue!

Features

  • Custom legacy bootloader, which loads the Kernel (/kernel.elf), and the Initial boot and FS drivers (/idm.elf and /ifsm.elf)
  • Support for PCI (not PCIe)
  • Custom VFS, with built-in explicit support for mount points, devices, directories, and pipes.
  • Support for ELF executable files
  • Loading Kernel modules
  • Serial debugging (Logging messages over COM0)

Instructions

So far, I only officially support using an emulator.

To build and run, first you must run

make init

to create necesary folders and files, followed by

make

to build and run in qemu. Running will ask you for your sudo password, this is because of this line in the makefile: sudo mount image.bin mount. This line will simply mount the kernel image to a LOCAL directory made by make init called mount. It will not override anything outside of the root directory OF THIS PROJECT. When this project is more mature and supports bare metal better (Tested with a machine I can test on), I'll offer pre-compiled images on the github releases tab.