rbldns-conf(8)

💖 rbldns-conf — the setup bestie for your IP-address-listing DNS service 💖

okay so real talk, this is rbldns-conf from section 8 of the System Manager's Manual, and it's literally the little matchmaker that sets up your whole IP-address-listing DNS service. no cap, she does all the boring scaffolding so you don't have to. 🎀

---

✨ NAME ✨

rbldns-conf — sets up an IP-address-listing DNS service.

like... that's the whole vibe. she builds the service. you go live. slay. 💅

---

🌸 SYNOPSIS 🌸

rbldns-conf acct logacct D ip base

five little arguments, one big glow-up. let's get into it. 🦋

---

🧚 DESCRIPTION 🧚

so basically rbldns-conf creates a service directory D that runs rbldns(8). and bestie, listen — D has RULES:

• it must start with a slash /
• it must not contain any special characters

normally D is just /etc/rbldns, which is giving very much "the default and I'm at peace with it" energy. ✨

🫶 running it under svscan(8)

you've got two paths here and both of them ate:

path one — Debian GNU/Linux girlies: use the update-service(8) program on Debian GNU/Linux, like so:

update-service --add D

path two — symlink stans: create a symbolic link in the svscan(8) directory (normally /service or /etc/service), e.g.:

ln -s D /service

and then?? the service will start within five seconds, and will be restarted upon reboot. iconic behavior honestly. you can use svc(8) to control the service whenever you feel like it. 👑

🔥 the chroot / uid / gid situation

rbldns-conf arranges for rbldns(8) to chroot to D/root and to run under the uid and gid of acct.

heads up: the name acct must not contain any special characters. this is not a drill, the vibes must stay clean. 🚫

🍓 the Makefile moment

rbldns-conf creates D/root/Makefile to run rbldns-data(8) upon request. cute, tiny, powerful. it's giving assistant energy. 💜

🌈 networking tea

rbldns-conf arranges for rbldns(8) to listen for UDP packets on port 53 of ip, and to send outgoing packets from ip. port 53 said "I'm the main character" and honestly? correct.

⭐ answering queries

rbldns-conf arranges for rbldns(8) to answer queries under the base domain.

and yes, the name base must not contain any special characters either. same rule, different parameter, no exceptions bestie. 😭

💖 the log directory

rbldns-conf creates an automatically rotated log directory in D/log/main.

• the logs are owned by logacct
• the corresponding multilog(8) processes run under the uid and gid of logacct
• and you already know what's coming — the name logacct must not contain any special characters

three parameters, three "no special characters" warnings. the manpage said consistency and she MEANT it. 🙈

---

🌟 SEE ALSO 🌟

go read these next, they're all part of the friend group:

• rbldns(8)
• rbldns-data(8)
• svscan(8)
• svc(8)
• multilog(8)
• axfrdns-conf(8)
• dnscache-conf(8)
• tinydns-conf(8)
• walldns-conf(8)
• update-service(8)

and if you want the lore, the whole extended universe lives at:

http://cr.yp.to/djbdns.html

---

that's the whole page bestie — rbldns-conf(8), straight out of the System Manager's Manual, and yes she is section 8 and yes she knows it. go forth, set up your IP-address-listing DNS service, and remember: no special characters, five seconds to start, restarted on reboot. periodt. 💅✨🎀