Skip to content

Wii-Linux/gumboot-utils

Repository files navigation

Wii Linux Gumboot Utilities

This repository contains multiple utilities for the Wii Linux bootloader, known as Gumboot.
These utilities try to mirror similarly named utilities by GRUB, the standard bootloader for x86-based Linux PCs.

The utilities included in this package are as follows.

gumboot-mkconfig

A clone of GNU GRUB's grub-mkconfig. It takes the same1 arguments, and behaves in the same way.
It generates a gumboot.lst based on the config options specified in /etc/default/gumboot, and /etc/gumboot.d.

If no arguments are passed, it will print the config to stdout, and log messages to stderr. If you pass -o, it will write to the file path that follows.

update-gumboot

A clone of Debian's update-grub helper script.
It makes it possible to update your Gumboot config file without needing to memorize the path, or the command line arguments.
Instead, you can simply run update-gumboot as root, and it handles everything.

gumboot-install

A clone of GNU GRUB's grub-install. It takes a few of the same1 arguments, and should generally behave in a similar way.
It takes an install path, which is a critical difference from GRUB's version, which instead takes an install device.
If you accidentally pass gumboot-install a block device, it will print a warning, and attempt to figure out where you really wanted to install to.
It will do this by searching your mounted filesystems for the block device that you've provided.
If found, it will install to the path where the block device is mounted.

Note that gumboot-install will install Gumboot, as well as it's associated fork of MINI directly.
It will overwrite any existing gumboot/gumboot.elf, bootmii/armboot.bin, and bootmii/gui.elf It will not update bootmii/ppcboot.elf.

Note as well that gumboot-install, like grub-install, does not generate a configuration file.

Installation / Building

This doesn't really need to be built, since it's all shell scripts.
However, it does need to downlad important binaries for Gumboot and BootMii.
You can do that with make download, or simply make.

After downloaded, you can install to a directory of choice with make install.
By default it'll install to [pwd]/install, but this can be overriden with the DESTDIR parameter.
For example: make install DESTDIR=/ to install to the local rootfs.

Notes

Footnotes

  1. Long options (e.g. --output=/some_file.cfg) are not supported due to limitations of the builtin getopt in POSIX sh. 2

About

Utilities for the Wii Linux bootloader, Gumboot

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published