summaryrefslogtreecommitdiff
path: root/docs/interfaces/ethernet.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/interfaces/ethernet.rst')
-rw-r--r--docs/interfaces/ethernet.rst101
1 files changed, 10 insertions, 91 deletions
diff --git a/docs/interfaces/ethernet.rst b/docs/interfaces/ethernet.rst
index 95aef851..1d3aeda3 100644
--- a/docs/interfaces/ethernet.rst
+++ b/docs/interfaces/ethernet.rst
@@ -7,34 +7,12 @@ Ethernet
Configuration
#############
-Address
--------
+Common interface configuration
+------------------------------
-.. cfgcmd:: set interfaces ethernet <interface> address <address | dhcp | dhcpv6>
-
- .. include:: common-ip-ipv6-addr.txt
-
- Example:
-
- .. code-block:: none
-
- set interfaces ethernet eth0 address 192.0.2.1/24
- set interfaces ethernet eth0 address 192.0.2.2/24
- set interfaces ethernet eth0 address 2001:db8::ffff/64
- set interfaces ethernet eth0 address 2001:db8:100::ffff/64
-
-.. cfgcmd:: set interfaces ethernet <interface> ipv6 address autoconf
-
- .. include:: common-ipv6-addr-autoconf.txt
-
-.. cfgcmd:: set interfaces ethernet <interface> ipv6 address eui64 <prefix>
-
- :abbr:`EUI-64 (64-Bit Extended Unique Identifier)` as specified in
- :rfc:`4291` allows a host to assign iteslf a unique 64-Bit IPv6 address.
-
- .. code-block:: none
-
- set interfaces ethernet eth0 ipv6 address eui64 2001:db8:beef::/64
+.. cmdinclude:: ../_include/interface-common-with-dhcp.txt
+ :var0: ethernet
+ :var1: eth0
Speed/Duplex
------------
@@ -67,71 +45,12 @@ Speed/Duplex
VyOS default will be `auto`.
-Link Administration
--------------------
-
-.. cfgcmd:: set interfaces ethernet <interface> description <description>
-
- Assign given `<description>` to interface. Description will also be passed
- to SNMP monitoring systems.
-
-.. cfgcmd:: set interfaces ethernet <interface> disable
-
- Disable given `<interface>`. It will be placed in administratively down
- (``A/D``) state.
-
-.. cfgcmd:: set interfaces ethernet <interface> disable-flow-control
-
- Disable Ethernet flow control (pause frames).
-
-
-.. cfgcmd:: set interfaces ethernet <interface> mac <mac-address>
-
- Configure user defined :abbr:`MAC (Media Access Control)` address on given
- `<interface>`.
-
-.. cfgcmd:: set interfaces ethernet <interface> mtu <mtu>
-
- Configure :abbr:`MTU (Maximum Transmission Unit)` on given `<interface>`. It
- is the size (in bytes) of the largest ethernet frame sent on this link.
-
-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 ethernet <interface> dhcpv6-option pd <id> length <length>
-
- Some ISPs by default only delegate a /64 prefix. To request for a specific
- prefix size use this option to request for a bigger delegation for this pd
- `<id>`. This value
- is in the range from 32 - 64 so you could request up to /32 down to a /64
- delegation.
-
- Default value is 64.
-
-.. cfgcmd:: set interfaces ethernet <interface> dhcpv6-option pd <id> interface <delegatee> address <address>
-
- Specify the interface address used locally on the interfcae where the prefix
- has been delegated to. 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 ``<id>`` value 65535 will assign IPv6 address ``<prefix>::ffff`` to the
- interface.
-
-.. cfgcmd:: set interfaces ethernet <interface> dhcpv6-option pd <id> interface <delegatee> sla-id <id>
+VLAN (802.1q) configuration
+---------------------------
- Specify 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.
+.. cmdinclude:: ../_include/interface-vlan.txt
+ :var0: ethernet
+ :var1: eth0
Operation
=========