tinydns-conf(8)

πŸ“¦
version 1.05 Β· 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– tinydns-conf(8) πŸ’–

okay bestie, welcome to tinydns-conf(8) from the System Manager's Manual β€” yes she's a real one, and she's about to set up your whole DNS publication service for you. no cap. πŸŽ€


✨ NAME ✨

tinydns-conf β€” sets up a DNS publication service. that's it, that's the job. πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

tinydns-conf acct logacct D ip

🌸 DESCRIPTION 🌸

okay so first things first, this is a reference page. it's the "just the facts, ma'am" version. if you want the tutorial vibes, the instructions for running a DNS server live over here: http://cr.yp.to/djbdns/run-server.html β€” go read those, they're giving teacher's pet in the best way. πŸ“š

tinydns-conf creates a service directory D that runs tinydns(8). and listen, the name D has rules:

  • it must start with a slash / πŸ”₯
  • it must not contain any special characters πŸ™…β€β™€οΈ

normally D is /etc/tinydns. that's the classic, that's the main character address. πŸ‘‘


πŸ’« running it under svscan πŸ’«

you can run the service under svscan(8) by using the update-service(8) program on Debian GNU/Linux:

update-service --add D

or, if you'd rather do it the manual way, by creating a symbolic link in the svscan(8) directory (normally /service or /etc/service), e.g.:

ln -s D /service

and then boom β€” the service will start within five seconds, and it will be restarted upon reboot. it literally cannot be stopped (well, it can, but it keeps coming back, we love a resilient queen). you can use svc(8) to control the service. πŸŽ›οΈ


🧚 chroot + uid/gid tea 🧚

tinydns-conf arranges for tinydns(8) to chroot to D/root and to run under the uid and gid of acct. the name acct must not contain any special characters β€” same energy as D, keep it clean bestie. ✨


πŸ“ the Makefile moment πŸ“

tinydns-conf creates D/root/Makefile to run tinydns-data(8) upon request. she comes with her own build system, we love a prepared icon. πŸ› οΈ


🌈 network vibes 🌈

tinydns-conf arranges for tinydns(8) to listen for UDP packets on port 53 of ip, and to send outgoing packets from ip. so ip is doing double duty, inbound and outbound, she's booked and busy. πŸ’Œ


πŸ‘‘ logging (automatically rotated, obviously) πŸ‘‘

tinydns-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 yes, the name logacct must not contain any special characters. three names, three "no special characters" rules, that's the vibe check, don't fail it. 🫢


πŸ’œ SEE ALSO πŸ’œ


and that's the whole page bestie!! πŸ’–βœ¨πŸŽ€ this was tinydns-conf(8) from the System Manager's Manual β€” no date on this one, she's timeless like that. go set up your DNS server, you're literally gonna slay. πŸ’…πŸ¦‹πŸŒΈ

πŸ“¦ where this page comes from