Overlay containing various utility ebuilds for Gentoo on EFI.
Required for the tutorial "Sakaki's EFI Install Guide" on the Gentoo wiki.
- app-portage/showem source
- Provides a simple utility script (showem(1)), which enables you to monitor the progress of a parallel emerge(1). A manpage is included.
- sys-kernel/buildkernel source
- Provides a script (buildkernel(8)) to build a (stub EFI) kernel (with integral initramfs) suitable for booting from a USB key on UEFI BIOS PCs. Automatically sets the necessary kernel configuration parameters, including the command line, and signs the resulting kernel if possible (for secure boot). Has a interactive and non-interactive (batch) mode. Manpages for the script and its configuration file (/etc/buildkernel.conf) are included.
- app-portage/genup source
- Provides the genup(8) script, to simplify the process of keeping your Gentoo system up-to-date. genup(8) can automatically update the Portage tree, all installed packages, and kernel. Has interactive and non-interactive (batch) modes. A manpage is included.
- app-crypt/efitools
- This package provides various useful tools for manipulating the EFI secure boot variables. However, at the time of writing, the latest version available on Gentoo (1.4.2-r1) does not yet reflect a change made upstream which is necessary to allow proper operation with LVM under Gentoo. The ebuild supplied here (1.4.2-r2) is identical to the standard version (1.4.2-r1), except that it additionally applies a patch to bring version 1.4.2-r1 in line with upstream. It will be removed from the sakaki-tools repository when the official Gentoo repository version bumps.
- app-crypt/staticgpg
- A simple ebuild, derived from app-crypt/gnupg version 1.4.16, which creates a statically linked, no-pinentry version of gpg(1) suitable for use in an initramfs context. It can safely be installed beside a standard 2.x version of app-crypt/gnupg (which isn't SLOTted). Deploys its executable to /usr/bin/staticgpg. A placeholder manpage is included.
As of version >= 2.2.16 of Portage, sakaki-tools is best installed (on Gentoo) via the new plug-in sync system. Full instructions are provided on the Gentoo wiki.
The following are short form instructions. If you haven't already installed git(1), do so first:
# emerge --ask --verbose dev-vcs/git
Next, create a custom /etc/portage/repos.conf
entry for the sakaki-tools overlay, so Portage knows what to do. Make sure that /etc/portage/repos.conf
exists, and is a directory. Then, fire up your favourite editor:
# nano -w /etc/portage/repos.conf/sakaki-tools.conf
and put the following text in the file:
[sakaki-tools]
# Various utility ebuilds for Gentoo on EFI
# Maintainer: sakaki ([email protected])
location = /usr/local/portage/sakaki-tools
sync-type = git
sync-uri = https://github.com/sakaki-/sakaki-tools.git
priority = 50
auto-sync = yes
Then run:
# emaint sync --repo sakaki-tools
If you are running on the stable branch by default, allow ~amd64 keyword files from this repository. Make sure that /etc/portage/package.accept_keywords
exists, and is a directory. Then issue:
# echo "*/*::sakaki-tools ~amd64" >> /etc/portage/package.accept_keywords/sakaki-tools-repo
Now you can install packages from the overlay. For example:
# emerge --ask --verbose app-portage/genup