Man Linux: Main Page and Category List

NAME

       dibbler-relay - a portable DHCPv6 relay

DESCRIPTION

       dibbler-relay  is a portable implementation of the DHCPv6 relay. DHCPv6
       relays are proxies, which allow one  server  to  support  links,  which
       server  is  not  directly  connected  to. 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-relay [ run | start | stop | status ]

OPTIONS

       run - starts relay in the console. Relay can be closed using ctrl-c.

       start - starts relay in daemon mode.

       stop - stops running relay.

       status - shows status of the relay.

EXAMPLES

       Relay forwards DHCPv6 messages between interfaces. Messages from client
       are encapsulated and forwarded as  RELAY_FORW  messages.  Replies  from
       server  are  received  as RELAY_REPL message. After decapsulation, they
       are being sent back to clients.

       It is vital to inform server, where this relayed message was  received.
       DHCPv6  does  this  using  interface-id option. This identifier must be
       unique. Otherwise relays will get confused when they will receive reply
       from server. Note that this id does not need to be alligned with system
       interface id (ifindex). Think about it as "ethernet segment identifier"
       if  you  are  using  Ethernet network or as "bss identifier" if you are
       using 802.11 network.

       Let’s assume this case: relay has 2 interfaces: eth0 and eth1.  Clients
       are  located  on  the  eth1  network. Relay should receive data on that
       interface using well-known ALL_DHCP_RELAYS_AND_SERVER multicast address
       (ff02::1:2).  Relay  also  listens  on  its  global  address 2000::123.
       Packets received on the eth1 should be forwarded on the eth0 interface,
       also using multicast address:

       log-level 8
       log-mode short

       iface eth0 {
         server multicast yes
       }

       iface eth1 {
         client multicast yes
         client unicast 2000::123
         interface-id 1000
       }

       Here  is  another  exmaple. This time messages should be forwarded from
       eth1 and eth3 to the eth0 interface (using multicast) and to  the  eth2
       interface  (using server’s global address 2000::546). Also clients must
       use multicasts (the default approach):

       iface eth0 {
         server multicast yes
       }

       iface eth2 {
         server unicast 2000::456
       }

       iface eth1 {
         client multicast yes
         interface-id 1000
       }

       iface eth3 {
         client multicast yes
         interface-id 1001
       }

FILES

       All  files  are  created  in  the  /var/lib/dibbler  directory.  During
       operation,  Dibbler saves various file in that directory. Dibbler relay
       reads /etc/dibbler/relay.conf file. Log file is named client.log.

STANDARDS

       This implementation aims at conformance to the following standards:

       RFC 3315 DHCP for IPv6

       RFC 3736 Stateless DHCPv6

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. Author can be reached at thomson@klub.com.pl.

SEE ALSO

       There   are   dibbler-server(8)   and  dibbler-client(8)  manual  pages
       available. 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 and the  only
       one  with  relay  support. 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.