load

Synopsis

pibootctl load [-h] [--no-backup] name

Description

Overwrite the current boot configuration with a stored one.

Options

name

The name of the boot configuration to restore

-h, --help

Show a brief help page for the command.

--no-backup

Don’t take an automatic backup of the current boot configuration if one doesn’t exist

Usage

The load command is used to replace the current boot configuration with one previously stored. Effectively this simply unpacks the PKZIP of the stored boot configuration into the boot partition, overwriting existing files.

If the current boot configuration has not been stored (with the save command), an automatically named backup will be saved first:

$ sudo pibootctl save default
$ sudo pibootctl set video.hdmi0.group=1 video.hdmi0.mode=4
$ sudo pibootctl load default
Backed up current configuration in backup-20200310-095646

This can be avoided with the --no-backup option.

Warning

The command is written to guarantee that no files will ever be left half-written (files are unpacked to a temporary filename then atomically moved into their final location overwriting any existing file).

However, the utility cannot guarantee that in the event of an error, the configuration as a whole is not half-written (i.e. that one or more files failed to unpack). In other words, in the event of failure you cannot assume that the boot configuration is consistent.