qpsmtpd-forkserver(8)

💅 qpsmtpd-forkserver — the manual page, but make it bestie (qpsmtpd-forkserver(8))

okay so this is a page from the System Manager's Manual, and it's all about a lil script called qpsmtpd-forkserver. grab a strawberry 🍓 and let's get into it.

✨ NAME ✨

qpsmtpd-forkserver — a fork-on-demand server for qpsmtpd. it literally just vibes there and makes a whole new process the second somebody knocks. fork-on-demand. periodt. 💅

✨ SYNOPSIS ✨

qpsmtpd-forkserver [options]

that's it. that's the whole summoning ritual. no arguments, just options, and honestly? iconic. 👑

✨ DESCRIPTION ✨

so qpsmtpd-forkserver is the frontend script for qpsmtpd — the one that actually grabs the SMTP TCP socket and holds onto it, and then forks a new process every single time a client connects. it's giving "come in, the door's open, and also you get your own personal clone of me." 🦋

one connection, one fork. no cap.

✨ OPTIONS ✨

• --port port, -p port — bind to a specific port instead of being basic and using the default 2525. 🎀
• --user user, -u user — on startup, switch to running as user instead of whoever started it. heads up though: this only does anything when you start it as root — which, tbh, is the normal situation when you're listening on port 25. 💀
• --limit-connections limit, -c limit — accept at most limit simultaneous connections. anything inbound beyond this limit gets deferred or refused. the door only opens so wide, bestie. 🚪
• --max-from-ip limit, -m limit — accept at most limit simultaneous connections from any one given IP address. and ngl, it does not override --limit-connections if that one's set — they're separate rules, both applying. 🙈
• --listen-address addr, -l addr — bind to the local address addr instead of the default behaviour of binding to all interfaces. and the slay part? you can pass this multiple times to bind to more than one interface or local address. ✨
• --detach, -d — detach from the controlling terminal at startup so it runs as a standalone daemon. see also --pid-file, because you're gonna want that. 👀
• --pid-file filename — on startup, and after daemonizing if that applies, write the process ID to filename, so sysvinit control scripts or similar utilities can find it. the little receipt of where your daemon went. 🧚

✨ AUTHOR ✨

Ask Bjorn Hansen <ask@develooper.com> http://smtpd.develooper.com/

lowkey the actual MVP of this whole page. say thank you. 🫶

and that's a wrap, bestie 💖 this one's straight from the System Manager's Manual — qpsmtpd-forkserver(8), no version or date of its own, just that manual name and section stamped at the bottom like a lil signature. stay forky. 🌸