dhcp6r



dhcp6r(8)                Linux System Manager’s Manual               dhcp6r(8)




NAME

       dhcp6r - DHCPv6 relay agent


SYNOPSIS

       dhcp6r [ -d ] [ client-options ] [ server-options ]


DESCRIPTION

       dhcp6r  acts  as  DHCPv6  relay  agent  forwarding DHCPv6 messages from
       clients to servers and vice versa.  DHCPv6 messages  from  clients  are
       received  at  UDP  port  547,  they are forwarded to one or more DHCPv6
       servers by multicast and/or unicast.  DHCPv6 messages from  servers  to
       clients  are  also  received  at  UDP port 547 and forwarded by unicast
       only.

       DHCPv6 messages received by multicast at a certain IPv6  interface  are
       never forwarded by multicast to the same interface.

       If no options are present, the relay agent receives messages by unicast
       and multicast at all IPv6 interfaces, and all messages are forwarded to
       all  IPv6  interfaces  by multicast with the exception mentioned in the
       previous paragraph.

       If one or more client-options  are  present,  then  messages  are  only
       received  as  specified  by the client options.  If one or more server-
       options are present, then messages are only forwarded as  specified  by
       the server options.


CLIENT-OPTIONS

       If no client-options are present, the relay receives messages by multi-
       cast and unicast at all IPv6 interfaces.

       If one or more client options  are  present,  then  messages  are  only
       received as specified by the client-options.

       In any case, the relay receives client messages by unicast.

       -cu    This  option  can  be  used to configure the client such that it
              receives messages from clients or other relay agents by  unicast
              only.  It does not have any effect if a -cm option is present.

       -cm INTERFACE
              Accept  client messages multicasted at IPv6 interface INTERFACE.
              The others are receiving only unicast messages. For specifying a
              set  of  interfaces,  an instance of this option is required for
              each interface.


SERVER-OPTIONS

       If no server-options are present, the relay forwards messages  received
       from  clients  by  multicast and unicast to all IPv6 interfaces, except
       the one, which the packet was received on.

       If one or more server-options are present, then messages are  forwarded
       as specified by the server-options.

       -sm INTERFACE
              Forward all received client messages by multicast at IPv6 inter-
              face INTERFACE.  For specifying a set of interfaces, an instance
              of this option is required for each interface.

       -su ADDRESS
              Forward  all  received  client  messages  by unicast to the IPv6
              address ADDRESS.  For specifying a set of addresses, an instance
              of this option is required for each address.

       -sf INTERFACE+ADDRESS
              Forward  all  received  client  messages  by unicast to the IPv6
              address ADDRESS through the IPv6 interface INTERFACE.  For spec-
              ifying  a  set  of  combinations of interfaces and addresses, an
              instance of this option is required for each combination.

       The -sm, -su, and -sf options can be combined in arbitrary ways.


OTHER OPTIONS

       -d     If this option is not present, dhcp6r will dump logging informa-
              tion  into  the  file  /var/log/dhcp6r.log.   If  the  option is
              present, logging information will be sent to stderr instead.


EXAMPLES

       The following examples are shown as given to the shell:


       dhcp6r Receive messages from clients at all IPv6 interfaces  by  multi-
              cast and by unicast, and forward them to all (other) IPv6 inter-
              faces by multicast.


       dhcp6r -cu
              Receive messages from clients by unicast only, and forward  them
              to all (other) IPv6 interfaces by multicast.


       dhcp6r -cm eth0 -cm eth2
              Receive  messages  from  clients  at interfaces eth0 and eth2 by
              multicast and by unicast, and forward them to  all  IPv6  inter-
              faces  by  multicast  (except  the  one at which the message was
              received by multicast).


       dhcp6r -cm eth0 -cm eth2 -sm eth1
              Receive messages from clients at interfaces  eth0  and  eth2  by
              multicast and by unicast, and forward them to interfaces eth1 by
              multicast.


       dhcp6r -su fec0::204:ce33:763f:b34 -su fec0::504:ff33:73f:c557
              Receive messages from clients at all IPv6 interfaces  by  multi-
              cast  and  by unicast, and forward a copy of them to each of the
              specified addresses.


       dhcp6r -sm eth1 -su fec0::204:ce33:763f:b34
              Receive messages from clients at all IPv6 interfaces  by  multi-
              cast  and by unicast, and forward them to interface eth1 by mul-
              ticast and to the specified unicast address.


       dhcp6r -sm eth1 -sf eth0+fec0::504:ff33:73f:c557
              Receive messages from clients at all IPv6 interfaces  by  multi-
              cast  and by unicast, and forward them to interface eth1 by mul-
              ticast and to the specified unicast address.   For  the  unicast
              address  it  is  enforced  that the message will be sent through
              interface eth0.


NOTES

       For proper operation of  dhcp6r,  the  host  must  have  at  least  one
       global/site scope address assigned to each interface.


FILES

       /var/log/dhcv6r.log
       /var/run/dhcp6r.pid


BUGS

       Email bug reports to <bug@dhcpv6.org>


AUTHORS

       Cristian Cadar, <cadar@ccrle.nec.de>
       Juergen Quittek,
       Martin Stiemerling



dhcp6r                           15 March 2004                       dhcp6r(8)

Man(1) output converted with man2html