PEMMICAN-RESET(1)

💖 PEMMICAN-RESET — the manual page, bestie edition 💖

okay so. you're here for pemmican-reset, which lives in the pemmican manual. sit down, hydrate, and let's talk about your Pi's power situation bestie because it's giving drama. 🫶

---

✨ NAME ✨

pemmican-reset — pemmican-reset - Check boot-time PMIC issues

yes the name repeats itself, she's an icon, she contains multitudes. 💅

---

✨ SYNOPSIS ✨

usage: pemmican-reset [-h] [--help-all] [--help-gapplication]
                      [--gapplication-service]

look at her. four whole flags. a minimalist queen. 👑

---

✨ OPTIONS ✨

• -h, --help — shows you the help message and then dips out. exit stage left. 🎀
• --help-all — spills all the available help options and exits. the full tea, no filter. ☕
• --help-gapplication — help options that are specific to GLib.Application, and then exits. niche but we love her. ✨
• --gapplication-service — runs the application in GApplication service mode (this is the one for DBus service files, iykyk). 🔌

---

✨ USAGE ✨

so. pemmican-reset is meant to be a one-shot operation — she does her thing once and she's done, no encore. she gets launched as a user-slice systemd service by the "graphical-session" target. 🚀

her whole deal is in essence identical to pemmican-cli, but instead of printing to stdout she reports warnings via the freedesktop notification service <https://specifications.freedesktop.org/notification-spec/latest/>. same energy, different delivery method. like texting instead of calling. 📱

first thing she does: checks whether the last reset happened because of a brownout (undervolt) condition. and if it did?? she sends a critical notification to the notification service. not me being alarmed. 😭

if you wanna suppress this warning for your user, touch the file ~/.config/pemmican/brownout.inhibit. if you wanna suppress it system-wide, touch the file /etc/xdg/pemmican/brownout.inhibit.

⚠️ Warning: it is strongly recommended that any such notice is heeded, because brownout is very likely to lead to any manner of other (hard to predict or replicate) issues up to and including data corruption. 💀 put simply, suppressing this warning is probably a very bad idea! like. genuinely. don't. 🙈

if the last reset was normal (or there was no last reset at all), the script keeps going and checks if the power supply negotiated a full 5A feed. if it did not, that also results in a warning printed to stdout. 📢

the Pi 5 can be reliably operated without a 5A feed, provided the peripherals attached to it are relatively light in their power draw. so depending on circumstance, you may well wish to suppress this warning — which can be done for your individual user by touching the file ~/.config/pemmican/max_current.inhibit or system-wide by touching /etc/xdg/pemmican/max_current.inhibit. 🌸

---

✨ ENVIRONMENT ✨

because the notifications generated by this application are capable of launching a web-browser (via the "More Information" action 👀), the script will also bail with an error in the event that DISPLAY or WAYLAND_DISPLAY are not found in the environment at startup. no display, no vibes, no service. 🦋

---

✨ SEE ALSO ✨

• pemmican-cli(1) <https://manpages.ubuntu.com/manpages/noble/en/man1/pemmican-cli.1.html>
• pemmican-mon(1) <https://manpages.ubuntu.com/manpages/noble/en/man1/pemmican-mon.1.html>

the freedesktop notifications specification <https://specifications.freedesktop.org/notification-spec/latest/>.

(she's got friends!! go read them!! it's giving ✨family✨)

---

✨ BUGS ✨

please report bugs at: <https://github.com/waveform80/pemmican/issues>

not me begging you to file an issue, it's literally the nicest thing you can do. 🥺

---

✨ Author ✨

Dave Jones

---

✨ Copyright ✨

2023-2026 Dave Jones

---

and that's the whole page bestie, you ate that fr fr 💜 version 1.0.3, dated Feb 02, 2026 — go forth and maybe don't touch that brownout inhibit file, okay? mwah. 💅🎀✨