dibbler-client(8)

📦 version 1.0.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing

💖 dibbler-client 💖

okay bestie, so this is the manual for dibbler-client, which lives in the Dibbler family of man pages (yes, section 8, the system-admin girly section 💅). Buckle up, it's actually so good.

✨ NAME ✨

dibbler-client — a portable DHCPv6 client 🦋

🌸 DESCRIPTION 🌸

So dibbler-client is a portable implementation of the DHCPv6 client, and honestly? She does both modes. She supports stateful autoconfiguration (that's the one where you actually get IPv6 addresses handed to you, iconic) and stateless autoconfiguration (that's the one where you just get options, no address, lowkey chill).

There are ports available for Linux 2.4/2.6 systems, and also for MS Windows XP and 2003. They're freely available under the GNU GPL version 2 (or later) license, periodt. 🫶

🎀 SYNOPSIS 🎀

dibbler-client [ run | start | stop | status | install | uninstall ]

💅 OPTIONS 💅

  • run — starts the client in the console. You can close the client using ctrl-c. main character energy, she's right there in your terminal with you ✨
  • start — starts the client in daemon mode. she goes in the background and just… vibes 🌙
  • stop — stops running clients. bye bestie 👋
  • status — shows status of the client and server. nosy but make it useful 🔍
  • install — installs client as a service. ⚠️ not implemented yet, so don't get your hopes up 💀
  • uninstall — uninstall client service. ⚠️ also not implemented yet. same energy. 💀

🌈 EXAMPLES 🌈

Let's start with the simple configuration, because we love an easy win. Say we want to receive one IPv6 address, and there's only one Ethernet interface present. In that case the client.conf file might be completely empty. And that's it. That's the whole config. Dibbler client will request one IPv6 address on each up, running and multicast capable interface (except loopback, obviously, she's not doing that 🙈).

Now some real example. We want one IPv6 address, and we want to receive DNS servers and domain name. We are also not interested in the details, so debug mode is disabled. ✨

log-mode short
log-level 6
iface eth0
{
  ia { }
   option dns-server
   option domain
}

Next example: we want only NIS domain and NIS server information. That information should be periodicaly renewed, so we use the lifetime option. We don't need any addresses, so stateless mode is used. slay 🦋

log-mode short
iface eth0
{
  stateless
  option nis-server
  option nis-domain
  option lifetime
}

More examples can be found in the User's Guide. 📖

🗂️ FILES 🗂️

All files are created in the /var/lib/dibbler directory. Here's the rundown, bestie:

  • Dibbler client reads /var/lib/dibbler/client.conf 💖
  • During operation, Dibbler saves various file in that directory.
  • After reception of the DNS servers or domain informations, they are added to the /etc/resolv.conf file. After shutdown, that information is removed from that file. she cleans up after herself, we stan 🧹
  • Option values are stored in the option-* files.
  • Log file is named client.log.

📜 STANDARDS 📜

This implementation aims at conformance to the following standards:

Also options specified in following drafts are implemented:

  • draft-ietf-dhc-dhcpv6-opt-timeconfig-03.txt NTP and timezone options.
  • draft-ietf-dhc-dhcpv6-opt-lifetime-00.txt Option renewal.

🐛 BUGS 🐛

Bugs are tracked with bugzilla, available at http://klub.com.pl/bugzilla/. If you belive you have found a bug, don't hesitate to report it. fr fr, they want to know 🫶

👑 AUTHOR 👑

Dibbler was developed as a master thesis on the Technical University of Gdansk by Tomasz Mrugalski and Marek Senderski. Currently Marek has not enough free time, so this project is being developed by Tomasz Mrugalski. Authors can be reached at thomson@klub.com.pl and msend@o2.pl 💌

🔗 SEE ALSO 🔗

There is a dibbler-server(8) manual page. You are also advised to take a look at project website located at http://klub.com.pl/dhcpv6/.

As far as authors know, this is the only Windows DHCPv6 stateful implementation available. It is also one of two freely available under Linux. The other Linux implementation is available at http://dhcpv6.sourceforge.net, but it is rather outdated and seems not being actively developed. 💀 (not us being shady, that's literally what the manpage says, iykyk)

ok that's the whole page bestie, you're officially certified in dibbler-client 💅✨

GNU · 2004-12-11 · dibbler-client(8) — that's the version, the date, and the manual section, all wrapped up with a lil bow 🎀 bye pookie, go configure something iconic 🌸

📦 where this page comes from