rename

Synopsis

pibootctl rename [-h] [-f] name to

Description

Rename a stored boot configuration.

Options

name

The name of the boot configuration to rename.

to

The new name of the boot configuration.

-h, --help

Show a brief help page for the command.

-f, --force

Overwrite the target configuration, if it exists.

Usage

The rename command can be used to change the name of a stored boot configuration:

$ pibootctl ls
+---------+--------+---------------------+
| Name    | Active | Timestamp           |
|---------+--------+---------------------|
| 720p    | x      | 2020-03-10 11:33:24 |
| default |        | 2020-03-10 11:32:12 |
| dpi     |        | 2020-02-01 15:46:48 |
+---------+--------+---------------------+
$ sudo pibootctl rename default foo
$ pibootctl ls
+------+--------+---------------------+
| Name | Active | Timestamp           |
|------+--------+---------------------|
| 720p | x      | 2020-03-10 11:33:24 |
| dpi  |        | 2020-02-01 15:46:48 |
| foo  |        | 2020-03-10 11:32:12 |
+------+--------+---------------------+

As with save, any characters permitted in a filename are permitted in the new destination name.

If you wish to rename a configuration such that it overwrites an existing configuration you will need to use the --force option:

$ sudo pibootctl load default
$ sudo pibootctl save foo
$ pibootctl ls
+---------+--------+---------------------+
| Name    | Active | Timestamp           |
|---------+--------+---------------------|
| 720p    |        | 2020-03-10 11:33:24 |
| default | x      | 2020-03-10 11:32:12 |
| dpi     |        | 2020-02-01 15:46:48 |
| foo     | x      | 2020-03-10 11:32:12 |
+---------+--------+---------------------+
$ sudo pibootctl mv foo default
[Errno 17] File exists: 'default.zip'
$ sudo pibootctl mv -f foo default