PIBOOTCTL-SAVE(1)

✨ PIBOOTCTL-SAVE(1) ✨

okay bestie, welcome to the pibootctl-save page — it's part of the pibootctl manual, and it's literally the "save my whole boot vibe" command 💾💖

---

🌸 NAME 🌸

pibootctl-save — the pibootctl manual, bestie. that's the whole name. short, sweet, iconic 👑

---

🦋 SYNOPSIS 🦋

pibootctl save [-h] [-f] name

that's it. that's the whole summoning ritual ✨

---

💜 DESCRIPTION 💜

so what does it do?? it stores the current boot configuration under a given name. like, a little snapshot of your boot setup, labeled and tucked away. main character archival energy, fr fr 🎀

---

💅 OPTIONS 💅

• name — the name you're saving the current boot configuration under 🏷️. it can include any characters legal in a filename — go wild, just, like, legally 🫶
• -h, --help — shows a brief help page for the command 🙈. your little "wait what does this do again" safety net.
• -f, --force — overwrites an existing configuration, if one exists 💀. this is the "yes I'm sure, I said what I said" flag.

---

🌈 USAGE 🌈

okay so the save command is how you take a backup of the current boot configuration 🛟. in practice?? it creates a PKZIP archive (yes, the zip file format — https://en.wikipedia.org/wiki/Zip_(file_format)) of all the files that make up your boot configuration (config.txt et al. — you know the crew), and it drops that archive under the configured directory on the boot partition, which is usually pibootctl ✨

here's the vibe check, live:

$ ls /boot/pibootctl
$ sudo pibootctl save foo
$ ls /boot/pibootctl
foo.zip

see how foo became foo.zip?? ate that 🍓

---

now, important: by default you CANNOT overwrite saved configurations 🚫. no sneaky replacements, no cap. but you can override that with the --force option:

$ sudo pibootctl save foo
[Errno 17] File exists: 'foo.zip'
$ sudo pibootctl save -f foo

there it is — the error said no, and -f said "actually, yes" 💅

---

and listen, the whole POINT of this: if your system ever gets 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, just so you know what you're agreeing to 🫶. alternatively you can use the load command, if the system can actually boot. and the list command will show you all the currently stored configurations, like a lil roster of your backups 📋✨

---

👑 AUTHOR 👑

Dave Jones — the icon who made this happen 🌟

---

🎀 COPYRIGHT 🎀

2019-2020 Dave Jones — periodt 💖

---

and that's the whole page, bestie!! this was pibootctl-save, version 0.5.2, dated Sep 14, 2020 🌸 go save something, you've got this 🦋💖✨