NAME

       dibbler-client - 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 thomson@klub.com.pl and msend@o2.pl

SEE ALSO

       There is 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.