Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mtrzc0/bootldr
Unix-family, multiboot compliant bootloader
https://github.com/mtrzc0/bootldr
assembly bootloader i386 linux unix x86-64
Last synced: 3 months ago
JSON representation
Unix-family, multiboot compliant bootloader
- Host: GitHub
- URL: https://github.com/mtrzc0/bootldr
- Owner: mtrzc0
- License: gpl-3.0
- Created: 2024-07-19T09:55:04.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-09-28T12:19:54.000Z (4 months ago)
- Last Synced: 2024-09-30T05:43:59.279Z (4 months ago)
- Topics: assembly, bootloader, i386, linux, unix, x86-64
- Language: C
- Homepage:
- Size: 228 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bootldr Project
This project focuses on understanding how bootloaders work. It includes various stages and components to load an operating system.
> [!WARNING]
>
> This project is a work in progress and is not yet complete. It is not recommended for production use.
## Core Components
- **OS Loader**: Loads the operating system (Unix family).
- **GUI**: Graphical user interface.
- **Config**: Configuration files and settings.
## Installation
Currently, there is no installation process available.
## Build Instructions
### Prerequisites
- `nasm` (Netwide Assembler)
- `ld` (GNU Linker)
- `gcc` (GNU Compiler Collection)
- `make` (GNU Make)
- `clang` (LLVM Compiler)
- `qemu` (for running the bootloader)
### Building the Bootloader
To build the bootloader, run the following command:
```sh
make
```
This will generate the bootloader binary in the `build` directory.
### Build ELF file for Debugging
To build the ELF file for debugging, run:
```sh
make debug
```
### Running the Bootloader in QEMU
TO run the bootloader in QEMU, run:
```sh
make run DEBUG=false
```
TO run the bootloader in QEMU with debugging enabled, run:
```sh
make run DEBUG=true
```
### Cleaning the Build
To clean the build directory, run:
```sh
make clean
```
## To-Do List
Click to expand
- [x] Place the code in MBR (first sector of the disk)
- [x] Setup 16-bit segment registers and stack
- [x] Print startup message
- [x] Enable and confirm enabled A20 line
- [x] Load GDTR
- [x] Setup GDT
- [x] Enable 32-bit Protected Mode
- [x] Call second stage C code
- [ ] Support GNU Multiboot
- [ ] Check presence of PCI, CPUID, MSRs
- [ ] Inform BIOS of target processor mode
- [ ] Get memory map from BIOS
- [ ] Locate kernel in filesystem
- [ ] Allocate memory to load kernel image
- [ ] Load kernel image into buffer
- [ ] Enable graphics mode
- [ ] Check kernel image ELF headers
- [ ] Allocate and map memory for kernel segments
- [ ] Setup COM serial output port
- [ ] Setup IDT
- [ ] Disable PIC
- [ ] Check presence of CPU features (NX, SMEP, x87, PCID, global pages, TCE, WP, MMX, SSE, SYSCALL), and enable them
- [ ] Assign a PAT to write combining
- [ ] Setup FS/GS base
- [ ] Load IDTR
- [ ] Enable APIC and setup using information in ACPI tables
- [ ] Setup TSS
## Contribution
Contributions are welcome! Please fork the repository and submit a pull request.