1dhcp6r(8) Linux System Manager's Manual dhcp6r(8)
2
6 dhcp6r - DHCPv6 relay agent
7
9 dhcp6r [ -d ] [ client-options ] [ server-options ]
10
12 dhcp6r acts as DHCPv6 relay agent forwarding DHCPv6 messages from
13 clients to servers and vice versa. DHCPv6 messages from clients are
14 received at UDP port 547, they are forwarded to one or more DHCPv6
15 servers by multicast and/or unicast. DHCPv6 messages from servers to
16 clients are also received at UDP port 547 and forwarded by unicast
17 only.
18 DHCPv6 messages received by multicast at a certain IPv6 interface are
20 never forwarded by multicast to the same interface.
21 If no options are present, the relay agent receives messages by unicast
23 and multicast at all IPv6 interfaces, and all messages are forwarded to
24 all IPv6 interfaces by multicast with the exception mentioned in the
25 previous paragraph.
26 If one or more client-options are present, then messages are only
28 received as specified by the client options. If one or more server-
29 options are present, then messages are only forwarded as specified by
30 the server options.
31
33 If no client-options are present, the relay receives messages by multi‐
34 cast and unicast at all IPv6 interfaces.
35 If one or more client options are present, then messages are only
37 received as specified by the client-options.
38 In any case, the relay receives client messages by unicast.
40 -cu This option can be used to configure the client such that it
42 receives messages from clients or other relay agents by unicast
43 only. It does not have any effect if a -cm option is present.
44 -cm INTERFACE
46 Accept client messages multicasted at IPv6 interface INTERFACE.
47 The others are receiving only unicast messages. For specifying a
48 set of interfaces, an instance of this option is required for
49 each interface.
50
52 If no server-options are present, the relay forwards messages received
53 from clients by multicast and unicast to all IPv6 interfaces, except
54 the one, which the packet was received on.
55 If one or more server-options are present, then messages are forwarded
57 as specified by the server-options.
58 -sm INTERFACE
60 Forward all received client messages by multicast at IPv6 inter‐
61 face INTERFACE. For specifying a set of interfaces, an instance
62 of this option is required for each interface.
63 -su ADDRESS
65 Forward all received client messages by unicast to the IPv6
66 address ADDRESS. For specifying a set of addresses, an instance
67 of this option is required for each address.
68 -sf INTERFACE+ADDRESS
70 Forward all received client messages by unicast to the IPv6
71 address ADDRESS through the IPv6 interface INTERFACE. For spec‐
72 ifying a set of combinations of interfaces and addresses, an
73 instance of this option is required for each combination.
74 The -sm, -su, and -sf options can be combined in arbitrary ways.
76
78 -d If this option is not present, dhcp6r will dump logging informa‐
79 tion into the file /var/log/dhcp6r.log. If the option is
80 present, logging information will be sent to stderr instead.
81
83 The following examples are shown as given to the shell:
84 dhcp6r
87 Receive messages from clients at all IPv6 interfaces by multi‐
88 cast and by unicast, and forward them to all (other) IPv6 inter‐
89 faces by multicast.
90 dhcp6r -cu
93 Receive messages from clients by unicast only, and forward them
94 to all (other) IPv6 interfaces by multicast.
95 dhcp6r -cm eth0 -cm eth2
98 Receive messages from clients at interfaces eth0 and eth2 by
99 multicast and by unicast, and forward them to all IPv6 inter‐
100 faces by multicast (except the one at which the message was
101 received by multicast).
102 dhcp6r -cm eth0 -cm eth2 -sm eth1
105 Receive messages from clients at interfaces eth0 and eth2 by
106 multicast and by unicast, and forward them to interfaces eth1 by
107 multicast.
108 dhcp6r -su fec0::204:ce33:763f:b34 -su fec0::504:ff33:73f:c557
111 Receive messages from clients at all IPv6 interfaces by multi‐
112 cast and by unicast, and forward a copy of them to each of the
113 specified addresses.
114 dhcp6r -sm eth1 -su fec0::204:ce33:763f:b34
117 Receive messages from clients at all IPv6 interfaces by multi‐
118 cast and by unicast, and forward them to interface eth1 by mul‐
119 ticast and to the specified unicast address.
120 dhcp6r -sm eth1 -sf eth0+fec0::504:ff33:73f:c557
123 Receive messages from clients at all IPv6 interfaces by multi‐
124 cast and by unicast, and forward them to interface eth1 by mul‐
125 ticast and to the specified unicast address. For the unicast
126 address it is enforced that the message will be sent through
127 interface eth0.
128
130 For proper operation of dhcp6r, the host must have at least one
131 global/site scope address assigned to each interface.
132
134 /var/log/dhcv6r.log
135 /var/run/dhcp6r.pid
136
138 Email bug reports to <bug@dhcpv6.org>
139
141 Cristian Cadar, <cadar@ccrle.nec.de>
142 Juergen Quittek,
143 Martin Stiemerling
144dhcp6r 15 March 2004 dhcp6r(8)