A comprehensive operating system in active development with kernel, drivers, filesystem, networking, security, and system services. Currently in development phase - experimental and subject to change.
- Build: bash build.sh
- Test: ./tests/integration_test
- Benchmark: ./tests/performance_bench
All users should know:
- Requirements: GCC, GNU Make, LD, Objcopy
- Build Instructions: See Building section below
- Architecture: x86-64, ARM64, RISC-V
- License: GPL v3 - See LICENSE file
Documentation and code available in repository.
- Developer - Building and extending OneOS
- Researcher - Studying OS architecture
- Student - Learning kernel internals
- Contributor - Adding features and fixes
- Driver Developer - Implementing hardware support
Start here:
- oneos.c - Main entry point
- kernel/ - Kernel implementation
- drivers/ - Device driver framework
- tests/ - Integration and performance tests
- Build: bash build.sh
Explore kernel design:
- kernel/ - Scheduling, memory, IPC
- mm/ - Virtual memory and paging
- net/ - TCP/IP stack
- security/ - Cryptographic implementations
- core-services/ - System architecture
Learn OS concepts:
- oneos.c - Start here for overview
- kernel/scheduler.c - Process scheduling
- mm/ - Memory management
- fs/ - Filesystem implementation
- tests/ - See usage examples
Write hardware support:
- drivers/base/ - Driver framework
- drivers/block/ - Block devices
- drivers/char/ - Character devices
- drivers/network/ - Network drivers
- See Makefile for integration
Improve OneOS:
- Fork repository
- Create feature branch
- Implement changes
- Add tests
- Submit pull request
Prerequisites:
GCC compiler
GNU Make
GNU LD
Objcopy (binutils)
Build OneOS:
bash build.sh
Output:
oneos-kernel.elf - Kernel with symbols
oneos-kernel.bin - Bootable kernel
oneos.iso - Bootable ISO
kernel.map - Symbol map
Integration tests:
./tests/integration_test
Validates: kernel, drivers, filesystem, networking, security
Performance benchmarks:
./tests/performance_bench
Measures: memory, CPU, context switching, syscalls
- Kernel - Scheduling, memory, interrupts
- Drivers - Block, char, network, audio, USB, PCI
- Filesystem - ext4, FAT32, caching
- Networking - TCP/IP, DNS, routing
- Security - AES, SHA-256, RSA, TPM
- Services - Daemons, logging, IPC
- Tests - Integration and performance
Code Statistics
802 C source files
816 header files
16 assembly files
~50,000 lines of code
81 compiled objects (452 KB)
Architecture Support
x86-64 with high memory mapping
ARM64 with exception levels
RISC-V with privilege levels
Currently In Development - This project is actively being developed. Features may change. Not recommended for production use yet.
GPL v3 License - See LICENSE for details.
Open source for research, learning, and development.
What GPL v3 means:
- You can use, modify, and redistribute OneOS
- Any modified version must also be open source under GPL v3
- You cannot rename OneOS and claim it as your own closed-source project
- You must provide source code with any distribution
- Commercial use is allowed, but source must be available
Contributing:
- Bug fixes and patches welcome
- Performance improvements wanted
- New drivers appreciated
- Feature proposals via issues
- All contributions remain under GPL v3
💡 Git Pro Tip: ❌Commit - ✅Bulk Commit 😂 (The real developer experience)
GPL ensures OneOS remains free and open for the community.
- GitHub: https://github.com/abhishekprajapatt/oneos
- Issues: Bug reports and feature requests
- Discussions: Questions and ideas
- Build System: build.sh, Makefile
- Kernel Layout: kernel.ld
- Tests: tests/ directory
- Source: Full implementation included
