From e53e716659951c7d020bfb958b72b6917f1ccd0c Mon Sep 17 00:00:00 2001 From: pitust Date: Mon, 29 Nov 2021 20:58:58 +0000 Subject: [PATCH 1/3] fwcfg: document the features --- CONFIG.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/CONFIG.md b/CONFIG.md index b47d7587..e8dc46d6 100644 --- a/CONFIG.md +++ b/CONFIG.md @@ -6,6 +6,12 @@ Limine scans for a config file on *the boot drive*. Every partition on the boot is scanned sequentially (first partition first, last partition last) for the presence of either a `/limine.cfg`, `/boot/limine.cfg`, or a `/EFI/BOOT/limine.cfg` file, in that order. +If no config file is found in the aforementioned locations, limine looks for the file on the fw_cfg +interface called `opt/org.limine-bootloader.config`. +If that is not present, limine enters the so-called "simple mode", where the kernel is loaded from +`opt/org.limine-bootloader.kernel`, and, (if present), the background is loaded from +`opt/org.limine-bootloader.background`. + Once the file is located, Limine will use it as its config file. Other possible candidates in subsequent partitions or directories are ignored. @@ -149,6 +155,7 @@ A resource can be one of the following: * `guid` - The `root` takes the form of a GUID/UUID, such as `guid://736b5698-5ae1-4dff-be2c-ef8f44a61c52/...`. The GUID is that of either a filesystem, when available, or a GPT partition GUID, when using GPT, in a unified namespace. * `uuid` - Alias of `guid`. * `tftp` - The `root` is the IP address of the tftp server to load the file from. If the root is left empty (`tftp:///...`) the file will be loaded from the server Limine booted from. This resource is only available when booting off PXE. +* `fwcfg` - The `root` must be empty. The `path` refers to a fw_cfg filename to be loaded. The canonical place to put fw_cfg files is in the `opt/fqdn.` namespace. A URI can optionally be prefixed by a `$` character to indicate that the file pointed to be the URI is a gzip-compressed payload to be uncompressed on the From 4de17a2b96594fc930ded562935070676bff6db5 Mon Sep 17 00:00:00 2001 From: pitust Date: Mon, 29 Nov 2021 21:04:30 +0000 Subject: [PATCH 2/3] capitalize limine --- CONFIG.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CONFIG.md b/CONFIG.md index e8dc46d6..c5fdc4c9 100644 --- a/CONFIG.md +++ b/CONFIG.md @@ -6,9 +6,9 @@ Limine scans for a config file on *the boot drive*. Every partition on the boot is scanned sequentially (first partition first, last partition last) for the presence of either a `/limine.cfg`, `/boot/limine.cfg`, or a `/EFI/BOOT/limine.cfg` file, in that order. -If no config file is found in the aforementioned locations, limine looks for the file on the fw_cfg +If no config file is found in the aforementioned locations, Limine looks for the file on the fw_cfg interface called `opt/org.limine-bootloader.config`. -If that is not present, limine enters the so-called "simple mode", where the kernel is loaded from +If that is not present, Limine enters the so-called "simple mode", where the kernel is loaded from `opt/org.limine-bootloader.kernel`, and, (if present), the background is loaded from `opt/org.limine-bootloader.background`. From 73f2816403fc4981fa3ba7588d523283ccd2eba1 Mon Sep 17 00:00:00 2001 From: pitust Date: Mon, 29 Nov 2021 21:05:25 +0000 Subject: [PATCH 3/3] config: add mire detail to simple mode fw_cfg autodetection --- CONFIG.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CONFIG.md b/CONFIG.md index c5fdc4c9..da5ca48e 100644 --- a/CONFIG.md +++ b/CONFIG.md @@ -7,8 +7,8 @@ is scanned sequentially (first partition first, last partition last) for the pre of either a `/limine.cfg`, `/boot/limine.cfg`, or a `/EFI/BOOT/limine.cfg` file, in that order. If no config file is found in the aforementioned locations, Limine looks for the file on the fw_cfg -interface called `opt/org.limine-bootloader.config`. -If that is not present, Limine enters the so-called "simple mode", where the kernel is loaded from +interface called `opt/org.limine-bootloader.config`. If that is not present and the kernel is found at +`opt/org.limine-bootloader.kernel`, Limine enters the so-called "simple mode", where the kernel is loaded from `opt/org.limine-bootloader.kernel`, and, (if present), the background is loaded from `opt/org.limine-bootloader.background`.