socklog-check(8)

💖 socklog-check(8) 💖

okay bestie, welcome to socklog-check, a little page from the System Manager's Manual. she's small, she's mighty, and she's literally just here to answer one question: is socklog even up rn??? 🦋

---

✨ NAME ✨

socklog-check — checks for the availability of a socklog(8) service.

---

🌸 SYNOPSIS 🌸

socklog-check [-v] [unix [address]]

---

🎀 DESCRIPTION 🎀

so here's the tea: socklog-check tries to connect to a socklog(8) unix service, and then it reports back whether that connection attempt succeeded or didn't. that's the whole job. she's not complicated, she's just reliable 💅

she connects to the datagram oriented unix domain socket address, and reports success through the return code. and if you don't hand her an address? she just goes straight for /dev/log like it's her usual spot. no cap.

now here's the part where she really eats 👑 — when you're running services that use the syslog facility under runit's service supervision, you should add socklog-check to the top of the service's run script. why? so that no syslog messages get generated until a syslog service is actually up and running to process those messages. it's giving "don't yell into the void, bestie." like this:

#!/bin/sh
socklog-check || exit 1
exec service_using_syslog

---

✨ OPTIONS ✨

• -v — verbose. prints a verbose message to standard error. (she's chatty, we love that for her 🗣️)

---

💀 EXIT CODES 💀

• on success, socklog-check returns 0. iconic. no notes. 🫶
• on error, socklog-check prints a message to standard error and exits 111. yeah she's dramatic about it but she's honest 😭

---

🌈 SEE ALSO 🌈

socklog(8), socklog-conf(8), svlogd(8), tryto(1), uncat(1), sv(8), runsv(8), runsvdir(8)

go read the lore, iykyk 📚

https://smarden.org/socklog/
https://smarden.org/runit/

---

💜 AUTHOR 💜

Gerrit Pape <pape@smarden.org> — the original main character, we stan 🎀

---

and that's the page bestie!! this was socklog-check(8) from the System Manager's Manual, and the footer literally just says socklog-check(8) one more time for good measure — no version number, no date, she said "my name is enough." periodt. 💖✨🦋