save

Synopsis

pibootctl save [-h] [-f] name

Description

Store the current boot configuration under a given name.

Options

name

The name to save the current boot configuration under; can include any characters legal in a filename

-h, --help

Show a brief help page for the command.

-f, --force

Overwrite an existing configuration, if one exists

Usage

The save command is used to take a backup of the current boot configuration. In practice this creates a PKZIP of the files that make up the boot configuration (config.txt et al.), and places it under the configured directory on the boot partition (usually pibootctl):

$ ls /boot/pibootctl
$ sudo pibootctl save foo
$ ls /boot/pibootctl
foo.zip

Note that by default, you cannot overwrite saved configurations, but this can be overridden with the --force option:

$ sudo pibootctl save foo
[Errno 17] File exists: 'foo.zip'
$ sudo pibootctl save -f foo

In the event that your system is rendered un-bootable, a boot configuration can be easily restored by extracting the PKZIP of a saved configuration into the boot partition (over-writing files as necessary). Alternatively you can use the load command (if the system can boot). The list command can be used to display all currently stored configurations.