https://github.com/axfab/koraos
Main repository for the distribution of my hobbyist operating system KoraOs
https://github.com/axfab/koraos
hobby-kernel hobby-os operating-system os
Last synced: 3 months ago
JSON representation
Main repository for the distribution of my hobbyist operating system KoraOs
- Host: GitHub
- URL: https://github.com/axfab/koraos
- Owner: AxFab
- License: agpl-3.0
- Created: 2019-03-11T22:36:28.000Z (about 6 years ago)
- Default Branch: develop
- Last Pushed: 2020-12-28T20:20:35.000Z (over 4 years ago)
- Last Synced: 2025-01-23T09:35:31.554Z (4 months ago)
- Topics: hobby-kernel, hobby-os, operating-system, os
- Language: Shell
- Size: 48.8 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# Kora OS - Distribution workspace
KoraOs is a hobbyst OS.
The KoraOs system is composed of several components.
- [Kernel](https://github.com/axfab/kora-kernel)
- [Libc](https://github.com/axfab/kora-libc)
- [File-systems](https://github.com/axfab/kora-filesystems)
- [Drivers PC](https://github.com/axfab/kora-driver-pc)
- [Utilities](https://github.com/axfab/kora-utils)
- [Desktop](https://github.com/axfab/kora-desktop)
- And more...
The repositories have been created to keep small components that take
care of one ascpect of the system.
Also many components are made to run on other platform and can be run and
tested as a unit.
## Hacking and building
To compile any deliveries for KoraOS you need to prepare a cross-compilor
toolchain.
This can be done easly with the following scripts:
```
./disto.sh header
./resx/toolchain/build-gcc.sh --prefix=/i386-kora
```
However it require some knowledge to debug some issues.
A simpler way might be to use the docker image which already contains all
the required tools.
```
docker pull axfab/kora-gcc:latest
docker run -v `pwd`:/app -w /app -it axfab/kora-gcc:latest bash
```
Once the toolchain is up and ready it can be update using:
```
./disto.sh setup
```
And the Kora image can be build with:
```
./disto.sh build
```
## Organisation of the working space
The repository is not a real source repository but a pre-configure workspace
to build a custom system image.
We can find all kora package into the `sources/` directory. If you wanna edit
code, that the place to look at.
The `package/` directory is a cache for all download packages. You might look
for archived package there, but all writing should be done by the `pkg.sh`
script. I'm quite proud of my Dropbox based package manager!
The directories `build-{target}/` are were all intermediate files goes to
create deliveries and packages.
The `3rd_parties/` hold sources for external libraries.
The `resx/` contains utilities scripts.