2
1
Fork 0
mirror of https://git.savannah.gnu.org/git/gnuboot.git synced 2025-01-03 23:07:39 +01:00
gnuboot/site/docs/gnulinux/index.md
Denis 'GNUtoo' Carikli 0e3ff8047f
Announce and release GNU Boot 0.1 RC2 and project status.
The file adding the news is named gnuboot-december-2023.md instead of
gnuboot-0.1-rc1.md as the later is understood as a translation in the
'1-rc1' lang. Renaming the file to gnuboot-0.1-rc1.en.md instead makes
untitled detect the lang correctly but then it assumes this is a
translation and adds a broken link for "English" on the new page.

For now the older Libreboot news were kept as this shows the history
of the project and since GNU Boot is a continuation of the Libreboot
project it makes sense to also keep them.

The CSS also needed to be separated from the template because
otherwise the generated news page would be incomplete and miss all
what comes before the CSS like '<!DOCTYPE html>' for instance.

Finally x-reviewed was changed into x-unreviewed because we can't set
x-reviewed for the news, so the only way to remove the banner for the
individual news is to default to reviewed (and to mark all unreviewed
files as such).

As for the Untitled patch it is needed to make the news page work.

Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
Acked-by: Adrien 'neox' Bourmault <neox@gnu.org>
2023-12-09 16:01:23 +01:00

4.1 KiB


title: GNU+Linux guides x-unreviewed: true ...

This page is useful for those who wish to use the GNU GRUB payload directly. If you're using SeaBIOS, the boot process will work similarly to traditional BIOS systems; refer to the SeaBIOS documentation on https://seabios.org/SeaBIOS

GNU+Linux is the operating system of choice, for Libreboot development. It is highly recommended over any other operating system, precisely because it consists of Free Software (free as in freedom). There are other free operating systems, such as BSD, but most of the software in a typical GNU+Linux system is also copylefted. To learn more about the importance of copyleft, read this page on the GNU website: https://www.gnu.org/licenses/copyleft.html

Useful links

Refer to the following pages:

Guix, Parabola, Trisquel

These guides were outdated, so they were deleted. You can find links to them here: https://notabug.org/libreboot/lbwww/issues/4

The above issue page is the same as this entry on the TODO page: ../../tasks/#move-all-distro-fdeboot-guides-to-distro-wikimanuals

The Debian guide has been retained, because it's currently up to date. The Hyperbola guide is already on the Hyperbola website, and the above is just a link.

In general, it is recommended that you use SeaBIOS but if you want extra security, GRUB payload is recommended where you can then have a fully encrypted /boot directory.

TODO: Nuke all distro-specific guides on libreboot.srht.site. Instead, move these instructions to the wiki pages of these projects, on their websites. The reasons are explained in the above issue page.

Rebooting system in case of freeze

Linux kernel has a feature to do actions to the system any time, even with it freezes, this is called a Magic SysRq keys. You can do these actions with Alt + Sysrq + Command. These are the actions:

  • Alt + SysRq + B: Reboot the system
  • Alt + SysRq + I: Send SIGKILL to every process except PID 1
  • Alt + SysRq + O: Shut off the system

If some of them don't work, you have to enable it in the kernel command line paramter. So append sysrq_always_enabled=1 to your GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub

You can also run # sysctl kernel.sysrq=1 to enable them.

Fedora won't boot?

This may also apply to CentOS or Redhat. Chroot guide can be found on fedora website

linux16 issue

When you use Libreboot's default GRUB config, and libreboot's grub uses fedora's default grub.cfg (in /boot/grub2/grub.cfg), fedora by default makes use of the linux16 command, whereas it should be saying linux

Do this in fedora:

Open /etc/grub.d/10_linux

Set the sixteenbit variable to an empty string, then run:

grub2-mkconfig -o /boot/grub2/grub.cfg

BLS issue

With newer versions of fedora, scripts from grub package default to generating BLS instead of grub.cfg. To change that behaviour add following line to /etc/default/grub (or modify existing one if it already exists):

GRUB_ENABLE_BLSCFG=false

Then generate grub.cfg with:

grub2-mkconfig -o /boot/grub2/grub.cfg