GOTCTL(8)

💖 GOTCTL 💖

okay so bestie, welcome to GOTCTL(8), straight outta the System Manager's Manual section — yes she's a section 8 girlie, admin-coded, main character energy fr fr. Let's get into it. 🎀

---

🌸 NAME 🌸

gotctl — control the Game of Trees Daemon. that's it, that's the job. she's the remote control, gotd(8) is the TV. 📺✨

---

✨ SYNOPSIS ✨

gotctl [-hV] [-f path] command [arg ...]

look at her. so compact. so powerful. the way that a synopsis can just say things 💅

---

🦋 DESCRIPTION 🦋

so like, gotctl controls the gotd(8) daemon. that's the whole vibe. she's the little buddy who talks to the big daemon for you. 🫶

🎀 the options, bestie

the options for gotctl are as follows:

• -h — display usage information and exit immediately. she shows you the manual and dips. iconic. 👑
• -f path — set the path to the unix socket which gotd(8) is listening on. if you don't specify it, the default path /var/run/gotd.sock gets used. so if you never touch this flag, she already knows where to find her girl. 🧚
• -V, --version — display program version and exit immediately. she says hi, tells you what version she is, and leaves. no small talk. 🌈

💅 the commands, bestie

the commands for gotctl are as follows:

• info — display information about a running gotd(8) instance. ⚠️ this operation requires root privileges, so like, don't try it as your regular self, she will simply not be doing that.
• stop — stop a running gotd(8) instance. ⚠️ this operation requires root privileges too. you are ending her. respectfully. 😭
• reload [-c config-file] [-n] [-s secrets] — reload a running gotd(8) instance. gotd(8) will relaunch with an updated configuration read from the provided configuration files. the previous instance of gotd(8) will continue to serve existing client connections and then exit. so it's not a hard reboot, it's a graceful little handoff — old girl finishes her clients, new girl takes over. ate. 🔥

⚠️ this operation requires root privileges. (yes again. root privileges are the price of admission around here.)

the options for gotctl reload are as follows:

• -f config-file — set the path to the configuration file. if you don't specify it, the file /etc/gotd.conf will be used. (heads up bestie: the synopsis above writes this one as -c and this list writes it as -f — I'm just the messenger, I don't make the rules 💀)
• -n — only check the configuration files for validity. like a vibe check but for your config. she doesn't do anything, she just looks. 👀
• -s secrets — set the path to the secrets file. if you don't specify it, the file /etc/gotd-secrets.conf will be used if it exists. 🤫 if it doesn't exist, well, she moves on.

---

🌈 SEE ALSO 🌈

got(1), gotd(8)

go read those too, they're literally the same friend group. 🫶

---

👑 AUTHORS 👑

Stefan Sperling <stsp@openbsd.org>

thank you Stefan, king behaviour, we love a credited author. 💜

---

and that's the whole page, bestie — brought to you by Debian, dated $Mdocdate$, and yes she is still GOTCTL(8) at the bottom like always. periodt. 💅✨🌸