ldns-notify(1)

πŸ“¦
version 1.9.2 Β· 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’Œ ldns-notify β€” it's giving "hey bestie, the zone changed" πŸ’…

okay so this is a page from the General Commands Manual, and it's about ldns-notify, and honestly? she's a little legend.


✨ NAME ✨

ldns-notify β€” notify DNS servers that updates are available πŸ¦‹


🌸 SYNOPSIS 🌸

ldns-notify [options] -z zone servers

πŸ’– DESCRIPTION πŸ’–

okay so here's the tea β˜• β€” ldns-notify sends a NOTIFY message to DNS servers. what that does is tell them "hey, an updated zone is available at the master servers" πŸ‘‘ like a little group chat message but for zones.

she can also do TSIG signatures, and she can add a SOA serial number of the updated zone. and the cute part? if a server already has that serial number, it will just disregard the message entirely. no drama, no nothing. periodt. πŸ’…


πŸŽ€ OPTIONS πŸŽ€

  • -z zone β€” the zone that is updated. literally the whole point bestie πŸ’–
  • -I address β€” source IP to send the query from. like, where you're sending it from, the origin, the home base 🏠
  • -h β€” show usage and exit. little help moment πŸ™ˆ
  • -v β€” show the version and exit. identity check ✨
  • -s serial β€” append a SOA record indicating the serial number of the updated zone. this is the "btw it's THIS version" receipt 🧾
  • -p port β€” use port as the destination port (default the DNS port 53) for the UDP packets πŸšͺ
  • -y key:data[:algo] β€” use the given TSIG key and base64-data, and optionally an algorithm to sign the NOTIFY. the algorithm defaults to hmac-md5.sig-alg.reg.int πŸ” no cap, that's the default.
  • -d β€” print verbose debug information. and by verbose we mean the query that is sent AND the query that is received. both. she's showing you everything πŸ‘€
  • -r num β€” specify the maximum number of retries before notify gives up trying to send the UDP packet. like, she will try, but she's not gonna try forever 😭

πŸ’€ EXIT CODE πŸ’€

the program exits with a 0 exit code if all servers replied an acknowledgement to the notify message, and a failure exit code otherwise. that's it. that's the whole vibe check.


πŸ‘‘ AUTHOR πŸ‘‘

written by the ldns team as an example for ldns usage. icons teaching by example, we love to see it 🫢


🌈 REPORTING BUGS 🌈

report bugs to <dns-team@nlnetlabs.nl>. they wanna hear it fr fr πŸ“¬


Copyright (C) 2005 NLnet Labs. this is free software. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

like genuinely no warranty bestie, none, zero, nada πŸ™ˆ

and that's the whole page!! πŸŽ€ this edition was dated 9 Jan 2007 and lives in the ldns-notify(1) corner of the manual. slay, bye πŸ’–βœ¨πŸ¦‹