BALBOA-BACKEND-CONSOLE(1)

💅 BALBOA-BACKEND-CONSOLE 💅

okay bestie, pull up a chair — this is balboa-backend-console, section 1 of the manual (User Commands, if you're keeping track 🎀). she's the backend maintenance console for balboa, and she's here to help you poke at your balboa-backends without losing your mind. let's get into it. ✨

---

🌸 NAME 🌸

balboa-backend-console — the backend maintenance console for balboa, periodt 💖

---

✨ SYNOPSIS ✨

balboa-backend-console <--version|help|jsonize|dump|replay> [options]

like… pick a command, add some options, go off. that's the whole vibe. 🦋

---

👑 DESCRIPTION 👑

balboa-backend-console is a management tool for balboa-backends. she's the one you call when you need to look at things, dump things, replay things, or ask the database a lil question. no cap. 💅

🫶 Command help:

show help. that's it. that's the command. ask and you shall receive. 💖

🍓 Command jsonize:

read a dump file and print all entries as json. gorgeous, immaculate, chef's kiss. ✨

• -d <path> — path to the dump file to read

🔥 Command dump:

connect to a balboa-backend and request a dump of all data to local stdout. big "give me everything" energy, and honestly? valid. 👑

• -h <host> — ip address of the balboa-backend (default: 127.0.0.1)
• -p <port> — port of the balboa-backend (default: 4242)
• -v — increase verbosity; can be passed multiple times (stack 'em like scrunchies, bestie 💜)
• -d <remote-dump-path> — unused/ignored (default: -) 😭 like she's literally just sitting there, ignored, but she's still in the docs so we still list her

🌈 Command query:

execute a query against the database. main character energy fr fr. 🧚

• -h <host> — ip address of the balboa-backend (default: 127.0.0.1)
• -p <port> — port of the balboa-backend (default: 4242)
• -r <rrname> — rrname to query for
• -d <rdata> — rdata to query for
• -s <sensorid> — sensorid to filter by
• -l <limit> — maximum number of results (default: 100)
• -v — increase verbosity; can be passed multiple times

⭐ Command replay:

replay a previously generated database dump. the way she just… runs it back? iconic. 🎀

• -d <path> — database dump file or - for stdin (default: -)
• -h <host> — ip address of the balboa-backend (default: 127.0.0.1)
• -p <port> — port of the balboa-backend (default: 4242)
• -v — increase verbosity; can be passed multiple times

---

🦋 EXAMPLES 🦋

here's the example exactly as the page lays it out, no edits from me, bestie — I'm just holding the mirror 💖:

balboa-backend-console jsonize -r /tmp/pdns.dmp lz4cat /tmp/pdns.dmp.lz4
| balboa-backend-console jsonize

---

lowkey a whole toolkit, highkey a vibe check. go dump something, go query something, go be the main character of your own backend. 💅✨

---

and that's the page, babes — this is balboa-backend-console v2.0.0, dated March 2026, and honestly? she ate. 🫶 no cap, fr fr. go forth and maintain those backends. 💖🎀🌸