PIBOOTCTL-LIST(1)

💖 PIBOOTCTL-LIST 💖

okay bestie, gather round, because this is the pibootctl manual and we're about to get into the list subcommand. it's giving ✨ organized ✨ and honestly? you're gonna love it.

---

✨ SYNOPSIS ✨

pibootctl list [-h] [--json | --yaml | --shell]

---

🌸 DESCRIPTION 🌸

List all stored boot configurations. that's it. that's the whole job. slay. 💅

---

🎀 OPTIONS 🎀

• -h, --help — shows you a brief help page for the command, for when you need a lil refresher 🫶
• --json — use JSON as the output format.
• --yaml — use YAML as the output format.
• --shell — use a tab-delimited output format suitable for the shell.

---

🦋 USAGE 🦋

so the list command is what you use to display the content of the store of boot configurations, like this:

$ pibootctl list
+---------+--------+---------------------+
| 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 |
| gpi     |        | 2020-02-01 16:13:02 |
+---------+--------+---------------------+

if one (or more) of the stored configurations match the current boot configuration, that gets flagged in the "Active" column. but wait — and this is the part everyone gets wrong, so listen up 👑 — equivalence is based on a hash of all files in the configuration, not on the resulting settings. so like, a simple edit? even something as tiny as reversing the order of two lines, which might not make any difference at all to the resulting settings? yeah, that alone is enough to mark the configuration as "different". fr fr. 😭

the "timestamp" of a stored configuration is the last modification date of that configuration — and that's calculated as the latest modification date of all files within the configuration. so it's the newest mtime of the bunch. 💖

---

🧚 FOR THE DEVS 🧚

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 — no surprises, just vibes:

$ pibootctl list --json
[{"timestamp": "2020-02-01T15:46:48", "active": false, "name": "dpi"},
{"timestamp": "2020-03-10T11:32:12", "active": false, "name": "default"},
{"timestamp": "2020-02-01T16:13:02", "active": false, "name": "gpi"},
{"timestamp": "2020-03-10T11:33:24", "active": true, "name": "720p"}]

---

🌈 AUTHOR 🌈

Dave Jones 💜

🍓 COPYRIGHT 🍓

2019-2020 Dave Jones

---

and that's the whole page, bestie. go forth and list your boot configs with main character energy. periodt. ✨

version 0.5.2, dated Sep 14, 2020 — pibootctl girlies rise up 🎀🦋💅