PENLOGD(1)

💖 PENLOGD — the manual page, but make it a group chat 💖

okay bestie, sit down, hydrate, and let me tell you about penlogd from the General Commands Manual (section 1, LOCAL edition, obviously). it's giving log-consolidation royalty. 👑

---

✨ NAME ✨

penlogd — consolidate web server logs 🫶

---

✨ SYNOPSIS ✨

penlogd [-fd] [-j dir] [-l logfile] [-n N] [-p pidfile] [-u user] port

---

✨ EXAMPLE ✨

penlogd -l /var/log/access_log -p /var/run/penlogd.pid 10000

---

✨ DESCRIPTION ✨

so penlogd receives log entries from Pen and from each of the web servers. iconic behaviour, honestly.

then it consolidates those entries by replacing the source addresses in each entry with the "real" client address, and writes the result to stdout or to the file you gave it on the command line. the way that this completely removes the need for postprocessing with mergelogs because the logs are already merged?? chef's kiss. no cap. 🔥

💅 heads up bestie: Pen must be instructed to send its log to penlogd. see HOWTO and the pen man page for the details. iykyk.

---

🦋 signals, aka vibe checks 🦋

sending penlogd a HUP signal will make it close and reopen the logfile, unless it's logging to stdout. (if it's logging to stdout, it just... doesn't. respect the stdout lifestyle. 🙈)

rotate the log like this:

mv access_log access_log.1 kill -HUP `cat <pidfile>`

where <pidfile> is the file containing pen's process id.

sending penlogd a TERM signal will make it close the log file and exit cleanly. a peaceful departure. main character exit. ✨

---

✨ OPTIONS ✨

• -d — Turn on debugging. the output goes to stderr if we're running in the foreground (peep -f) and to syslog (facility user, priority debug) otherwise. 🔍
• -f — Stay in foreground. don't go anywhere, bestie. 🫶
• -j dir — Run in a chroot environment. 🏠
• -l logfile — Write output into logfile. 📝
• -n N — Number of pen log entries to cache (default 1000). 🧺
• -p pidfile — Write process id into pidfile. 🆔
• -u user — Run as a different user. 🎭
• port — The UDP port where penlogd receives log entries. 📡

---

✨ SEE ALSO ✨

• pen(1)
• penlog(1)
• webresolve(1)

go read those too, they're all in the same friend group. 🌸

---

✨ AUTHOR ✨

Copyright (C) 2002-2015 Ulric Eriksson, <ulric@siag.nu>. 💜

---

okay that's the whole page, you ate it, you're literally a Unix girlie now ⭐

this lil' cutie came from the LOCAL manual set, section 1 — PENLOGD(1) — and no date is listed on it, because it's timeless, periodt. 🎀 bye bestie!! 💖🦋✨