byronsanchez / sakaki-tools

Overlay containing various utility ebuilds for Gentoo on EFI.

sakaki-tools Gentoo Overlay

Overlay containing various utility ebuilds for Gentoo on EFI.

Required for the tutorial "Sakaki's EFI Install Guide" on the Gentoo wiki.

List of ebuilds

• 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.

Installation

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

Maintainers

• sakaki