dibbler-client(8) a portable DHCPv6 client

DESCRIPTION

dibbler-client is a portable implementation of the DHCPv6 client. It supports both stateful (i.e. IPv6 address granting) and stateless (i.e. options granting) autoconfiguration. There are ports available for Linux 2.4/2.6 systems as well as MS Windows XP and 2003. They are freely available under GNU GPL version 2 (or later) license.

SYNOPSIS

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

OPTIONS

run - starts client in the console. Client can be closed using ctrl-c.

start - starts client in daemon mode.

stop - stops running clients.

status - shows status of the client and server.

install - installs client as a service. This is not implemented yet.

uninstall - uninstall client service. This is not implemented yet.

EXAMPLES

Let's start with simple configuration. We want receive one IPv6 address and there is only one Ethernet interface present. In that case client.conf file might be completly empty. Dibbler client will request for one IPv6 address on each up, running and multicast capable interface (except loopback).

Now some real example. We want one IPv6 address and 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 lifetime option. We don't need any addresses so stateless mode is used.

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. Dibbler client reads /var/lib/dibbler/client.conf file. 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. Option values are stored in the option-* files. Log file is named client.log.

STANDARDS

This implementation aims at conformance to the following standards:

RFC 3315 DHCP for IPv6

RFC 3319 SIP options for DHCPv6

RFC 3646 DNS server options for DHCPv6

RFC 3736 Stateless DHCPv6

RFC 3898 NIS options for DHCPv6

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.

AUTHOR

Dibbler was developed as 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 [email protected] and [email protected]