|
|
dhcp6r(8) 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 for- warded 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 multicast 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 interface 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 specifying 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 information 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 multicast and by unicast, and forward them to all (other) IPv6 interfaces 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 interfaces 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 multi- cast. dhcp6r -su fec0::204:ce33:763f:b34 -su fec0::504:ff33:73f:c557 Receive messages from clients at all IPv6 interfaces by multicast and by unicast, and forward a copy of them to each of the speci- fied addresses. dhcp6r -sm eth1 -su fec0::204:ce33:763f:b34 Receive messages from clients at all IPv6 interfaces by multicast and by unicast, and forward them to interface eth1 by multicast 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 multicast and by unicast, and forward them to interface eth1 by multicast 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/dhcpv6/dhcp6r.pid BUGS
Report bugs via http://fedorahosted.org/dhcpv6/ AUTHORS
See http://fedorahosted.org/dhcpv6/wiki/Authors dhcp6r(8)