Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/RobertCsordas/arch-efiboot
Boot EFISTUB linux kernels on UEFI systems not supporting kernel command line
https://github.com/RobertCsordas/arch-efiboot
arch-linux bootloader linux linux-kernel uefi-boot xps13 xps15
Last synced: 15 days ago
JSON representation
Boot EFISTUB linux kernels on UEFI systems not supporting kernel command line
- Host: GitHub
- URL: https://github.com/RobertCsordas/arch-efiboot
- Owner: RobertCsordas
- Created: 2019-01-02T20:30:56.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-11-22T10:29:48.000Z (almost 2 years ago)
- Last Synced: 2024-08-01T03:14:02.413Z (3 months ago)
- Topics: arch-linux, bootloader, linux, linux-kernel, uefi-boot, xps13, xps15
- Language: Shell
- Size: 6.84 KB
- Stars: 40
- Watchers: 6
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- stars - RobertCsordas/arch-efiboot
README
# EFI-bootable kernel image builder for Arch Linux
Linux supports EFISTUB booting, where the UEFI can load the kernel directly without any bootloader. This can be done by setting up the boot entries with efibootmgr command (https://wiki.archlinux.org/index.php/EFISTUB). The problem is that **some systems (like Dell XPS laptops) doesn't support passing kernel command line arguments**. This results in failing to boot.
This script builds single-file bootable efi modules, which includes the kernel, command line strings, initramfs and microcode.
EFISTUB booting should not have any negative consequences to anything (hibernation, power management, etc). For my Dell XPS 9560, everything works just fine.
## How it works
Objcopy can be used to merge all the files in single bootable image. See https://wiki.archlinux.org/index.php/systemd-boot, section "Preparing kernels for /EFI/Linux" for more details. You *do not* have to use systemd-boot for this to work.
If you have multiple initrds (ucode and initramfs), then you have to concatenate them to a single file before embedding.
The problem remaining is that this manually builds the kernel, but does not run if you update. Here is where the pacman hooks come handy. It is possible to set up hooks for updating the kernels or the microcode and run the build script automatically (see kernel-update.hook).
## How to install
### AUR
*Note: this method is only suited for systems with EFI partition mounted as /boot (as recommended in https://wiki.archlinux.org/index.php/EFI_system_partition) and with kernels installed there. For other setups, see [manual installation instructions](#manual-installation).*
Install the [AUR package](https://aur.archlinux.org/packages/arch-efiboot/).
### Manual installation
[Download the repository](https://github.com/xdever/arch-efiboot/archive/master.zip) onto your system.
If your EFI partition is mounted as /boot and your kernels are installed there, run
```
sudo install.sh
```
If not, please edit build_kernel.sh and install it manually. You can do it by running
```
cp build_kernel.sh to /opt
mkdir -p /etc/pacman.d/hooks/
cp kernel-update.hook /etc/pacman.d/hooks
```
## EFI boot entries
When completed, you can use efibootmgr to setup the boot item, or your BIOS settings might have an option to chose the file from the ESP partition (as with Dell XPS 9560). It works either way.
## Custom command line parameters
By default, when you run the script, it extract your current kernel command line to /boot/cmdline.txt. Change it and rerun to include the new paramters. If the file exists, it will *not* overwrite it.
It is also possible to have different command lines for different kernels. You can do this by placing cmdline-.txt in your /boot folder, where the is the part after "vmlinuz-" of your kernel. For example for vmlinuz-linux it is cmdline-linux.txt, for vmlinuz-linux-lts it is cmdline-linux-lts.txt.