Linux Certif

Toute la documentation sur la certification Linux LPI

dhcp6r

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 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 multicast.

 

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 specified 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/dhcp6r.pid

BUGS

Report bugs via http://hosted.fedoraproject.org/projects/dhcpv6/

AUTHORS

See http://hosted.fedoraproject.org/projects/dhcpv6/wiki/Authors