show interfaces mac-database
Syntax
show interfaces mac-database (ge-fpc/pic/port | ge-fpc/pic/port.n | aex| xe-fpc/pic/port | xe-fpc/pic/port.n | et-fpc/pic/port | et-fpc/pic/port.n) <mac-address mac-address>
Description
(M Series, T Series, MX Series routers, and PTX Series Packet Transport Routers only) Display media access control (MAC) address information for the specified interface.
Options
ge-fpc/pic/port | Display MAC addresses that have been learned on all logical interfaces on a particular physical interface. |
ge-fpc/pic/port.n | Display MAC addresses that have been learned on a particular logical interface. |
aex | Display MAC addresses that have been learned on a particular aggregated Ethernet interface. |
xe-fpc/pic/port | Display MAC addresses that have been learned on all logical interfaces on a particular physical interface. |
xe-fpc/pic/port.n | Display MAC addresses that have been learned on a particular logical interface. |
et-fpc/pic/port | Display MAC addresses that have been learned on all logical interfaces on a particular physical interface. |
et-fpc/pic/port.n | Display MAC addresses that have been learned on a particular logical interface. |
mac-address mac-address | (Optional) Display detailed MAC address
statistics, including policer information for |
Additional Information
On IQ2 PIC interfaces, the default value for maximum retention of entries in the MAC address table has changed, for cases in which the table is not full. The new holding time is 12 hours. The previous retention time of 3 minutes is still in effect when the table is full.
Required Privilege Level
view
Output Fields
Table 1 lists the output fields for the show interfaces mac-database
command. Output fields are listed in the approximate order in which
they appear.
Field Name |
Field Description |
---|---|
Physical Interface | |
Physical interface |
Name of the physical interface. |
Enabled |
State of the physical interface. Possible values are described in the “Enabled Field” section under Common Output Fields Description. |
Interface index |
Physical interface index number, which reflects its initialization sequence. |
SNMP ifIndex |
SNMP index number for the physical interface. |
Description |
Description and name of the interface. |
Link-level type |
Encapsulation being used on the physical interface. |
MTU |
MTU size on the physical interface. |
Speed |
Speed at which the interface is running. |
Loopback |
Whether loopback is enabled and the type of loopback: local or remote. |
Source filtering |
Whether source filtering is configured. |
Flow control |
Whether flow control is enabled or disabled. |
|
(Aggregated Ethernet interfaces only) Number of child links that must be operational for the aggregated interface to be operational. |
|
(Aggregated Ethernet interfaces only) Minimum amount of bandwidth of child links that must be operational for the aggregated interface to be operational. |
Device flags |
Information about the physical device. Possible values are described in the “Device Flags” section under Common Output Fields Description. |
|
(Aggregated Ethernet interfaces only) Configured MAC address. |
|
(Aggregated Ethernet interfaces only) Hardware MAC address. |
|
(Aggregated Ethernet interfaces only) Date, time, and how long
ago the interface went from down to up or from up to down. The format
is |
|
(Aggregated Ethernet interfaces only) Input rate in bits per second (bps) and packets per second (pps). |
|
(Aggregated Ethernet interfaces only) Output rate in bps and pps. |
Interface flags |
Information about the interface. Possible values are described in the “Links Flags” section under Common Output Fields Description. |
Link flags |
Information about the link. Possible v4alues are described in the “Device Flags” section under Common Output Fields Description. |
Logical Interface | |
Logical interface |
Name of the logical interface. |
Index |
Logical interface index number, which reflects its initialization sequence. |
SNMP ifIndex |
Logical interface SNMP interface index number. |
Flags |
Information about the logical interface (possible values are described in the “Logical Interface Flags” section under Common Output Fields Description. |
Encapsulation |
Encapsulation on the logical interface. |
MAC address, Input frames, Input bytes, Output frames, Output bytes |
MAC address and corresponding number of input frames, input bytes, output frames, and output bytes. |
Number of MAC addresses |
Number of MAC addresses configured. |
Policer Statistics |
(Displayed for mac-address option for
|
Sample Output
- show interfaces mac-database (All MAC Addresses on a Port)
- show interfaces mac-database (All MAC Addresses on an Aggregated Ethernet Interface)
- show interfaces mac-database (All MAC Addresses on a Service)
- show interfaces mac-database mac-address
- show interfaces mac-database (Physical interface)
- show interfaces mac-database (Logical interface)
- show interfaces mac-database (Aggregated Ethernet)
show interfaces mac-database (All MAC Addresses on a Port)
user@host> show interfaces mac-database xe-0/3/3 Physical interface: xe-0/3/3, Enabled, Physical link is Up Interface index: 372, SNMP ifIndex: 788 Link-level type: Ethernet, MTU: 1514, LAN-PHY mode, Speed: 10Gbps, Loopback: None, Source filtering: Disabled, Flow control: Enabled Device flags : Present Running Interface flags: SNMP-Traps Internal: 0x4000 Link flags : None Logical interface xe-0/3/3.0 (Index 364) (SNMP ifIndex 829) Flags: SNMP-Traps 0x4004000 Encapsulation: ENET2 MAC address Input frames Input bytes Output frames Output bytes 00:00:00:00:00:00 1 56 0 0 00:00:c0:01:01:02 7023810 323095260 0 0 00:00:c0:01:01:03 7023810 323095260 0 0 00:00:c0:01:01:04 7023810 323095260 0 0 00:00:c0:01:01:05 7023810 323095260 0 0 00:00:c0:01:01:06 7023810 323095260 0 0 00:00:c0:01:01:07 7023810 323095260 0 0 00:00:c0:01:01:08 7023809 323095214 0 0 00:00:c0:01:01:09 7023809 323095214 0 0 00:00:c0:01:01:0a 7023809 323095214 0 0 00:00:c0:01:01:0b 7023809 323095214 0 0 00:00:c8:01:01:02 30424784 1399540064 37448598 1722635508 00:00:c8:01:01:03 30424784 1399540064 37448598 1722635508 00:00:c8:01:01:04 30424716 1399536936 37448523 1722632058 00:00:c8:01:01:05 30424789 1399540294 37448598 1722635508 00:00:c8:01:01:06 30424788 1399540248 37448597 1722635462 00:00:c8:01:01:07 30424783 1399540018 37448597 1722635462 00:00:c8:01:01:08 30424783 1399540018 37448596 1722635416 00:00:c8:01:01:09 8836796 406492616 8836795 406492570 00:00:c8:01:01:0a 30424712 1399536752 37448521 1722631966 00:00:c8:01:01:0b 30424715 1399536890 37448523 1722632058 Number of MAC addresses : 21
show interfaces mac-database (All MAC Addresses on an Aggregated Ethernet Interface)
user@host> show interfaces mac-database ae4 Physical interface: ae4, Enabled, Physical link is Up Interface index: 132, SNMP ifIndex: 588 Description: Member links xe-0/2/0 Link-level type: Ethernet, MTU: 9188, Speed: Unspecified, BPDU Error: None, MAC-REWRITE Error: None, Loopback: Disabled, Source filtering: Disabled, Flow control: Disabled, Minimum links needed: 1, Minimum bandwidth needed: 0 Device flags : Present Running Interface flags: Interface flags: SNMP-Traps Internal: 0x4000 Current address: 00:22:83:76:ff:c4, Hardware address: 00:22:83:76:ff:c4 Last flapped : 2013-12-18 04:33:22 PST (1w5d 22:23 ago) Input rate : 62756384 bps (85266 pps) Output rate : 62759472 bps (85272 pps) Logical interface ae4.0 (Index 334) (SNMP ifIndex 647) Flags: SNMP-Traps 0x4004000 Encapsulation: ENET2 MAC address Input frames Input bytes Output frames Output bytes 00:00:00:aa:00:02 23888711 2627758118 300 22200 00:00:00:aa:00:03 0 0 0 0 00:00:00:aa:00:04 0 0 0 0 Number of MAC addresses : 3
show interfaces mac-database (All MAC Addresses on a Service)
user@host> show interfaces mac-database xe-0/3/3 Logical interface xe-0/3/3.0 (Index 364) (SNMP ifIndex 829) Flags: SNMP-Traps 0x4004000 Encapsulation: ENET2 MAC address Input frames Input bytes Output frames Output bytes 00:00:00:00:00:00 1 56 0 0 00:00:c0:01:01:02 7023810 323095260 0 0 00:00:c0:01:01:03 7023810 323095260 0 0 00:00:c0:01:01:04 7023810 323095260 0 0 00:00:c0:01:01:05 7023810 323095260 0 0 00:00:c0:01:01:06 7023810 323095260 0 0 00:00:c0:01:01:07 7023810 323095260 0 0 00:00:c0:01:01:08 7023809 323095214 0 0 00:00:c0:01:01:09 7023809 323095214 0 0 00:00:c0:01:01:0a 7023809 323095214 0 0 00:00:c0:01:01:0b 7023809 323095214 0 0 00:00:c8:01:01:02 31016568 1426762128 38040381 1749857526 00:00:c8:01:01:03 31016568 1426762128 38040382 1749857572 00:00:c8:01:01:04 31016499 1426758954 38040306 1749854076 00:00:c8:01:01:05 31016573 1426762358 38040381 1749857526 00:00:c8:01:01:06 31016573 1426762358 38040381 1749857526 00:00:c8:01:01:07 31016567 1426762082 38040380 1749857480 00:00:c8:01:01:08 31016567 1426762082 38040379 1749857434 00:00:c8:01:01:09 9428580 433714680 9428580 433714680 00:00:c8:01:01:0a 31016496 1426758816 38040304 1749853984 00:00:c8:01:01:0b 31016498 1426758908 38040307 1749854122
show interfaces mac-database mac-address
user@host> show interfaces mac-database xe-0/3/3 mac-address 00:00:c8:01:01:09 Physical interface: xe-0/3/3, Enabled, Physical link is Up Interface index: 372, SNMP ifIndex: 788 Link-level type: Ethernet, MTU: 1514, LAN-PHY mode, Speed: 10Gbps, Loopback: None, Source filtering: Disabled, Flow control: Enabled Device flags : Present Running Interface flags: SNMP-Traps Internal: 0x4000 Link flags : None Logical interface xe-0/3/3.0 (Index 364) (SNMP ifIndex 829) Flags: SNMP-Traps 0x4004000 Encapsulation: ENET2 MAC address: 00:00:c8:01:01:09, Type: Configured, Input bytes : 202324652 Output bytes : 202324560 Input frames : 4398362 Output frames : 4398360 Policer statistics: Policer type Discarded frames Discarded bytes Output aggregate 3992386 183649756
show interfaces mac-database (Physical interface)
user@host> show interfaces mac-database et-1/0/1 Physical interface: et-1/0/1, Enabled, Physical link is Up Interface index: 1022, SNMP ifIndex: 533 Link-level type: Ethernet, MTU: 1514, LAN-PHY mode, Speed: 400Gbps, BPDU Error: None, Loop Detect PDU Error: None, MAC-REWRITE Error: None, Loopback: Disabled, Source filtering: Disabled, Flow control: Enabled, Auto-negotiation: Disabled, Media type: Fiber Device flags : Present Running Interface flags: SNMP-Traps Logical interface et-1/0/1.0 (Index 1005) (SNMP ifIndex 545) Flags: Up SNMP-Traps Encapsulation: ENET2 MAC address Input frames Input bytes Output frames Output bytes 00:00:00:00:00:00 1 56 0 0 00:00:c0:01:01:02 7023810 323095260 0 0 00:00:c0:01:01:03 7023810 323095260 0 0 00:00:c0:01:01:04 7023810 323095260 0 0 00:00:c0:01:01:05 7023810 323095260 0 0 00:00:c0:01:01:06 7023810 323095260 0 0 00:00:c0:01:01:07 7023810 323095260 0 0 00:00:c0:01:01:08 7023809 323095214 0 0 00:00:c0:01:01:09 7023809 323095214 0 0 00:00:c0:01:01:0a 7023809 323095214 0 0 00:00:c0:01:01:0b 7023809 323095214 0 0 00:00:c8:01:01:02 30424784 1399540064 37448598 1722635508 00:00:c8:01:01:03 30424784 1399540064 37448598 1722635508 00:00:c8:01:01:04 30424716 1399536936 37448523 1722632058 00:00:c8:01:01:05 30424789 1399540294 37448598 1722635508 00:00:c8:01:01:06 30424788 1399540248 37448597 1722635462 00:00:c8:01:01:07 30424783 1399540018 37448597 1722635462 00:00:c8:01:01:08 30424783 1399540018 37448596 1722635416 00:00:c8:01:01:09 8836796 406492616 8836795 406492570 00:00:c8:01:01:0a 30424712 1399536752 37448521 1722631966 00:00:c8:01:01:0b 30424715 1399536890 37448523 1722632058 Number of MAC addresses : 21
show interfaces mac-database (Logical interface)
user@host> show interfaces mac-database et-1/0/1.0 Logical interface et-1/0/1.0 (Index 1005) (SNMP ifIndex 545) Flags: SNMP-Traps Encapsulation: ENET2 MAC address Input frames Input bytes Output frames Output bytes 00:00:00:00:00:00 1 56 0 0 00:00:c0:01:01:02 7023810 323095260 0 0 00:00:c0:01:01:03 7023810 323095260 0 0 00:00:c0:01:01:04 7023810 323095260 0 0 00:00:c0:01:01:05 7023810 323095260 0 0 00:00:c0:01:01:06 7023810 323095260 0 0 00:00:c0:01:01:07 7023810 323095260 0 0 00:00:c0:01:01:08 7023809 323095214 0 0 00:00:c0:01:01:09 7023809 323095214 0 0 00:00:c0:01:01:0a 7023809 323095214 0 0 00:00:c0:01:01:0b 7023809 323095214 0 0 00:00:c8:01:01:02 30424784 1399540064 37448598 1722635508 00:00:c8:01:01:03 30424784 1399540064 37448598 1722635508 00:00:c8:01:01:04 30424716 1399536936 37448523 1722632058 00:00:c8:01:01:05 30424789 1399540294 37448598 1722635508 00:00:c8:01:01:06 30424788 1399540248 37448597 1722635462 00:00:c8:01:01:07 30424783 1399540018 37448597 1722635462 00:00:c8:01:01:08 30424783 1399540018 37448596 1722635416 00:00:c8:01:01:09 8836796 406492616 8836795 406492570 00:00:c8:01:01:0a 30424712 1399536752 37448521 1722631966 00:00:c8:01:01:0b 30424715 1399536890 37448523 1722632058
show interfaces mac-database (Aggregated Ethernet)
user@host> show interfaces mac-database ae0 Physical interface: ae0, up, Physical link is Up Interface index: 6000, SNMP ifIndex: 541 Link-level type: Ethernet, MTU: 1514, Speed: 800Gbps, BPDU Error: None, MAC-REWRITE Error: None, Loopback: Disabled, Source filtering: Disabled, Flow control: Enabled, Minimum links needed: 1, Minimum bandwidth needed: 1bps Device flags : Present Running Interface flags: SNMP-Traps Current address: da:5e:26:3b:03:57, Hardware address: da:5e:26:3b:03:57 Last flapped : 2021-12-16 12:08:26 IST (00:04:00 ago) Input rate : 0 bps (0 pps) Output rate : 0 bps (0 pps) Logical interface ae0.0 (Index 9700) (SNMP ifIndex 546) Flags: Up SNMP-Traps Encapsulation: Ethernet-Bridge MAC address Input frames Input bytes Output frames Output bytes 00:00:00:aa:00:02 23888711 2627758118 300 22200 00:00:00:aa:00:03 0 0 0 0 00:00:00:aa:00:04 0 0 0 0 Number of MAC addresses : 3
Release Information
Command introduced before Junos OS Release 7.4.
Command introduced on PTX Series Packet Transport Routers for Junos OS Release 12.1.
Support for statement
with the aex
option introduced in
Junos OS Release 15.1.