libreboot / lbwww (public) (License: Unspecified) (since 2023-04-11) (hash sha1)
libreboot website (markdown files). https://libreboot.org/
Clone URLs: https://rocketgit.com/user/libreboot/lbwww ssh://rocketgit@ssh.rocketgit.com/user/libreboot/lbwww git://git.rocketgit.com/user/libreboot/lbwww
25.04 master
List of commits:
Subject Hash Author Date (UTC)
grub payload warning 040249ca742becbbbf9f3cd4cf4e6e7a0ac1ff9e Leah Rowe 2024-05-27 11:02:37
put cc0 on site.cfg 1ea2893e03bb863485bdd3edb39f01af5de589cc Leah Rowe 2024-05-27 07:42:55
update docs/maintain/ b2b2b7a95698b1591b3fa945a27aefdca60f82eb Leah Rowe 2024-05-26 14:39:50
add missing parenthese 91e4e3974aece4a24d142c1300b3d43cceacb60e sertonix 2024-05-23 18:30:45
docs/install/e6400.md: Make note of 1440x900 panel errata 222db52b57487cf1ae0503c814132c9314f091d3 Nicholas Chin 2024-05-20 17:13:07
follow-up c1c9a60e67c73d56986c40c9e0af3ce0769d3b11 Leah Rowe 2024-05-13 17:04:02
docs/hardware/dell9029: Internal Flashing is possible with original BIOS 10b6ca1f638f1d131a8c286a64fe5850b2a34a74 Ben Westover 2024-05-13 03:55:53
reddit 0a66ed0e2222040985ef0e842b6caf0c46435631 Leah Rowe 2024-05-12 19:27:23
further context 6520f681fa9e0c3db689dd53f992fbad2b275a42 Leah Rowe 2024-05-12 18:54:14
sex it up a bit 8c407d05c99a28dc3de78e4cb579fba76cf6f0fd Leah Rowe 2024-05-12 18:23:50
purists 0fb8d5d75719d4197368370942b2bac7693e6b7f Leah Rowe 2024-05-12 18:14:49
intent 061f47fd3a22b290b6f34c049938669b1bcd357f Leah Rowe 2024-05-12 18:08:52
context 8451f94036815c7ac023e5aa04a3c27b5c429b06 Leah Rowe 2024-05-12 18:07:36
actually add the canoegnu page a02fe843e6197324a316fde694a7792f65e50edc Leah Rowe 2024-05-12 18:04:40
canoegnu f671d8929475c0cce6a869e4cdff578d7b5f1a66 Leah Rowe 2024-05-12 18:02:58
updates 5d5ed3b930ef76310683b95ec7f26f9a5d48bc13 Leah Rowe 2024-05-10 04:04:10
purge remaining stragglers cb8dbd0f386b5b0a892ff05fdc03481708160e3c Leah Rowe 2024-05-07 18:44:53
extreme ditto 96e51ca06ed3cca057cc2d9aaa0c3f9de1cf9fc8 Leah Rowe 2024-05-07 16:38:45
extremely ditto 83de07b6033250c5c113fd172badb0216e88ded1 Leah Rowe 2024-05-07 16:25:34
don't promote canoeboot in release 4f992eedaa5fedb8caa3429e003e3b6da6471e5a Leah Rowe 2024-05-07 16:19:49
Commit 040249ca742becbbbf9f3cd4cf4e6e7a0ac1ff9e - grub payload warning
Signed-off-by: Leah Rowe <info@minifree.org>
Author: Leah Rowe
Author date (UTC): 2024-05-27 11:02
Committer name: Leah Rowe
Committer date (UTC): 2024-05-27 11:02
Parent(s): 1ea2893e03bb863485bdd3edb39f01af5de589cc
Signer:
Signing key:
Signing status: N
Tree: 91cd6c19cfe7c8a3ccd75390852fc1f79504d5ff
File Lines added Lines deleted
site/docs/install/index.md 42 36
File site/docs/install/index.md changed (mode: 100644) (index 1a98f70..0c4dff2)
... ... title: Installation instructions
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 **GRUB payload warning**
7 ====================
8
9 Firstly, it should be stated: in almost all cases, GRUB works just fine, on
10 all of the machines that we test, but as of 26 May 2024 we got the error
11 report:
12
13 See: <https://codeberg.org/libreboot/lbmk/issues/216>
14
15 Although we've only seen this thus far (as per user reports) on Intel
16 SandyBridge based Dell Latitude laptops, we advise:
17
18 **DO NOT use a ROM image where GRUB is the first payload. If you want to
19 use the GRUB payload, please use a ROM image with `seabios_` at the start
20 of the file name. Avoid images with `grub_` at the start of the file name.**
21
22 ROM images with `grubonly` in them should also be avoided; if you want GRUB
23 to be the first thing you see (without interruption), use a ROM image
24 with `seabios_` at the start of the file name, and `grubfirst` at the end;
25 these place a bootorder file in CBFS, so that SeaBIOS loads GRUB first, but
26 you can still press ESC to bring up the SeaBIOS boot select menu.
27
28 The error above, in the linked bug report, occurs on `grub_free()`
29 or `grub_realloc()` and could be caused by anything in GRUB; the user tested
30 on memtest86plus and got no errors, and SeaBIOS works; BIOS GRUB (from a distro)
31 also works, where GRUB doesn't need as many drivers; we suspect this may be
32 a use-after-free in a GRUB driver, or otherwise something writing to heap memory
33 wrongly. The bug is not yet known, only the symptom (the fatal error message).
34
35 Libreboot releases after 20240504 will *only* (on x86) contain ROM images where
36 SeaBIOS is the first payload, without disabling the SeaBIOS menu (no `grubonly`). You'll still be able to use GRUB, either by pressing ESC for the boot
37 select menu, and/or using an image with `grubfirst` in the file name so that
38 SeaBIOS loads it first (while still permitting boot select via ESC keypress).
39
40 GRUB's code is vast, and complicated, so this policy change is permanent,
41 until GRUB can be well-audited (likely forked, with dead/legacy code removed).
42 SeaBIOS code is much smaller and more robust. Remember always: code equals bugs.
43
6 44 Need help? Need help?
7 45 ========== ==========
8 46
 
... ... an option in the boot menu.
199 237 ROM images that have `seabios_withgrub` in the file name start with SeaBIOS ROM images that have `seabios_withgrub` in the file name start with SeaBIOS
200 238 first, but also have GRUB available in the boot menu when you press ESC. first, but also have GRUB available in the boot menu when you press ESC.
201 239
202 ### seabios\_grubfirst (DEFUNCT)
203
204 **DEFUNCT**
205
206 This build option is obsolete, and should not be used. It was deleted
207 in lbmk revision `e1bbdadc9584291cf062660d67128e9f17ab788e`.
208
209 It was believed, in earlier theory, that VGA ROM initialisation could
210 be used in SeaBIOS and then SeaBIOS boots into a GRUB payload (built
211 for coreboot), where the initialisation would continue to be used, but
212 it didn't work that way.
213
214 It's best to use PC GRUB (normal BIOS GRUB), but compile it into a floppy
215 image to insert inside CBFS, to then be executed by SeaBIOS. This is referred
216 to as SeaGRUB by the Libreboot project, and it would be quite useful
217 for desktop users, but it's largely irrelevant on laptops where
218 coreboot's own `libgfxinit` is usually available (or the option ROM is
219 easy to extract from vendor firmware and insert).
220
221 Where direct bare metal GRUB is desired, but you use a desktop system with
222 an add-on graphics card, you must extract the VGA ROM for your card and
223 insert it into the coreboot ROM, for coreboot itself to execute. This will
224 require custom configuration on your part, and it is thus beyond the scope
225 of the Libreboot project, in context of lbmk (automated build system).
226
227 Some older Libreboot releases included ROM images built using this option,
228 and those specific ROM images (`seabios_grubfirst` ones) should not be
229 used; you should only use `seabios_grubfirst` or `seabios`, in most
230 scenarios, if SeaBIOS is required.
231
232 For most desktop users, if running an external graphics card, it's easier
233 to simply boot in text mode with a SeaBIOS payload and use only that. This
234 will Just Work with almost all graphics cards, allowing you to use an
235 operating system with a full display and (drivers permitting) full 2D/3D
236 acceleration.
240 ROM images with this and `grubonly` in the image start SeaBIOS, but only load
241 GRUB from SeaBIOS and the SeaBIOS menu is disabled. Use these images if you
242 only want GRUB; they are provided on systems that only have VGA ROM-based
243 initialisation, usually discrete graphics cards on desktop machines.
237 244
238 245 Which systems are supported? Which systems are supported?
239 246 ============================ ============================
240 247
241 248 [Refer to the hardware compatibility page](../hardware/) [Refer to the hardware compatibility page](../hardware/)
242 249
243 Sandy/Ivybridge/Haswell MAC address (e.g. X230, X220, T440p, W541, hp8200sff)
244 250 Intel GbE MAC address (IFD-based systems) Intel GbE MAC address (IFD-based systems)
245 251 ===================================================================== =====================================================================
246 252
Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/libreboot/lbwww

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/libreboot/lbwww

Clone this repository using git:
git clone git://git.rocketgit.com/user/libreboot/lbwww

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main