DHCP6RELAY(8)

📦 in debian bookworm, debian trixie, epel 10, epel 9, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 DHCP6RELAY 💖

okay bestie, so this is the manual page for dhcp6relay, and it lives in section 8 of the System Manager's Manual (that's the sysadmin-y one, iykyk). it's a DHCPv6 relay agent and honestly? it's giving middleman-but-make-it-iconic. 🧚

✨ NAME ✨

dhcp6relay — the DHCPv6 relay agent, periodt 💅

🦋 SYNOPSIS 🦋

dhcp6relay [-Ddf] [-b boundaddr] [-H hoplim] [-r relay-IF]
           [-s serveraddr] [-S script-file] [-p pid-file] interface ...

🌸 DESCRIPTION 🌸

so basically, dhcp6relay is the lil go-between that delivers DHCPv6 messages back and forth between clients and servers. it sits on the same link as a client — like, it's literally in the same neighborhood, no cap. 🏘️

and it needs those command line arguments, bestie: interface ... — that's the list of links that are accommodating clients. plural. the ... is not decorative, it's a vibe check on your argument count. 💀

Options supported by dhcp6relay are (and yes, we're going through every single one, because we don't skip 🫶):

  • -d — prints debugging messages. lil baby debug mode. 🐛
  • -D — even more debugging information gets printed. it's the -d of -d. not me turning the volume all the way up. 📢
  • -f — foreground mode (super useful when you're debugging, fr fr). normally dhcp6relay sends its warning / debugging / error messages off to syslog(8), but if you specify this option it prints them to standard error instead. so you actually get to see the drama live. 👀
  • -b boundaddr — specifies the source address to relay packets to servers (or other agents). it's the "who am I sending this as" address. 💌
  • -H hoplim — specifies the hop limit of DHCPv6 Solicit messages that get forwarded to servers. yes, hop limit, like a TTL but make it Solicit. 🐇
  • -r relay-IF — specifies the interface on which messages to servers are sent. if you omit it, the same interface as interface gets used. but — and this is the important part — when multiple interface values are specified, you cannot omit this option. pick an interface, bestie, the program is not gonna guess for you. 🚫
  • -s serveraddr — specifies the DHCPv6 server address to relay packets to. if you don't specify it, packets get relayed to ff05::1:3 (that's All DHCPv6 servers, iconic multicast address energy 🌈).
  • -S script-file — specifies the script file to be executed when dhcp6relay receives a RELAY-REPLY message from a DHCPv6 server. further detail on the script file syntax lives over in dhcp6c(8), so go peek there for the deets. 📜
  • -p pid-file — use pid-file to dump the process ID of dhcp6relay. little ID card for your process. 🪪

🎀 FILES 🎀

  • /var/run/dhcp6relay.pid — this is the default file that contains the pid of the currently running dhcp6relay. it's the home address of your process ID, lowkey. 🏠

⭐ SEE ALSO ⭐

💜 HISTORY 💜

the dhcp6relay command first appeared in the WIDE/KAME IPv6 protocol stack kit. vintage. iconic. elder statesman of relays. 👑

okay that's the whole page, bestie — and before you go, a lil sign-off 🫶: this one's from the KAME era of things, dated Apr 18, 2000 (yes, it's old enough to have main character energy and a 401k). go forth and relay responsibly. ✨🌸💖

📦 where this page comes from