os-k/README.md

57 lines
1.6 KiB
Markdown
Raw Normal View History

2019-04-03 14:16:04 +02:00
# OS/K (OS on Kaleid)
2019-12-11 22:35:37 +01:00
| ![FSF Logo](https://www.os-k.eu/GPLLOGO.png) | This program is free software, released under the terms of the [GNU GPL](COPYING) version 3 or later as published by the Free Software Foundation |
2019-04-03 14:16:04 +02:00
|----------------------------------------------|----------------------------------------------------------------------|
### Fully free operating system from scratch (WIP)
For changelog, see [ChangeLog](ChangeLog)
For structure of the sources, see [ProjectTree](ProjectTree)
2019-04-09 15:04:21 +02:00
For our IRC channel, see `#os.k-devel` on [Freenode](https://webchat.freenode.net)
2019-04-09 15:01:33 +02:00
2019-04-03 14:16:04 +02:00
Note that every file within OS/K is written using spaces for tabulation, with each
2019-04-04 18:47:30 +02:00
tabulation being 4 spaces long.
2019-04-03 14:16:04 +02:00
#### Compile from sources
2020-09-29 15:15:12 +02:00
To compile this project from sources, you must first install the dependencies :
2019-04-03 14:16:04 +02:00
```
2020-09-29 15:15:12 +02:00
sudo apt update && apt upgrade
2020-06-02 01:16:21 +02:00
apt install grub-pc-bin dosfstools make nasm qemu tree parted udisks2
2019-04-03 14:16:04 +02:00
```
To compile, simply use at the root of this project :
2020-09-29 15:15:12 +02:00
2019-04-03 14:16:04 +02:00
```
make
```
2020-06-01 23:22:31 +02:00
The OS/K cross-compiler will automatically be installed.
2019-04-03 14:16:04 +02:00
To compile and test, simply use at the root of this project :
2020-09-29 15:15:12 +02:00
2019-04-03 14:16:04 +02:00
```
make test
```
2020-09-29 15:15:12 +02:00
#### Compile the cross-compiler from sources
2019-04-04 18:47:30 +02:00
2020-09-29 15:15:12 +02:00
To compile the cross-compiler from sources, you must first install the dependencies :
```
sudo apt install build-essential bison flex libgmp3-dev libmpc-dev libmpfr-dev texinfo
```
2020-01-09 23:51:55 +01:00
2020-09-29 15:15:12 +02:00
Then use the `compile-cross-cc` option :
2020-01-09 23:51:55 +01:00
2020-09-29 15:15:12 +02:00
```
make compile-cross-cc=yes
```
2020-01-09 23:51:55 +01:00
2020-09-29 15:15:12 +02:00
Note : Depending on your connection, it may take some time to download the GCC and Binutils sources. In addition, compiling may require a lot of resources.
#### Screenshot
2021-02-22 22:20:14 +01:00
![OS/K Started](https://wiki.osdev.org/images/7/70/OS-on-kaleid.png)