YAKU-NS(1)

✨ yaku-ns — small and simple DNS server 💅

okay bestie, sit DOWN, because this is yaku-ns(1), a User Commands manual page, and it's literally a whole tiny DNS server and I'm obsessed 🫶

---

🌸 NAME 🌸

yaku-ns — small and simple DNS server. that's it, that's the vibe. tiny. simple. iconic.

---

🎀 SYNOPSIS 🎀

yaku-ns [-p <port>] [-P <port>] [-f <port>] [-C <max>] [-F <max>] [-T
<forward_timeout>] [-c <config_file>] [-l <logfile>] [-r <chroot jail>]
[-u owner] [-b <addr>] [-xdhV]

like. look at her. a whole queen with a whole flag list. ✨

---

💖 DESCRIPTION 💖

so this is a simple and small DNS server. not complicated, not doing the most, just serving DNS and looking cute while doing it. Major features are:

• Support for A, MX, NS, TXT, PTR, SOA in local resource records 🗂️
• Additional RRs handling
• Responses cache, with optional TTL expiration ⏳
• Forwarding to multiple exteral DNS servers, with simultaneous or time-driven query 📡
• Optional TCP zone transfer
• A in RRs shuffling 🔀
• Built-in ACL rules
• Root privileges squashing 🥿
• Chroot jail under unix systems
• Secure DNS IDs to prevent DNS forget
• Logging 📝
• Very simple config file

ngl that's a lot of features for something calling itself "small". she's humble AND talented. main character energy fr fr 👑

---

🦋 OPTIONS 🦋

• -p <port> — use the UDP port <port> for the DNS service. udp girlies rise 💅
• -P <port> — use the TCP port <port> for the DNS under TCP service. and heads up bestie, the only two requests accepted under TCP are IN/AXFR and IN/SOA. that's the whole guest list, no plus-ones 🚫
• -f <port> — query the external DNS servers to the port <port>.
• -C <size> — use a cache of size <size>, 0 is no-cache. zero means she forgets everything instantly, no thoughts head empty 💀
• -F <max> — use a forwarded request queue of size <size>, 0 turn off the forwarding.
• -T <timeout> — forwarded requets expire in <timeout> seconds. ⏰
• -c <file> — use the config file <file>. WARNING: you must specify the absolute path here, since the server chdir() to "/". Also note that this path is relative to the chroot jail. Use "-" as filename to provide the configuration from the standard input. yeah the path rules are doing the absolute most, read them twice bestie 😭
• -l <file> — use the <file> for yaku-ns logs. Remember to use an absolute path, relative to the chroot (if used).
• -r <directory> — chroot to <directory>. get in the jail bestie 🔒
• -u <username> — run as <username> (default is nobody, not so secure). not so secure!! she said it not me 🙈
• -b <address> — bind only the interface with IP address <address>.
• -x — Enable the TCP services.
• -d — Demonize.
• -h — Show some help.
• -V — Verbosity level: -V: low level, -VV medium level, -VVV high level of verbosity. -VVV is raccomanded for new users. new here? go -VVV, she will tell you EVERYTHING 🗣️

---

🌈 SIGNALS 🌈

the DNS server yaku-ns performs different action if some signal is received:

• SIGHUP — Reload the configuration (use on record updates)
• SIGUSR1 — Force yaku-ns to log some debugging information
• SIGUSR2 — Switch the forwarding ON/OFF

literally just tap her on the shoulder with a signal and she changes her whole personality 💅

---

👑 SEE ALSO 👑

yaku-getzone(1).

---

💜 AUTHOR 💜

yaku-ns was written by Salvatore Sanfilippo <antirez@gmail.com>.

This manual page was written by Gürkan Myczko <alex@aiei.ch>, for the Debian project (but may be used by others).

---

periodt. that's the whole page. go forth and serve DNS responsibly, bestie 🫶

yaku-ns — November 2011 ✨ thanks for reading my little manual page rewrite, mwah 💖