DHCPY6D(8)

📦
version 1.2.3 · 2 versions
  • 1.2.3 · debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.7 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ dhcpy6d ✨

okay bestie, sit DOWN, because we're about to talk about dhcpy6d — the MAC address aware DHCPv6 server 💅 and yes, this is the DHCPY6D(8) manual page, section 8, system administration, the whole vibe. 🎀

NAME

dhcpy6d — MAC address aware DHCPv6 server 🦋

SYNOPSIS

dhcpy6d [-c file] [-u user] [-g group] [-p prefix] [-r yes|no] [-d duid]
[-m message] [-G]

look at her. so compact. so powerful. an icon, literally. 💖

DESCRIPTION

okay so dhcpy6d is an open source server for DHCPv6, which is the DHCP protocol for IPv6. no cap. 🌈

the whole reason she exists? the need to be able to use the existing IPv4 infrastructure in coexistence with IPv6. like, in a dualstack scenario, your existing DHCPv4 is most probably using MAC addresses of clients to identify them. and here's the tea ☕ — RFC 3315 does not intend that for DHCPv6... but it also doesn't forbid it. 👀 so dhcpy6d does it anyway in local network segments, and that gives you a pragmatical method for parallel use of DHCPv4 and DHCPv6, because your existing client management solutions could keep being used. slay. 💅

dhcpy6d comes with the following features, and honestly? she ate:

  • identifies clients by MAC address, DUID or hostname
  • generates addresses randomly, by MAC address, by range, by given ID or from DNS name
  • filters clients by MAC, DUID or hostname
  • assigns multiple addresses per client
  • allows one to organize clients in different classes
  • stores leases in MySQL, PostgreSQL or SQLite database
  • client information can be retrieved from MySQL or PostgreSQL database or textfile
  • dynamically updates DNS (Bind)
  • supports rapid commit
  • listens on multiple interfaces

the range? the versatility? the database support?? main character energy fr fr. 🔥

OPTIONS

heads up bestie: most configuration is done via the configuration file. the flags are just the lil extra seasoning ✨

  • -c, --config=<configfile> — set the configuration file to use. the default is /etc/dhcpy6d.conf. 🎀
  • -u, --user=<user> — set the unprivileged user to be used. 🫶
  • -g, --group=<group> — set the unprivileged group to be used. 🫶
  • -r, --really-do-it=<yes|no> — really activate the DHCPv6 server. this is a precaution to prevent larger network trouble — so like, it's a vibe check before you go feral on a whole network. respect. 🙈
  • -d, --duid=<duid> — set the DUID for the server. this argument is used by /etc/init.d/dhcpy6d and /lib/systemd/system/dhcpy6d.service respectively. ⭐
  • -p, --prefix=<prefix> — set the prefix which will be substituted for the $prefix$ variable in address definitions. useful for setups where the ISP uses a changing prefix. 🦋
  • -G, --generate-duid — generate DUID to be used in config file. this argument is used to generate a DUID for /etc/default/dhcpy6d. after generation dhcpy6d exits. (she does her one job and leaves. queen behavior. 👑)
  • -m, --message <message> — send message to running dhcpy6d server. at the moment the only valid message is "prefix <prefix>". the value of <prefix> will be used instantly where $prefix$ is to be replaced as placeholder in address definitions. this might be of use for dynamic prefixes by ISPs, for example:
dhcpy6d -m "prefix 2001:db8"

not me thinking that example is lowkey iconic. 🔥

FILES

  • /etc/dhcpy6d.conf
  • /etc/dhcpy6d-clients.conf
  • /var/lib/dhcpy6d/
  • /var/log/dhcpy6d.log

the four sacred texts. 📜✨

LICENSE

okay so legal moment, but make it cute 💜

this program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU General Public License for more details.

bestie pls read this part: you should have received a copy of the GNU General Public License along with this package; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

on Debian systems, the full text of the GNU General Public License version 2 can be found in the file /usr/share/common-licenses/GPL-2. 🎀

SEE ALSO

go read the related pages bestie, iykyk 🦋

AUTHOR

Copyright (C) 2012-2022 Henri Wahl <henri@dhcpy6d.de> 💖

this manual page is licensed under the GPL-2 license. ⭐

and that's the whole page, bestie!! 💅✨ this was version 1.0.3 and the date on it is 2020-12-21 — and that's the DHCPY6D(8) manual page footer, so you literally just got the full lore. mwah. 🎀💖🦋

📦 where this page comes from