1. Vyatta
Suite 200
1301 Shoreway Road
Belmont, CA 94002
vyatta.com
650 413 7200
1 888 VYATTA 1 (US and Canada)
VYATTA, INC. | Vyatta System
LAN Interfaces
REFERENCE GUIDE
Loopback Interface
Ethernet Interfaces
Ethernet Link Bonding Interfaces
Pseudo‐Ethernet Interfaces
Wireless Interfaces
VLAN Interfaces
Input Interfaces

2. COPYRIGHT
Copyright © 2005–2012 Vyatta, Inc. All rights reserved.
Vyatta reserves the right to make changes to software, hardware, and documentation without notice. For the most recent version of
documentation, visit the Vyatta web site at vyatta.com.
PROPRIETARY NOTICES
Vyatta is a registered trademark of Vyatta, Inc.
Hyper‐V is a registered trademark of Microsoft Corporation.
VMware, VMware ESX, and VMware server are trademarks of VMware, Inc.
XenServer, and XenCenter are trademarks of Citrix Systems, Inc.
All other trademarks are the property of their respective owners.
RELEASE DATE: October 2012
DOCUMENT REVISION. 6.5R1 v01
RELEASED WITH: 6.5R1
PART NO. A0‐0211‐10‐0017

3. iii
LAN Interfaces 6.5R1 v01 Vyatta
Contents
Quick List of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
List of Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Organization of This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
Vyatta Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Chapter 1 Loopback Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Loopback Interface Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Loopback Interface Configuration Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Configuring Network Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
IPv6 on the Loopback Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Loopback Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
clear interfaces loopback counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
interfaces loopback lo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
interfaces loopback lo address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
interfaces loopback lo description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
show interfaces loopback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 2 Ethernet Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Ethernet Interfaces Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Ethernet Interface Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Viewing System Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Basic Ethernet Interface Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Ethernet Multinetting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
IPv6 on Ethernet Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Ethernet Interface Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
clear interfaces ethernet counters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
interfaces ethernet <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
interfaces ethernet <ethx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
interfaces ethernet <ethx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
interfaces ethernet <ethx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
interfaces ethernet <ethx> disable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
interfaces ethernet <ethx> disable‐flow‐control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

4. iv
LAN Interfaces 6.5R1 v01 Vyatta
interfaces ethernet <ethx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
interfaces ethernet <ethx> duplex <duplexity> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
interfaces ethernet <ethx> hw‐id <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
interfaces ethernet <ethx> ip enable‐proxy‐arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
interfaces ethernet <ethx> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
interfaces ethernet <ethx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
interfaces ethernet <ethx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
interfaces ethernet <ethx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
interfaces ethernet <ethx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
interfaces ethernet <ethx> mirror <interface> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
interfaces ethernet <ethx> mtu <mtu> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
interfaces ethernet <ethx> redirect <interface>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
interfaces ethernet <ethx> smp_affinity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
interfaces ethernet <ethx> speed <speed>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
monitor interfaces ethernet <ethx> traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
show interfaces ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
show interfaces ethernet detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
show interfaces ethernet <ethx> brief. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
show interfaces ethernet <ethx> identify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
show interfaces ethernet <ethx> physical. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
show interfaces ethernet <ethx> queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
show interfaces ethernet <ethx> statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Chapter 3 Ethernet Link Bonding Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Ethernet Link Bonding Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Ethernet Bonding Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Basic Ethernet Bonding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Ethernet Bonding with VLAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
IPv6 on Ethernet Link Bonding Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Ethernet Link Bonding Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
interfaces bonding <bondx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
interfaces bonding <bondx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
interfaces bonding <bondx> arp‐monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
interfaces bonding <bondx> description <desc>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
interfaces bonding <bondx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
interfaces bonding <bondx> disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
interfaces bonding <bondx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
interfaces bonding <bondx> hash‐policy <policy> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
interfaces bonding <bondx> ip enable‐proxy‐arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
interfaces bonding <bondx> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
interfaces bonding <bondx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

5. v
LAN Interfaces 6.5R1 v01 Vyatta
interfaces bonding <bondx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
interfaces bonding <bondx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
interfaces bonding <bondx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
interfaces bonding <bondx> mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
interfaces bonding <bondx> mtu <mtu> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
interfaces bonding <bondx> primary <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
interfaces ethernet <ethx> bond‐group <bondx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
show interfaces bonding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Chapter 4 Pseudo‐Ethernet Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Pseudo‐Ethernet Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Pseudo‐Ethernet Interface Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Creating a Pseudo‐Ethernet Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
IPv6 on Pseudo‐Ethernet Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Pseudo‐Ethernet Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
interfaces pseudo‐ethernet <pethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
interfaces pseudo‐ethernet <pethx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
interfaces pseudo‐ethernet <pethx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
interfaces pseudo‐ethernet <pethx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
interfaces pseudo‐ethernet <pethx> disable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
interfaces pseudo‐ethernet <pethx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
interfaces pseudo‐ethernet <pethx> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
interfaces pseudo‐ethernet <pethx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
interfaces pseudo‐ethernet <pethx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . 140
interfaces pseudo‐ethernet <pethx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
interfaces pseudo‐ethernet <pethx> link <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
interfaces pseudo‐ethernet <pethx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Chapter 5 Wireless Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Wireless Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Wireless Interface Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Configuring a Wireless Access Point. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Configuring a Wireless Station . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
IPv6 on Wireless Interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Wireless Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
interfaces wireless <wlanx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
interfaces wireless <wlanx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
interfaces wireless <wlanx> channel <channel> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
interfaces wireless <wlanx> country <country> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
interfaces wireless <wlanx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
interfaces wireless <wlanx> dhcpv6‐options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

6. vi
LAN Interfaces 6.5R1 v01 Vyatta
interfaces wireless <wlanx> disable‐broadcast‐ssid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
interfaces wireless <wlanx> disable‐link‐detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
interfaces wireless <wlanx> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
interfaces wireless <wlanx> ipv6 disable‐forwarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
interfaces wireless <wlanx> ipv6 dup‐addr‐detect‐transmits <num>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
interfaces wireless <wlanx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
interfaces wireless <wlanx> mac <mac‐addr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
interfaces wireless <wlanx> mode <mode> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
interfaces wireless <wlanx> physical‐device <device> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
interfaces wireless <wlanx> security wep key <key> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
interfaces wireless <wlanx> security wpa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
interfaces wireless <wlanx> ssid <ssid> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
interfaces wireless <wlanx> type <type>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
monitor interfaces wireless <wlanx> traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
show interfaces wireless . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
show interfaces wireless <wlanx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
show interfaces wireless <wlanx> brief . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
show interfaces wireless <wlanx> queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
show interfaces wireless <wlanx> scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
show interfaces wireless <wlanx> stations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Chapter 6 VLAN Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
VLAN Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
VLAN Operation Using vifs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Interface Types Supporting VLAN Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
VLAN Operation vs. Multinetting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Simultaneous Ethernet and 802.1Q Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Referring to VLAN Interfaces in Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
IPv6 Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
VLAN Interface Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
VLAN Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
IPv6 on VLAN Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
VLAN Interface Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
interfaces <interface> vif <vlan‐id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
interfaces <interface> vif <vlan‐id> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
interfaces <interface> vif <vlan‐id> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
interfaces <interface> vif <vlan‐id> dhcpv6‐options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
interfaces <interface> vif <vlan‐id> disable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
interfaces <interface> vif <vlan‐id> disable‐link‐detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
interfaces <interface> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
interfaces <interface> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

7. vii
LAN Interfaces 6.5R1 v01 Vyatta
interfaces <interface> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
interfaces <interface> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
show interfaces <interface> vif <vlan‐id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Chapter 7 Input Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Input Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Input Interface Configuration Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Creating an Input Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
IPv6 on Input Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Input Interface Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
interfaces input <ifbx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
interfaces input <ifbx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
show interfaces input <ifbx> vif <vlan‐id>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Glossary of Acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

8. viii
LAN Interfaces 6.5R1 v01 Vyatta

9. ix
LAN Interfaces 6.5R1 v01 Vyatta

10. x
LAN Interfaces 6.5R1 v01 Vyatta
Quick List of Commands
Use this list to help you quickly locate commands.
clear interfaces ethernet counters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
clear interfaces loopback counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
interfaces <interface> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
interfaces <interface> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
interfaces <interface> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
interfaces <interface> ipv6 router‐advert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
interfaces <interface> vif <vlan‐id> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
interfaces <interface> vif <vlan‐id> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
interfaces <interface> vif <vlan‐id> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
interfaces <interface> vif <vlan‐id> disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
interfaces <interface> vif <vlan‐id> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
interfaces <interface> vif <vlan‐id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
interfaces bonding <bondx> address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
interfaces bonding <bondx> arp‐monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
interfaces bonding <bondx> description <desc> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
interfaces bonding <bondx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
interfaces bonding <bondx> disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
interfaces bonding <bondx> disable‐link‐detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
interfaces bonding <bondx> hash‐policy <policy> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
interfaces bonding <bondx> ip enable‐proxy‐arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
interfaces bonding <bondx> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
interfaces bonding <bondx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
interfaces bonding <bondx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
interfaces bonding <bondx> ipv6 router‐advert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
interfaces bonding <bondx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
interfaces bonding <bondx> mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
interfaces bonding <bondx> mtu <mtu>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
interfaces bonding <bondx> primary <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
interfaces bonding <bondx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
interfaces ethernet <ethx> address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
interfaces ethernet <ethx> bond‐group <bondx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
interfaces ethernet <ethx> description <descr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

11. xi
LAN Interfaces 6.5R1 v01 Vyatta
interfaces ethernet <ethx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
interfaces ethernet <ethx> disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
interfaces ethernet <ethx> disable‐flow‐control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
interfaces ethernet <ethx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
interfaces ethernet <ethx> duplex <duplexity> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
interfaces ethernet <ethx> hw‐id <mac‐addr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
interfaces ethernet <ethx> ip enable‐proxy‐arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
interfaces ethernet <ethx> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
interfaces ethernet <ethx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
interfaces ethernet <ethx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
interfaces ethernet <ethx> ipv6 router‐advert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
interfaces ethernet <ethx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
interfaces ethernet <ethx> mirror <interface>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
interfaces ethernet <ethx> mtu <mtu>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
interfaces ethernet <ethx> redirect <interface> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
interfaces ethernet <ethx> smp_affinity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
interfaces ethernet <ethx> speed <speed>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
interfaces ethernet <ethx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
interfaces input <ifbx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
interfaces input <ifbx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
interfaces loopback lo address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
interfaces loopback lo description <descr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
interfaces loopback lo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
interfaces pseudo‐ethernet <pethx> address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
interfaces pseudo‐ethernet <pethx> description <descr>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
interfaces pseudo‐ethernet <pethx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
interfaces pseudo‐ethernet <pethx> disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
interfaces pseudo‐ethernet <pethx> disable‐link‐detect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
interfaces pseudo‐ethernet <pethx> ipv6 address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
interfaces pseudo‐ethernet <pethx> ipv6 disable‐forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
interfaces pseudo‐ethernet <pethx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
interfaces pseudo‐ethernet <pethx> ipv6 router‐advert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
interfaces pseudo‐ethernet <pethx> link <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
interfaces pseudo‐ethernet <pethx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
interfaces pseudo‐ethernet <pethx>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
interfaces wireless <wlanx> address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

12. xii
LAN Interfaces 6.5R1 v01 Vyatta
interfaces wireless <wlanx> channel <channel>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
interfaces wireless <wlanx> country <country> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
interfaces wireless <wlanx> description <descr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
interfaces wireless <wlanx> dhcpv6‐options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
interfaces wireless <wlanx> disable‐broadcast‐ssid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
interfaces wireless <wlanx> disable‐link‐detect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
interfaces wireless <wlanx> ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
interfaces wireless <wlanx> ipv6 disable‐forwarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
interfaces wireless <wlanx> ipv6 dup‐addr‐detect‐transmits <num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
interfaces wireless <wlanx> ipv6 router‐advert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
interfaces wireless <wlanx> mac <mac‐addr> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
interfaces wireless <wlanx> mode <mode> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
interfaces wireless <wlanx> physical‐device <device>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
interfaces wireless <wlanx> security wep key <key> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
interfaces wireless <wlanx> security wpa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
interfaces wireless <wlanx> ssid <ssid>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
interfaces wireless <wlanx> type <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
interfaces wireless <wlanx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
monitor interfaces ethernet <ethx> traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
monitor interfaces wireless <wlanx> traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
show interfaces <interface> vif <vlan‐id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
show interfaces bonding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
show interfaces ethernet <ethx> brief . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
show interfaces ethernet <ethx> identify. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
show interfaces ethernet <ethx> physical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
show interfaces ethernet <ethx> queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
show interfaces ethernet <ethx> statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
show interfaces ethernet detail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
show interfaces ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
show interfaces input <ifbx> vif <vlan‐id>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
show interfaces loopback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
show interfaces wireless <wlanx> brief. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
show interfaces wireless <wlanx> queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
show interfaces wireless <wlanx> scan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
show interfaces wireless <wlanx> stations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
show interfaces wireless <wlanx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

13. xiii
LAN Interfaces 6.5R1 v01 Vyatta
show interfaces wireless. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

14. xiv
LAN Interfaces 6.5R1 v01 Vyatta

15. xv
LAN Interfaces 6.5R1 v01 Vyatta

16. xvi
LAN Interfaces 6.5R1 v01 Vyatta
List of Examples
Use this list to help you locate examples you’d like to look at or try.
Example 1‐1 Configuring the loopback interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Example 1‐2 Displaying loopback interface information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Example 1‐3 Displaying additional loopback interface detail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Example 2‐1 Viewing available system interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Example 2‐2 Configuring Ethernet interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Example 2‐3 Configuring Ethernet multinetting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Example 2‐4 Displaying traffic data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Example 2‐5 Displaying information for all Ethernet interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Example 2‐6 Displaying information for one Ethernet interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Example 2‐7 Displaying detailed Ethernet interface information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Example 2‐8 Displaying brief Ethernet interface status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Example 2‐9 Identifying an Ethernet interface by blinking its LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Example 2‐10 Displaying physical line characteristics for an Ethernet interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Example 2‐11 Displaying Ethernet queue information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Example 2‐12 Displaying Ethernet statistics information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Example 3‐1 Creating a bond group with two Ethernet interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Example 3‐2 Adding a VLAN to an existing bonding interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Example 3‐3 Displaying information about the bonding interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Example 3‐4 Displaying information about the bonding slaves. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Example 4‐1 Creating a pseudo‐Ethernet interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Example 5‐1 Configuring an Access Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Example 5‐2 Configuring a Station. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Example 5‐3 Displaying captured data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Example 5‐4 Displaying wireless interface information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Example 5‐5 Displaying detailed wireless interfaces information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Example 5‐6 Displaying wireless‐specific information for all wireless interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Example 5‐7 Displaying status and statistics for a specific wireless interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

17. xvii
LAN Interfaces 6.5R1 v01 Vyatta
Example 5‐8 Displaying summary status for a wireless interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Example 5‐9 Displaying wireless interface queue information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Example 5‐10 Displaying scan information for a specific wireless interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Example 5‐11 Displaying detailed scan information for a specific wireless interface . . . . . . . . . . . . . . . . . . . . . . . 206
Example 5‐12 Displaying station data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Example 6‐2 Displaying virtual interface information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Example 6‐3 Displaying brief status for a virtual interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Example 6‐4 Displaying VLAN interface queue information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Example 7‐1 Configuring an Input interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Example 7‐2 Displaying Input interface information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Example 7‐3 Displaying queue information for an Input interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

18. xviii
LAN Interfaces 6.5R1 v01 Vyatta
Preface
This document describes the various deployment, installation, and upgrade options
for Vyatta software.
This preface provides information about using this guide. The following topics are
presented:
• Intended Audience
• Organization of This Guide
• Document Conventions
• Vyatta Publications

19. Intended Audience xix
LAN Interfaces 6.5R1 v01 Vyatta
Intended Audience
This guide is intended for experienced system and network administrators.
Depending on the functionality to be used, readers should have specific knowledge
in the following areas:
• Networking and data communications
• TCP/IP protocols
• General router configuration
• Routing protocols
• Network administration
• Network security
• IP services
Organization of This Guide
This guide has the following aid to help you find the information you are looking for:
• Quick List of Commands
Use this list to help you quickly locate commands.
• List of Examples
Use this list to help you locate examples you’d like to try or look at.
This guide has the following chapters:
Chapter Description Page
Chapter 1: Loopback Interface This chapter explains how to work with the
Vyatta system’s software loopback interface.
1
Chapter 2: Ethernet Interfaces This chapter describes basic configuration for
Ethernet interfaces.
13
Chapter 3: Ethernet Link Bonding
Interfaces
This chapter explains how to bond Ethernet
links into a larger virtual link.
75
Chapter 4: Pseudo‐Ethernet
Interfaces
This chapter describes how to create a
pseudo‐Ethernet interface by defining
multiple MAC addresses on a single physical
interface.
121
Chapter 5: Wireless Interfaces This chapter explains how to work with
wireless interfaces on the Vyatta system.
151

20. Document Conventions xx
LAN Interfaces 6.5R1 v01 Vyatta
Document Conventions
This guide uses the following advisory paragraphs, as follows.
NOTE Notes provide information you might need to avoid problems or configuration errors.
This document uses the following typographic conventions.
Chapter 6: VLAN Interfaces This chapter lists the commands for
configuring VLAN interfaces on Ethernet
interfaces and Ethernet bonded links.
208
Chapter 7: Input Interface This chapter explains how to work with Input
interfaces on the Vyatta system.
240
Glossary of Acronyms 249
WARNING Warnings alert you to situations that may pose a threat to personal safety.
CAUTION Cautions alert you to situations that might cause harm to your system or damage to
equipment, or that may affect service.
Monospace Examples, command-line output, and representations of
configuration nodes.
bold Monospace Your input: something you type at a command line.
bold Commands, keywords, and file names, when mentioned
inline.
Objects in the user interface, such as tabs, buttons, screens,
and panes.
italics An argument or variable where you supply a value.
<key> A key on your keyboard, such as <Enter>. Combinations of
keys are joined by plus signs (“+”), as in <Ctrl>+c.
[ key1 | key2] Enumerated options for completing a syntax. An example is
[enable | disable].
num1–numN A inclusive range of numbers. An example is 1–65535, which
means 1 through 65535, inclusive.

21. Vyatta Publications xxi
LAN Interfaces 6.5R1 v01 Vyatta
Vyatta Publications
Full product documentation is provided in the Vyatta technical library. To see what
documentation is available for your release, see the Guide to Vyatta Documentation.
This guide is posted with every release of Vyatta software and provides a great
starting point for finding the information you need.
Additional information is available on www.vyatta.com and www.vyatta.org.
arg1..argN A range of enumerated values. An example is eth0..eth3,
which means eth0, eth1, eth2, or eth3.
arg[ arg...]
arg[,arg...]
A value that can optionally represent a list of elements (a
space-separated list and a comma-separated list, respectively).

22. 1
LAN Interfaces 6.5R1 v01 Vyatta
Chapter 1: Loopback Interface
This chapter explains how to work with the Vyatta system’s software loopback
interface.
This chapter presents the following topics:
• Loopback Interface Overview
• Loopback Interface Configuration Examples
• Loopback Interface Commands

23. Chapter 1: Loopback Interface Loopback Interface Overview 2
LAN Interfaces 6.5R1 v01 Vyatta
Loopback Interface Overview
The loopback interface is a special software-only interface that emulates a physical
interface and allows the router to “connect” to itself. Packets routed to the loopback
interface are rerouted back to the router and processed locally. Packets routed out
the loopback interface but not destined for the loopback interface are dropped.
The loopback interface provides a number of advantages:
• As long as the router is functioning, the loopback interface is always up, and so
is very reliable. As long as there is even one functioning link to the router, the
loopback interface can be accessed. The loopback interface thus eliminates the
need to try each IP address of the router until you find one that is still up.
• Because the loopback interface is always up, a routing session (such as a BGP
session) can continue even if the outbound interface fails.
• You can simplify collection of management information by specifying the
loopback interface as the interface for sending and receiving management
information such as logs and SNMP traps.
• The loopback interface can be used to increase security, by filtering incoming
traffic using access control rules that specify the local interface as the only
acceptable destination.
• In OSPF, you can advertise a loopback interface as an interface route into the
network, regardless of whether physical links are up or down. This increases
reliability by allowing traffic to take alternate paths if one or more physical links
go down.
• In BGP, parallel paths can be configured to the loopback interface on a peer
device. This provides improved load sharing and redundancy.
The router automatically creates the loopback interface on startup, with an interface
name of lo. It also automatically configures the loopback address with standard IP
addressing:
• As per RFC 5735, the IPv4 address 127.0.0.1/8 is assigned to the loopback
address. Typically, the IPv4 address assigned to the loopback device is 127.0.0.1
for IPv4, although any address in the range 127.0.0.0 to 127.255.255.255 is
mapped to it.
• As per RFC 3513, the IPv6, IP address ::1/128 is assigned to the loopback
interface.
• As per RFC 2606, the domain name localhost is mapped to the loopback
addresses.
When configuring the router, it is good practice to take advantage of the loopback
interface’s reliability:

24. Chapter 1: Loopback Interface Loopback Interface Configuration Examples 3
LAN Interfaces 6.5R1 v01 Vyatta
• The router’s hostname should be mapped to the loopback interface address,
rather than to a physical interface.
• In OSPF and BGP, the router ID should be set to the loopback address. This will
prevent a possible dynamic recalculation and reassignment of the loopback
address when physical interfaces are added or removed from the system. This
action will be disruptive to active BGP and OSPF sessions.
The Vyatta system has extensive support for IPv6, including IPv6 interface
addressing. The commands for configuring IPv6 on the loobback interface are given
in this chapter. A full description of Vyatta IPv6 support is provided in the Vyatta
IPv6 Support Reference Guide.
Loopback Interface Configuration Examples
This section presents the following topics:
• Configuring Network Addresses
• IPv6 on the Loopback Interface
Configuring Network Addresses
The system automatically creates and addresses the loopback interface, so you need
not configure any additional addressing. If you delete the loopback node, the system
recreates and re-addresses the loopback address again the next time the system starts.
There may be times when you want to configure a smaller network prefix than /8 to
the loopback interface. The example in this section assigns the address
192.168.75.1/32 to the loopback interface. When you have finished, the interface
will be configured as in Figure 1-1.
Figure 1‐1 Configuring the loopback interface
R2
lo
192.168.75.1/32
192.168.75.1/32

25. Chapter 1: Loopback Interface Loopback Interface Configuration Examples 4
LAN Interfaces 6.5R1 v01 Vyatta
To configure the loopback interface, perform the following steps in configuration
mode.
IPv6 on the Loopback Interface
Examples for configuring IPv6 on interfaces are provided in the Vyatta IPv6 Support
Reference Guide.
Example 1‐1 Configuring the loopback interface
Step Command
Assign the IP address to the
loopback interface.
vyatta@R1# set interfaces loopback lo address 192.168.75.1/32
Commit the configuration. vyatta@R1# commit
View the configuration. vyatta@R1# show interfaces loopback
loopback lo {
address 192.168.75.1/32
}

26. Chapter 1: Loopback Interface Loopback Interface Commands 5
LAN Interfaces 6.5R1 v01 Vyatta
Loopback Interface Commands
Commands for using other system features with loopback interfaces can be found in
the following locations.
Configuration Commands
interfaces loopback lo Defines the loopback interface.
interfaces loopback lo address Sets an IP address and network prefix for the loopback interface.
interfaces loopback lo description <descr> Allows you to record a description for the loopback interface.
Operational Commands
clear interfaces loopback counters Clears statistics counters for loopback interfaces.
show interfaces loopback Displays information about the loopback interface.
Related Commands Documented Elsewhere
OSPF OSPF is supported on the loopback interface. Commands for configuring OSPF are
described in the Vyatta OSPF Reference Guide.
QoS QoS traffic policies are supported on the loopback interface. Commands for
configuring quality of service on the loopback interface are described in the Vyatta
QoS Reference Guide.
RIP RIP is supported on the loopback interface. Commands for configuring RIP are
described in the Vyatta RIP Reference Guide.
RIPng RIPng is supported on the loopback interface. Commands for configuring RIPng are
described in the Vyatta RIPng Reference Guide.

27. Chapter 1: Loopback Interface Loopback Interface Commands 6
LAN Interfaces 6.5R1 v01 Vyatta
clear interfaces loopback counters
Clears statistics counters for loopback interfaces.
Syntax
clear interfaces loopback [lo] counters
Command Mode
Operational mode.
Parameters
Default
Clears all counters for the loopback interface.
Usage Guidelines
Use this command to clear counters on the loopback interface.
lo Optional. Clears statistics for the loopback interface only.
Equivalent to using the command with no option.

28. Chapter 1: Loopback Interface Loopback Interface Commands 7
LAN Interfaces 6.5R1 v01 Vyatta
interfaces loopback lo
Defines the loopback interface.
Syntax
set interfaces loopback lo
delete interfaces loopback lo
show interfaces loopback
Command Mode
Configuration mode.
Configuration Statement
interfaces {
loopback lo
}
Parameters
None.
Default
A configuration node is automatically created for the loopback interface on startup.
Usage Guidelines
Use this command to configure the loopback interface.
You can use the set form of this command to create the loopback interface. However,
the system automatically creates a configuration node for the loopback interface on
startup, so you should not need to use the set form of this command to create the
loopback interface unless you have deleted it.
Use the delete form of this command to remove all configuration for the loopback
interface. The system will create an empty configuration node for the interface the
next time the system starts.
Use the show form of this command to view loopback interface configuration.

29. Chapter 1: Loopback Interface Loopback Interface Commands 8
LAN Interfaces 6.5R1 v01 Vyatta
interfaces loopback lo address
Sets an IP address and network prefix for the loopback interface.
Syntax
set interfaces loopback lo address {ipv4 | ipv6}
delete interfaces loopback lo address {ipv4 | ipv6}
show interfaces loopback lo address
Command Mode
Configuration mode.
Configuration Statement
interfaces {
loopback lo {
address [ipv4|ipv6]
}
}
Parameters
Default
None.
ipv4 An IPv4 address and network prefix for this interface. The format
is ip-address/prefix (for example, 127.0.0.1/8).
You can define multiple IP addresses for the loopback interface by
creating multiple address configuration nodes.
ipv6 An IPv6 address and network prefix for this interface. The format
is ipv6-address/prefix (for example, ::1/128).
You can define multiple IPv6 addresses for a single interface, by
creating multiple address configuration nodes.

30. Chapter 1: Loopback Interface Loopback Interface Commands 9
LAN Interfaces 6.5R1 v01 Vyatta
Usage Guidelines
Use the set form of this command to specify the IP address and network mask for the
loopback interface. You can set more than one IP address for the loopback interface
by creating multiple address configuration nodes.
Use the delete form of this command to remove the loopback interface address.
Use the show form of this command to view loopback interface address
configuration.

31. Chapter 1: Loopback Interface Loopback Interface Commands 10
LAN Interfaces 6.5R1 v01 Vyatta
interfaces loopback lo description <descr>
Allows you to record a description for the loopback interface.
Syntax
set interfaces loopback lo description descr
delete interfaces loopback lo description
show interfaces loopback lo description
Command Mode
Configuration mode.
Configuration Statement
interfaces {
loopback lo {
description descr
}
}
Parameters
Default
None.
Usage Guidelines
Use this command to set a description for the loopback interface.
Use the set form of this command to specify the description.
Use the delete form of this command to remove the description.
Use the show form of this command to view description configuration.
descr A description for the loopback interface.

32. Chapter 1: Loopback Interface Loopback Interface Commands 11
LAN Interfaces 6.5R1 v01 Vyatta
show interfaces loopback
Displays information about the loopback interface.
Syntax
show interfaces loopback [lo [brief] | detail]
Command Mode
Operational mode.
Parameters
Default
When used with no option, this command displays brief status information for the
loopback interface.
Usage Guidelines
Use this command to view information and status for the loopback interface.
The show interfaces loopback and show interfaces loopback lo brief commands are
equivalent.
The show interfaces loopback lo and show interfaces loopback detail commands are
equivalent.
lo Displays detailed statistics and configuration information for the
loopback interface.
brief Displays brief status information for the loopback interface. Enter
the show interfaces loopback command with the lo brief option is
equivalent to entering it with no option.
detail Displays detailed information and statistics about the loopback
interface.

33. Chapter 1: Loopback Interface Loopback Interface Commands 12
LAN Interfaces 6.5R1 v01 Vyatta
Examples
Example 1-2 shows brief status information for the loopback interface.
Example 1‐2 Displaying loopback interface information.
vyatta@R1:~$ show interfaces loopback
Codes: S ‐ State, L ‐ Link, u ‐ Up, D ‐ Down, A ‐ Admin Down
Interface IP Address S/L Description
‐‐‐‐‐‐‐‐‐ ‐‐‐‐‐‐‐‐‐‐ ‐‐‐ ‐‐‐‐‐‐‐‐‐‐‐
lo 127.0.0.1/8 u/u
::1/128
Example 1-3 shows additional detail for the loopback interface.
Example 1‐3 Displaying additional loopback interface detail.
vyatta@R1:~$ show interfaces loopback lo
lo: <LOOPBACK,UP,LOWER_UP> mtu 16436 qdisc noqueue state UNKNOWN
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
RX: bytes packets errors dropped overrun mcast
44056 730 0 0 0 0
TX: bytes packets errors dropped carrier collisions
44056 730 0 0 0 0

34. 13
LAN Interfaces 6.5R1 v01 Vyatta
Chapter 2: Ethernet Interfaces
This chapter describes basic configuration for Ethernet interfaces.
This chapter presents the following topics:
• Ethernet Interfaces Overview
• Ethernet Interface Configuration Examples
• Ethernet Interface Commands

35. Chapter 2: Ethernet Interfaces Ethernet Interfaces Overview 14
LAN Interfaces 6.5R1 v01 Vyatta
Ethernet Interfaces Overview
A system receives packets from neighboring systems through its network interfaces.
On the LAN, this interface is typically an Ethernet interface.
Ethernet interfaces are viewed and configured in the interfaces ethernet node of the
configuration tree. The system automatically discovers the physical interfaces on the
system and creates entries for them on startup in the configuration tree. For example,
on a system with two Ethernet interfaces, the router automatically creates
configuration nodes for eth0 and eth1.
Once the interface is enabled and provided with an address, you can configure it with
various system features—such as firewall, routing protocols, Quality of Service, and
so on.
The Vyatta system has extensive support for IPv6, including IPv6 interface
addressing. The commands for configuring IPv6 on Ethernet interfaces are given in
this chapter. A full description of Vyatta IPv6 support is provided in the Vyatta IPv6
Support Reference Guide.
Ethernet Interface Configuration Examples
This section presents the following topics:
• Viewing System Interfaces
• Basic Ethernet Interface Configuration
• Ethernet Multinetting
• IPv6 on Ethernet Interfaces
Viewing System Interfaces
You can only configure interfaces that actually are physically available to the
operating system on the hardware you are using. To view all the interfaces known to
the operating system, use the show interfaces system command in operational mode,
as shown in Example 2-1. In this example, the system has two physical Ethernet
interfaces, eth0 and eth1, plus a VLAN interface (vif) configured for VLAN 40 under
eth1.
Example 2‐1 Viewing available system interfaces
vyatta@vyatta:~$ show interfaces system
vyatta@R1:~$ show interfaces system
eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state
UP qlen 1000
link/ether 3a:26:db:4d:63:a2 brd ff:ff:ff:ff:ff:ff

36. Chapter 2: Ethernet Interfaces Ethernet Interface Configuration Examples 15
LAN Interfaces 6.5R1 v01 Vyatta
inet 192.168.1.81/24 brd 192.168.1.255 scope global eth0
inet6 fe80::3826:dbff:fe4d:63a2/64 scope link
valid_lft forever preferred_lft forever
RX: bytes packets errors dropped overrun mcast
18512372 189264 0 0 0 0
TX: bytes packets errors dropped carrier collisions
867299 7494 0 0 0 0
eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state
UP qlen 1000
link/ether aa:31:57:a8:ee:90 brd ff:ff:ff:ff:ff:ff
inet 10.10.30.65/24 brd 10.10.30.255 scope global eth1
inet6 fe80::a831:57ff:fea8:ee90/64 scope link
valid_lft forever preferred_lft forever
RX: bytes packets errors dropped overrun mcast
0 0 0 0 0 0
TX: bytes packets errors dropped carrier collisions
776 8 0 0 0 0
eth1.40@eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue
state UP
link/ether aa:31:57:a8:ee:90 brd ff:ff:ff:ff:ff:ff
inet 10.10.40.65/24 brd 10.10.40.255 scope global eth1.40
inet6 fe80::a831:57ff:fea8:ee90/64 scope link
valid_lft forever preferred_lft forever
RX: bytes packets errors dropped overrun mcast
0 0 0 0 0 0
TX: bytes packets errors dropped carrier collisions
368 4 0 0 0 0
lo: <LOOPBACK,UP,LOWER_UP> mtu 16436 qdisc noqueue state UNKNOWN
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
RX: bytes packets errors dropped overrun mcast
11170696 186174 0 0 0 0
TX: bytes packets errors dropped carrier collisions
11170696 186174 0 0 0 0

37. Chapter 2: Ethernet Interfaces Ethernet Interface Configuration Examples 16
LAN Interfaces 6.5R1 v01 Vyatta
Basic Ethernet Interface Configuration
This section presents a sample configuration for an Ethernet interface connected to
an Ethernet LAN.
When you have finished, the system will be configured as shown in Figure 2-1.
Figure 2‐1 Basic Ethernet configuration
Example 2-2 applies IP addresses directly to the two Ethernet interfaces already
discovered for the system—eth0 and eth1. These interfaces were automatically
created by the system on startup, when the system detected the physical interfaces. In.
Each IP address is applied directly to the interface. The system automatically
discovers the MAC address (hardware ID) of the Network Interface Card (NIC)
housing the Ethernet interface, and applies default values for a number of other
options.
To configure these interfaces, perform the following steps in configuration mode.
R1
eth0
.65
eth1
.65
172.16.0.0/24
10.10.30.0/24
Example 2‐2 Configuring Ethernet interfaces
Step Command
Assign an IP address to interface
eth0.
vyatta@R1# set interfaces ethernet eth0 address
176.16.0.65/24
Assign an IP address to interface
eth1.
vyatta@R1# set interfaces ethernet eth1 address
10.10.30.65/24
[edit]

38. Chapter 2: Ethernet Interfaces Ethernet Interface Configuration Examples 17
LAN Interfaces 6.5R1 v01 Vyatta
Ethernet Multinetting
Each physical interface can have multiple IP addresses assigned to it.If you want to
have multiple networks on the same physical interface (called multinetting), but you
don’t want to use 802.1Q VLANs, simply create multiple address configuration
nodes directly under the primary interface.
To configure Ethernet multinetting, perform the following steps in configuration
mode.
Commit and view the
configuration.
vyatta@R1# commit
OK
[edit]
vyatta@R1# show interfaces ethernet
eth0 {
address 176.16.0.65/24
duplex auto
hw‐id 3a:26:db:4d:63:a2
smp_affinity auto
speed auto
}
eth1 {
address 10.10.30.65/24
duplex auto
hw‐id 00‐14‐22‐01‐5c‐6f
smp_affinity auto
speed auto
}
[edit]
Example 2‐2 Configuring Ethernet interfaces
Example 2‐3 Configuring Ethernet multinetting
Step Command
Assign the first IP address to
eth0.
vyatta@R2# set interfaces ethernet eth0 address
172.16.0.65/24 [edit]
Assign the second IP address to
eth0.
vyatta@R1# set interfaces ethernet eth0 address
192.168.1.17/24
[edit]

39. Chapter 2: Ethernet Interfaces Ethernet Interface Configuration Examples 18
LAN Interfaces 6.5R1 v01 Vyatta
IPv6 on Ethernet Interfaces
Examples for configuring IPv6 on interfaces are provided in the Vyatta IPv6 Support
Reference Guide.
Commit and view the
configuration.
vyatta@R1# commit
OK
[edit]
vyatta@Test1# show interfaces ethernet eth0
address 192.168.1.81/24
address 192.168.1.17/24
duplex auto
hw‐id 3a:26:db:4d:63:a2
smp_affinity auto
auto
[edit]
Example 2‐3 Configuring Ethernet multinetting

40. Chapter 2: Ethernet Interfaces Ethernet Interface Commands 19
LAN Interfaces 6.5R1 v01 Vyatta
Ethernet Interface Commands
Configuration Commands
clear interfaces ethernet counters Clears statistics counters for Ethernet interfaces.
interfaces ethernet <ethx> address Sets an IP address and network prefix for an Ethernet
interface.
interfaces ethernet <ethx> description <descr> Specifies a description for an Ethernet interface.
interfaces ethernet <ethx> dhcpv6‐options Specifies the way in which a DHCPv6 client is to acquire an
address and/or parameters from a DHCPv6 server.
interfaces ethernet <ethx> disable Disables an Ethernet interface without discarding
configuration.
interfaces ethernet <ethx> disable‐flow‐control Disables IEEE 802.3x full‐duplex flow control (“PAUSE”
frames).
interfaces ethernet <ethx> disable‐link‐detect Directs an Ethernet interface not to detect physical link‐state
changes.
interfaces ethernet <ethx> duplex <duplexity> Sets the duplex mode for an Ethernet interface.
interfaces ethernet <ethx> hw‐id <mac‐addr> Associates the Ethernet interface name with a hardware MAC
address.
interfaces ethernet <ethx> ip enable‐proxy‐arp Enables proxy ARP on an Ethernet interface.
interfaces ethernet <ethx> ipv6 address Assigns an IPv6 address to an Ethernet interface.
interfaces ethernet <ethx> ipv6
disable‐forwarding
Disables IPv6 forwarding on an Ethernet interface.
interfaces ethernet <ethx> ipv6
dup‐addr‐detect‐transmits <num>
Specifies the number of times to transmit NS packets as part
of the DAD process.
interfaces ethernet <ethx> ipv6 router‐advert Specifies the router advertisements to be sent from an
Ethernet interface.
interfaces ethernet <ethx> mac <mac‐addr> Sets the MAC address of an Ethernet interface.
interfaces ethernet <ethx> mirror <interface> Mirrors inbound traffic from an Ethernet interface to another
interface.
interfaces ethernet <ethx> mtu <mtu> Sets the MTU for an Ethernet interface.
interfaces ethernet <ethx> redirect <interface> Redirects inbound traffic from an Ethernet interface to
another interface.