.. _ethernet-interface: ######## Ethernet ######## Configuration ############# Common interface configuration ------------------------------ .. cmdinclude:: ../_include/interface-common-with-dhcp.txt :var0: ethernet :var1: eth0 Speed/Duplex ------------ .. cfgcmd:: set interfaces ethernet duplex Configure physical interface duplex setting. * auto - interface duplex setting is auto-negotiated * full - always use full-duplex * half - always use half-duplex VyOS default will be `auto`. .. cfgcmd:: set interfaces ethernet speed Configure physical interface speed setting. * auto - interface speed is auto-negotiated * 10 - 10 MBit/s * 100 - 100 MBit/s * 1000 - 1 GBit/s * 2500 - 2.5 GBit/s * 5000 - 5 GBit/s * 10000 - 10 GBit/s * 25000 - 25 GBit/s * 40000 - 40 GBit/s * 50000 - 50 GBit/s * 100000 - 100 GBit/s VyOS default will be `auto`. Link Administration ------------------- .. cfgcmd:: set interfaces ethernet description Assign given `` to interface. Description will also be passed to SNMP monitoring systems. .. cfgcmd:: set interfaces ethernet disable Disable given ``. It will be placed in administratively down (``A/D``) state. .. cfgcmd:: set interfaces ethernet disable-flow-control Disable Ethernet flow control (pause frames). .. cfgcmd:: set interfaces ethernet mac Configure user defined :abbr:`MAC (Media Access Control)` address on given ``. .. cfgcmd:: set interfaces ethernet mtu Configure :abbr:`MTU (Maximum Transmission Unit)` on given ``. 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 dhcpv6-option pd 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 ``. 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 dhcpv6-option pd interface 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 ```` value 65535 will assign IPv6 address ``::ffff`` to the interface. .. cfgcmd:: set interfaces ethernet dhcpv6-option pd interface sla-id 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. Operation ========= .. opcmd:: show interfaces ethernet Show brief interface information. .. code-block:: none vyos@vyos:~$ show interfaces ethernet Codes: S - State, L - Link, u - Up, D - Down, A - Admin Down Interface IP Address S/L Description --------- ---------- --- ----------- eth0 172.18.201.10/24 u/u LAN eth1 172.18.202.11/24 u/u WAN eth2 - u/D .. opcmd:: show interfaces ethernet Show detailed information on given `` .. code-block:: none vyos@vyos:~$ show interfaces ethernet eth0 eth0: mtu 1500 qdisc pfifo_fast state UP group default qlen 1000 link/ether 00:50:44:00:f5:c9 brd ff:ff:ff:ff:ff:ff inet6 fe80::250:44ff:fe00:f5c9/64 scope link valid_lft forever preferred_lft forever RX: bytes packets errors dropped overrun mcast 56735451 179841 0 0 0 142380 TX: bytes packets errors dropped carrier collisions 5601460 62595 0 0 0 0 .. opcmd:: show interfaces ethernet physical Show information about physical `` .. code-block:: none vyos@vyos:~$ show interfaces ethernet eth0 physical Settings for eth0: Supported ports: [ TP ] Supported link modes: 1000baseT/Full 10000baseT/Full Supported pause frame use: No Supports auto-negotiation: No Supported FEC modes: Not reported Advertised link modes: Not reported Advertised pause frame use: No Advertised auto-negotiation: No Advertised FEC modes: Not reported Speed: 10000Mb/s Duplex: Full Port: Twisted Pair PHYAD: 0 Transceiver: internal Auto-negotiation: off MDI-X: Unknown Supports Wake-on: uag Wake-on: d Link detected: yes driver: vmxnet3 version: 1.4.16.0-k-NAPI firmware-version: expansion-rom-version: bus-info: 0000:0b:00.0 supports-statistics: yes supports-test: no supports-eeprom-access: no supports-register-dump: yes supports-priv-flags: no .. opcmd:: show interfaces ethernet physical offload Show available offloading functions on given `` .. code-block:: none vyos@vyos:~$ show interfaces ethernet eth0 physical offload rx-checksumming on tx-checksumming on tx-checksum-ip-generic on scatter-gather off tx-scatter-gather off tcp-segmentation-offload off tx-tcp-segmentation off tx-tcp-mangleid-segmentation off tx-tcp6-segmentation off udp-fragmentation-offload off generic-segmentation-offload off generic-receive-offload off large-receive-offload off rx-vlan-offload on tx-vlan-offload on ntuple-filters off receive-hashing on tx-gre-segmentation on tx-gre-csum-segmentation on tx-udp_tnl-segmentation on tx-udp_tnl-csum-segmentation on tx-gso-partial on tx-nocache-copy off rx-all off .. opcmd:: show interfaces ethernet transceiver Show transceiver information from plugin modules, e.g SFP+, QSFP .. code-block:: none vyos@vyos:~$ show interfaces ethernet eth5 transceiver Identifier : 0x03 (SFP) Extended identifier : 0x04 (GBIC/SFP defined by 2-wire interface ID) Connector : 0x07 (LC) Transceiver codes : 0x00 0x00 0x00 0x01 0x00 0x00 0x00 0x00 0x00 Transceiver type : Ethernet: 1000BASE-SX Encoding : 0x01 (8B/10B) BR, Nominal : 1300MBd Rate identifier : 0x00 (unspecified) Length (SMF,km) : 0km Length (SMF) : 0m Length (50um) : 550m Length (62.5um) : 270m Length (Copper) : 0m Length (OM3) : 0m Laser wavelength : 850nm Vendor name : CISCO-FINISAR Vendor OUI : 00:90:65 Vendor PN : FTRJ-8519-7D-CS4 Vendor rev : A Option values : 0x00 0x1a Option : RX_LOS implemented Option : TX_FAULT implemented Option : TX_DISABLE implemented BR margin, max : 0% BR margin, min : 0% Vendor SN : FNS092xxxxx Date code : 0506xx