https://github.com/Alessandro-Salerno/SalernOS-EFI-Bootloader
A Bootloader for my Operating System
https://github.com/Alessandro-Salerno/SalernOS-EFI-Bootloader
amd64 assembly bootloader c efi salernos uefi x86-64
Last synced: 3 months ago
JSON representation
A Bootloader for my Operating System
- Host: GitHub
- URL: https://github.com/Alessandro-Salerno/SalernOS-EFI-Bootloader
- Owner: Alessandro-Salerno
- License: apache-2.0
- Archived: true
- Created: 2021-12-28T17:42:29.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-11-18T22:36:33.000Z (7 months ago)
- Last Synced: 2024-11-18T23:36:31.111Z (7 months ago)
- Topics: amd64, assembly, bootloader, c, efi, salernos, uefi, x86-64
- Language: C
- Homepage:
- Size: 325 KB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> [!WARNING]
> This repository is for historical purposes only. It is used as a monument to the year 2022, and may be used as a "nostalgia kit" to build older SalernOS versions from that year. The SalernOS EFI Bootloader was discontinued in 2023 and is no longer in use.
## SalernOS
SalernOS is a small Toy OS I'm working on.
## SalernOS EFI Bootloader (SEB)
The SalernOS EFI Bootloader is a free and open source GNU-EFI bootloader built on top of https://github.com/Absurdponcho/gnu-efi
## Naming Conventions
* ```_variablename``` and ```_variable_name``` are stack-allocated variables
* ```_VariableName``` is a struct member variable
* ```variablename``` and ```variable_name``` are global variables
* ```__variablename``` and ```__variable_name``` are function arguments
## Compiling SEB
Compiling SEB is quite eaasy, just follow these steps
* Make sure you're running a GNU/Linux system. If you're running Windows 10/11 or macOS, use WSL or Docker
* Install the build-essentials package via your package manager (apt-get/pacman etc)
* Open a terminal in the SEB directory
* If it's the first time you compile SEB, Type `make` and wait for a few seconds
* Type `make bootloader` and wait for a few seconds
* The resulting `main.efi` file will be in the `x86_64/bootloader` directory
## Editing SEB's source code
All of SEB's source code is in the `bootloader` directory.
NOTE: Remember to change something in `main.c` before compiling, otherwise it won't work!
## Using SEB as bootloader for an Operating System
This is a little trickier, but you should be able to do it, otherwise, open an issue on this Github page.
### The Simple Boot Specification
The SalernOS EFI Bootlaoder uses the [Simple Boot Specification](https://github.com/Alessandro-Salerno/Simple-Boot-Specification) to hand information over to the Kernel.
#### Making a SEB Compatible File System
Currently the SEB Specification requires the following directories
* EFI
* EFI/BOOT
* openbit
* openbit/bin
* openbit/assets
The `EFI/BOOT`directory must contain a `bootx64.efi` file. This file is the SEB binary, you can get it by renaming the `main.efi` file.
The `openbit/assets` directory must contain a PSF1 Font named `kernelfont.psf`.
The `openbit/bin` directory must contain the kernel executable, named `kernel.elf`