https://github.com/dokadev/legacyos
ROM BIOS-based MBR Operating System Project
https://github.com/dokadev/legacyos
Last synced: about 1 year ago
JSON representation
ROM BIOS-based MBR Operating System Project
- Host: GitHub
- URL: https://github.com/dokadev/legacyos
- Owner: DokaDev
- License: mit
- Created: 2024-02-07T13:17:15.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-13T07:10:57.000Z (over 2 years ago)
- Last Synced: 2025-04-14T03:33:56.897Z (about 1 year ago)
- Language: C
- Size: 47.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## LegacyOS
ROM BIOS-based MBR Operating System Project
### Build Instructions
This project is designed to be build for the i386 architecture, specifically targeting low-level systems programming.
To compile and build the project, you will need to have several tools and dependencies installed on your system.
#### Prerequisites
Before you begin, ensure you have the following tools installed:
* **GCC**: The GNU Compiler Collection, with support for compiling 32-bit(`-m32`) code. You can install GCC on most Linux distributions via your package manager. For Debian-based systems, use `sudo apt-get install gcc-multilib`.
* **NASM**: The Netwide Assembler, a popular assembler for x86 architecture. Install it using your package manager, for example, `sudo apt-get install nasm` on Debian-based systems.
* **GNU LD**: The GNU Linker, which should come with the binutils package. Ensure you have the 32-bit version capable of handling `elf_i386` format. For Debian-based systems, `sudo apt-get install binutils`.
* **GNU Objcopy**: Part of the GNU Binutils for converting and copying object files; used here to create a binary from the ELF file.
#### Build Process
To build the project, follow these steps:
1. **Clone the Repository**: To clone the repository, execute the following command on your local machine:
```bash
git clone https://github.com/DokaDev/LegacyOS.git
```
2. **Navigate to the Project Directory**: Change to the project directory using the command below:
```bash
cd LegacyOS
```
3. **Compile and Build Project**: After you clone the repository, just run `make` to build it. :)
The script contains `clean` label that automatically cleans the build temporary files before the build process begins.
```bash
make
```
### Testing with QEMU
To ensure our OS works as expected in a virtualized environment, we leverage QEMU for comprehensive testing.
Follow the steps below to run tests on your system using QEMU.
#### Prerequisites
Before running tests, make sure you have QEMU installed on your system.
QEMU is a generic and open source machine emulator and virtualizer, which is essential for our testing process.
#### Running Tests
To run tests, simply use the `make test` command.
This command builds the necessary components and executes our operating system in a QEMU virtual machine, allowing us to observe and evaluate its behavior in a controlled environment.
```bash
make test
```
#### Installing QEMU
If QEMU is not already installed on your system, you can install it using the following command on Debian-based systems(such as Ubuntu):
```bash
sudo apt-get install qemu-kvm
```