mirrors/limine
1
0
Fork 0
mirror of https://github.com/limine-bootloader/limine synced 2024-12-04 06:02:28 +03:00
Code Issues Packages Projects Releases Wiki Activity
219 Commits 18 Branches 1,006 Tags 162 MiB
C 90.6%
Makefile 5.7%
Assembly 1.5%
M4 1.3%
Shell 0.9%
45aaa72e85
Go to file
mint 45aaa72e85
Decompressor (#23) 
* Add decompressor infrastructure

* Fix up everything

* Add a gzip decompressor (#22)

Co-authored-by: Matteo Semenzato <mattew8898@gmail.com>
2020-09-06 03:35:32 +02:00
src Decompressor (#23) 2020-09-06 03:35:32 +02:00
test Wire up logic for graphical terminal 2020-09-02 09:55:56 +02:00
.gitignore Decompressor (#23) 2020-09-06 03:35:32 +02:00
bochsrc Initial linux protocol support 2020-04-19 10:14:49 +02:00
CONFIG.md Rebranding 2020-08-29 20:02:16 +02:00
LICENSE.md Update copyright notice 2020-05-31 05:18:04 +02:00
limine-install.c Move to clang, no longer ship prebuilt binary, embed bootloader into the installer and provide a way to install the installer 2020-09-04 05:21:58 +02:00
Makefile Move to clang, no longer ship prebuilt binary, embed bootloader into the installer and provide a way to install the installer 2020-09-04 05:21:58 +02:00
README.md Decompressor (#23) 2020-09-06 03:35:32 +02:00
screenshot.png Rebranding 2020-08-29 20:02:16 +02:00
STIVALE2.md Update STIVALE2.md 2020-08-11 18:10:38 +02:00
STIVALE.md Restore old stivale specification and move stivale2 spec to own file 2020-08-11 17:53:37 +02:00

README.md

Limine

x86/x86_64 BIOS Bootloader

Reference screenshot

Supported boot protocols

  • Linux
  • stivale and stivale2 (Limine's native boot protocols, see STIVALE{,2}.md for details)

Supported filesystems

  • ext2
  • echfs
  • FAT32

Supported partitioning schemes

  • MBR
  • GPT

Building

Dependencies

To build Limine, it is necessary to have an LLVM/Clang toolchain installed. More specifically, the following programs need to be present: clang, llvm-objcopy, llvm-link, opt, ld.lld. Furthermore, nasm also needs to be installed. curl, tar, and zstd need to be installed for retrieving libgcc.a during build.

Compiling

A simple make and make install will suffice. Use the PREFIX variable with make install to specify where to install limine-install. It defaults to /usr/local.

How to use

In order to install Limine on a MBR device (which can just be a raw image file), run the limine-install as such:

limine-install <path to device/image>

If using a GPT formatted device, it will be necessary to create an extra partition (of at least 32K in size) to store stage 2 code. Then it will be necessary to tell limine-install where this partition is located by specifying the start sector.

fdisk <device>    # Create bootloader partition using your favourite method
limine-install <path to device/image> <start sector of boot partition>

Then make sure the device/image contains at least 1 partition formatted in a supported filesystem containing a /limine.cfg or /boot/limine.cfg file and the kernel/modules one wants to load.

An example limine.cfg file can be found in test/limine.cfg.

More info on the format of limine.cfg can be found in CONFIG.md.

For example, to create an empty image file of 64MiB in size, 1 echfs partition on the image spanning the whole device, format it, copy the relevant files over, and install Limine, one can do:

dd if=/dev/zero bs=1M count=0 seek=64 of=test.img
parted -s test.img mklabel msdos
parted -s test.img mkpart primary 1 100%
parted -s test.img set 1 boot on # Workaround for buggy BIOSes

echfs-utils -m -p0 test.img quick-format 32768
echfs-utils -m -p0 test.img import path/to/limine.cfg limine.cfg
echfs-utils -m -p0 test.img import path/to/kernel.elf kernel.elf
echfs-utils -m -p0 test.img import <path to file> <path in image>
...
limine-install test.img

One can get echfs-utils by installing https://github.com/qword-os/echfs.

Limine uses a stripped-down version of https://github.com/jibsen/tinf

Discord server

We have a Discord server if you need support, info, or you just want to hang out: https://discord.gg/QEeZMz4