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.