Provided by: pibootctl_0.5.2-0ubuntu1_all 
NAME
pibootctl-status - pibootctl manual
SYNOPSIS
pibootctl status [-h] [-a] [--json | --yaml | --shell] [pattern]
DESCRIPTION
Output the current value of modified boot time settings that match the specified pattern (or all if no
pattern is provided). The --all option may be specified to output all boot settings regardless of
modification state.
OPTIONS
pattern
If specified, only displays settings with names that match the specified pattern which may include
shell globbing characters (e.g. *, ?, and simple [classes]).
-h, --help
Show a brief help page for the command.
-a, --all
Include all settings, regardless of modification, in the output. By default, only settings which
have been modified are included.
--json Use JSON as the output format.
--yaml Use YAML as the output format.
--shell
Use a var=value format suitable for the shell.
USAGE
By default, the status command only outputs boot time settings which have been modified:
$ pibootctl status
+-------------+-------+
| Name | Value |
|-------------+-------|
| i2c.enabled | on |
| spi.enabled | on |
+-------------+-------+
The full set of settings (which is usually several pages long, and thus will implicitly invoke the
system's pager) can be displayed with the --all option:
$ pibootctl status --all
+------------------------------+----------+--------------------------+
| Name | Modified | Value |
|------------------------------+----------+--------------------------|
...
| i2c.baud | | 100000 |
| i2c.enabled | x | on |
| i2s.enabled | | off |
| serial.baud | | 115200 |
| serial.clock | | 48000000 |
| serial.enabled | | on |
| serial.uart | | 0 (/dev/ttyAMA0; PL011) |
| spi.enabled | x | on |
| video.cec.enabled | | on |
...
Note that when --all is specified, a "Modified" column is included in the output to indicate which
settings are no longer default.
The list of settings can be further filtered by specified a pattern with the command. The pattern can
include any of the common shell wildcard characters:
• * for any number of any character
• ? for any single character
• [seq] for any character in seq
• [!seq] for any character not in seq
For example:
$ pibootctl status --all i2c.*
+-------------+----------+--------+
| Name | Modified | Value |
|-------------+----------+--------|
| i2c.baud | | 100000 |
| i2c.enabled | x | on |
+-------------+----------+--------+
For developers wishing to build on top of pibootctl, options are provided to produce the output in JSON
(--json), YAML (--yaml), and shell-friendly (--shell). These combine with all aforementioned options as
expected:
$ pibootctl status --json --all i2c.*
{"i2c.baud": 100000, "i2c.enabled": true}
AUTHOR
Dave Jones
COPYRIGHT
2019-2020 Dave Jones
0.5.2 Sep 14, 2020 PIBOOTCTL-STATUS(1)