NAME

       pibootctl-save - pibootctl manual

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  <https://en.wikipedia.org/wiki/Zip_(file_format)> 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.

AUTHOR

       Dave Jones

COPYRIGHT

       2019-2020 Dave Jones