avahi-dnsconfd.action(8)

📦 version 0.9_rc4, in alpine 3.22, alpine 3.23, alpine 3.24, debian bookworm, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 avahi-dnsconfd.action(8) 💖

okay bestie, gather round, because today we're talking about avahi-dnsconfd.action from the System Manager's Manual — yes it's a section 8 page, yes it's a script, yes it's lowkey iconic 🫶

✨ NAME ✨

avahi-dnsconfd.action — the action script for avahi-dnsconfd, no cap 💅

✨ SYNOPSIS ✨

/etc/avahi/avahi-dnsconfd.action

that's it. that's the whole vibe. one path, zero flags, main character energy 👑

✨ DESCRIPTION ✨

so avahi-dnsconfd.action is the action script that gets called every single time a new unicast DNS server is found — or removed — by avahi-dnsconfd. like, it literally gets summoned the moment things change 🦋

and the default script that ships with avahi? it patches /etc/resolv.conf so that file reflects the changed unicast DNS server configuration. it's giving "keeping everything in sync, periodt" ✨

✨ PARAMETERS ✨

here's the tea, bestie — the script gets arguments, and you cannot sleep on them:

  • argv[1] — holds the character "+" if the DNS server is new, and "-" when it's supposed to be removed from the DNS server list. so basically plus = hi bestie, minus = bye bestie 😭
  • argv[2] — the IP address of the DNS server 🌈
  • argv[3] — the numerical network interface number that this DNS server was found on 🔢
  • argv[4] — the numerical protocol number this DNS server was found on (usually 2 for IPv4 and 10 for IPv6, iykyk) 🌸

✨ ENVIRONMENT ✨

the environment variables are where it gets really cute:

  • AVAHI_INTERFACE — contains the textual interface name that corresponds with argv[3]. (e.g. "eth0") 🎀
  • AVAHI_INTERFACE_DNS_SERVERS — contains a list of all DNS servers that avahi-dnsconfd found on the interface $AVAHI_INTERFACE, separated by spaces 💖
  • AVAHI_DNS_SERVERS — contains a list of all DNS servers that avahi-dnsconfd found on all interfaces, separated by spaces 🌟

✨ AUTHORS ✨

The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from http://avahi.org/ — shoutout to the devs, they ate 💅👑

✨ SEE ALSO ✨

go read these too, they're part of the lore:

✨ COMMENTS ✨

fun fact fr fr: this man page was written using xml2man(1) by Oliver Kurth 🧚

bestie reminder: this page lives in the Manuals source, User section, and it's the avahi-dnsconfd.action(8) page you just read 💜 now go patch that resolv.conf and slay 💅✨
📦 where this page comes from