PIBOOTCTL-GET(1) pibootctl PIBOOTCTL-GET(1)

pibootctl-get - pibootctl manual

pibootctl get [-h] [--json | --yaml | --shell] setting [setting ...]


Query the status of one or more boot configuration settings. If a single setting is requested then just that value is output. If multiple values are requested then both setting names and values are output. This applies whether output is in the default, JSON, YAML, or shell-friendly styles.

The name(s) of the setting(s) to query; if a single setting is given its value alone is output, if multiple settings are queried the names and values of the settings are output.

Show a brief help page for the command.

Use JSON as the output format.

Use YAML as the output format.

Use a var=value output format suitable for the shell.

The get command is primarily of use to those wishing to build something on top of pibootctl; for end users wishing to query the current boot configuration the status command is of more use. When given a single setting to query the value of that setting is output on its own, in whatever output style is selected:

$ pibootctl get video.overscan.enabled
on
$ pibootctl get --json video.overscan.enabled
true


When given multiple settings, names and values of those settings are both output:

$ pibootctl get serial.enabled serial.baud serial.uart
+----------------+-------------------------+
| Name           | Value                   |
|----------------+-------------------------|
| serial.baud    | 115200                  |
| serial.enabled | on                      |
| serial.uart    | 0 (/dev/ttyAMA0; PL011) |
+----------------+-------------------------+
$ pibootctl get --json serial.enabled serial.baud serial.uart
{"serial.enabled": true, "serial.baud": 115200, "serial.uart": 0}


Note that wildcards are not permitted with this command, unlike with the status command.

Dave Jones

2019-2020 Dave Jones

September 14, 2020 0.5.2