DHCPv6: Dibbler - a portable DHCPv6

News

2011-11-13: Dibbler 0.8.1 Release Candidate 1 is released. This release introduces number of useful additions, new features and the usual bug fixes. In particular, the highlights of this release are:

• Support for routing configuration was added. Yes, you read that correctly. Recent draft draft-ietf-mif-dhcpv6-route-option defines provisioning mechanism that delivers routing information over DHCPv6. Although this implementation is not entirely complete (there are certain limitations, see User's Guide), it isvery usable. This feature was tested with excellent ISC DHCP implementation and is interoperable. You may want to read Routing configuration over DHCPv6 for additional information.
• Script support is rewritten. Client can call a script every time it receives a message and pass all received options as environment variables. That is very convenient way to extend client with custom actions. This feature is going to be further expanded in upcoming releases.
• Server is now able to run scripts, too. That is convenient if you need your server to execute custom actions. One notable example is a routing reconfiguration after prefix was delegated to a client.
• Added support for FreeBSD, NetBSD and OpenBSD. Mac OS X support is now also significantly improved. To achieve this level of portability, build system was completely rewritten and is now using automake and autoconf tools. You can now use ./configure script to enable or disable various parameters. Makefile modification is no longer necessary.
• DNS Update can now be performed over UDP, TCP or both (try over UDP and if it fails, try TCP). Configurable timeout for DNS Updates added.
• Significant update in prefix delegation support. Server will now remember previously assigned prefixes and will try to assign the same prefix to returning client.
• Support for DS-Lite tunnels configuration added (RFC6334)
• Rather large User's Guide documentation update
• Fixed mis-aligned memory reads on ARMv5 architecture
• Added support for unittests using googletests. Number of tests is small now, but is expected to grow.

2011-09-05: Dibbler source has been moved to GIT repository at github.

2011-05-11:Dibbler 0.8.0 has been released. That is a new release after long time. Dibbler development just resumed.

2011-03-14: I got my first mac! Yay! After figuring out how to do anything useful without insert, delete, pgup and pgdown, I think I was able to fix many problem with Mac OS port. I'm able to run both client and server on my mac. If you have Mac hardware available, please Get the latest code from SVN and give it a try.

2011-02-11: I'm happy to announce that my 7 year struggle to complete my Ph.D. is finally over. It appears that I will finally have some time to reinvigorate Dibbler. There are many things happening lately in DHCP world, so it seems I'll be busy in the near future. In the mean time, Dibbler became quite outdated. Please send a note to the mailing list regarding missing features that you find the most urgent to develop.

Cheers,
Tomasz Mrugalski, Ph.D.

2010-09-17: Good news, everyone! After a year and a half, I finally found some time to wrap everything that was slowly going around, packed and released 0.8.0 Release Candidate 1. The major changes include support for Windows 7 and Mac OS (both experimental), support for CONFIRM, client and server will reload their databases during boot, Linux console now can be colorful, support for bunch of experimental stuff added. Finally, there's large code refactoring taking place, so let's hope that everything is working... Enjoy

2009-12-01: Dibbler source code has been migrated from CVS to SVN.

2009-03-09: 0.7.3 has been released. The immediate reason to release this version is that compilation error under Linux with libc6,version 2.8 is fixed. Also, some new features are added and bunch of old bugs fixed: new timezone option support added, syslog support added, interface-ids other that 4 bytes long are now supported, empty FQDN option problem fixed, client classification added, /etc/resolv.conf support improved and one race condition under Linux fixed. As it was released in a hurry, testing of this release is very limited. Please use with care.

2008-09-05: Windows binaries for 0.7.2 are now available. They support XP, 2003 and Vista.

2008-08-31: Dibbler 0.7.2 have been released. There are several new features added: external scripts may no be executed, DNS configuration is now working properly under XP/Vista, new extra options may be configured, experimental CONFIRM support, client's hints in FQDN may now be accepted. And traditional bunch of bug fixes, of course. There's also one significant difference. This version is released under GNU GPL v2 only, not v2 or later. That is for companies that may have legal concerns with "GPL v2 or later" and GPLv3.

2008-08-12: Small update this time: New DEB packages (0.7.1-2) have been released.

2008-06-22: I'm proud to announce immediate release of 0.7.1 version. Instead of re-releasing outdated 0.7.0 I've decided to go ahead with new features and release 0.7.1. Among new features are leasequery and experimental authentication. It is also worth mentioning that Microsoft Vista is now supported. As usual, numerous bug fixes and small improvements were made and documentation was updated. Download and enjoy.

2008-03-24: Although no news have been added and no new releases become available recently, development is progressing in a quite fast pace. Megapatch by Michal Kowalczuk has been finally merged. So dibbler now supports authentication and authorization. Yay! Several new features have been added for relay scenarios. Relays may now be configured to add remote-id and/or echo-request options. Server now supports both options. This and results from Philly meeting strongly suggest that going ahead with 0.7.0, would in fact mean releasing outdated code. I'm thinking rather to skip 0.7.0 and release auth+0.8.0-RC1 instead. To be precise, 0.7.0 was released in the source code form, but I don't expect to prepare any binary packages.

2007-12-31: After a few months, new version is being prepared. First release candidate for 0.7.0 has been released. The biggest change is support for leasequery. Also numerous bugfixes found during second DHCPv6 bakeoff meetings have been fixed.

2007-12-03: Things seem to be quiet lately. I'm on a 2 month business trip (which has been extended slightly), so the time I can devote to Dibbler is limited. What's worse, I have access to my laptop only, so even executing simple client-server scenario is somewhat problematic. Neverthless, I'm coding support for recently published RFC5007: leasequery. It is almost functional, but there are still a few bugs to troubleshoot. It will be ready very soon.

2007-09-27: A few small things to announce: I have updated sourgeforge.net files, new WIN32 binary for 0.6.1 version added. Also, I'm starting over 2 months long business trip. I won't be able to spend as much time on the Dibbler project as before. Also, I will have my laptop only available. Those two factors may cause this project to be stalled for a while. But rest assured. It will not die. Ok, now the great news: I'm gonna see California. Yay! Ok, ok. That was a great news for me only. :)

2007-09-11: Good news, everyone! The next stable version, 0.6.1, has been released. Most changes are related to security flaws, so upgrade is strongly recommended. Sources and Linux binaries are ready, but more tagests/platforms wiil be prepared sortly. Enjoy.

2007-07-05: Security fix: Two issues has been reported, both present in the 0.6.0 version. All dibbler components (client, server and relay) are not able to handle properly maliciously formed messages. This could lead to remote denial of service (resulting in dibbler crash). Dibbler also created world writable files in /var/lib/dibbler in the Linux environment. Latest snapshot (dated 2007-07-05) fixes both of this issues. Thanks to Mu Security Team and Tero Pelander for reporting those problems.

2007-06-22: New packages for Debian with 0.6.0 version have been prepared. They were uploaded to unstable some time ago. Besides several Debian related fixes, there are also new debconf translations: French and Portuguese.

2007-05-08: After 7 months of hard work, several release candidates, 2 day test session and countless number of coding hours, Dibbler 0.6.0 has been released. List of changes and new features is rather impressive: Support for prefix delegation, vendor-specific information, all DUID types and anonymous INF-REQUESTS has been added. Client is now able to properly support not ready (e.g. not yet associated WiFi interfaces). Server now properly supports more than one relay connected in cascade. Relay operation has also been improved. And we has common announcements: lots of bugfixes and improved documentation. This time Dibbler User's Guide is 60+ pages long and contains pictures and diagrams. Ok, download and enjoy!

2007-03-31: There are two major things to announce. First, I was invited to participate in the DHCPv6 interop test session held in RIPE, Amsterdam. There were 7 vendors and open source implementation available. It was great experience to test so many different solutions. 15 issues related to the spec itself has been found. They has been discussed during IETF meeting in Prague. Also, I was able to locate over 10 problems in the dibbler code itself. Luckily, only one of them was critical (i.e. resulted in server crash). Since that event took place on March 15th-16th, I had enough time to fix most of those bugs. And that is second news to be announced: 0.6.0 Release Candidate 4 has been released. Besides numerous bugfixes, new client features has been added. It is now possible to generate DUID-EN type. Client is able to support downed/not associated interfaces. It is also possible to switch client to a insist-mode. It means that, in case of not receiving requested option, client will insist to get it anyway, from other servers for example. Also, last note: My ISP has changed links, so klub's IPv4 address has changed, so right now there is a domain delegation taking place. It may take some time before all changes are propagated to remote DNS servers. However, since you are reading this, you already have updated domain info.

2007-03-10: Another snapshot has been prepared. This time there is a new feature in dibbler-relay. When relay receives data from clients, it encapsulates, adds interface-id option and forwards the data to server. Server should respond with message containing the same interface-id option. This information will be used by relay to properly choose appropriate interface. However, there are faulty server implementations (luckily, dibbler is not one of them), which does not send interface-id option, thus confusing relay. To overcome this problem, relay has to "guess" the original interface the request has been sent on. This is achieved using guess-mode. By the way: In the following week I'll be on a short vacation and interop test session, so I'll probably won't answer any emails.

2007-03-04: Although there were no announcements lately, things are not exactly dead. I have fixed several issues today. Client now behaves properly when server stops responding and REBIND procedure fails. Large (as in 4 bilions) timeouts does not confuse client anymore. Also server does not crash when FQDN is enabled, but there are no DNS servers defined. A small new feature also has been added: in a stateless mode, it is now possible to send INF-REQUEST messages without client-id. If you are interested, snapshot with all those fixes is available. And finally, small announcement: for some mysterious reason 0.6.0 will be built on March 14th. So if you want to test dibbler, now is a very good time.

2007-02-07: Binary versions for Windows XP/2003 and NT/2000 have been prepared. Clickable installators are available as well. I have also uploaded new version to sourceforge.

2007-02-04: First Release Candidate for 0.6.0 has been released. I believe it is very stable and lots of bug fixes has been included, so it's recommended to upgrade. Also if you are interested in prefix delegation, vendor-specific information options, per-client configuration, that's the release for you. If you have experienced interoperability issues related to elapsed option, you should upgrade. User's Guide has also been updated - besides much improved "Features HOWTO" section, several figures has been added. In the upcoming days, I'll generate packages for various distributions and installation wizards for Windows. Final 0.6.0 version will be released after additional testing. So if you experience ANY problems, be sure to report it. If that version will work for you, also let me know.

2007-02-02: I have just finished last feature scheduled for the next release. In the upcoming weekend I'll do some testing and first release candidate for 0.6.0 will be released.

2007-01-30: Michal "Sammael" Kowalczuk has provided dibbler packages for OpenWRT. Dibbler 0.5.0 packages are available in the download section. Scripts for generating ipk packages has been added to the CVS repository. Thanks. I know that there is at least one person in Thailand, who will be very happy about that :) Also things are progressing quite smoothly. Several development snapshots has been created and preparation for releasing 0.6.0 version will start soon.

2007-01-04: Although there were no announcements lately, dibbler development is progressing well. Support for prefix delegation has been implemented and is more or less functional, i.e. client can request for, and server will provide prefixes (this also includes support for multiple prefixes for the same client). Client will configure those prefixes on the interface and will also generate radvd.conf file. (Sorry Windows users, this works in Linux only.). Vendor-specific information option support has been improved. Now several values for different vendors may be defined. Also it is now possible to define per-client configuration on the server size (so called exceptions). So as you see, dibbler development in not stagnant :) That would be all for today. Happy new year!

[Old news]

Feature List

• Server discovery and address assignment (SOLICIT, ADVERTISE, REQUEST and REPLY messages) - This is a most common case: client discovers servers available in the local network, then asks for an address (and possibly additional options like DNS configuration), which is granted by a server.
• Best server selection - when client detects more than one server available (by receiving more than one ADVERTISE message), it chooses the best one and remembers remaining ones as a backup.
• Relay support - In a larger network, which contains several Ethernet segments and/or wireless areas, sometimes centrally located DHCPv6 server might not be directly reachable. In such cace, additional proxies, so called relays, might be deployed to relay communication between clients and a remote server. Dibbler server supports indirect communication with clients via relays. Standalone, lightweight relay implementation is also available. Clients are capable of talking to the server directly or via relays.
• Leasequery - From the sysadmin's perspective, it is often beneficial to check which address has been assigned to a specific client or who got a specific address. To do so, it is possible to query server for such information. There is a special type of DHCPv6 entity called requestor that performs such queries and parses server's answers.
• Address renewal - After receiving address from a server, client might be instructed to renew its address at regular intervals. Client periodically sends RENEW messege to a server, which granted its address. In case of communication failure, client is also able to attempt emergency address renewal (i.e. it sends REBIND message to any server).
• Unicast communication - if specific conditions are met, client could send messages directly to a server's unicast address, so additional servers does not need to process those messages. It also improves effciency, as all nodes present in LAN segment receive multicast packets.
• Duplicate address detection - Client is able to detect and properly handle faulty situation, when server grants an address which is illegaly used by some other host. It will inform server of such circumstances (using DECLINE message), and request another address. Server will mark this address as used by unknown host, and will assign another address to a client.
• Power failure/crash support - After client recovers from a crash or a power failure, it still can have valid addresses assigned. In such circumstances, client uses CONFIRM message, to config if those addresses are still valid.
• Normal and temporary addresses - Depending on its purpose, client can be configured to ask for normal (IA NA option) or temporary (IA TA option). Although use of temporary addresses is rather uncommon, both dibbler server and client support it.
• Hint system - Client can be configured to send various parameters and addresses in the REQUEST message. It will be treated as a hint by the server. If such hint is valid, it will be granted for this client.
• Server caching - Server can cache granted addresses, so the same client will receive the same address each time it asks. Size of this cache can be configured.
• Stateless mode - Client can be configured to not ask for any addresses, but the configuration options only. In such case, when no addresses are granted, such configuration is called stateless (INFORMATION-REQUEST message is used instead of normal REQUEST).
• Rapid Commit - Sometimes it is desirable to quicken configuration process. If both client and server are configured to use rapid commit, address assignment procedure can be shortened to 2 messages, instead of usual 4. Major advantage is lesser network usage and quicker client startup time.

Also following extensions are supported:

• DNS Servers - During normal operation, almost all hosts require constant use of the DNS servers. It is necessary for event basic operations, like web surfing. DHCPv6 client can ask for information about DNS servers and DHCPv6 server will provide necessary information.
• Domain Name - Client might be interested in obtaining information about its domain. Properly configured domain allow reference to a different hosts in the same domain using hostname only, not the full domain name, e.g. alice.example.com with properly configured domain can refer to another host in the same domain by using 'bob' only, instead of full name bob.example.com.
• NTP Servers - To prevent clock misconfiguration and drift, NTP protocol can be used to synchronize clocks. However, to successful use it, location of near NTP servers must be known. Dibbler is able to configure this information.
• Time Zone - To avoid time-related ambiguation, each host should have timezone set properly. Dibbler is able to pass this parameter to all clients, who request it.
• SIP Servers - Session Initiation Protocol (SIP) is commonly used in VoIP solutions. One of the necessary information is SIP server addresses. This information can be passed to the clients.
• SIP Domain Name - SIP domain name is another important parameter of the VoIP capable nodes. This parameter can be passed to all clients, who ask for it.
• NIS, NIS+ Server - Network Information Service is a protocol for sharing authentication parameters between multiple Unix or Linux nodes. Both NIS and NIS+ server adresses can be passed to the clients.
• NIS, NIS+ Domain Name - NIS or NIS+ domain name is another necessary parameter for NIS or NIS+. It can be obtained from the DHCPv6 server to all clients, who require it.
• Option Renewal Mechanism (Lifetime option) - All of the options mentioned on this list can be refreshed periodically. This might be handy if one of those parameters change.
• Dynamic DNS Updates - Server can assign a fully qualified domain name for a client. To make such name useful, DNS servers must be informed that such name is bound to a specific IPv6 address. This procedure is called DNS Update. There are two kinds of the DNS Updates: forward and reverse. First is used to translate domain name to an address. The second one is used to obtain full domain name of a known address.
• Prefix Delegation - Server can delegate a prefix to a client. That feature is intended to be used mainly by routers, which obtain prefixes from an upper level router. Client after receiving prefix, will generate smaller prefixes for each available interface.

Download: stable

Here's newest stable version. If you need, for some reason, older releases, you can find them in the dibbler directory.

Download: development version

Sources can also be downloaded from GIT repository:

git clone git://github.com/tomaszmrugalski/dibbler.git

You can also browse source directly with your web browser: Dibbler sources at github.

Old sources can also be downloaded from SVN. These sources are outdated and keep around only for several students that are doing their master theses. They can compare changes here. Everyone should migrate to GIT. If you really have a reason to use this old version, please use following command to download SVN sources:

svn checkout https://anonymous@klub.com.pl/var/svn/dibbler/trunk

Short-term goals (aka TODO)

Bugzilla is a bug tracking system. It allows to report, assign and deal with bugs in a convinient manner. It can also be used to request new features. It is called enhancement. Take a look at bugs with severity ("Sev" column) set to "enh". You can define what are you looking for by hand, or use one of the links on the side panel.

Long-term goals (aka Roadmap)

There's list of features, which I would like to include someday. In some far, distant, not so sure future. I'm really busy person, sorry. In parenthesis there are estimated versions, where this feature will be implemented.

• (0.4.0) RELAY AGENT support [done]
• (0.5.0-RC1) temporary addresses support (IA_TA option) [done]
• (0.5.0-RC1) DNS updates (FQDN option) [done]
• (0.6.0-RC1) Prefix Delegation [done]
• (0.7.0) Leasequery (RFC5007)
• (0.7.0) Authentication [done]
• (0.7.1-CVS)crash/power outage recovery (CONFIRM message)[done]
• (0.8.0) Mac OS X port
• (0.8.1RC1) DNS Updates over UDP
• (0.8.1RC1) FreeBSD/NetBSD/OpenBSD port
• (0.8.1RC1) Routing configuration (draft-mif-dhcpv6-route-option)
• (0.9.0) Proper lease expiration support (with external script support)
• (0.9.0) DNS Update security (TSIG)
• (0.9.0) RECONFIGURE support
• (0.9.0) Better client classification support (DUID, link address, relay-id etc.)
• (0.9.0) Universal new option definition (with external script support)
• (1.0.0) Remaining RFC3315 features
• Bulk leasequery
• DOCSIS 3.0 options
• (under consideration) Minimal client for embedded devices
• (under consideration) allow DB storage in a real database (PostgreSQL probably)
• DHCPv6 Failover (once the draft becomes solid enough)

If you are thinking about joining or contributing to the dibbler project, you may want to see this Developer's TODO list.

Looking for sponsor

During Dibbler development, I have encountered several problems with equipment availability. This project has no budget and I develop everything in my home. I have several computers, so I can build basic configuration. However, I don't have any fancy hardware, so I can't verify any of the more advanced setups.

Another issue that I have encountered is a lack of access to non-x86 architectures. I would like to develop Dibbler versions for other architectures, eg. 64-bit or Mac. So, if you are a well prospering company and you find Dibbler useful, consider supporting open source development and donating some of your equipment.

In further Dibbler development, access to the following equipment would be useful:

• An Intel 64-bit box
• AMD64 box
• A MAC capable of running Mac OS X
• Sun Sparc with Sun OS supporting IPv6
• A Cisco router capable of running DHCPv6 relay
• a LinkSys Wireless router WRT54G (which already supports Dibbler)
• A PDA with a network interface
• Any other uncommon hardware which would be able to run Dibbler

Mailing lists

USERS: Mailing list was created to support Dibbler users. Feel free to discuss any topic related to Dibbler or DHCPv6 in general. You can also ask for help here. If you want to subscribe, please send mail with subject "subscribe" to dibbler-request(at)klub.com.pl. You will receive confirmation request shortly. You can also subscribe to mailing list using www browser. There are list archives available.

DEVELOPERS: Second list is dedicated to free exchange of thoughts between people engaged in the Dibbler development. Sadly, this list will be even more desolated then the previous one. If you want to subscribe, please send mail with subject "subscribe" to dibbler-devel-request(at)klub.com.pl. You will receive confirmation request shortly. You can also subscribe to mailing list using www browser. There are list archives .

Requirements

This implementation is developed using tools listed below. It may, of course, work with newer/older versions. Even with other compilers. Marek Senderski developed WinXP version using microsoft Visual C++ 2003, 2005 and 2008 editions. Bison++ has been merged into CVS, so there should be no more problems with obtaining bison++. Note that bison++ is available in Debian GNU/Linux distribution. In parenthesis is version which has been used to develop Dibbler. It will work for sure, but there's pretty good chance that other versions will work, too. Here's the list:

• gcc (2.95 to 4.3.2)
• g++ (2.95 to 4.3.2)
• flex (2.5.35, Windows version included in CVS)
• bison++ (1.21.9 Windows binary and Linux sources included in CVS)
• libxml2 (with pkg-config in Linux)

To generate Windows installer, fantastic Inno Setup tool was used. Code documentation was generated using Doxygen program. Developer's and User's Guide were written in LaTeX.

Older versions

All versions are stored in the /dhcpv6/dibbler/ directory. Take note that they are kept for archeological/sentimental purposes only. Please use latest version only.