dbshell(1)

💅 dbshell — HiPerConTracer Database Shell

okay bestie, welcome to the dbshell(1) page from the General Commands Manual 🫶 this is the whole vibe, no skips, no cap.

---

✨ NAME ✨

dbshell — HiPerConTracer Database Shell 🦋

---

🌸 SYNOPSIS 🌸

dbshell database_configuration [-d | --dry-run]
        [-B file_prefix | --write-dbeaver-config file_prefix]
        [-q | --quiet] [-w | --verbose]
dbshell [-h | --help]
dbshell [-v | --version]

---

💖 DESCRIPTION 💖

so dbshell is literally just a lil script that opens up a database shell for you, and it figures out how to do that from the settings in a database configuration file you hand it. that's it. that's the whole job. iconic, honestly. 💅

it's mostly meant for testing database access using the config files that belong to HPCT Importer and HPCT Query Tool. so like, vibe check for your db creds, basically. 🎀

---

🍓 ARGUMENTS 🍓

here's everything you can pass it, one by one:

• database_configuration — this sets the name of the database configuration file. yeah that's the one, the file you want it to read. 📄
• -d | --dry-run — it just shows you the command-line call it would use to start the database shell, but it does not actually run it. like window shopping but for commands. no commitment. ✨
• -B file_prefix | --write-dbeaver-config file_prefix — writes out DBeaver configuration files using the file name prefix you give it — that's both the configuration file itself and a credentials file. two for one, slay. 🦋
• -q | --quiet — turns off status output. silence. peace. 🤫
• -w | --verbose — turns on status output. tell me everything, bestie. 🗣️
• -h | --help — prints command help. 🫶
• -v | --version — prints program version. 👑

---

🔥 EXIT STATUS 🔥

dbshell exits with 0 when everything went fine, and >0 if there was an error. so 0 = we ate, anything bigger = it's giving problem. 😭

---

🌈 EXAMPLES 🌈

run it with the importer config:

dbshell hipercontracer-importer.conf

run it with the database config, but keep it quiet:

dbshell hipercontracer-database.conf -q

just show the call, don't run anything:

dbshell hipercontracer-importer.conf -d

same energy, long flag version:

dbshell hipercontracer-database.conf --dry-run

dry run AND quiet AND write the DBeaver configs, all at once — main character behavior:

dbshell hipercontracer-database.conf --dry-run -q -B dbeaver-config

---

💜 NOTES 💜

this program is part of HiPerConTracer. you can find the latest version of HiPerConTracer on the HiPerConTracer Homepage at:

HiPerConTracer Homepage: https://www.nntb.no/~dreibh/hipercontracer/

---

🎀 AUTHORS 🎀

Thomas Dreibh, Homepage: https://www.nntb.no/~dreibh

---

fr fr that's the whole page, nothing skipped, every flag accounted for 💖

and that's a wrap on the dbshell page from the General Commands Manual — shoutout to the source at version dated May 26, 2026, tysm for coming to my ted talk, mwah 💅✨