From 703ae17b5ab7ac05c78265cff0126eace7838430 Mon Sep 17 00:00:00 2001 From: Christian Poessinger Date: Mon, 18 May 2020 08:05:39 +0200 Subject: pppoe: add IPv6 DHCPv6-PD documentation --- docs/interfaces/pppoe.rst | 50 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) (limited to 'docs/interfaces') diff --git a/docs/interfaces/pppoe.rst b/docs/interfaces/pppoe.rst index 8a7f027f..d9b5aa3d 100644 --- a/docs/interfaces/pppoe.rst +++ b/docs/interfaces/pppoe.rst @@ -167,6 +167,38 @@ IPv6 Use this command to enable acquisition of IPv6 address using stateless autoconfig (SLAAC). +Prefix Delegation (DHCPv6-PD) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +VyOS 1.3 (equuleus) supports DHCPv6-PD. DHCPv6 Prefix Delegation is supported +by most ISPs who provide native IPv6 for consumers on fixed networks. + +.. cfgcmd:: set interfaces pppoe dhcpv6-option delegate interfaces-id + + This statement specifies the interface id. ID must be a decimal integer. + It will be combined with the delegated prefix and the sla-id to form a + complete interface address. The default is to use the EUI-64 address of the + interface. + + Example: + + Using `` value 65535 will assign IPv6 address ::ffff to the + interface. + +.. cfgcmd:: set interfaces pppoe dhcpv6-option delegate sla-id + + This statement specifies the identifier value of the site-level aggregator + (SLA) on the interface. ID must be a decimal number greater then 0 which + fits in the length of SLA IDs (see below). For example, if ID is 1 and the + client is delegated an IPv6 prefix 2001:db8:ffff::/48, dhcp6c will combine + the two values into a single IPv6 prefix, 2001:db8:ffff:1::/64, and will + configure the prefix on the specified interface. + +.. cfgcmd:: set interfaces pppoe dhcpv6-option delegate sla-len + + This statement specifies the length of the SLA ID in bits. ` must be a + decimal number between 0 and 128. If the length is not specified by this + statement, the default value 16 will be used. Operation ========= @@ -276,3 +308,21 @@ which is the default VLAN for Deutsche Telekom: set interfaces pppoe pppoe0 authentication password 'secret' set interfaces pppoe pppoe0 source-interface 'eth0.7' + +IPv6 DHCPv6-PD Example +---------------------- + +The following configuration will assign a /64 prefix out of a /56 delegation +to eth0. The IPv6 address assigned to eth0 will be ::ffff/64. +If you do not know the prefix size delegated to you, start with sla-len 0. + +.. code-block:: none + + set interfaces pppoe pppoe0 authentication user vyos + set interfaces pppoe pppoe0 authentication password vyos + set interfaces pppoe pppoe0 dhcpv6-options delegate eth0 interface-id 65535 + set interfaces pppoe pppoe0 dhcpv6-options delegate eth0 sla-id 0 + set interfaces pppoe pppoe0 dhcpv6-options delegate eth0 sla-len 8 + set interfaces pppoe pppoe0 ipv6 address autoconf + set interfaces pppoe pppoe0 ipv6 enable + set interfaces pppoe pppoe0 source-interface eth1 -- cgit v1.2.3