avahi-autoipd.action(8)

💖 avahi-autoipd.action — the manual, bestie edition 💖

okay so real talk, this is the page for avahi-autoipd.action(8) from the System Manager's Manual, and it's genuinely one of those tiny little scripts that does SO much heavy lifting. like, unglamorous but essential. main character energy in a trench coat. let's get into it 🫶

✨ NAME ✨

avahi-autoipd.action — the action script for avahi-autoipd. that's it. that's the whole name. short, sweet, slays. 💅

🌸 SYNOPSIS 🌸

/etc/avahi/avahi-autoipd.action

that's the path. that's where it lives. iconic behavior, no arguments to pass yourself, it just gets called. 🔥

🦋 DESCRIPTION 🦋

so avahi-autoipd.action is the action script, and it gets called in exactly two vibes of situation:

• whenever an IP address has been acquired by avahi-autoipd, or
• when it detected an IP address conflict. 😭

and what's the script supposed to do? literally just add or remove the specified address from the specified network interface. that's the job. add it. remove it. no drama. periodt. ✨

🎀 PARAMETERS 🎀

these come in as argv, and there are three of them, and you need ALL of them, bestie. no skipping.

• argv[1] — an event string, and it's one of exactly four things: BIND, CONFLICT, UNBIND or STOP. here's the tea on each one:
  • if BIND is passed, an IP address has been successfully acquired and the script shall add it to the network interface. yay!! we got an address!! 🎉
  • if CONFLICT is passed, avahi-autopid detected a IP address on the local network, and the action script should remove the configured IP address. oh no, someone else has it, back off. 💀
  • if UNBIND is passed, the IP address should be removed from the interface too, because a routable address has been configured to the interface by some other program. like, someone else showed up with a better address, we're out. 🙈
  • if STOP is passed, avahi-autoipd is being shutdown and the action script should remove the IP address. packing up, lights off, bye. 👋
  • and in short (because I know that was a lot): on BIND the address should be added to the interface, and on CONFLICT, UNBIND or STOP it should be removed. that's the whole rule. memorize it. it's giving cheat sheet. ⭐
• argv[2] — the network interface name. y'know, the actual interface we're doing all this adding and removing on. 🌈
• argv[3] — an IP address from the IPv4LL range. that's the address in question, the one getting bound or unbound. 💜

👑 AUTHORS 👑

The Avahi Developers <avahi (at) lists (dot) freedesktop (dot) org>; Avahi is available from http://avahi.org/

look at them. legends. respect the elders. 🫡

🔥 SEE ALSO 🔥

• avahi-autoipd(8)
• dhclient-script(8)
• ip(8)
• ifconfig(8)

go read these too, they're the friend group. iykyk. ✨

💜 COMMENTS 💜

This man page was written using xml2man(1) by Oliver Kurth.

shoutout Oliver, thank you for your service, the pipeline delivered. 🎀

heads up bestie: this script is literally the thing standing between your interface and a stray address that shouldn't be there, so be careful what you make it do. it gets called at the messiest moments. no cap. 😭

and that's the whole page!! it's from Manuals, section User, and the manual name is avahi-autoipd.action(8) — so if you ever forget where you read this, that's the receipt. mwah 💅💖✨